Hewlett-Packard Company - 1 - Version B.1, October 1986
LPADMIN(IM) HP-UX LP ADMIN (1M)
NAME
Ipadmin - configure the LP spooling system SYNOPSIS
/usr /lib /lpadmin -p printer [options]
/usr/lib/lpadmin -xdest /usr /lib/lpadmin -d[destJ DESCRIPTION
Lpadmin configures LP spooling systems to describe printers, classes and devices. It is used to add and remove destinations, change membership in classes, change devices for printers, change printer interface programs and to change the system default destination. Lpadmin may not be used when the LP scheduler, Ipsched(lM), is running, except where noted below.
Exactly one of the -p, -x or -d options must be present for every legal invocation of Ipadmin.
-pprinter
copies an existing printer's interface program to be the new interface program for P. Ipsched(lM), disables all login terminals automatically each time it is started.
Before re-enabling P, its current device should be established using Ipadmin.
selects a model interface program for P. Model is one of the model interface names supplied with the LP software (see Models below).
removes printer P from the specified class. If P is the last member of the class,
Hewlett-Packard Company - 1 - Version B.1, October 1986
LP ADMIN (1M) HP-UX LP ADMIN (1M)
consist entirely of the characters A-Z, a-z, 0-9 and _ (underscore).
Models
Model printer interface programs are supplied with the LP software. They are shell procedures, C programs, or other executable programs which interface between Ipsched(lM) and devices. All models reside in the directory /usr/spool/lp/model and may be used as is with Ipadmin -m.
Models should have 644 permission if owned by lp and bin, or 664 permission if owned by bin and bin. Alternatively, LP administrators may modify copies of models and then use Ipadmin -i to associate them with printers. See mklp(lM) for details of the printer models provided with your HP-UX system.
The LP model interface program does the actual printing on the device that is currently associated with the printer. The LP spooler sets standard in to /dev /null and standard out and standard error to the device specified in the -v option of Ipadmin. The interface program is invoked then for printer P from the directory /usr/spool/lp as follows:
interface/P id user title copies options file ...
id is the request returned by Ip.
user is the logname of the user who made the request.
title is the optional title specified with the -t option of lp.
copies is the number of copies to be printed.
options is a blank separated list of class-dependent or printer-dependent options specified with the -0 option of lp.
file is the full pathname of the file to be printed.
Given the command line arguments and the output directed to the device, interface programs may format their output in any way they choose.
When the printing is completed, it is the responsibility of the interface program to exit with a code indicative of the success of the print job. A return value of 0 indicates that the job com-pleted successfully. Values of 1 to 127 indicate that some error was encountered. This problem will not effect future print jobs. Ipsched notifies users by mail that there was an error in printing the request. When problems are detected which are likely to effect future print jobs, the interface program would be well to disable the printer so that print requests are not lost.
EXAMPLES
Assuming there is an existing Hewlett-Packard 2934A line printer named Ip2, it will use the hp2934a model interface after the command:
/usr/lib/lpadmin -plp2 -mhp2934a FILES
/usr/spool/lp/*
SEE ALSO
accept(lM), enable(l), lp(l), Ipsched(lM), lpstat(l), mklp(lM), nroff(l).
INTERNATIONAL SUPPORT messages.
Hewlett-Packard Company - 2 - Version B.l, October 1986
LPSCHED (1M) HP-UX LPSCHED (1M)
NAME
Ipsched, lpshut, lpmove - start/stop the LP request scheduler and move requests SYNOPSIS
/usr /lib/lpsched [-v
1
/usr/lib/lpshut
/usr /lib/lpmove requests dest /usr /lib /lpmove destl dest2 DESCRIPTION
FILES
Lpsched schedules requests taken by lp(1) for printing on line printers. Lpsched(1M) is typically invoked in jete/reo This creates a process which runs in the background untillpshut is executed.
The activity of the process is recorded in /usr/spool/lp/log. If the -v option is invoked, a ver-bose record of the lpsched process is captured.
Lpshut shuts down the line printer scheduler. All printers that are printing at the time lpshut is invoked will stop printing. Requests that were printing at the time a printer was shut down will be reprinted in their entirety after lpsched is started again. All LP commands perform their func-tions even when lpsched is not running.
Lpmove moves requests that were queued by lp(1) between LP destinations. This command may be used only when lpsched is not running.
The first form of the command moves the named requests to the LP destination, dest. Requests are request ids as returned by lp (1). The second form moves all requests for destination dest1 to destination dest2. As a side effect, lp (1) will reject requests for dest1.
Note that lpmove never checks the acceptance status (see accept(1M)) for the new destination when moving requests.
/usr/spool/lp/*
SEE ALSO
accept(1M), enable(1), Ip(1), Ipadmin(1M), Ipstat(1).
INTERNATIONAL SUPPORT messages.
Hewlett-Packard Company - 1 - Version B.l, October 1986
MKDEV(lM) HP-UX Series 200, 300, 500 Only
MKDEV(lM)
NAME
mkdev - make device files SYNOPSIS
/etc/mkdev REMARKS
This command is implemented as a shell script, and will differ between the different implementa-tions of HP-UX. This description applies to all versions, and further details will be found in the commentary in the script.
DESCRIPTION
This shell script helps the superuser install and maintain an HP-UX system. It consists of a machine-dependent list of commands which create one of each possible type of device file, with suggested default device addresses. It also creates mount directories for mountable volumes and changes permissions as appropriate for the device files.
This command makes it easier to build (or rebuild) special files all at once.
Mkdev automatically changes the working directory (using cd) to /dev before starting execution.
Mkdev is specifically intended for modification before (each) use. Command lines for non-desired devices should be commented out with "#" so that they are still available for later use. You may want to use shorter device names than those suggested, especially for default devices. For HP-UX naming conventions, see intro(7).
SEE ALSO
chmod{l), mkdir{l), mknod{lM), intro(7).
DIAGNOSTICS
Each command line in mkdev is echoed as it is executed. Error messages, if any, are generated by the commands invoked.
Since the super-user must modify this script before using it the first time, an error is given if it has not been modified.
AUTHOR
Mkdev was developed by the Hewlett-Packard Company.
Hewlett-Packard Company - 1 - Version B.l, October 1986
MKFS[HFS] (1M) HP-UX
The optional arguments allow fine tune control over the parameters of the file system.
N sect specifies the number of sectors per track on the disk.
Ntraek specifies the number of tracks per cylinder on the disk.
Blksize gives the primary block size for files on the file system. It must be a power of two, currently selected from 4096 or 8192.
Fragsize gives the fragment size for files on the file system. The fragsize represents the smallest amount of disk space that will be allocated to a file. It must be a power of two currently selected from the range DEV -BSIZE to MAXBSIZE.
Nepg specifies the number of disk cylinders per cylinder group. This number must be in the range 1 to 32.
Minfree specifies the minimum percentage of free disk space allowed. Once the file system capa-city reaches this threshold, only the super-user is allowed to allocate disk blocks. The default
(The characters -bed specify regular, block special, character special and directory files respec-tively.) The second character of the type is either u or - to specify set-user-id mode or not. The third is g or - for the set-group-id mode. The rest of the mode is a three digit octal number giv-ing the owner, group, and other read, write, execute permissions, see chmod(I}.
Two decimal number tokens come after the mode; they specify the user and group ID's of the owner of the file.
If the file is a regular file, the next token is a pathname whence the contents and size are copied.
If the file is a block or character special file, two decimal number tokens follow which give the major and minor device numbers.
Hewlett-Packard Company - 1 - Version B.l, October 1986