System Administration Commands autopush(1M)
NAME
autopush - configures lists of automatically pushed STREAMS
modulesSYNOPSIS
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. Anautopush 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. Thenext two fields are integers that specify the minor dev-
ice number and last-minor device number. The fields fol-
lowing represent the names of modules. If minor is -1,
then all minor devices of a major driver specified bymajor 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 dev-
ices for a particular major, minor must be less thanlast-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 specified. The optional special character sequence [anchor] indicates that a STREAMS anchor should be placed on the stream atSunOS 5.11 Last change: 15 Feb 2008 1
System Administration Commands autopush(1M)
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 thelines in the specified file failed to complete success-
fully.-g
Gets the current configuration setting of a particularmajor 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 correspondsto 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 thefirst minor device number in the range, the configura-
tion would be removed for the entire range. EXIT STATUS The following exit values are returned: 0 Successful completion.non-zero
An error occurred.SunOS 5.11 Last change: 15 Feb 2008 2
System Administration Commands autopush(1M)
EXAMPLES
Example 1 Using the autopush command.
The following example gets the current configuration set-
tings for the major and minor device numbers as indicatedand 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.apATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWcs ||_____________________________|_____________________________|
SEE ALSO
dladm(1M), ttymon(1M), attributes(5), ldterm(7M), sad(7D), streamio(7I), ttcompat(7M) NOTESThe use of the autopush command is obsolete for networking
data-links. The preferred method of configuring a list of
automatically pushed STREAMS modules on a given networkingdata-link interface is the dladm(1M) autopush link property.
Because network devices are self-cloning, the autopush com-
mand is inadequate for networking devices. The granularityof the autopush command's configuration is driver-wide, and
not per-interface as one might expect. Another reason not to
use autopush is that administrators are more familiar with
the names of their network interfaces than with device majorand minor numbers. The dladm(1M) command allows the confi-
guration using data-link interface names.
SunOS 5.11 Last change: 15 Feb 2008 3