x29hosts(4)

Requires Optional LAN/X.25 Software

NAME

x29hosts - PAD-related configuration file

DESCRIPTION

x29hosts is an ASCII file in directory /etc/x25 that provides configuration information for the X.25 PAD components: padem, x29printd, x29server, and x29uucpd. Although the x25init command is used to configure the interface cards as well as the X.25 subsystem, further configuration is required for the use of the PAD components.

/etc/x25/x29hosts is made up of one or more parameter groups. The syntax of the parameter groups in the file is as follows:

component_type{
   device            device_name
   name              programmatic_access_name
   remote_x121       remote_x121_address
   x3                x3_config_set_name
   profile           profile_ID
   reverse_charge    request
   logging           level
}

Items in computer font are parameter names and are required if a corresponding parameter value is given. A parameter value follows the parameter name on each line. Parameter name-value pairs can be arranged in any order, but each must appear on a separate line, terminated by a new-line character. Any amount of whitespace (spaces or tabs) can be inserted as long as each parameter group consists of the component_type followed by a pair of curly braces enclosing the description parameters, each on a separate line as shown above. Description parameters are constructed as follows:

Component Type syntax:component_type

The component type field is checked during initialization of each PAD application program. Each program extracts only those parameter groups that are relevant to its own operation. Recognized component types are:

printer (used by x29printd)

pad_spt (used by x29server)

pad_uucp (used by x29uucpd)

pad_em (used by padem)

Device Name syntax:device device_name

The device name defines which device file in directory /dev/x29 is to be used. This field must be present if component_type is either printer for x29printd or pad_uucp for x29uucpd. This field is not meaningful for pad_em and pad_spt.

X.25 Programmatic Access Name
syntax:name programmatic_access_name

The programmatic access name defines the interface card to use for outbound calls. It is the same name as used by the x25init command (see x25init(1M)). This field is not meaningful for pad_spt, which accepts calls on all interfaces.

Remote X.121 Address syntax:remote_x121 remote_x121_address

The X.121 address field defines the remote address to which this PAD component will connect. It can be an extended address based on the address of the interface port that the remote PAD device is using.

X.3 Configuration syntax:x3 x3_config_set_name

The X.3 configuration set name refers to the name given to the set of X.3 parameters used by this PAD component for vitual circuits to this X.121 address. The X.3 configuration sets are found in the file /etc/x25/x3config. This field is only meaningful for pad_spt, printer, and pad_uucp.

Logging Level syntax:logging level

The logging field defines the severity of messages to be saved either in the files under directory /usr/adm/x29 (for x29printd, x29uucpd, and x29server) or in $HOME/plog. PID (for padem).

Profile ID syntax:profile profile_ ID

profile_ ID is an integer that can be used in adition to the X.3 configuration set name. profile_ ID is a reference to a defined set of X.3 parameters found in file /etc/x25/x3config. This field is only meaningful for padem.

Reverse Charging syntax:reverse_charge request

This field tells the PAD component whether reverse charging is requested in the call request packet for the PAD components x29printd, x29uucpd, and padem. It specifies whether reverse charge is allowed for specific incoming calls if it is used in the context of pad_spt. Valid request values are enable, enabled, disable, and disabled. If this parameter is not specified, the default value is disabled.

Also found in the x29hosts file is the host table, which is a mechanism for mapping X.121 addresses to symbolic hostnames manipulated by the end-user. The syntax for the host table is:

host_table {
[symbolic_hostname address]
...
...
}

host_table must be the first token to appear in the host table entry. Each entry in the table consists of a symbolic_hostname followed by a corresponding adddress. symbolic_hostname must be listed first, followed by one or more tabs or spaces, then the X.121 address. Each table entry must appear on a separate line, terminated by a new-line character. The group of one or more entries in the table must be enclosed within a pair of curly braces {}. Comments are allowed in the file and have the character # at the beginning of the line. host_table{} is only used by padem.

EXAMPLES

# Sample x29hosts file

printer {
    device printer1
    name hptndxk0
    remote_x121 408555111201
    x3 hp_printer
    reverse_charge enable
    logging 1
}

pad_uucp {
    device x25uucp
    name hptndxk0
    remote_x121 4085551113
    x3 hp_uucp
    reverse_charge enable
    logging 3
}

host_table {
    Gale 4085551111
    Tornado 4085551113
    Typhoon 40855511115
}

pad_em {
    name hptndxk0
    remote_x121 4085551111
    reverse_charge enable
    profile 0
    logging 3
}

pad_spt {
    remote_x121 408555120801
    x3 hp_padsrvr
    logging 1
    reverse_charge disable
}

# End of sample x29hosts file

AUTHOR

x29hosts was developed by HP.

Museum

Related Articles

x29hosts(4)

NAME

DESCRIPTION

EXAMPLES

AUTHOR

SEE ALSO