autopush(1M)                                                   autopush(1M)




 NAME    [Toc]    [Back]
      autopush - manage system database of automatically pushed STREAMS
      modules

 SYNOPSIS    [Toc]    [Back]
      autopush -f file

      autopush -g -M major -m minor

      autopush -r -M major -m minor

 DESCRIPTION    [Toc]    [Back]
      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    [Toc]    [Back]
      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 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



 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003






 autopush(1M)                                                   autopush(1M)




                          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    [Toc]    [Back]
      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:

           autopush -g -M 75 -m -2

 FILES    [Toc]    [Back]
      /usr/lib/nls/msg/C/autopush.cat                   NLS catalog for
                                                        autopush.

 SEE ALSO    [Toc]    [Back]
      sad(7), streamio(7).


 Hewlett-Packard Company            - 2 -   HP-UX 11i Version 2: August 2003