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

AVAILABILITY

SUNWcsu

DESCRIPTION

This command is used to configure 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

-f filename

Set 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 . . . modulen

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 last fields of a line in the autopush file represent the list of module names. The maximum number of modules that can be automatically pushed on a stream is eight. The modules are pushed in the order they are specified. Comment lines start with a # sign. The sys_devices privilege is required for this command to succeed.

-g

Get 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 major

Specifies the major device number.

-m minor

Specifies the minor device number.

-r

Remove the previous configuration setting of the particular 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. The sys_devices privilege is required for this command to succeed.

EXAMPLES

The following example gets the current configuration settings 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

SUMMARY OF TRUSTED

The sys_devices privilege is required for this command to succeed.

SOLARIS CHANGES

FILES

/etc/iu.ap

SEE ALSO

bdconfig (1M),ttymon(1M), ldterm(7M), sad(7DTSOL), streamio(7I) ttcompat(7M)

STREAMS Programming Guide