autopush(1M)

NAME

     autopush - configures lists of automatically pushed  STREAMS
     modules

SYNOPSIS

     autopush -f filename

     autopush -g -M major -m minor

     autopush -r -M major -m minor

DESCRIPTION

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

OPTIONS

     The following options are supported:

     -f filename
           Sets up the autopush  configuration  for  each  driver
           according  to  the  information stored in filename. An
           autopush file  consists  of  lines  of  four  or  more
           fields, separated by spaces as shown below:

           major minor last-minor module1 module2 ... module8

           The first field is a string that specifies  the  major
           device  name,  as listed in the /kernel/drv directory.
           The next two fields  are  integers  that  specify  the
           minor  device number and last-minor device number. The
           fields following represent the names  of  modules.  If
           minor  is -1, then all minor devices of a major driver
           specified by major are configured, and the  value  for
           last-minor is ignored. If last-minor is 0, then only a
           single minor device  is  configured.  To  configure  a
           range  of  minor devices for a particular major, minor
           must be less than last-minor.

           The remaining fields list the names of modules  to  be
           automatically  pushed  onto  the  stream  when opened,
           along with the position of  an  optional  anchor.  The
           maximum number of modules that can be pushed is eight.
           The modules are pushed in the order  they  are  speci-
           fied. The optional special character sequence [anchor]
           indicates that a STREAMS anchor should  be  placed  on
           the  stream  at the module previously specified in the
           list; it is an error to specify more than  one  anchor
           or to have an anchor first in the list.

            A nonzero exit status indicates that one or  more  of
           the  lines  in  the  specified file failed to complete
           successfully.

     -g    Gets the current configuration setting of a particular
           major  and  minor  device number specified with the -M
           and -m options respectively and displays the  autopush
           modules  associated  with  it. It will also return the
           starting  minor   device   number   if   the   request
           corresponds to a setting of a range (as described with
           the -f option).

     -m minor
           Specifies the minor device number.

     -M major
           Specifies the major device number.

     -r    Removes the previous configuration setting of the par-
           ticular  major  and minor device number specified with
           the -M and -m options respectively. If the  values  of
           major and minor correspond to a previously established
           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.

EXIT STATUS

     The following exit values are returned:

          0     Successful completion.

          non-zero
                An error occurred.

EXAMPLES

     Example 1: Using the autopush command.

     The following example gets the  current  configuration  set-
     tings  for  the  major and minor device numbers as indicated
     and displays the autopush modules associated with  them  for
     the character-special device /dev/term/a:

     example# autopush -g -M 29 -m 0
     Major     Minor     Lastminor     Modules
       29        0         1           ldterm  ttcompat

FILES

     /etc/iu.ap

ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWcsu                     |
    |_____________________________|_____________________________|

SEE ALSO

     bdconfig(1M),   ttymon(1M),    attributes(5),    ldterm(7M),
     sad(7D),  streamio(7I), ttcompat(7M)

     STREAMS Programming Guide