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.
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
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
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
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 six opens of device
test.
This next example lists information about the stream for major device
75
and its minor device
-2:
FILES
- /usr/lib/nls/msg/C/autopush.cat
NLS catalog for
autopush.