autopush(1M)                   DG/UX R4.11MU05                  autopush(1M)


NAME
       autopush - configure automatically pushed STREAMS modules

SYNOPSIS
       autopush -f file

       autopush -r -M major -m minor

       autopush -g -M major -m minor

   where:
       file   An autopush configuration script, either the path to a file or
              - to indicate standard input
       major  A STREAMS major device identifier, either a major device
              number or the path to a device file
       minor  A STREAMS minor device identifier, either a minor device
              number or the path to a device file

DESCRIPTION
       The autopush command configures the list of modules to be
       automatically pushed onto a stream when a STREAMS device is opened.
       It can also be used to remove a previous setting or get information
       on a setting.

       STREAMS devices are specified to autopush using ``device
       identifiers'' that represent major and minor device numbers.  A
       device identifier can be an explicit non-negative number.
       Alternatively, it can be the path of a character-special device file,
       in which case the major or minor device number of the node is used
       (whichever is appropriate to the context).  The latter choice is
       usually more convenient and less prone to change (see the NOTES
       section below).

       Options are:

       -f file
              Set up the autopush configuration for each driver according to
              the information stored in the file specified by file.  If - is
              given for file, autopush reads the information from its
              standard input.  The information consists of lines of at least
              four fields each, where the fields are separated by blanks
              (spaces or tabs) as shown below:

                   major  minor  last_minor  mod1 mod2 ... modN

              The first three fields are device identifiers.  major
              specifies the major device number, minor specifies the (first
              or only) minor device number, and last_minor specifies the
              last minor device number.

              If minor is -1 (generic), then all minor devices of a driver
              specified by major are configured and the value for last_minor
              is ignored.  If last_minor is 0 or -1, then only the single
              minor device specified by minor is configured.  If minor is
              less than last_minor, all minor devices in the range minor
              through last_minor (inclusive) are configured for major,

              The remaining fields are strings representing the names of
              STREAMS modules.  Each name is separated by a space.  A
              maximum of eight modules can be automatically pushed onto a
              stream.  The modules are pushed in the order they are
              specified (leftmost first).

              Comment lines starting with a # sign are ignored by autopush.
              Blank lines can also be included in the file.

       -r     This option removes the previous configuration setting
              associated with the particular major and minor device
              identifiers specified by the -M and -m options, respectively.
              If the values of major and minor correspond to the setting of
              a range of minor devices, where minor matches the first minor
              device number in the range, the configuration would be removed
              for the entire range.

       -g     This option gets (prints) the current configuration setting
              associated with the particular major and minor device
              identifiers specified by the -M and -m options, respectively.
              It will also print the starting minor device number if the
              request corresponds to the setting of a range (as described
              for the -f option).

EXAMPLES
       $ ls -l /dev/tty00
       crw--w--w-   1 root   root   19,  0 Feb 21 12:51 /dev/tty00

       $ autopush -g -M 19 -m 0
            Major      Minor  Lastminor        Modules
               19          0      -            ldterm ttcompat

       This example prints out the list of automatically-pushed STREAMS
       modules for the TTY device /dev/tty00.  ls -l provides the major and
       minor device numbers (19 and 0, respectively) for the device.  These
       numbers can then be used as the arguments to the -M and -m options of
       autopush.  Note that the first minor number is 0 and the last minor
       number is null.  These values indicate that the autopush setting
       holds for only the individual minor device represented by /dev/tty00
       (although other devices may have duplicate settings).

       autopush -r -M /dev/console -m 0
       echo "/dev/console -1 0 ldterm" | autopush -f -

       This example reconfigures the console device to automatically push
       one STREAMS module, ldterm.  The first command line removes the
       current configuration setting associated with the console driver.
       The second command line creates the new configuration setting, making
       it apply to all minor devices associated with the console driver.

SEE ALSO
       ls(1), strchg(1), sad(7), streamio(7)

NOTES
       On the DG/UX System major and minor device numbers change as devices
       are configured into and de-configured from the system.
       Reconfiguration can obsolete explicit device numbers used with
       autopush.

       The following features are Data General enhancements: the alternative
       of using device pathnames instead of major and minor device numbers;
       the ability to read from standard input instead of from a file; and
       the option of using -1 instead of 0 for the last_minor field of the
       configuration file.


Licensed material--property of copyright holder(s)