NAME

autopush − manage system database of automatically pushed STREAMS modules

SYNOPSIS

autopush -f file

autopush -g -M major -m minor

autopush -r -M major -m minor

DESCRIPTION

autopush manages the system database that is used for automatic configuration of STREAMS devices.  The command is used in three different ways as dictated by the -f, -g, and -r command-line options described below. 

Options

autopush recognizes the following command-line options and arguments:

-f file Using the configuration information contained in file, load the system database with the names of the STREAMS devices and a list of modules to use for each device.  When a device is subsequently opened, the HP-UX STREAMS subsystem pushes the modules onto the stream for the device. 

file must contain one or more lines of at least four fields separated by a space as shown below:

major minor lastminor module1 module2 ...  moduleN

The first field major can be either an integer or a device name.  The device name is the name for the device used in the /etc/master file.  The next two fields are integers.  If minor is set to -1, then all minor devices for the specified major are configured and ­lastminor is ignored.  If ­lastminor is 0, then only a single minor device is configured. To configure a range of minor devices for a major device, minor must be less then ­lastminor.  The remaining field(s) list one or more module names.  Each module is pushed in the order specified. A maximum of eight modules can be pushed.  Any text after a # character in file is treated as a comment for that line only. 

This option is also used to restore device configuration information previously removed by autopush -r.  However, when used in such a manner, the entire database is restored, not just the information that was previously removed. 

-g -M major -m minor
Display current configuration information from the system database for the STREAMS device specified by the major device number (or device name for the device from the /etc/master file) and minor number. 

If a range of minors has been previously configured then autopush -g returns the configuration information for the first minor in the range, in addition to other information. 

-r -M major -m minor
Remove configuration information from the system database for the STREAMS device specified by the major device number (or device name for the device from the /etc/master file) and minor number.  Removal is performed on the database only, not on the original configuration file.  Therefore, the original configuration can be restored by using the -f file option.  To permanently exclude a STREAMS device from the database, its information must be removed from the configuration file. 

If minor matches the first minor of a previously configured range then ­autopush -r removes the configuration information for the entire configured range. 

EXAMPLES

If the file /tmp/autopush.example contains:

75 -1 0 modA modB

test 0 5 modC modA

Then autopush -f /tmp/autopush.example will cause modA and modB to be pushed whenever major device # 75 is opened, and modC and ModA to be pushed for the first 6 opens of device "test". 

To list information about the stream for major device 75 and its minor device -2:

autopush -g -M 75 -m -2

FILES

/usr/lib/nls/C/autopush.cat
NLS catalog for autopush.

SEE ALSO

sad(7), streamio(7). 

Hewlett-Packard Company  —  HP-UX Release 9.0: October 1992