STREAMS-UX Programmer's Guide (February 2007)

STREAMS Commands
autopush
Appendix G
288
autopush
The autopush command manages the system database of automatically pushed STREAMS modules. The
HP-UX autopush command has been enhanced with respect to UNIX SVR4.2, to allow the user to specify the
device name in place of the major number, which is recommended since HP-UX provides dynamic major
numbers. The name can be specified in the autopush file and on the command line. Device names are located
in the HP-UX modmeta files. The major number can still be used if needed.
Synopsis
The general syntax of autopush on HP-UX is as follows:
autopush -f autopush_file_name
autopush -r -M major_num|dev_name -m minor_num
autopush -g -M major_num|dev_name -m minor_num
The contents of the autopush filename are as follows:
major_num|dev_name low_minor high_minor mod_name 1...mod_name N
Options and Arguments
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.
If “-” appears as a file argument, autopush uses the standard input.
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 modmeta 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 than 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 modmeta file) and minor number.