uucpadm Command

Purpose

Enters basic BNU configuration information.

Syntax

uucpadm

Description

The uucpadm command provides interactive entry and modification of basic BNU configuration information in the Devices, Systems, Permissions, Poll, and Dialcodes files in the /etc/uucp directory. You can use the uucpadm command repeatedly to adjust the same file.

When you enter the uucpadm command at the command line, the command displays a list of the files you can change. After you choose a file to modify, the command displays a vertical list of the names of the fields in that file. You can enter the appropriate entry in each field. When you press the Enter key, the cursor moves to the next field in the list.

The command uses a copy of a file to record changes. The original file remains unchanged until you press the Ctrl+U or Ctrl+X key sequence at the appropriate menu. You can exit to the main uucpadm menu at any time, without saving your changes, by using the Ctrl+D key sequence.

The help routine provides instructions for each data field. Type a ? (question mark) in any menu field to access the help routine for that field.

Type a ~ (tilde) in any field to enter an ASCII editor and edit the appropriate file for that field. The uucpadm command invokes the editor designated by the EDITOR environment variable. If the EDITOR variable is not defined, the command invokes the vi editor.

If your entry for the first menu item matches an existing record, the uucpadm command retrieves that record for update. The command also tells you how many records have that first entry. If your entry for the first menu item does not match any existing record, the uucpadm command displays the word ADD at the top of the screen.

The uucpadm command checks the data as you enter it. If an inconsistency among the files is found, the command displays a warning message.

If the uucpadm command recognizes the entry you make for the first menu item, it fills in the default values for the remaining fields. For example, if you type TCP as the Type in the Devices file menu, the command places a - (hyphen) in each remaining field for you. It also checks for consistency with other files and for processes that should be running on the system. For example, when you type TCP as the Type in the Devices file menu, the uucpadm command checks to see if the uucpd daemon is running. If the daemon is not running, the command displays a note after the Type field, as follows:

Type: TCP
       <Note: Make certain uucpd is enabled.>
Line1: -
Note: The uucpadm command does not edit the /etc/uucp/Dialers file. Use an ASCII editor to edit this file.
Mode File
rw /etc/uucp/Devices
rw /etc/uucp/Dialcodes
rw /etc/uucp/Permissions
rw /etc/uucp/Poll
rw /etc/uucp/Systems

Examples

  1. To start the uucpadm command, type the following:
    /usr/sbin/uucp/uucpadm
    A menu listing the files you can change is displayed.
  2. To make an entry to the /etc/uucp/Devices file, choose the Add/Change Uucp Devices option at the uucpadm menu. The following is a sample uucpadm screen defining a direct 9600 baud connection to system merlin over the tty3 device:
    Type: merlin
    line1: tty3
    line2: -
    class: 9600
    dialers: direct
  3. To make an entry to the /etc/uucp/Systems file, choose the Add/Change Uucp Systems option at the uucpadm menu. The following is a sample uucpadm screen defining the nostromo.aus.ibm.com system connected to an ACU device in class 2400:
    Name: nostromo.aus.ibm.com
    Time: Any
    Type: ACU
    Class: 2400
    Phone: 997-7942
    Login: nuucp
    Password: gotcha
  4. To change the /etc/uucp/Permissions file, choose the Add/Change Uucp Permissions File option at the uucpadm menu.
    1. Following is a sample uucpadm screen defining a LOGNAME entry in the Permissions file:
      L/M: LOGNAME=uucpz
      Request: yes
      Sendfiles: yes
      Read: /
      Write: NOWRITE=/etc
      Callback:
      Commands:
      Validate: merlin:nostromo
      If the remote machine is merlin or nostromo, the login ID must be uucpz (VALIDATE option). Remote hosts using this ID can request to send files, and the local host can sendfiles as requested. Users with this ID can read all files with permissions granted to the others group, and can write to all files, except those in the /etc directory, with permissions granted to the others group.
    2. Following is a sample uucpadm screen defining a MACHINE entry in the Permissions file:
      L/M: MACHINE=merlin
      Request: yes
      Sendfiles:
      Read: NOREAD=/etc
      Write: NOWRITE=/etc
      Callback:
      Commands: ALL
      Validate:
      The machine ID is merlin. Requests for file transfers can be made. The user can read all files and can write to all files except those in the /etc directory. The execution of all commands is permitted.
  5. To make an entry in the /etc/uucp/Poll file, choose the Add/Change Uucp Poll File option at the uucpadm menu. Following is a sample uucpadm screen defining an entry in the Poll file:
    System: merlin
    Hours: 0 7 13 19
    This entry instructs BNU to poll the merlin.aus.ibm.com system at 2400 hours (midnight), 700 hours (7 a.m.), 1300 hours (1 p.m.), and 1900 hours (7 p.m.).
  6. To make an entry in the /etc/uucp/Dialcodes file, choose the Add/Change Uucp Dialcodes option at the uucpadm menu. Following is a sample uucpadm screen defining an entry in the Dialcodes file:
    Abr: LA
    Dialcode: 1-213-
    This entry assigns LA as the abbreviation for the Los Angeles area code.

Files

Item Description
/usr/sbin/uucp/uucpadm Contains the uucpadm command.
/etc/uucp/Devices Contains information about available devices.
/etc/uucp/Dialcodes Contains dialing code abbreviations.
/etc/uucp/Dialers Specifies initial handshaking on a connection.
/etc/uucp/Permissions Describes access permissions for remote systems.
/etc/uucp/Poll Specifies when BNU polls remote systems to initiate tasks.
/etc/uucp/Systems Describes accessible remote systems.