diff options
Diffstat (limited to 'usr/src/man/man1b')
37 files changed, 7297 insertions, 0 deletions
diff --git a/usr/src/man/man1b/Makefile b/usr/src/man/man1b/Makefile new file mode 100644 index 0000000000..dc8013a719 --- /dev/null +++ b/usr/src/man/man1b/Makefile @@ -0,0 +1,73 @@ +# +# This file and its contents are supplied under the terms of the +# Common Development and Distribution License ("CDDL"), version 1.0. +# You may only use this file in accordance with the terms of version +# 1.0 of the CDDL. +# +# A full copy of the text of the CDDL should have accompanied this +# source. A copy of the CDDL is also available via the Internet +# at http://www.illumos.org/license/CDDL. +# + +# Copyright 2011, Richard Lowe + +include ../../Makefile.master + +MANSECT= 1b + +MANFILES= basename.1b \ + biff.1b \ + chown.1b \ + df.1b \ + du.1b \ + echo.1b \ + exportfs.1b \ + expr.1b \ + fastboot.1b \ + file.1b \ + from.1b \ + groups.1b \ + grpck.1b \ + ln.1b \ + logger.1b \ + lpc.1b \ + lpq.1b \ + lpr.1b \ + lprm.1b \ + lptest.1b \ + mail.1b \ + mkstr.1b \ + plot.1b \ + printenv.1b \ + ps.1b \ + rusage.1b \ + shutdown.1b \ + stty.1b \ + sum.1b \ + test.1b \ + touch.1b \ + tset.1b \ + users.1b \ + vipw.1b \ + whereis.1b \ + whoami.1b + +MANSOFILES = Mail.1b \ + fasthalt.1b \ + reset.1b + +MANFILES += $(MANSOFILES) + +Mail.1b := SOSRC = man1b/mail.1b + +fasthalt.1b := SOSRC = man1b/fastboot.1b + +reset.1b := SOSRC = man1b/tset.1b + +.KEEP_STATE: + +include ../Makefile.man + +install: $(ROOTMANFILES) + + diff --git a/usr/src/man/man1b/basename.1b b/usr/src/man/man1b/basename.1b new file mode 100644 index 0000000000..ab8f7dcc36 --- /dev/null +++ b/usr/src/man/man1b/basename.1b @@ -0,0 +1,44 @@ +'\" te +.\" Copyright (c) 1995, Sun Microsystems, Inc. All Rights Reserved +.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. +.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. +.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] +.TH basename 1B "28 Mar 1995" "SunOS 5.11" "SunOS/BSD Compatibility Package Commands" +.SH NAME +basename \- display portions of pathnames +.SH SYNOPSIS +.LP +.nf +\fB/usr/ucb/basename\fR \fIstring\fR [\fIsuffix\fR] +.fi + +.SH DESCRIPTION +.sp +.LP +The \fBbasename\fR utility deletes any prefix ending in `\fB/\fR' and the +\fIsuffix\fR, if present in \fIstring\fR. It directs the result to the standard +output, and is normally used inside substitution marks (\fB` `\fR) within shell +procedures. The \fIsuffix\fR is a string with no special significance attached +to any of the characters it contains. +.SH EXAMPLES +.LP +\fBExample 1 \fRUsing the \fBbasename\fR command. +.sp +.LP +This shell procedure invoked with the argument \fB/usr/src/bin/cat.c\fR +compiles the named file and moves the output to \fBcat\fR in the current +directory: + +.sp +.in +2 +.nf +example% \fBcc $1\fR +example% \fBmv a.out `basename $1 .c`\fR +.fi +.in -2 +.sp + +.SH SEE ALSO +.sp +.LP +\fBsh\fR(1), \fBattributes\fR(5) diff --git a/usr/src/man/man1b/biff.1b b/usr/src/man/man1b/biff.1b new file mode 100644 index 0000000000..cb76b21500 --- /dev/null +++ b/usr/src/man/man1b/biff.1b @@ -0,0 +1,80 @@ +'\" te +.\" Copyright (c) 1988, Sun Microsystems, Inc. All Rights Reserved +.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. +.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. +.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] +.TH biff 1B "14 Sep 1992" "SunOS 5.11" "SunOS/BSD Compatibility Package Commands" +.SH NAME +biff \- give notice of incoming mail messages +.SH SYNOPSIS +.LP +.nf +\fB/usr/ucb/biff\fR [y | n] +.fi + +.SH DESCRIPTION +.sp +.LP +\fBbiff\fR turns mail notification on or off for the terminal session. With no +arguments, \fBbiff\fR displays the current notification status for the +terminal. +.sp +.LP +If notification is allowed, the terminal rings the bell and displays the header +and the first few lines of each arriving mail message. \fBbiff\fR operates +asynchronously. For synchronized notices, use the \fBMAIL\fR variable of +\fBsh\fR(1) or the \fBmail\fR variable of \fBcsh\fR(1). +.sp +.LP +A `\fBbiff y\fR' command can be included in your \fB~/.login\fR or +\fB~/.profile\fR file for execution when you log in. +.SH OPTIONS +.sp +.ne 2 +.mk +.na +\fB\fBy\fR\fR +.ad +.RS 5n +.rt +Allow mail notification for the terminal. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBn\fR\fR +.ad +.RS 5n +.rt +Disable notification for the terminal. +.RE + +.SH FILES +.sp +.ne 2 +.mk +.na +\fB\fB~/.login\fR\fR +.ad +.RS 14n +.rt +User's login file +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB~/.profile\fR\fR +.ad +.RS 14n +.rt +User's profile file +.RE + +.SH SEE ALSO +.sp +.LP +\fBcsh\fR(1), \fBmail\fR(1), \fBsh\fR(1), \fBattributes\fR(5) diff --git a/usr/src/man/man1b/chown.1b b/usr/src/man/man1b/chown.1b new file mode 100644 index 0000000000..43f8011b7c --- /dev/null +++ b/usr/src/man/man1b/chown.1b @@ -0,0 +1,76 @@ +'\" te +.\" Copyright (c) 1980 Regents of the University of California. All rights reserved. The Berkeley software License Agreement specifies the terms and conditions for redistribution. Copyright (c) 2004, Sun Microsystems, Inc. All Rights Reserved +.TH chown 1B "21 Jun 2004" "SunOS 5.11" "SunOS/BSD Compatibility Package Commands" +.SH NAME +chown \- change owner +.SH SYNOPSIS +.LP +.nf +\fB/usr/ucb/chown\fR [\fB-fR\fR] \fIowner\fR[.group] \fIfilename\fR... +.fi + +.SH DESCRIPTION +.sp +.LP +\fBchown\fR changes the owner of the \fIfilename\fRs to \fIowner\fR. The owner +can be either a decimal user \fBID\fR (\fBUID\fR) or a login name found in the +password file. An optional \fIgroup\fR can also be specified. The group can be +either a decimal group \fBID\fR (\fBGID\fR) or a group name found in the +\fBGID\fR file. +.sp +.LP +In the default case, only the super-user of the machine where the file is +physically located can change the owner. The system configuration option +\fB{_POSIX_CHOWN_RESTRICTED}\fR and the privileges \fBPRIV_FILE_CHOWN\fR and +\fBPRIV_FILE_CHOWN_SELF\fR also affect who can change the ownership of a file. +See \fBchown\fR(2) and \fBprivileges\fR(5). +.SH OPTIONS +.sp +.LP +The following options are supported: +.sp +.ne 2 +.mk +.na +\fB\fB-f\fR\fR +.ad +.RS 6n +.rt +Do not report errors. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-R\fR\fR +.ad +.RS 6n +.rt +Recursively descend into directories setting the ownership of all files in each +directory encountered. When symbolic links are encountered, their ownership is +changed, but they are not traversed. +.RE + +.SH USAGE +.sp +.LP +See \fBlargefile\fR(5) for the description of the behavior of \fBchown\fR when +encountering files greater than or equal to 2 Gbyte ( 2^31 bytes). +.SH FILES +.sp +.ne 2 +.mk +.na +\fB\fB/etc/passwd\fR\fR +.ad +.RS 15n +.rt +Password file +.RE + +.SH SEE ALSO +.sp +.LP +\fBchgrp\fR(1), \fBchown\fR(2), \fBgroup\fR(4), \fBpasswd\fR(4), +\fBattributes\fR(5), \fBlargefile\fR(5), \fBprivileges\fR(5) diff --git a/usr/src/man/man1b/df.1b b/usr/src/man/man1b/df.1b new file mode 100644 index 0000000000..c0e8d7a665 --- /dev/null +++ b/usr/src/man/man1b/df.1b @@ -0,0 +1,122 @@ +'\" te +.\" Copyright (c) 1988 Sun Microsystems, Inc. - All Rights Reserved +.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. +.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. +.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] +.TH df 1B "14 Sep 1992" "SunOS 5.11" "SunOS/BSD Compatibility Package Commands" +.SH NAME +df \- display status of disk space on file systems +.SH SYNOPSIS +.LP +.nf +\fB/usr/ucb/df\fR [\fB-a\fR] [\fB-i\fR] [\fB-t\fR \fItype\fR] [\fIfilesystem...\fR] + [\fIfilename...\fR] +.fi + +.SH DESCRIPTION +.sp +.LP +The \fBdf\fR utility displays the amount of disk space occupied by currently +mounted file systems, the amount of used and available space, and how much of +the file system's total capacity has been used. +.sp +.LP +If arguments to \fBdf\fR are path names, \fBdf\fR produces a report on the file +system containing the named file. Thus `\fBdf .\fR' shows the amount of space +on the file system containing the current directory. +.SH OPTIONS +.sp +.LP +The following options are supported: +.sp +.ne 2 +.mk +.na +\fB\fB-a\fR\fR +.ad +.RS 11n +.rt +Report on all filesystems including the uninteresting ones which have zero +total blocks (that is, auto-mounter). +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-i\fR\fR +.ad +.RS 11n +.rt +Report the number of used and free inodes. Print ` \fB*\fR ' if no information +is available. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB\fR\fB-t\fR\fB \fR\fItype\fR\fR +.ad +.RS 11n +.rt +Report on filesystems of a given type (for example, nfs or ufs). +.RE + +.SH EXAMPLES +.LP +\fBExample 1 \fRUsing \fBdf\fR +.sp +.LP +A sample of output for \fBdf\fR looks like: + +.sp +.in +2 +.nf +example% \fBdf\fR +Filesystem kbytes used avail capacity Mounted on +sparky:/ 7445 4714 1986 70% / +sparky:/usr 42277 35291 2758 93% /usr +.fi +.in -2 +.sp + +.sp +.LP +Note that \fBused\fR+\fBavail\fR is less than the amount of space in the file +system (kbytes); this is because the system reserves a fraction of the space in +the file system to allow its file system allocation routines to work well. The +amount reserved is typically about 10%; this can be adjusted using \fBtunefs\fR +(see \fBtunefs\fR(1M)). When all the space on a file system except for this +reserve is in use, only the super-user can allocate new files and data blocks +to existing files. When a file system is overallocated in this way, \fBdf\fR +can report that the file system is more than 100% utilized. + +.SH FILES +.sp +.ne 2 +.mk +.na +\fB\fB/etc/mnttab\fR\fR +.ad +.RS 15n +.rt +List of file systems currently mounted +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB/etc/vfstab\fR\fR +.ad +.RS 15n +.rt +List of default parameters for each file system +.RE + +.SH SEE ALSO +.sp +.LP +\fBdu\fR(1), \fBquot\fR(1M), \fBtunefs\fR(1M), \fBmnttab\fR(4), +\fBattributes\fR(5) diff --git a/usr/src/man/man1b/du.1b b/usr/src/man/man1b/du.1b new file mode 100644 index 0000000000..e858dcfd27 --- /dev/null +++ b/usr/src/man/man1b/du.1b @@ -0,0 +1,201 @@ +'\" te +.\" Copyright (c) 2001 Sun Microsystems, Inc. - All Rights Reserved. +.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. +.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. +.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] +.TH du 1B "5 Jun 2001" "SunOS 5.11" "SunOS/BSD Compatibility Package Commands" +.SH NAME +du \- display the number of disk blocks used per directory or file +.SH SYNOPSIS +.LP +.nf +\fB/usr/ucb/du\fR [\fB-adkLr\fR] [\fB-o\fR | \fB-s\fR] [\fIfilename\fR] +.fi + +.SH DESCRIPTION +.sp +.LP +The \fBdu\fR utility gives the number of kilobytes contained in all files and, +recursively, directories within each specified directory or file +\fIfilename\fR. If \fIfilename\fR is missing, `\fB\&.\fR' (the current +directory) is used. +.sp +.LP +A file that has multiple links to it is only counted once. +.SH OPTIONS +.sp +.LP +The following options are supported: +.sp +.ne 2 +.mk +.na +\fB\fB-a\fR\fR +.ad +.RS 6n +.rt +Generates an entry for each file. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-d\fR\fR +.ad +.RS 6n +.rt +Does not cross file system boundaries. For example, \fBdu\fR \fB-d\fR \fB/\fR +reports usage only on the root partition. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-k\fR\fR +.ad +.RS 6n +.rt +Writes the files sizes in units of 1024 bytes, rather than the default +512-byte units. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-L\fR\fR +.ad +.RS 6n +.rt +Processes symbolic links by using the file or directory that the symbolic link +references, rather than the link itself. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-o\fR\fR +.ad +.RS 6n +.rt +Does not add child directories' usage to a parent's total. Without this option, +the usage listed for a particular directory is the space taken by the files in +that directory, as well as the files in all directories beneath it. This option +does nothing if the \fB-s\fR option is used. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-r\fR\fR +.ad +.RS 6n +.rt +Generates messages about directories that cannot be read, files that cannot be +opened, and so forth, rather than being silent (the default). +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-s\fR\fR +.ad +.RS 6n +.rt +Only displays the grand total for each of the specified \fIfilename\fRs. +.RE + +.sp +.LP +Entries are generated only for each directory in the absence of options. +.SH EXAMPLES +.LP +\fBExample 1 \fRShowing usage of all subdirectories in a directory +.sp +.LP +This example uses \fBdu\fR in a directory. The \fBpwd\fR(1) command was used to +identify the directory, then \fBdu\fR was used to show the usage of all the +subdirectories in that directory. The grand total for the directory is the last +entry in the display: + +.sp +.in +2 +.nf +example% \fBpwd\fR +/usr/ralph/misc +example% \fBdu\fR +5 ./jokes +33 ./squash +44 ./tech.papers/lpr.document +217 ./tech.papers/new.manager +401 ./tech.papers +144 ./memos +80 ./letters +388 ./window +93 ./messages +15 ./useful.news +1211 . +.fi +.in -2 +.sp + +.SH ENVIRONMENT VARIABLES +.sp +.LP +If any of the \fBLC_*\fR variables, that is, \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, +\fBLC_TIME\fR, \fBLC_COLLATE\fR, \fBLC_NUMERIC\fR, and \fBLC_MONETARY\fR (see +\fBenviron\fR(5)), are not set in the environment, the operational behavior of +\fBdu\fR for each corresponding locale category is determined by the value of +the \fBLANG\fR environment variable. If \fBLC_ALL\fR is set, its contents are +used to override both the \fBLANG\fR and the other \fBLC_*\fR variables. If +none of the above variables is set in the environment, the "C" (U.S. style) +locale determines how \fBdu\fR behaves. +.sp +.ne 2 +.mk +.na +\fB\fBLC_CTYPE\fR\fR +.ad +.RS 15n +.rt +Determines how \fBdu\fR handles characters. When \fBLC_CTYPE\fR is set to a +valid value, \fBdu\fR can display and handle text and filenames containing +valid characters for that locale. \fBdu\fR can display and handle Extended Unix +Code (EUC) characters where any individual character can be 1, 2, or 3 bytes +wide. \fBdu\fR can also handle EUC characters of 1, 2, or more column widths. +In the "C" locale, only characters from ISO 8859-1 are valid. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBLC_MESSAGES\fR\fR +.ad +.RS 15n +.rt +Determines how diagnostic and informative messages are presented. This includes +the language and style of the messages, and the correct form of affirmative and +negative responses. In the "C" locale, the messages are presented in the +default form found in the program itself (in most cases, U.S. English). +.RE + +.SH SEE ALSO +.sp +.LP +\fBpwd\fR(1), \fBdf\fR(1M), \fBdu\fR(1), \fBquot\fR(1M), \fBattributes\fR(5), +\fBenviron\fR(5) +.SH NOTES +.sp +.LP +Filename arguments that are not directory names are ignored, unless you use +\fB-a\fR. +.sp +.LP +If there are too many distinct linked files, \fBdu\fR will count the excess +files more than once. diff --git a/usr/src/man/man1b/echo.1b b/usr/src/man/man1b/echo.1b new file mode 100644 index 0000000000..a388d850af --- /dev/null +++ b/usr/src/man/man1b/echo.1b @@ -0,0 +1,92 @@ +'\" te +.\" Copyright (c) 1988 Sun Microsystems, Inc - All Rights Reserved. +.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. +.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. +.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] +.TH echo 1B "3 Aug 1994" "SunOS 5.11" "SunOS/BSD Compatibility Package Commands" +.SH NAME +echo \- echo arguments to standard output +.SH SYNOPSIS +.LP +.nf +\fB/usr/ucb/echo\fR [\fB-n\fR] [\fIargument\fR] +.fi + +.SH DESCRIPTION +.sp +.LP +\fBecho\fR writes its arguments, separated by \fIBLANK\fRs and terminated by a +\fINEWLINE\fR, to the standard output. +.sp +.LP +\fBecho\fR is useful for producing diagnostics in command files and for sending +known data into a pipe, and for displaying the contents of environment +variables. +.sp +.LP +For example, you can use \fBecho\fR to determine how many subdirectories below +the root directory (\fB/\fR) is your current directory, as follows: +.RS +4 +.TP +.ie t \(bu +.el o +echo your current-working-directory's full pathname +.RE +.RS +4 +.TP +.ie t \(bu +.el o +pipe the output through \fBtr\fR to translate the path's embedded +slash-characters into space-characters +.RE +.RS +4 +.TP +.ie t \(bu +.el o +pipe that output through \fBwc\fR \fB-w\fR for a count of the names in your +path. +.sp +.in +2 +.nf +example% \fB/usr/bin/echo "echo $PWD | tr '/' ' ' | wc -w"\fR +.fi +.in -2 +.sp + +.RE +.sp +.LP +See \fBtr\fR(1) and \fBwc\fR(1) for their functionality. +.sp +.LP +The shells \fBcsh\fR(1), \fBksh\fR(1), and \fBsh\fR(1), each have an \fBecho\fR +built-in command, which, by default, will have precedence, and will be invoked +if the user calls \fBecho\fR without a full pathname. \fB/usr/ucb/echo\fR and +\fBcsh\fR's \fBecho()\fR have an \fB-n\fR option, but do not understand +back-slashed escape characters. \fBsh\fR's \fBecho()\fR, \fBksh\fR's +\fBecho()\fR, and \fB/usr/bin/echo\fR, on the other hand, understand the +black-slashed escape characters, and \fBksh\fR's \fBecho()\fR also understands +\fB\ea\fR as the audible bell character; however, these commands do not have an +\fB-n\fR option. +.SH OPTIONS +.sp +.ne 2 +.mk +.na +\fB\fB-n\fR\fR +.ad +.RS 6n +.rt +Do not add the \fINEWLINE\fR to the output. +.RE + +.SH SEE ALSO +.sp +.LP +\fBcsh\fR(1), \fBecho\fR(1), \fBksh\fR(1), \fBsh\fR(1), \fBtr\fR(1), +\fBwc\fR(1), \fBattributes\fR(5) +.SH NOTES +.sp +.LP +The \fB-n\fR option is a transition aid for \fBBSD\fR applications, and may not +be supported in future releases. diff --git a/usr/src/man/man1b/exportfs.1b b/usr/src/man/man1b/exportfs.1b new file mode 100644 index 0000000000..96ae4f4ce5 --- /dev/null +++ b/usr/src/man/man1b/exportfs.1b @@ -0,0 +1,93 @@ +'\" te +.\" Copyright (c) 1994, Sun Microsystems, Inc. +.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. +.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. +.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] +.TH exportfs 1B "6 Nov 2000" "SunOS 5.11" "SunOS/BSD Compatibility Package Commands" +.SH NAME +exportfs \- translates exportfs options to share/unshare commands +.SH SYNOPSIS +.LP +.nf +\fB/usr/sbin/exportfs\fR [\fB-aiuv\fR] [\fB-o\fR \fIoptions\fR] [\fIpathname\fR] +.fi + +.SH DESCRIPTION +.sp +.LP +\fBexportfs\fR translates SunOS 4.x \fBexportfs\fR options to the corresponding +\fBshare\fR/\fBunshare\fR options and invokes \fBshare\fR/\fBunshare\fR with +the translated options. +.sp +.LP +With no options or arguments, \fBexportfs\fR invokes \fBshare\fR to print out +the list of all currently shared \fBNFS\fR filesystems. +.sp +.LP +\fBexportfs\fR is the BSD/Compatibility Package command of \fBshare\fR(1M) and +\fBunshare\fR(1M). Use \fBshare\fR(1M)/ \fBunshare\fR(1M) whenever possible. +.SH OPTIONS +.sp +.ne 2 +.mk +.na +\fB\fB-a\fR\fR +.ad +.RS 14n +.rt +Invokes \fBshareall\fR(1M), or if \fB-u\fR is specified, invokes +\fBunshareall\fR(1M). +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-i\fR\fR +.ad +.RS 14n +.rt +Ignore options in \fB/etc/dfs/dfstab\fR. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-u\fR\fR +.ad +.RS 14n +.rt +Invokes \fBunshare\fR(1M) on \fIpathname\fR. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-v\fR\fR +.ad +.RS 14n +.rt +Verbose. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-o\fR\fI options\fR\fR +.ad +.RS 14n +.rt +Specify a comma-separated list of optional characteristics for the filesystems +being exported. \fBexportfs\fR translates \fIoptions\fR to +\fBshare\fR-equivalent options. (see \fBshare\fR(1M) for information about +individual options). +.RE + +.SH SEE ALSO +.sp +.LP +\fBshare\fR(1M), \fBshareall\fR(1M), \fBunshare\fR(1M), \fBunshareall\fR(1M), +\fBattributes\fR(5) diff --git a/usr/src/man/man1b/expr.1b b/usr/src/man/man1b/expr.1b new file mode 100644 index 0000000000..910f2b253b --- /dev/null +++ b/usr/src/man/man1b/expr.1b @@ -0,0 +1,356 @@ +'\" te +.\" Copyright (c) 2000, Sun Microsystems, Inc. All Rights Reserved +.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. +.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. +.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] +.TH expr 1B "6 Jun 2000" "SunOS 5.11" "SunOS/BSD Compatibility Package Commands" +.SH NAME +expr \- evaluate arguments as a logical, arithmetic, or string expression +.SH SYNOPSIS +.LP +.nf +\fB/usr/ucb/expr\fR \fIargument\fR... +.fi + +.SH DESCRIPTION +.sp +.LP +The \fBexpr\fR utility evaluates expressions as specified by its arguments. +After evaluation, the result is written on the standard output. Each token of +the expression is a separate argument, so terms of the expression must be +separated by blanks. Characters special to the shell must be escaped. Note: +\fB0\fR is returned to indicate a zero value, rather than the null string. +Strings containing blanks or other special characters should be quoted. +Integer-valued arguments may be preceded by a unary minus sign. Internally, +integers are treated as 32-bit, two's-complement numbers. +.sp +.LP +The operators and keywords are listed below. Characters that need to be escaped +are preceded by `\fB\e\fR\&'. The list is in order of increasing precedence, +with equal precedence operators grouped within \fB{\|}\fR symbols. +.sp +.ne 2 +.mk +.na +\fB\fIexpr\fR\fB \e| \fR\fIexpr\fR\fR +.ad +.sp .6 +.RS 4n +Returns the evaluation of the first \fIexpr\fR if it is neither \fINULL\fR nor +\fB0\fR; otherwise, returns the evaluation of the second \fIexpr\fR if it is +not \fINULL\fR; otherwise, \fB0\fR. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fIexpr\fR\fB \e& \fR\fIexpr\fR\fR +.ad +.sp .6 +.RS 4n +Returns the first \fIexpr\fR if neither \fIexpr\fR is \fINULL\fR or \fB0\fR, +otherwise returns \fB0\fR. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fIexpr\fR { \fB=,\fR \e\fB,\fR \e , \fB\e<\fR,\fB \e<=\fR,\fB != \fR} +\fIexpr\fR\fR +.ad +.sp .6 +.RS 4n +Returns the result of an integer comparison if both arguments are integers, +otherwise returns the result of a lexical comparison. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fIexpr\fR { \fB+\fR,\fB \(mi \fR} \fIexpr\fR\fR +.ad +.sp .6 +.RS 4n +Addition or subtraction of integer-valued arguments. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fIexpr\fR { \fB\e\fR,\fB /\fR,\fB % \fR} \fBexpr\fR\fR +.ad +.sp .6 +.RS 4n +Multiplication, division, or remainder of the integer-valued arguments. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fIstring\fR\fB : \fR\fIregular-expression\fR\fR +.ad +.br +.na +\fB\fBmatch\fR\fI string regular-expression\fR\fR +.ad +.sp .6 +.RS 4n +The two forms of the matching operator above are synonymous. The matching +operators \fB:\fR and \fBmatch\fR compare the first argument with the second +argument which must be a regular expression. Regular expression syntax is the +same as that of \fBregexp\fR(5), except that all patterns are "anchored" +(treated as if they begin with \fB^\fR) and therefore \fB^\fR is not a special +character, in that context. Normally, the matching operator returns the number +of characters matched (\fB0\fR on failure). Alternatively, the +\fB\e\|.\|.\|.\|\e\fR pattern symbols can be used to return a portion of the +first argument. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBsubstr\fR \fIstring integer-1 integer-2\fR\fR +.ad +.sp .6 +.RS 4n +Extracts the substring of \fIstring\fR starting at position \fIinteger-1\fR +and of length \fIinteger-2\fR characters. If \fIinteger-1\fR has a value +greater than the length of \fIstring\fR, \fBexpr\fR returns a null string. If +you try to extract more characters than there are in \fIstring\fR, \fBexpr\fR +returns all the remaining characters from \fIstring\fR. Beware of using +negative values for either \fIinteger-1\fR or \fIinteger-2\fR as \fBexpr\fR +tends to run forever in these cases. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBindex\fR \fIstring character-list\fR\fR +.ad +.sp .6 +.RS 4n +Reports the first position in \fIstring\fR at which any one of the characters +in \fIcharacter-list\fR matches a character in \fIstring\fR. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBlength\fR \fIstring\fR\fR +.ad +.sp .6 +.RS 4n +Returns the length (that is, the number of characters) of \fIstring\fR. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB( expr )\fR\fR +.ad +.sp .6 +.RS 4n +Parentheses may be used for grouping. +.RE + +.SH EXAMPLES +.LP +\fBExample 1 \fRAdding an integer to a shell variable +.sp +.LP +Add 1 to the shell variable \fBa\fR. + +.sp +.in +2 +.nf +\fBa='expr $a + 1'\fR +.fi +.in -2 +.sp + +.LP +\fBExample 2 \fRReturning a path name segment +.sp +.LP +Return the last segment of a path name (that is, the filename part). Watch out +for \fB/\fR alone as an argument: \fBexpr\fR will take it as the division +operator (see \fBBUGS\fR below). + +.sp +.in +2 +.nf +\fB# 'For $a equal to either "/usr/abc/file" or just "file"' +expr $a : '.*/\e \e $a\fR +.fi +.in -2 +.sp + +.LP +\fBExample 3 \fRUsing // characters to simplify the expression +.sp +.LP +The addition of the \fB//\fR characters eliminates any ambiguity about the +division operator and simplifies the whole expression. + +.sp +.in +2 +.nf +\fB# A better representation of example 2. +expr //$a : '.*/\e\fR +.fi +.in -2 +.sp + +.LP +\fBExample 4 \fRReturning the value of a variable +.sp +.LP +Returns the number of characters in \fB$VAR\fR. + +.sp +.in +2 +.nf +\fBexpr $VAR : '.*'\fR +.fi +.in -2 +.sp + +.SH EXIT STATUS +.sp +.LP +\fBexpr\fR returns the following exit codes: +.sp +.ne 2 +.mk +.na +\fB\fB0\fR\fR +.ad +.RS 5n +.rt +If the expression is neither \fINULL\fR nor \fB0\fR. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB1\fR\fR +.ad +.RS 5n +.rt +If the expression \fIis\fR \fINULL\fR or \fB0\fR. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB2\fR\fR +.ad +.RS 5n +.rt +For invalid expressions. +.RE + +.SH SEE ALSO +.sp +.LP +\fBsh\fR(1), \fBtest\fR(1), \fBattributes\fR(5), \fBregexp\fR(5) +.SH DIAGNOSTICS +.sp +.ne 2 +.mk +.na +\fB\fBsyntax\fR \fBerror\fR\fR +.ad +.RS 24n +.rt +for operator/operand errors +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBnon-numeric argument\fR\fR +.ad +.RS 24n +.rt +if arithmetic is attempted on such a string +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBdivision by zero\fR\fR +.ad +.RS 24n +.rt +if an attempt to divide by zero is made +.RE + +.SH BUGS +.sp +.LP +After argument processing by the shell, \fBexpr\fR cannot tell the difference +between an operator and an operand except by the value. If \fB$a\fR is an +\fB=\fR, the command: +.sp +.in +2 +.nf +\fBexpr $a = '='\fR +.fi +.in -2 +.sp + +.sp +.LP +looks like: +.sp +.in +2 +.nf +\fBexpr = = =\fR +.fi +.in -2 +.sp + +.sp +.LP +as the arguments are passed to \fBexpr\fR (and they will all be taken as the +\fB=\fR operator). The following works: +.sp +.in +2 +.nf +\fBexpr X$a = X=\fR +.fi +.in -2 +.sp + +.sp +.LP +Note: the \fBmatch\fR, \fBsubstr\fR, \fBlength\fR, and \fBindex\fR operators +cannot themselves be used as ordinary strings. That is, the expression: +.sp +.in +2 +.nf +example% \fBexpr index expurgatorious length\fR +syntax error +example% +.fi +.in -2 +.sp + +.sp +.LP +generates the `\fBsyntax error\fR' message as shown instead of the value +\fB1\fR as you might expect. diff --git a/usr/src/man/man1b/fastboot.1b b/usr/src/man/man1b/fastboot.1b new file mode 100644 index 0000000000..248da3eec7 --- /dev/null +++ b/usr/src/man/man1b/fastboot.1b @@ -0,0 +1,32 @@ +'\" te +.\" Copyright (c) 1988 Sun Microsystems, Inc. - All Rights Reserved. +.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. +.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. +.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] +.TH fastboot 1B "28 Feb 1994" "SunOS 5.11" "SunOS/BSD Compatibility Package Commands" +.SH NAME +fastboot, fasthalt \- reboot/halt the system without checking the disks +.SH SYNOPSIS +.LP +.nf +\fB/usr/ucb/fastboot\fR [\fIboot-options\fR] +.fi + +.LP +.nf +\fB/usr/ucb/fasthalt\fR [\fIhalt-options\fR] +.fi + +.SH DESCRIPTION +.sp +.LP +\fBfastboot\fR and \fBfasthalt\fR are shell scripts that invoke \fBreboot\fR +and \fBhalt\fR with the proper arguments. +.sp +.LP +These commands are provided for compatibility only. +.SH SEE ALSO +.sp +.LP +\fBfsck\fR(1M), \fBhalt\fR(1M), \fBinit\fR(1M), \fBreboot\fR(1M), +\fBinit.d\fR(4), \fBattributes\fR(5) diff --git a/usr/src/man/man1b/file.1b b/usr/src/man/man1b/file.1b new file mode 100644 index 0000000000..d1cfde78e2 --- /dev/null +++ b/usr/src/man/man1b/file.1b @@ -0,0 +1,142 @@ +'\" te +.\" Copyright (c) 1992, Sun Microsystems, Inc. +.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. +.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. +.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] +.TH file 1B "14 Sep 1992" "SunOS 5.11" "SunOS/BSD Compatibility Package Commands" +.SH NAME +file \- determine the type of a file by examining its contents +.SH SYNOPSIS +.LP +.nf +\fB/usr/ucb/file\fR [\fB-f\fR \fIffile\fR] [\fB-cL\fR] [\fB-m\fR \fImfile\fR] \fIfilename\fR... +.fi + +.SH DESCRIPTION +.sp +.LP +\fBfile\fR performs a series of tests on each \fIfilename\fR in an attempt to +determine what it contains. If the contents of a file appear to be \fBASCII\fR +text, \fBfile\fR examines the first 512 bytes and tries to guess its language. +.sp +.LP +\fBfile\fR uses the file \fB/etc/magic\fR to identify files that have some sort +of \fImagic number\fR, that is, any file containing a numeric or string +constant that indicates its type. +.SH OPTIONS +.sp +.ne 2 +.mk +.na +\fB\fB-c\fR\fR +.ad +.RS 12n +.rt +Check for format errors in the magic number file. For reasons of efficiency, +this validation is not normally carried out. No file type-checking is done +under \fB-c\fR. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-f\fR \fIffile\fR\fR +.ad +.RS 12n +.rt +Get a list of filenames to identify from \fIffile.\fR +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-L\fR\fR +.ad +.RS 12n +.rt +If a file is a symbolic link, test the file the link references rather than the +link itself. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-m\fR\fI mfile\fR\fR +.ad +.RS 12n +.rt +Use \fImfile\fR as the name of an alternate magic number file. +.RE + +.SH EXAMPLES +.LP +\fBExample 1 \fRUsing \fBfile\fR on all the files in a specific user's +directory. +.sp +.LP +This example illustrates the use of \fBfile\fR on all the files in a specific +user's directory: + +.sp +.in +2 +.nf +example% \fBpwd +/usr/blort/misc\fR +.fi +.in -2 +.sp + +.sp +.in +2 +.nf +example% \fB/usr/ucb/file *\fR + +code: mc68020 demand paged executable +code.c: c program text +counts: ascii text +doc: roff,nroff, or eqn input text +empty.file: empty +libz: archive random library +memos: directory +project: symboliclink to /usr/project +script: executable shell script +titles: ascii text +s5.stuff: cpio archive + + +example% +.fi +.in -2 +.sp + +.SH ENVIRONMENT VARIABLES +.sp +.LP +The environment variables \fBLC_CTYPE\fR, \fBLANG\fR, and \fBLC_default\fR +control the character classification throughout \fBfile\fR. On entry to +\fBfile\fR, these environment variables are checked in the following order: +\fBLC_CTYPE\fR, \fBLANG\fR, and \fBLC_default\fR. When a valid value is found, +remaining environment variables for character classification are ignored. For +example, a new setting for \fBLANG\fR does not override the current valid +character classification rules of \fBLC_CTYPE\fR. When none of the values is +valid, the shell character classification defaults to the POSIX.1 "C" +locale. +.SH FILES +.sp +.LP +\fB/etc/magic\fR +.SH SEE ALSO +.sp +.LP +\fBmagic\fR(4), \fBattributes\fR(5) +.SH BUGS +.sp +.LP +\fBfile\fR often makes mistakes. In particular, it often suggests that command +files are C programs. +.sp +.LP +\fBfile\fR does not recognize Pascal or LISP. diff --git a/usr/src/man/man1b/from.1b b/usr/src/man/man1b/from.1b new file mode 100644 index 0000000000..522ced507f --- /dev/null +++ b/usr/src/man/man1b/from.1b @@ -0,0 +1,56 @@ +'\" te +.\" Copyright (c) 2004, Sun Microsystems, Inc. All Rights Reserved +.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. +.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. +.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] +.TH from 1B "28 Jan 2004" "SunOS 5.11" "SunOS/BSD Compatibility Package Commands" +.SH NAME +from \- display the sender and date of newly-arrived mail messages +.SH SYNOPSIS +.LP +.nf +\fB/usr/ucb/from\fR [\fB-s\fR \fIsender\fR] [\fIusername\fR] +.fi + +.SH DESCRIPTION +.sp +.LP +The \fBfrom\fR utility prints out the mail header lines in your mailbox file to +show you who your mail is from. If \fIusername\fR is specified, +\fIusername\fR's mailbox is examined instead of your own. +.SH OPTIONS +.sp +.LP +The following option is supported: +.sp +.ne 2 +.mk +.na +\fB\fB-s\fR \fIsender\fR\fR +.ad +.RS 13n +.rt +Only display headers for mail sent by \fIsender\fR. +.RE + +.SH USAGE +.sp +.LP +See \fBlargefile\fR(5) for the description of the behavior of \fBfrom\fR when +encountering files greater than or equal to 2 Gbyte ( 2^31 bytes). +.SH FILES +.sp +.ne 2 +.mk +.na +\fB\fB/var/mail/*\fR\fR +.ad +.RS 15n +.rt + +.RE + +.SH SEE ALSO +.sp +.LP +\fBbiff\fR(1B), \fBmail\fR(1B), \fBattributes\fR(5), \fBlargefile\fR(5) diff --git a/usr/src/man/man1b/groups.1b b/usr/src/man/man1b/groups.1b new file mode 100644 index 0000000000..9d14e804e2 --- /dev/null +++ b/usr/src/man/man1b/groups.1b @@ -0,0 +1,54 @@ +'\" te +.\" Copyright (c) 1988 Sun Microsystems, Inc. - All Rights Reserved. +.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. +.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. +.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] +.TH groups 1B "14 Sep 1992" "SunOS 5.11" "SunOS/BSD Compatibility Package Commands" +.SH NAME +groups \- display a user's group memberships +.SH SYNOPSIS +.LP +.nf +\fB/usr/ucb/groups\fR [\fIuser\fR]... +.fi + +.SH DESCRIPTION +.sp +.LP +With no arguments, \fBgroups\fR displays the groups to which you belong; else +it displays the groups to which the \fBuser\fR belongs. Each user belongs to a +group specified in the password file \fB/etc/passwd\fR and possibly to other +groups as specified in the file \fB/etc/group\fR. If you do not own a file but +belong to the group which it is owned by then you are granted group access to +the file. +.SH FILES +.sp +.ne 2 +.mk +.na +\fB\fB/etc/passwd\fR\fR +.ad +.RS 15n +.rt + +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB/etc/group\fR\fR +.ad +.RS 15n +.rt + +.RE + +.SH SEE ALSO +.sp +.LP +\fBgetgroups\fR(2), \fBattributes\fR(5) +.SH NOTES +.sp +.LP +This command is obsolete. diff --git a/usr/src/man/man1b/grpck.1b b/usr/src/man/man1b/grpck.1b new file mode 100644 index 0000000000..3ad8483bd3 --- /dev/null +++ b/usr/src/man/man1b/grpck.1b @@ -0,0 +1,142 @@ +'\" te +.\" Copyright (c) 2000, Sun Microsystems, Inc. +.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. +.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. +.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] +.TH grpck 1B "10 Jan 2000" "SunOS 5.11" "SunOS/BSD Compatibility Package Commands" +.SH NAME +grpck \- check group database entries +.SH SYNOPSIS +.LP +.nf +\fB/etc/grpck\fR [\fIfilename\fR] +.fi + +.SH DESCRIPTION +.sp +.LP +The \fBgrpck\fR utility checks that a file in \fBgroup\fR(4) does not contain +any errors; it checks the \fB/etc/group\fR file by default. +.SH FILES +.sp +.LP +\fB/etc/group\fR +.SH SEE ALSO +.sp +.LP +\fBgroups\fR(1), \fBgroup\fR(4), \fBpasswd\fR(4), \fBattributes\fR(5) +.SH DIAGNOSTICS +.sp +.ne 2 +.mk +.na +\fB\fBToo many/few fields\fR\fR +.ad +.sp .6 +.RS 4n +An entry in the group file does not have the proper number of fields. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBNo group name\fR\fR +.ad +.sp .6 +.RS 4n +The group name field of an entry is empty. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBBad character(s) in group name\fR\fR +.ad +.sp .6 +.RS 4n +The group name in an entry contains characters other than lower-case letters +and digits. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBInvalid GID\fR\fR +.ad +.sp .6 +.RS 4n +The group ID field in an entry is not numeric or is greater than 65535. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBNull login name\fR\fR +.ad +.sp .6 +.RS 4n +A login name in the list of login names in an entry is null. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBLogname not found in password file\fR\fR +.ad +.sp .6 +.RS 4n +A login name in the list of login names in an entry is not in the password +file. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBLine too long\fR\fR +.ad +.sp .6 +.RS 4n +A line (including the newline character) in the group file exceeds the maximum +length of 512 characters. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBDuplicate logname entry\fR\fR +.ad +.sp .6 +.RS 4n +A login name appears more than once in the list of login names for a group file +entry. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBOut of memory\fR\fR +.ad +.sp .6 +.RS 4n +The program cannot allocate memory in order to continue. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBMaximum groups exceeded for logname\fR\fR +.ad +.sp .6 +.RS 4n +A login name's group membership exceeds the maximum, \fBNGROUPS_MAX\fR. +.RE + diff --git a/usr/src/man/man1b/ln.1b b/usr/src/man/man1b/ln.1b new file mode 100644 index 0000000000..24bdb7914f --- /dev/null +++ b/usr/src/man/man1b/ln.1b @@ -0,0 +1,201 @@ +'\" te +.\" Copyright (c) 1996, Sun Microsystems, Inc. All Rights Reserved +.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. +.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. +.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] +.TH ln 1B "11 Mar 1994" "SunOS 5.11" "SunOS/BSD Compatibility Package Commands" +.SH NAME +ln \- make hard or symbolic links to files +.SH SYNOPSIS +.LP +.nf +\fB/usr/ucb/ln\fR [\fB-fs\fR] \fIfilename\fR [\fIlinkname\fR] +.fi + +.LP +.nf +\fB/usr/ucb/ln\fR [\fB-fs\fR] \fIpathname\fR... \fIdirectory\fR +.fi + +.SH DESCRIPTION +.sp +.LP +The \fB/usr/ucb/ln\fR utility creates an additional directory entry, called a +link, to a file or directory. Any number of links can be assigned to a file. +The number of links does not affect other file attributes such as size, +protections, data, etc. +.sp +.LP +\fIfilename\fR is the name of the original file or directory. \fIlinkname\fR is +the new name to associate with the file or filename. If \fIlinkname\fR is +omitted, the last component of \fIfilename\fR is used as the name of the link. +.sp +.LP +If the last argument is the name of a directory, symbolic links are made in +that directory for each \fIpathname\fR argument; \fB/usr/ucb/ln\fR uses the +last component of each \fIpathname\fR as the name of each link in the named +\fIdirectory\fR. +.sp +.LP +A hard link (the default) is a standard directory entry just like the one made +when the file was created. Hard links can only be made to existing files. +Hard links cannot be made across file systems (disk partitions, mounted file +systems). To remove a file, all hard links to it must be removed, including +the name by which it was first created; removing the last hard link releases +the inode associated with the file. +.sp +.LP +A symbolic link, made with the \fB-s\fR option, is a special directory entry +that points to another named file. Symbolic links can span file systems and +point to directories. In fact, you can create a symbolic link that points to a +file that is currently absent from the file system; removing the file that it +points to does not affect or alter the symbolic link itself. +.sp +.LP +A symbolic link to a directory behaves differently than you might expect in +certain cases. While an \fBls\fR(1) on such a link displays the files in the +pointed-to directory, an `\fBls \fR\fB-l\fR' displays information about the +link itself: +.sp +.in +2 +.nf +example% /usr/ucb/ln \fB-s\fR dir link +example% ls link +file1 file2 file3 file4 +example% ls \fB-l\fR link +lrwxrwxrwx 1 user 7 Jan 11 23:27 link \(-> dir +.fi +.in -2 +.sp + +.sp +.LP +When you use \fBcd\fR(1) to change to a directory through a symbolic link, you +wind up in the pointed-to location within the file system. This means that the +parent of the new working directory is not the parent of the symbolic link, but +rather, the parent of the pointed-to directory. For instance, in the following +case the final working directory is \fB/usr\fR and not +\fB/home/user/linktest\fR. +.sp +.in +2 +.nf +example% pwd +/home/user/linktest +example% /usr/ucb/ln \fB-s\fR /var/tmp symlink +example% cd symlink +example% cd .\|. +example% pwd +/usr +.fi +.in -2 +.sp + +.sp +.LP +C shell user's can avoid any resulting navigation problems by using the +\fBpushd\fR and \fBpopd\fR built-in commands instead of \fBcd\fR. +.SH OPTIONS +.sp +.ne 2 +.mk +.na +\fB\fB-f\fR\fR +.ad +.RS 6n +.rt +Force a hard link to a directory. This option is only available to the +super-user, and should be used with extreme caution. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-s\fR\fR +.ad +.RS 6n +.rt +Create a symbolic link or links. +.RE + +.SH USAGE +.sp +.LP +See \fBlargefile\fR(5) for the description of the behavior of \fBln\fR when +encountering files greater than or equal to 2 Gbyte ( 2^31 bytes). +.SH EXAMPLES +.LP +\fBExample 1 \fRThe \fB/usr/ucb/ln\fR command +.sp +.LP +The commands below illustrate the effects of the different forms of the +\fB/usr/ucb/ln\fR command: + +.sp +.in +2 +.nf +example% /usr/ucb/ln file link +example% ls \fB-F\fR file link +file link +example% /usr/ucb/ln \fB-s\fR file symlink +example% ls \fB-F\fR file symlink +file symlink@ +example% ls \fB-li\fR file link symlink + 10606 -rw-r--r-- 2 user 0 Jan 12 00:06 file + 10606 -rw-r--r-- 2 user 0 Jan 12 00:06 link + 10607 lrwxrwxrwx 1 user 4 Jan 12 00:06 symlink \(-> file +example% /usr/ucb/ln \fB-s\fR nonesuch devoid +example% ls \fB-F\fR devoid +devoid@ +example% cat devoid +devoid: No such file or directory +example% /usr/ucb/ln \fB-s\fR /proto/bin/* /tmp/bin +example% ls \fB-F\fR /proto/bin /tmp/bin +/proto/bin: +x* y* z* + +/tmp/bin: +x@ y@ z@ +.fi +.in -2 +.sp + +.SH SEE ALSO +.sp +.LP +\fBcp\fR(1), \fBls\fR(1), \fBmv\fR(1), \fBrm\fR(1), \fBlink\fR(2), +\fBreadlink\fR(2), \fBstat\fR(2), \fBsymlink\fR(2), \fBattributes\fR(5), +\fBlargefile\fR(5) +.SH NOTES +.sp +.LP +When the last argument is a directory, simple basenames should not be used for +\fIpathname\fR arguments. If a basename is used, the resulting symbolic link +points to itself: +.sp +.in +2 +.nf +example% /usr/ucb/ln \fB-s\fR file /tmp +example% ls \fB-l\fR /tmp/file +lrwxrwxrwx 1 user 4 Jan 12 00:16 /tmp/file \(-> file +example% cat /tmp/file +/tmp/file: Too many levels of symbolic links +.fi +.in -2 +.sp + +.sp +.LP +To avoid this problem, use full pathnames, or prepend a reference to the +\fBPWD\fR variable to files in the working directory: +.sp +.in +2 +.nf +example% rm /tmp/file +example% /usr/ucb/ln \fB-s\fR $PWD/file /tmp +lrwxrwxrwx 1 user 4 Jan 12 00:16 /tmp/file \(-> +/home/user/subdir/file +.fi +.in -2 +.sp + diff --git a/usr/src/man/man1b/logger.1b b/usr/src/man/man1b/logger.1b new file mode 100644 index 0000000000..4f9b717610 --- /dev/null +++ b/usr/src/man/man1b/logger.1b @@ -0,0 +1,121 @@ +'\" te +.\" Copyright (c) 1988 Sun Microsystems, Inc. - All Rights Reserved. Copyright (c) 1983 Regents of the University of California. All rights reserved. The Berkeley software +.\" License Agreement specifies the terms and conditions for redistribution. +.TH logger 1B "14 Sep 1992" "SunOS 5.11" "SunOS/BSD Compatibility Package Commands" +.SH NAME +logger \- add entries to the system log +.SH SYNOPSIS +.LP +.nf +\fB/usr/ucb/logger\fR [\fB-f\fR \fIfilename\fR] [\fB-i\fR] [\fB-p\fR \fIpriority\fR] [\fB-t\fR \fItag\fR] mm + [\fImessage\fR]... +.fi + +.SH DESCRIPTION +.sp +.LP +The \fBlogger\fR utility provides a method for adding one-line entries to the +system log file from the command line. One or more \fImessage\fR arguments can +be given on the command line, in which case each is logged immediately. If +\fImessage\fR is unspecified, either the file indicated with \fB-f\fR or the +standard input is added to the log. Otherwise, a \fIfilename\fR can be +specified, in which case each line in the file is logged. If neither is +specified, \fBlogger\fR reads and logs messages on a line-by-line basis from +the standard input. +.SH OPTIONS +.sp +.LP +The following options are supported: +.sp +.ne 2 +.mk +.na +\fB\fB-i\fR\fR +.ad +.RS 15n +.rt +Log the process \fBID\fR of the \fBlogger\fR process with each line. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-f\fR \fIfilename\fR\fR +.ad +.RS 15n +.rt +Use the contents of \fIfilename\fR as the message to log. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-p\fR \fIpriority\fR\fR +.ad +.RS 15n +.rt +Enter the message with the specified \fIpriority\fR. The message priority can +be specified numerically, or as a \fIfacility.level\fR pair. For example, +\fB`\fR\fB-p\fR \fBlocal3.info'\fR assigns the message priority to the +\fBinfo\fR level in the \fBlocal3\fR facility. The default priority is +\fBuser.notice\fR. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-t\fR \fItag\fR\fR +.ad +.RS 15n +.rt +Mark each line added to the log with the specified \fItag\fR. +.RE + +.SH EXAMPLES +.LP +\fBExample 1 \fRLogging a message +.sp +.LP +The command: + +.sp +.in +2 +.nf +example% \fBlogger System rebooted\fR +.fi +.in -2 +.sp + +.sp +.LP +will log the message `\fBSystem rebooted\fR' to the facility at priority +\fBnotice\fR to be treated by \fBsyslogd\fR as other messages to the facility +\fBnotice\fR are. + +.LP +\fBExample 2 \fRLogging messages from a file +.sp +.LP +The command: + +.sp +.in +2 +.nf +example% \fBlogger \fR\fB-p\fR\fB local0.notice \fR\fB-t\fR\fB HOSTIDM \fR\fB-f\fR\fB /dev/idmc\fR +.fi +.in -2 +.sp + +.sp +.LP +will read from the file \fB/dev/idmc\fR and will log each line in that file as +a message with the tag `\fBHOSTIDM\fR' at priority \fBnotice\fR to be treated +by \fBsyslogd\fR as other messages to the facility \fBlocal0\fR are. + +.SH SEE ALSO +.sp +.LP +\fBsyslogd\fR(1M), \fBsyslog\fR(3C), \fBattributes\fR(5) diff --git a/usr/src/man/man1b/lpc.1b b/usr/src/man/man1b/lpc.1b new file mode 100644 index 0000000000..ffa942349d --- /dev/null +++ b/usr/src/man/man1b/lpc.1b @@ -0,0 +1,379 @@ +'\" te +.\" Copyright (c) 1983 Regents of the University of California. All rights reserved. The Berkeley software License Agreement specifies the terms and conditions for redistribution. +.\" Copyright (c) 2006 Sun Microsystems, Inc. All Rights Reserved. +.TH lpc 1B "2 Jun 2006" "SunOS 5.11" "SunOS/BSD Compatibility Package Commands" +.SH NAME +lpc \- line printer control program +.SH SYNOPSIS +.LP +.nf +\fB/usr/ucb/lpc\fR [\fIcommand\fR [\fIparameter\fR...]] +.fi + +.SH DESCRIPTION +.sp +.LP +The \fBlpc\fR utility controls the operation of local printers. +.sp +.LP +Use \fBlpc\fR to perform the following functions: +.RS +4 +.TP +.ie t \(bu +.el o +start or stop a printer, +.RE +.RS +4 +.TP +.ie t \(bu +.el o +disable or enable a printer's spooling queue, +.RE +.RS +4 +.TP +.ie t \(bu +.el o +rearrange the order of jobs in a print queue, or +.RE +.RS +4 +.TP +.ie t \(bu +.el o +display the status of a printer print queue and printer daemon. +.RE +.sp +.LP +\fBlpc\fR can be run from the command line or interactively. Specifying +\fBlpc\fR with the optional \fIcommand\fR and\fIparameter\fR arguments causes +\fBlpc\fR to interpret the first argument as an \fBlpc\fR command, and all +other arguments as parameters to that command. Specifying \fBlpc\fR without +arguments causes it to run interactively, prompting the user for \fBlpc\fR +commands with \fBlpc>\fR. By redirecting the standard input, \fBlpc\fR can read +commands from a file. +.SH USAGE +.sp +.LP +\fBlpc\fR commands can be typed in their entirety or abbreviated to an +unambiguous substring. Some \fBlpc\fR commands are available to all users; +others are available only to super-users. +.sp +.LP +All users can execute the following \fBlpc\fR commands: +.sp +.ne 2 +.mk +.na +\fB\fB?\fR [\fIcommand\fR \|.\|.\|.] | \fBhelp\fR [\fIcommand\fR \|.\|.\|.]\fR +.ad +.sp .6 +.RS 4n +Displays a short description of \fIcommand\fR. \fIcommand\fR is an \fBlpc\fR +command. If \fIcommand\fR is not specified, displays a list of \fBlpc\fR +commands. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBexit\fR | \fBquit\fR\fR +.ad +.sp .6 +.RS 4n +Exits from \fBlpc\fR. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBstatus\fR [\fBall\fR | \fIprinter\fR\|.\|.\|.]\fR +.ad +.sp .6 +.RS 4n +Displays the status of print daemons and print queues. \fBall\fR specifies that +this command is performed on all locally attached printers. \fIprinter\fR +indicates this command is performed on specific printers. Specify \fIprinter\fR +as an atomic name. See \fBprinters.conf\fR(4) for information regarding naming +conventions for atomic names. +.RE + +.sp +.LP +Only a super-user can execute the following \fBlpc\fR commands: +.sp +.ne 2 +.mk +.na +\fB\fBabort\fR [\fBall\fR | \fIprinter\fR\|.\|.\|.]\fR +.ad +.sp .6 +.RS 4n +Terminates an active spooling daemon. Disables printing (by preventing new +daemons from being started by \fBlpr\fR(1B)) for \fIprinter\fR. \fBall\fR +specifies this command is performed on all locally attached printers. +\fIprinter\fR indicates this command is performed on specific printers. Specify +\fIprinter\fR as an atomic name. See \fBprinters.conf\fR(4) for information +regarding naming conventions for atomic names. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBclean\fR [\fBall\fR | \fIprinter\fR\|.\|.\|.\|]\fR +.ad +.sp .6 +.RS 4n +Removes files created in the print spool directory by the print daemon from +\fIprinter\fR \fI\&'s\fR print queue. \fBall\fR specifies that this command is +performed on all locally attached printers.\fIprinter\fR indicates this command +is performed on specific printers. Specify \fIprinter\fR as an atomic name. See +\fBprinters.conf\fR(4) for information regarding naming conventions for atomic +names. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBdisable\fR [\fBall\fR | \fIprinter\fR \|.\|.\|.]\fR +.ad +.sp .6 +.RS 4n +Turns off the print queue for \fIprinter\fR. Prevents new printer jobs from +being entered into the print queue for \fIprinter\fRby \fBlpr\fR(1B). \fBall\fR +specifies that this command is performed on all locally attached printers. +\fIprinter\fR indicates this command is performed on specific printers. Specify +\fIprinter\fR as an atomic name. See \fBprinters.conf\fR(4) for information +regarding naming conventions for atomic names. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBdown\fR [\fBall\fR | \fIprinter\fR \|.\|.\|.\|] [\fImessage\fR]\fR +.ad +.sp .6 +.RS 4n +Turns the queue for \fIprinter\fR off and disables printing on \fIprinter\fR. +Inserts \fImessage\fR in the printer status file. \fImessage\fR does not need +to be quoted; multiple arguments to \fImessage\fR are treated as arguments are +to \fBecho\fR(1). Use \fBdown\fR to take a printer down and inform users. +\fBall\fR specifies that this command is performed on all locally attached +printers. \fIprinter\fR indicates this command is performed on specific +printers. Specify \fIprinter\fR as an atomic name. See \fBprinters.conf\fR(4) +for information regarding naming conventions for atomic names. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBenable\fR [\fBall\fR | \fIprinter\fR \|.\|.\|.]\fR +.ad +.sp .6 +.RS 4n +Enables \fBlpr\fR(1B) to add new jobs in the spool queue. \fBall\fR specifies +that this command is performed on all locally attached printers. \fIprinter\fR +indicates this command is performed on specific printers. Specify \fIprinter\fR +as an atomic name. See \fBprinters.conf\fR(4) for information regarding naming +conventions for atomic names. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBrestart\fR [\fBall\fR | \fIprinter\fR\|.\|.\|.]\fR +.ad +.sp .6 +.RS 4n +Attempts to start a new printer daemon. \fBrestart\fR is useful when a print +daemon dies unexpectedly and leaves jobs in the print queue. \fBall\fR +specifies that this command is performed on all locally attached printers. +\fIprinter\fR indicates that this command is performed on specific printers. +Specify \fIprinter\fR as an atomic name. See \fBprinters.conf\fR(4) for +information regarding naming conventions for atomic names. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBstart\fR [\fBall\fR | \fIprinter\fR\|.\|.\|.]\fR +.ad +.sp .6 +.RS 4n +Enables printing. Starts a spooling daemon for the \fIprinter\fR. \fBall\fR +specifies that this command is performed on all locally attached printers. +\fIprinter\fR indicates the command is performed on specific printers. Specify +\fIprinter\fR as an atomic name. See \fBprinters.conf\fR(4) for information +regarding naming conventions for atomic names. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBstop\fR [\fBall\fR | \fIprinter\fR\|.\|.\|.\|]\fR +.ad +.sp .6 +.RS 4n +Stops a spooling daemon after the current job is complete. Disables printing at +that time. \fBall\fR specifies that this command is performed on all locally +attached printers. \fIprinter\fR indicates this command is performed on +specific printers. Specify \fIprinter\fR as an atomic name. See +\fBprinters.conf\fR(4) for information regarding naming conventions for atomic +names. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBtopq\fR \fIprinter\fR[\fIrequest-ID\fR\|.\|.\|.] [\fIuser\fR +\|.\|.\|.]\fR +.ad +.sp .6 +.RS 4n +Moves \fIrequest-ID\fR or print jobs belonging to \fIuser\fR on \fIprinter\fR +to the beginning of the print queue. Specify \fIuser\fR as a user's login name. +Specify \fIprinter\fR as an atomic name. See \fBprinters.conf\fR(4) for +information regarding naming conventions for atomic names. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBup\fR [\fBall\fR | \fIprinter\fR \|.\|.\|.]\fR +.ad +.sp .6 +.RS 4n +Turns the queue for \fIprinter\fR on and enables printing on \fIprinter\fR. +Deletes the message in the printer status file (inserted by \fBdown\fR). Use +\fBup\fR to undo the effects of \fBdown\fR. \fBall\fR specifies that this +command is performed on all locally attached printers. \fIprinter\fR indicates +this command is performed on specific printers. Specify \fIprinter\fR as an +atomic name. See \fBprinters.conf\fR(4) for information regarding naming +conventions for atomic names. +.RE + +.SH EXIT STATUS +.sp +.LP +The following exit values are returned: +.sp +.ne 2 +.mk +.na +\fB\fB0\fR\fR +.ad +.RS 12n +.rt +Successful completion. +.RE + +.sp +.ne 2 +.mk +.na +\fBnon-zero\fR +.ad +.RS 12n +.rt +An error occurred. +.RE + +.SH FILES +.sp +.ne 2 +.mk +.na +\fB\fB/etc/printers.conf\fR\fR +.ad +.RS 24n +.rt + System printer configuration database +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB$HOME/.printers\fR\fR +.ad +.RS 24n +.rt +User-configurable printer database +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBprinters.conf.byname\fR\fR +.ad +.RS 24n +.rt +NIS version of \fB/etc/printers.conf\fR +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBprinters.org_dir\fR\fR +.ad +.RS 24n +.rt + NIS+ version of \fB/etc/printers.conf\fR +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBou=printers\fR\fR +.ad +.RS 24n +.rt +LDAP version of \fB/etc/printers.conf\fR +.RE + +.SH ATTRIBUTES +.sp +.LP +See \fBattributes\fR(5) for descriptions of the following attributes: +.sp + +.sp +.TS +tab() box; +cw(2.75i) |cw(2.75i) +lw(2.75i) |lw(2.75i) +. +ATTRIBUTE TYPEATTRIBUTE VALUE +_ +Interface StabilityStandard +.TE + +.SH SEE ALSO +.sp +.LP +\fBlpq\fR(1B), \fBlpr\fR(1B), \fBlprm\fR(1B), \fBlpstat\fR(1), +\fBlpsched\fR(1M), \fBlpshut\fR(1M), \fBsvcadm\fR(1M), \fBprinters.conf\fR(4), +\fBattributes\fR(5) +.SH DIAGNOSTICS +.sp +.LP +Use the \fBsvcs\fR(1) utility to check if \fBsvc:/application/print/server\fR +is running. If it is not running, use \fBsvcadm enable +svc:/application/print/server\fR to start \fBlpsched\fR. See \fBsvcadm\fR(1M). +.SH NOTES +.sp +.LP +When IPP is in use, the user is prompted for a passphrase if the remote print +service is configured to require authentication. diff --git a/usr/src/man/man1b/lpq.1b b/usr/src/man/man1b/lpq.1b new file mode 100644 index 0000000000..8faef0e61f --- /dev/null +++ b/usr/src/man/man1b/lpq.1b @@ -0,0 +1,247 @@ +'\" te +.\" Copyright (C) 2006, Sun Microsystems, Inc. All Rights Reserved +.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. +.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. +.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] +.TH lpq 1B "2 Jun 2006" "SunOS 5.11" "SunOS/BSD Compatibility Package Commands" +.SH NAME +lpq \- display the content of a print queue +.SH SYNOPSIS +.LP +.nf +\fB/usr/ucb/lpq\fR [\fB-P\fR \fIdestination\fR] [\fB-l\fR] [+ [\fIinterval\fR]] + [\fIrequest-ID\fR...] [\fIuser\fR]... +.fi + +.SH DESCRIPTION +.sp +.LP +The \fBlpq\fR utility displays the information about the contents of a print +queue. A print queue is comprised of print requests that are waiting in the +process of being printed. +.sp +.LP +\fBlpq\fR displays the following information to the standard output: +.RS +4 +.TP +.ie t \(bu +.el o +the username of the person associated with a print request, +.RE +.RS +4 +.TP +.ie t \(bu +.el o +the position of a print request in the print queue, +.RE +.RS +4 +.TP +.ie t \(bu +.el o +the name of file or files comprising a print request, +.RE +.RS +4 +.TP +.ie t \(bu +.el o +the job number of a print request, and +.RE +.RS +4 +.TP +.ie t \(bu +.el o +the size of the file requested by a print request. File size is reported in +bytes. +.RE +.sp +.LP +Normally, only as much information as will fit on one line is displayed. If the +name of the input file associated with a print request is not available, the +input file field indicates the standard input. +.sp +.LP +The print client commands locate destination information using the +\fBprinters\fR database in the name service switch. See \fBnsswitch.conf\fR(4), +\fBprinters\fR(4), and \fBprinters.conf\fR(4) for details. +.SH OPTIONS +.sp +.LP +The following options are supported: +.sp +.ne 2 +.mk +.na +\fB\fB-l\fR\fR +.ad +.RS 18n +.rt +Displays information in long format. Long format includes the name of the host +from which a print request originated in the display. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-P\fR \fIdestination\fR\fR +.ad +.RS 18n +.rt +Displays information about printer or class of printers (see \fBlpadmin\fR(1M)) +\fI\&.\fR Specify \fIdestination\fR using atomic, URI-style +(\fIscheme\fR\fB://\fR\fBendpoint\fR), or POSIX-style +(\fIserver\fR\fB:\fR\fIdestination\fR) names. See \fBprinters.conf\fR(4) for +information regarding destination names. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB+\fR [\fIinterval\fR]\fR +.ad +.RS 18n +.rt +Displays information at specific time intervals. Stops displaying information +when the print queue is empty. Clears the screen before reporting displaying +the print queue. Specify \fIinterval\fR as the number of seconds between +displays. If \fIinterval\fR is not specified only executes once. +.RE + +.SH OPERANDS +.sp +.LP +The following operands are supported: +.sp +.ne 2 +.mk +.na +\fB\fIrequest-ID\fR\fR +.ad +.RS 14n +.rt +The job number associated with a print request. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fIuser\fR\fR +.ad +.RS 14n +.rt +The name of the user about whose jobs \fBlpq\fR reports information. Specify +\fIuser\fR as a valid username. +.RE + +.SH EXIT STATUS +.sp +.LP +The following exit values are returned: +.sp +.ne 2 +.mk +.na +\fB\fB0\fR\fR +.ad +.RS 12n +.rt +Successful completion. +.RE + +.sp +.ne 2 +.mk +.na +\fBnon-zero\fR +.ad +.RS 12n +.rt +An error occurred. +.RE + +.SH FILES +.sp +.ne 2 +.mk +.na +\fB\fB$HOME/.printers\fR\fR +.ad +.RS 24n +.rt +User-configurable printer database +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB/etc/printers.conf\fR\fR +.ad +.RS 24n +.rt +System printer configuration database +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBprinters.conf.byname\fR\fR +.ad +.RS 24n +.rt +NIS version of \fB/etc/printers.conf\fR +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBprinters.org_dir\fR\fR +.ad +.RS 24n +.rt +NIS+ version of \fB/etc/printers.conf\fR +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBou=printers\fR\fR +.ad +.RS 24n +.rt +LDAP version of \fB/etc/printers.conf\fR +.RE + +.SH ATTRIBUTES +.sp +.LP +See \fBattributes\fR(5) for descriptions of the following attributes: +.sp + +.sp +.TS +tab() box; +cw(2.75i) |cw(2.75i) +lw(2.75i) |lw(2.75i) +. +ATTRIBUTE TYPEATTRIBUTE VALUE +_ +Interface StabilityStandard +.TE + +.SH SEE ALSO +.sp +.LP +\fBlp\fR(1), \fBlpc\fR(1B), \fBlpr\fR(1B), \fBlprm\fR(1B), \fBlpstat\fR(1), +\fBlpadmin\fR(1M), \fBnsswitch.conf\fR(4), \fBprinters\fR(4), +\fBprinters.conf\fR(4), \fBattributes\fR(5), \fBstandards\fR(5) +.SH NOTES +.sp +.LP +When IPP is in use, the user is prompted for a passphrase if the remote print +service is configured to require authentication. diff --git a/usr/src/man/man1b/lpr.1b b/usr/src/man/man1b/lpr.1b new file mode 100644 index 0000000000..1aff9c18b0 --- /dev/null +++ b/usr/src/man/man1b/lpr.1b @@ -0,0 +1,464 @@ +'\" te +.\" Copyright (c) 1980 Regents of the University of California. All rights reserved. The Berkeley software License Agreement specifies the terms and conditions for redistribution. +.\" Copyright (C) 2006, Sun Microsystems, Inc. All Rights Reserved +.TH lpr 1B "2 Jun 2006" "SunOS 5.11" "SunOS/BSD Compatibility Package Commands" +.SH NAME +lpr \- submit print requests +.SH SYNOPSIS +.LP +.nf +\fB/usr/ucb/lpr\fR [\fB-P\fR \fIdestination\fR] [\fB-#\fR \fInumber\fR] [\fB-C\fR \fIclass\fR] + [\fB-J\fR \fIjob\fR] [\fB-T\fR \fItitle\fR] [\fB-i\fR [\fIindent\fR]] + [\fB-1\fR | \fB-2\fR | \fB-3\fR | \fB-4\fR \fIfont\fR] [\fB-w\fR \fIcols\fR] [\fB-m\fR] [\fB-h\fR] [\fB-s\fR] + [\fB-filter_option\fR] [\fIfile\fR]... +.fi + +.SH DESCRIPTION +.sp +.LP +The \fBlpr\fR utility submits print requests to a destination. \fBlpr\fR prints +files (\fIfile\fR) and associated information, collectively called a \fIprint +request\fR. If \fIfile\fR is not specified, \fBlpr\fR assumes the standard +input. +.sp +.LP +The print client commands locate destination information using the "printers" +database in the name service switch. See \fBnsswitch.conf\fR(4), +\fBprinters\fR(4), and \fBprinters.conf\fR(4) for details. +.sp +.LP +Print requests with more than 52 \fIfile\fRs specified is truncated to 52 files +when the BSD print protocol is used for job submission. +.SH OPTIONS +.sp +.LP +The following options are supported: +.sp +.ne 2 +.mk +.na +\fB\fB-C\fR \fIclass\fR\fR +.ad +.sp .6 +.RS 4n +Prints \fIclass\fR as the job classification on the banner page of the output. +Enclose \fIclass\fR in double quotes if it contains blanks. If \fIclass\fR is +not specified, the name of the system (as returned by \fBhostname\fR) is +printed as the job classification. See \fBhostname\fR(1). +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-h\fR\fR +.ad +.sp .6 +.RS 4n +Suppresses printing of the banner page of the output. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-i\fR \fIindent\fR\fR +.ad +.sp .6 +.RS 4n +Indents the output a specific number of \fISPACE\fR characters. Use +\fIindent\fR to indicate the number of \fISPACE\fR characters to be indented. +Specify \fIindent\fR as a positive integer. If the optional argument to indent +is not specified, then eight \fISPACE\fR characters is the default. The +\fB-i\fR option is ignored unless it is specified with the \fB-p\fR filter +option. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-J\fR \fIjob\fR\fR +.ad +.sp .6 +.RS 4n +Prints \fIjob\fR as the \fIjob name\fR on the banner page of the output. +Enclose \fIjob\fR in double quotes if it contains blanks. If \fIjob\fR is not +specified, \fIfile\fR (or in the case of multiple files, the first \fIfile\fR +specified on the command line) is printed as the job name on the banner page of +the output. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-m\fR\fR +.ad +.sp .6 +.RS 4n +Sends mail after \fIfile\fR has printed. See \fBmail\fR(1). By default, no mail +is sent upon normal completion of a print request. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-P\fR \fIdestination\fR\fR +.ad +.sp .6 +.RS 4n +Prints \fIfile\fR on a specific printer or class of printers (see +\fBlpadmin\fR(1M)). Specify \fIdestination\fR using atomic, URI-style +(\fIscheme\fR\fB://\fR\fBendpoint\fR), or POSIX-style +(\fIserver\fR\fB:\fR\fIdestination\fR) names. See \fBprinters.conf\fR(4) for +information regarding destination names. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-s\fR\fR +.ad +.sp .6 +.RS 4n +Prints files by reference rather than copying them. This means that files +should not be modified or removed until they have completed printing. This +option only prevents copying of files when the print queue is on the local +machine and the files are specified on the command line. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-T\fR \fItitle\fR\fR +.ad +.sp .6 +.RS 4n +Prints a title on the page header of the output. Enclose \fItitle\fR in double +quotes if it contains blanks. The \fB-T\fR option is ignored unless it is +specified with the \fB-p\fR filter option. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-w\fR \fIcols\fR\fR +.ad +.sp .6 +.RS 4n +Prints \fIfile\fR with pages of a specific width. \fIcols\fR indicates the +number of columns wide. The \fB-w\fR option is ignored unless it is specified +with the \fB-p\fR filter option. +.RE + +.sp +.ne 2 +.mk +.na +\fB\(mi\fB1\fR|\(mi\fB2\fR|\(mi\fB3\fR|\(mi\fB4\fR \fIfont\fR\fR +.ad +.sp .6 +.RS 4n +Mounts the specified font in the font position \fB1\fR, \fB2\fR, \fB3\fR, or +\fB4\fR. Specify \fIfont\fR as a valid font name. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB\(mi\fR \fIfilter_option\fR\fR +.ad +.sp .6 +.RS 4n +Notifies the print spooler that \fIfile\fR is not a standard text file. Enables +the spooling daemon to use the appropriate filters to print \fIfile\fR. +.sp +\fIfilter_option\fRs offer a standard user interface. All filter options might +not be available for, or applicable to, all printers. +.sp +Specify \fIfilter_option\fR as a single character. +.sp +If \fIfilter_option\fR is not specified and the printer can interpret +PostScript\(rg, inserting `\fB%!\fR' as the first two characters of \fIfile\fR +causes \fIfile\fR to be interpreted as PostScript. +.sp +The following filter options are supported: +.sp +.ne 2 +.mk +.na +\fBc\fR +.ad +.RS 5n +.rt +\fIfile\fR contains data produced by \fIcifplot\fR. +.RE + +.sp +.ne 2 +.mk +.na +\fBd\fR +.ad +.RS 5n +.rt +\fIfile\fR contains \fBtex\fR data in \fBDVI\fR format from Stanford. +.RE + +.sp +.ne 2 +.mk +.na +\fBf\fR +.ad +.RS 5n +.rt +Interprets the first character of each line as a standard FORTRAN carriage +control character. +.RE + +.sp +.ne 2 +.mk +.na +\fBg\fR +.ad +.RS 5n +.rt +\fIfile\fR contains standard plot data produced by \fBplot\fR(1B) routines. +.RE + +.sp +.ne 2 +.mk +.na +\fBl\fR +.ad +.RS 5n +.rt +Print control characters and suppress page breaks. +.RE + +.sp +.ne 2 +.mk +.na +\fBn\fR +.ad +.RS 5n +.rt +\fIfile\fR contains \fBditroff\fR data from device independent troff. +.RE + +.sp +.ne 2 +.mk +.na +\fBp\fR +.ad +.RS 5n +.rt +Use \fBpr\fR to format the files. See \fBpr\fR(1). +.RE + +.sp +.ne 2 +.mk +.na +\fBt\fR +.ad +.RS 5n +.rt +\fIfile\fR contains \fBtroff\fR (cat phototypesetter) binary data. +.RE + +.sp +.ne 2 +.mk +.na +\fBv\fR +.ad +.RS 5n +.rt +\fIfile\fR contains a raster image. \fIprinter\fR must support an appropriate +imaging model such as PostScript in order to print the image. +.RE + +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-#\fR \fInumber\fR\fR +.ad +.sp .6 +.RS 4n +Prints a specific number of copies. Specify \fInumber\fR as a positive integer. +The default for \fInumber\fR is \fB1\fR. +.RE + +.SH OPERANDS +.sp +.LP +The following operand is supported: +.sp +.ne 2 +.mk +.na +\fB\fIfile\fR\fR +.ad +.RS 8n +.rt +The name of the file to be printed. Specify \fIfile\fR as a pathname. If +\fIfile\fR is not specified, \fBlpr\fR uses the standard input. +.RE + +.SH USAGE +.sp +.LP +See \fBlargefile\fR(5) for the description of the behavior of \fBlpr\fR when +encountering files greater than or equal to 2 Gbyte ( 2^31 bytes). +.SH EXIT STATUS +.sp +.LP +The following exit values are returned: +.sp +.ne 2 +.mk +.na +\fB\fB0\fR\fR +.ad +.RS 12n +.rt +Successful completion. +.RE + +.sp +.ne 2 +.mk +.na +\fBnon-zero\fR +.ad +.RS 12n +.rt +An error occurred. +.RE + +.SH FILES +.sp +.ne 2 +.mk +.na +\fB\fB/etc/printers.conf\fR\fR +.ad +.RS 24n +.rt +System printer configuration database +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB$HOME/.printers\fR\fR +.ad +.RS 24n +.rt +User-configurable printer database +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBou=printers\fR\fR +.ad +.RS 24n +.rt +LDAP version of \fB/etc/printers.conf\fR +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBprinters.conf.byname\fR\fR +.ad +.RS 24n +.rt +NIS version of \fB/etc/printers.conf\fR +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBprinters.org_dir\fR\fR +.ad +.RS 24n +.rt +NIS+ version of \fB/etc/printers.conf\fR +.RE + +.SH ATTRIBUTES +.sp +.LP +See \fBattributes\fR(5) for descriptions of the following attributes: +.sp + +.sp +.TS +tab() box; +cw(2.75i) |cw(2.75i) +lw(2.75i) |lw(2.75i) +. +ATTRIBUTE TYPEATTRIBUTE VALUE +_ +Interface StabilitlyStandard +_ +CSIEnabled. See NOTES +.TE + +.SH SEE ALSO +.sp +.LP +\fBhostname\fR(1), \fBlp\fR(1), \fBlpc\fR(1B), \fBlpq\fR(1B), \fBlprm\fR(1B), +\fBlpstat\fR(1), \fBmail\fR(1), \fBplot\fR(1B), \fBpr\fR(1), \fBtroff\fR(1), +\fBlpadmin\fR(1M), \fBnsswitch.conf\fR(4), \fBprinters\fR(4), +\fBprinters.conf\fR(4), \fBattributes\fR(5), \fBlargefile\fR(5), +\fBstandards\fR(5) +.SH DIAGNOSTICS +.sp +.ne 2 +.mk +.na +\fB\fBlpr:\fR \fIdestination\fR \fB|: unknown destination\fR\fR +.ad +.sp .6 +.RS 4n +\fIdestination\fR was not found in the \fBLP\fR configuration database. Usually +this is a typing mistake; however, it can indicate that the \fIdestination\fR +does not exist on the system. Use \fBlpstat\fR \fB-p\fR to display information +about the status of the print service. +.RE + +.SH NOTES +.sp +.LP +\fBlpr\fR is CSI-enabled except for the \fIprinter\fR name. +.sp +.LP +Print jobs are assumed to contain one type of data. That type of data is either +specified on the command line or autodetected (simple, PostScript) based on the +contents of the first file in the job. +.sp +.LP +When IPP is in use, the user is prompted for a passphrase if the remote print +service is configured to require authentication. diff --git a/usr/src/man/man1b/lprm.1b b/usr/src/man/man1b/lprm.1b new file mode 100644 index 0000000000..83ccff1ebd --- /dev/null +++ b/usr/src/man/man1b/lprm.1b @@ -0,0 +1,236 @@ +'\" te +.\" Copyright (c) 1983 Regents of the University of California. All rights reserved. The Berkeley software License Agreement specifies the terms and conditions for redistribution. +.\" Copyright (C) 2006, Sun Microsystems, Inc. All Rights Reserved +.TH lprm 1B "2 Jun 2006" "SunOS 5.11" "SunOS/BSD Compatibility Package Commands" +.SH NAME +lprm \- remove print requests from the print queue +.SH SYNOPSIS +.LP +.nf +\fB/usr/ucb/lprm\fR [\fB-P\fR \fIdestination\fR] [\fB-\fR] [\fIrequest-ID\fR]... + [\fIuser\fR]... +.fi + +.SH DESCRIPTION +.sp +.LP +The \fBlprm\fR utility removes print requests (\fIrequest-ID\fR) from the +print queue. +.sp +.LP +Without arguments, \fBlprm\fR deletes the current print request. \fBlprm\fR +reports the name of the file associated with print requests that it removes. +\fBlprm\fR is silent if there are no applicable print requests to remove. +.sp +.LP +Users can only remove print requests associated with their user name. See +Notes. If a superuser executes \fBlprm\fR and specifies the \fIuser\fR operand, +\fBlprm\fR removes all print requests belonging to the specified user. +.sp +.LP +The print client commands locate destination information using the "printers" +database in the name service switch. See \fBnsswitch.conf\fR(4), +\fBprinters\fR(4), and \fBprinters.conf\fR(4) for details. +.SH OPTIONS +.sp +.LP +The following options are supported: +.sp +.ne 2 +.mk +.na +\fB\fB-P\fR \fIdestination\fR\fR +.ad +.RS 18n +.rt +The name of the printer or class of printers (see \fBlpadmin\fR(1M)) from which +to remove print requests. Specify destination using atomic, URI-style +(\fIscheme\fR\fB://\fR\fBendpoint\fR), or POSIX-style +(\fIserver\fR\fB:\fR\fIdestination\fR) names. See \fBprinters.conf\fR(4) for +information regarding the naming naming conventions for destination names. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB\(mi\fR\fR +.ad +.RS 18n +.rt +If a user specifies this option, removes all print requests owned by that +user. If a superuser specifies this option, removes all requests in the print +queue. Job ownership is determined by the user's login name and host name on +the machine from which \fBlpr\fR was executed. See Notes. +.RE + +.SH OPERANDS +.sp +.LP +The following operands are supported. +.sp +.ne 2 +.mk +.na +\fB\fIrequest-ID\fR\fR +.ad +.RS 14n +.rt +Removes a specific print request. Specify \fIrequest-ID\fR as the job number +(\fBJob\fR) associated with a print request and reported by \fBlpq\fR. See +\fBlpq\fR(1B). +.RE + +.sp +.ne 2 +.mk +.na +\fB\fIuser\fR\fR +.ad +.RS 14n +.rt +Removes print requests associated with a specific user. Specify \fIuser\fR as +a valid user name. This option can only be used by a superuser. +.RE + +.SH EXAMPLES +.LP +\fBExample 1 \fRRemoving a Print Request +.sp +.LP +The following example removes request-ID \fB385\fR from destination +\fBkilltree\fR: + +.sp +.in +2 +.nf +example% \fBlprm \(miP killtree 385\fR +.fi +.in -2 +.sp + +.SH EXIT STATUS +.sp +.LP +The following exit values are returned: +.sp +.ne 2 +.mk +.na +\fB\fB0\fR\fR +.ad +.RS 12n +.rt +Successful completion. +.RE + +.sp +.ne 2 +.mk +.na +\fBnon-zero\fR +.ad +.RS 12n +.rt +An error occurred. +.RE + +.SH FILES +.sp +.ne 2 +.mk +.na +\fB\fB$HOME/.printers\fR\fR +.ad +.RS 24n +.rt +User-configurable printer database +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB/etc/printers.conf\fR\fR +.ad +.RS 24n +.rt +System printer configuration database +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBprinters.conf.byname\fR\fR +.ad +.RS 24n +.rt +NIS version of \fB/etc/printers.conf\fR +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBprinters.org_dir\fR\fR +.ad +.RS 24n +.rt +NIS+ version of \fB/etc/printers.conf\fR +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBou=printers\fR\fR +.ad +.RS 24n +.rt +LDAP version of \fB/etc/printers.conf\fR +.RE + +.SH ATTRIBUTES +.sp +.LP +See \fBattributes\fR(5) for descriptions of the following attributes: +.sp + +.sp +.TS +tab() box; +cw(2.75i) |cw(2.75i) +lw(2.75i) |lw(2.75i) +. +ATTRIBUTE TYPEATTRIBUTE VALUE +_ +Interface StabilityStandard +.TE + +.SH SEE ALSO +.sp +.LP +\fBlp\fR(1), \fBlpc\fR(1B), \fBlpq\fR(1B), \fBlpr\fR(1B), \fBlpstat\fR(1), +\fBlpadmin\fR(1M), \fBnsswitch.conf\fR(4), \fBprinters\fR(4), +\fBprinters.conf\fR(4), \fBattributes\fR(5), \fBstandards\fR(5) +.SH NOTES +.sp +.LP +Users can only remove print requests associated with their user name. By +default, users can only remove print requests on the host from which the print +request was submitted. If a superuser has set \fBuser-equivalence=true\fR in +\fB/etc/printers.conf\fR on the print server, users can remove print requests +associated with their user name on any host. Superusers can remove print +requests on the host from which the print request was submitted. Superusers can +also remove print requests from the print server. +.sp +.LP +Some print servers send cancelation notification to job owners when their print +jobs have been cancelled. This notification usually comes in the form of an +email message. Cancelation notices cannot be disabled on a Solaris server. +.SH NOTES +.sp +.LP +When IPP is in use, the user is prompted for a passphrase if the remote print +service is configured to require authentication. diff --git a/usr/src/man/man1b/lptest.1b b/usr/src/man/man1b/lptest.1b new file mode 100644 index 0000000000..bf1538a404 --- /dev/null +++ b/usr/src/man/man1b/lptest.1b @@ -0,0 +1,79 @@ +'\" te +.\" Copyright (c) 1985 Regents of the University of California. All rights reserved. The Berkeley software License Agreement specifies the terms and conditions for redistribution. +.\" Copyright (c) 1996 Sun Microsystems, Inc. All Rights Reserved. +.TH lptest 1B "9 Sep 1996" "SunOS 5.11" "SunOS/BSD Compatibility Package Commands" +.SH NAME +lptest \- generate line printer ripple pattern +.SH SYNOPSIS +.LP +.nf +\fB/usr/ucb/lptest\fR [\fIlength\fR [\fIcount\fR]] +.fi + +.SH DESCRIPTION +.sp +.LP +The \fBlptest\fR utility writes the traditional \fIripple test\fR pattern to +the standard output. In 96 lines, the ripple test pattern prints all 96 +printable \fBASCII\fR characters in each position. The ripple test pattern was +originally created to test printers. It is also useful for testing terminals, +driving terminal ports, debugging, and performing tasks that require a quick +supply of random data. +.sp +.LP +This command is obsolete. +.SH OPTIONS +.sp +.ne 2 +.mk +.na +\fB\fIlength\fR\fR +.ad +.RS 10n +.rt +Specifies the length of the output line in characters. \fB79\fR characters is +the default. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fIcount\fR\fR +.ad +.RS 10n +.rt +Specifies the number of output lines. \fB200\fR lines is the default. If +\fIcount\fR is specified, \fIlength\fR must also be specified. +.RE + +.SH EXIT STATUS +.sp +.LP +The following exit values are returned: +.sp +.ne 2 +.mk +.na +\fB\fB0\fR\fR +.ad +.RS 12n +.rt +Successful completion. +.RE + +.sp +.ne 2 +.mk +.na +\fBnon-zero\fR +.ad +.RS 12n +.rt +An error occurred. +.RE + +.SH SEE ALSO +.sp +.LP +\fBattributes\fR(5) diff --git a/usr/src/man/man1b/mail.1b b/usr/src/man/man1b/mail.1b new file mode 100644 index 0000000000..b98ea6df85 --- /dev/null +++ b/usr/src/man/man1b/mail.1b @@ -0,0 +1,32 @@ +'\" te +.\" Copyright (c) 1998, Sun Microsystems, Inc. All Rights Reserved +.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. +.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. +.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] +.TH mail 1B "19 Aug 1998" "SunOS 5.11" "SunOS/BSD Compatibility Package Commands" +.SH NAME +mail, Mail \- interactive message processing system +.SH SYNOPSIS +.LP +.nf +\fB/usr/ucb/mail\fR ... +.fi + +.LP +.nf +\fB/usr/ucb/Mail\fR ... +.fi + +.SH DESCRIPTION +.sp +.LP +\fB/usr/ucb/mail\fR and \fB/usr/ucb/Mail\fR are provided as links to +\fB/usr/bin/mailx.\fR See \fBmailx\fR(1) for more information on the usage of +these commands. +.SS "\fB/usr/ucb/Mail\fR" +.sp + +.SH SEE ALSO +.sp +.LP +\fBmailx\fR(1),\fBattributes\fR(5) diff --git a/usr/src/man/man1b/mkstr.1b b/usr/src/man/man1b/mkstr.1b new file mode 100644 index 0000000000..80ced3aca9 --- /dev/null +++ b/usr/src/man/man1b/mkstr.1b @@ -0,0 +1,95 @@ +'\" te +.\" Copyright (c) 1992, Sun Microsystems, Inc. +.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. +.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. +.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] +.TH mkstr 1B "14 Sep 1992" "SunOS 5.11" "SunOS/BSD Compatibility Package Commands" +.SH NAME +mkstr \- create an error message file by massaging C source files +.SH SYNOPSIS +.LP +.nf +\fB/usr/ucb/mkstr\fR [\fB-\fR] \fImessagefile\fR \fIprefix\fR \fIfilename\fR... +.fi + +.SH DESCRIPTION +.sp +.LP +The \fBmkstr\fR utility creates files of error messages. You can use +\fBmkstr\fR to make programs with large numbers of error diagnostics much +smaller, and to reduce system overhead in running the program \(em as the error +messages do not have to be constantly swapped in and out. +.sp +.LP +\fBmkstr\fR processes each of the specified \fIfilename\fRs, placing a massaged +version of the input file in a file with a name consisting of the specified +\fIprefix\fR and the original source file name. A typical example of using +\fBmkstr\fR would be: +.sp +.in +2 +.nf +\fBmkstr pistrings processed *.c\fR +.fi +.in -2 +.sp + +.sp +.LP +This command would cause all the error messages from the C source files in the +current directory to be placed in the file \fBpistrings\fR and processed copies +of the source for these files to be placed in files whose names are prefixed +with \fIprocessed\fR. +.sp +.LP +To process the error messages in the source to the message file, \fBmkstr\fR +keys on the string `\fBerror("\fR' in the input stream. Each time it occurs, +the C string starting at the `\fB"\fR' is placed in the message file followed +by a null character and a NEWLINE character; the null character terminates the +message so it can be easily used when retrieved, the NEWLINE character makes it +possible to sensibly \fBcat\fR the error message file to see its contents. The +massaged copy of the input file then contains a \fBlseek\fR pointer into the +file which can be used to retrieve the message, that is: +.sp +.in +2 +.nf + char efilname[\|] = "/usr/lib/pi_strings"; + int efil = \(mi1; + + error(a1, a2, a3, a4) + { + + char + buf[256]; + if (efil < 0) { + + efil = open(efilname, 0); + if (efil < 0) { +oops: + perror (efilname); + exit (1); + } + } + if (lseek(efil, (long) a1, 0) |\|| read(efil, buf, 256) <= 0) + goto oops; + printf(buf, a2, a3, a4); +} +.fi +.in -2 + +.SH OPTIONS +.sp +.ne 2 +.mk +.na +\fB\fB\(mi\fR\fR +.ad +.RS 8n +.rt +Place error messages at the end of the specified message file for recompiling +part of a large \fBmkstr\fRed program. +.RE + +.SH SEE ALSO +.sp +.LP +\fBxstr\fR(1), \fBattributes\fR(5) diff --git a/usr/src/man/man1b/plot.1b b/usr/src/man/man1b/plot.1b new file mode 100644 index 0000000000..eb7b9c7328 --- /dev/null +++ b/usr/src/man/man1b/plot.1b @@ -0,0 +1,391 @@ +'\" te +.\" Copyright (c) 1988 Sun Microsystems, Inc. - All Rights Reserved. +.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. +.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. +.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] +.TH plot 1B "3 Aug 1994" "SunOS 5.11" "SunOS/BSD Compatibility Package Commands" +.SH NAME +plot, aedplot, atoplot, bgplot, crtplot, dumbplot, gigiplot, hpplot, implot, +plottoa, t300, t300s, t4013, t450, tek, vplot, hp7221plot \- graphics filters +for various plotters +.SH SYNOPSIS +.LP +.nf +\fB/usr/ucb/plot\fR [\fB-T\fR\fIterminal\fR] +.fi + +.SH DESCRIPTION +.sp +.LP +The \fBplot\fR utility reads plotting instructions (see \fBplot\fR(4B)) from +the standard input and produces plotting instructions suitable for a particular +\fIterminal\fR on the standard output. +.sp +.LP +If no \fIterminal\fR is specified, the environment variable \fBTERM\fR is used. +The default \fIterminal\fR is \fBtek\fR. +.SH ENVIRONMENT VARIABLES +.sp +.LP +Except for \fBver\fR, the following terminal-types can be used with `\fBlpr\fR +\fB-g\fR' (see \fBlpr\fR(1B)) to produce plotted output: +.sp +.ne 2 +.mk +.na +\fB\fB2648\fR | \fB2648a\fR | \fBh8\fR | \fBhp2648\fR | \fBhp2648a\fR\fR +.ad +.sp .6 +.RS 4n +Hewlett Packard 2648 graphics terminal. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBhp7221\fR | \fBhp7\fR | \fBh7\fR |\fR +.ad +.sp .6 +.RS 4n +Hewlett Packard 7221 plotter. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB300\fR\fR +.ad +.sp .6 +.RS 4n +\fBDASI\fR 300 or \fBGSI\fR terminal (Diablo mechanism). +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB300s\fR | \fB300S\fR\fR +.ad +.sp .6 +.RS 4n +\fBDASI\fR 300s terminal (Diablo mechanism). +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB450\fR\fR +.ad +.sp .6 +.RS 4n +\fBDASI\fR Hyterm 450 terminal (Diablo mechanism). +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB4013\fR\fR +.ad +.sp .6 +.RS 4n +Tektronix 4013 storage scope. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB4014\fR | \fBtek\fR\fR +.ad +.sp .6 +.RS 4n +Tektronix 4014 and 4015 storage scope with Enhanced Graphics Module. (Use 4013 +for Tektronix 4014 or 4015 without the Enhanced Graphics Module). +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBaed\fR\fR +.ad +.sp .6 +.RS 4n +\fBAED\fR 512 color graphics terminal. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBbgplot\fR | \fBbitgraph\fR\fR +.ad +.sp .6 +.RS 4n +\fBBBN\fR bitgraph graphics terminal. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBcrt\fR\fR +.ad +.sp .6 +.RS 4n +Any crt terminal capable of running \fBvi\fR(1). +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBdumb\fR | \fBun\fR | \fBunknown\fR\fR +.ad +.sp .6 +.RS 4n +Dumb terminals without cursor addressing or line printers. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBgigi\fR | \fBvt125\fR\fR +.ad +.sp .6 +.RS 4n +\fBDEC\fR vt125 terminal. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBimplot\fR\fR +.ad +.sp .6 +.RS 4n +Imagen plotter. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBvar\fR\fR +.ad +.sp .6 +.RS 4n +Benson Varian printer-plotter +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBver\fR\fR +.ad +.sp .6 +.RS 4n +Versatec D1200A printer-plotter. The output is scan-converted and suitable +input to `\fBlpr\fR \fB-v\fR'. +.RE + +.SH FILES +.sp +.ne 2 +.mk +.na +\fB\fB/usr/ucb/aedplot\fR\fR +.ad +.RS 23n +.rt + +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB/usr/ucb/atoplot\fR\fR +.ad +.RS 23n +.rt + +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB/usr/ucb/bgplot\fR\fR +.ad +.RS 23n +.rt + +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB/usr/ucb/crtplot\fR\fR +.ad +.RS 23n +.rt + +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB/usr/ucb/dumbplot\fR\fR +.ad +.RS 23n +.rt + +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB/usr/ucb/gigiplot\fR\fR +.ad +.RS 23n +.rt + +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB/usr/ucb/hp7221plot\fR\fR +.ad +.RS 23n +.rt + +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB/usr/ucb/hpplot\fR\fR +.ad +.RS 23n +.rt + +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB/usr/ucb/implot\fR\fR +.ad +.RS 23n +.rt + +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB/usr/ucb/plot\fR\fR +.ad +.RS 23n +.rt + +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB/usr/ucb/plottoa\fR\fR +.ad +.RS 23n +.rt + +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB/usr/ucb/t300\fR\fR +.ad +.RS 23n +.rt + +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB/usr/ucb/t300s\fR\fR +.ad +.RS 23n +.rt + +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB/usr/ucb/t4013\fR\fR +.ad +.RS 23n +.rt + +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB/usr/ucb/t450\fR\fR +.ad +.RS 23n +.rt + +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB/usr/ucb/tek\fR\fR +.ad +.RS 23n +.rt + +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB/usr/ucb/vplot\fR\fR +.ad +.RS 23n +.rt + +.RE + +.SH SEE ALSO +.sp +.LP +\fBgraph\fR(1), \fBtplot\fR(1), \fBvi\fR(1), \fBlpr\fR(1B), \fBplot\fR(4B), +\fBattributes\fR(5) diff --git a/usr/src/man/man1b/printenv.1b b/usr/src/man/man1b/printenv.1b new file mode 100644 index 0000000000..68f491c74b --- /dev/null +++ b/usr/src/man/man1b/printenv.1b @@ -0,0 +1,29 @@ +'\" te +.\" Copyright (c) 1992, Sun Microsystems, Inc. +.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. +.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. +.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] +.TH printenv 1B "14 Sep 1992" "SunOS 5.11" "SunOS/BSD Compatibility Package Commands" +.SH NAME +printenv \- display environment variables currently set +.SH SYNOPSIS +.LP +.nf +\fB/usr/ucb/printenv\fR [\fIvariable\fR] +.fi + +.SH DESCRIPTION +.sp +.LP +\fBprintenv\fR prints out the values of the variables in the environment. If a +\fIvariable\fR is specified, only its value is printed. +.SH SEE ALSO +.sp +.LP +\fBcsh\fR(1), \fBecho\fR(1), \fBsh\fR(1), \fBstty\fR(1), \fBtset\fR(1B), +\fBattributes\fR(5), \fBenviron\fR(5) +.SH DIAGNOSTICS +.sp +.LP +If a \fIvariable\fR is specified and it is not defined in the environment, +\fBprintenv\fR returns an exit status of \fB1\fR. diff --git a/usr/src/man/man1b/ps.1b b/usr/src/man/man1b/ps.1b new file mode 100644 index 0000000000..effa18d220 --- /dev/null +++ b/usr/src/man/man1b/ps.1b @@ -0,0 +1,474 @@ +'\" te +.\" Copyright (c) 2002, Sun Microsystems, Inc. - All Rights Reserved. +.\" Copyright (c), 1980 Regents of the University of California. All rights reserved. The Berkeley software License Agreement specifies the terms and conditions for redistribution. +.TH ps 1B "26 May 2006" "SunOS 5.11" "SunOS/BSD Compatibility Package Commands" +.SH NAME +ps \- display the status of current processes +.SH SYNOPSIS +.LP +.nf +\fB/usr/ucb/ps\fR [\fB-aceglnrSuUvwx\fR] [\fB-t\fR \fIterm\fR] [\fInum\fR] +.fi + +.SH DESCRIPTION +.sp +.LP +The \fBps\fR command displays information about processes. Normally, only those +processes that are running with your effective user \fBID\fR and are attached +to a controlling terminal (see \fBtermio\fR(7I)) are shown. Additional +categories of processes can be added to the display using various options. In +particular, the \fB-a\fR option allows you to include processes that are not +owned by you (that do not have your user \fBID\fR), and the \fB-x\fR option +allows you to include processes without controlling terminals. When you specify +both \fB-a\fR and \fB-x\fR, you get processes owned by anyone, with or without +a controlling terminal. The \fB-r\fR option restricts the list of processes +printed to running and runnable processes. +.sp +.LP +\fBps\fR displays in tabular form the process ID, under \fBPID\fR; the +controlling terminal (if any), under \fBTT\fR; the cpu time used by the process +so far, including both user and system time, under \fBTIME\fR; the state of the +process, under S; and finally, an indication of the \fBCOMMAND\fR that is +running. +.sp +.LP +The state is given by a single letter from the following: +.sp +.ne 2 +.mk +.na +\fB\fBO\fR\fR +.ad +.RS 5n +.rt +Process is running on a processor. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBS\fR\fR +.ad +.RS 5n +.rt +Sleeping. Process is waiting for an event to complete. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBR\fR\fR +.ad +.RS 5n +.rt +Runnable. Process is on run queue. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBZ\fR\fR +.ad +.RS 5n +.rt +Zombie state. Process terminated and parent not waiting. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBT\fR\fR +.ad +.RS 5n +.rt +Traced. Process stopped by a signal because parent is tracing it. +.RE + +.SH OPTIONS +.sp +.LP +The following options must all be combined to form the first argument: +.sp +.ne 2 +.mk +.na +\fB\fB-a\fR\fR +.ad +.RS 11n +.rt +Includes information about processes owned by others. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-c\fR\fR +.ad +.RS 11n +.rt +Displays the command name rather than the command arguments. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-e\fR\fR +.ad +.RS 11n +.rt +Displays the environment as well as the arguments to the command. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-g\fR\fR +.ad +.RS 11n +.rt +Displays all processes. Without this option, \fBps\fR only prints interesting +processes. Processes are deemed to be uninteresting if they are process group +leaders. This normally eliminates top-level command interpreters and processes +waiting for users to login on free terminals. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-l\fR\fR +.ad +.RS 11n +.rt +Displays a long listing, with fields \fBF\fR, \fBPPID\fR, \fBCP\fR, \fBPRI\fR, +\fBNI\fR, \fBSZ\fR, \fBRSS\fR, and \fBWCHAN\fR as described below. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-n\fR\fR +.ad +.RS 11n +.rt +Produces numerical output for some fields. In a user listing, the \fBUSER\fR +field is replaced by a \fBUID\fR field. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-r\fR\fR +.ad +.RS 11n +.rt +Restricts output to running and runnable processes. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-S\fR\fR +.ad +.RS 11n +.rt +Displays accumulated \fBCPU\fR time used by this process and all of its reaped +children. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-t\fR \fIterm\fR\fR +.ad +.RS 11n +.rt +Lists only process data associated with the terminal, \fIterm\fR. Terminal +identifiers may be specified in one of two forms: the device's file name (for +example, \fBtty04\fR or \fBterm/14\fR ) or, if the device's file name starts +with \fBtty\fR, just the digit identifier (for example, \fB04\fR). +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-u\fR\fR +.ad +.RS 11n +.rt +Displays user-oriented output. This includes fields \fBUSER\fR, \fB%CPU\fR, +\fB%MEM\fR, \fBSZ\fR, \fBRSS\fR, and \fBSTART\fR as described below. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-U\fR\fR +.ad +.RS 11n +.rt +Obsolete. This option no longer has any effect. It causes \fBps\fR to exit +without printing the process listing. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-v\fR\fR +.ad +.RS 11n +.rt +Displays a version of the output containing virtual memory. This includes +fields \fBSIZE\fR, \fB%CPU\fR, \fB%MEM\fR, and \fBRSS\fR, described below. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-w\fR\fR +.ad +.RS 11n +.rt +Uses a wide output format, that is, 132 columns rather than 80. If the option +letter is repeated, that is, \fB-ww\fR, this option uses arbitrarily wide +output. This information is used to decide how much of long commands to print. +\fBNote:\fR The wide output option can be viewed only by a superuser or the +user who owns the process. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-x\fR\fR +.ad +.RS 11n +.rt +Includes processes with no controlling terminal. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fInum\fR\fR +.ad +.RS 11n +.rt +A process number may be given, in which case the output is restricted to that +process. This option must be supplied last. +.RE + +.SH DISPLAY FORMATS +.sp +.LP +Fields that are not common to all output formats: +.sp +.ne 2 +.mk +.na +\fB\fBUSER\fR\fR +.ad +.RS 9n +.rt +Name of the owner of the process. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB%CPU\fR\fR +.ad +.RS 9n +.rt +\fBCPU\fR use of the process. This is a decaying average over up to a minute of +previous (real) time. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBNI\fR\fR +.ad +.RS 9n +.rt +Process scheduling increment (see \fBgetpriority\fR(3C) and \fBnice\fR(3UCB)). +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBSIZE\fR\fR +.ad +.RS 9n +.rt +The total size of the process in virtual memory, including all mapped files and +devices, in kilobyte units. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBSZ\fR\fR +.ad +.RS 9n +.rt +Same as \fBSIZE\fR. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBRSS\fR\fR +.ad +.RS 9n +.rt +Real memory (resident set) size of the process, in kilobyte units. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBUID\fR\fR +.ad +.RS 9n +.rt +Numerical user-ID of process owner. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPPID\fR\fR +.ad +.RS 9n +.rt +Numerical \fBID\fR of parent of process. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBCP\fR\fR +.ad +.RS 9n +.rt +Short-term \fBCPU\fR utilization factor (used in scheduling). +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPRI\fR\fR +.ad +.RS 9n +.rt +The priority of the process (higher numbers mean lower priority). +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBSTART\fR\fR +.ad +.RS 9n +.rt +The starting time of the process, given in hours, minutes, and seconds. A +process begun more than 24 hours before the \fBps\fR inquiry is executed is +given in months and days. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBWCHAN\fR\fR +.ad +.RS 9n +.rt +The address of an event for which the process is sleeping (if blank, the +process is running). +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB%MEM\fR\fR +.ad +.RS 9n +.rt +The ratio of the process's resident set size to the physical memory on the +machine, expressed as a percentage. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBF\fR\fR +.ad +.RS 9n +.rt +Flags (hexadecimal and additive) associated with the process. These flags are +available for historical purposes; no meaning should be currently ascribed to +them. +.RE + +.sp +.LP +A process that has exited and has a parent, but has not yet been waited for by +the parent, is marked <\fBdefunct\fR>\|; otherwise, \fBps\fR tries to determine +the command name and arguments given when the process was created by examining +the user block. +.SH FILES +.sp +.LP +\fB/dev/tty*\fR +.sp +.ne 2 +.mk +.na +\fB\fB/etc/passwd\fR\fR +.ad +.RS 15n +.rt +\fBUID\fR information supplier +.RE + +.SH SEE ALSO +.sp +.LP +\fBkill\fR(1), \fBps\fR(1), \fBwhodo\fR(1M), \fBgetpriority\fR(3C), +\fBnice\fR(3UCB), \fBproc\fR(4), \fBattributes\fR(5), \fBtermio\fR(7I) +.SH NOTES +.sp +.LP +Things can change while \fBps\fR is running. The picture \fBps\fR gives is only +a close approximation to the current state. Some data printed for defunct +processes is irrelevant. diff --git a/usr/src/man/man1b/rusage.1b b/usr/src/man/man1b/rusage.1b new file mode 100644 index 0000000000..e83770ede2 --- /dev/null +++ b/usr/src/man/man1b/rusage.1b @@ -0,0 +1,81 @@ +'\" te +.\" Copyright (c) 2003, Sun Microsystems, Inc. +.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. +.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. +.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] +.TH rusage 1B "14 Sep 1992" "SunOS 5.11" "SunOS/BSD Compatibility Package Commands" +.SH NAME +rusage \- print resource usage for a command +.SH SYNOPSIS +.LP +.nf +\fB/usr/ucb/rusage\fR \fIcommand\fR +.fi + +.SH DESCRIPTION +.sp +.LP +The \fBrusage\fR command is similar to \fBtime\fR(1). It runs the given +\fIcommand\fR, which must be specified; that is, \fIcommand\fR is not optional +as it is in the C shell's timing facility. When the command is complete, +\fBrusage\fR displays the real (wall clock), the system \fBCPU,\fR and the user +\fBCPU\fR times which elapsed during execution of the command, plus other +fields in the \fBrusage\fR structure, all on one long line. Times are reported +in seconds and hundredths of a second. +.SH EXAMPLES +.LP +\fBExample 1 \fRThe format of rusage output +.sp +.LP +The example below shows the format of \fBrusage\fR output. + +.sp +.in +2 +.nf +example% \fBrusage wc /usr/share/man/man1/csh (1) +3045 13423 78071 /usr/share/man/man1/csh (1) +2.26 real 0.80 user 0.36 sys 11 pf 38 pr 0 sw 11 rb 0 wb 16 vcx 37 + icx 24 mx 0 ix 1230 id 9 is\fR +example% +.fi +.in -2 +.sp + +.sp +.LP +Each of the fields identified corresponds to an element of the \fBrusage\fR +structure, as described in \fBgetrusage\fR(3C), as follows: + +.sp + +.sp +.TS +tab(); +lw(.69i) lw(1.38i) lw(3.44i) +lw(.69i) lw(1.38i) lw(3.44i) +. +\fBreal\fR\fBelapsed real time\fR +\fBuser\fR\fBru_utime\fR\fBuser time used\fR +\fBsys\fR\fBru_stime\fR\fBsystem time used\fR +\fBpf\fR\fBru_majflt\fR\fBpage faults requiring physical I/O\fR +\fBpr\fR\fBru_minflt\fR\fBpage faults not requiring physical I/O\fR +\fBsw\fR\fBru_nswap\fR\fBswaps\fR +\fBrb\fR\fBru_inblock\fR\fBblock input operations\fR +\fBwb\fR\fBru_oublock\fR\fBblock output operations\fR +\fBvcx\fR\fBru_nvcsw\fR\fBvoluntary context switches\fR +\fBicx\fR\fBru_nivcsw\fR\fBinvoluntary context switches\fR +\fBmx\fR\fBru_maxrss\fR\fBmaximum resident set size\fR +\fBix\fR\fBru_ixrss\fR\fBcurrently 0\fR +\fBid\fR\fBru_idrss\fR\fBintegral resident set size\fR +\fBis\fR\fBru_isrss\fR\fBcurrently 0\fR +.TE + +.SH SEE ALSO +.sp +.LP +\fBcsh\fR(1), \fBtime\fR(1), \fBgetrusage\fR(3C), \fBattributes\fR(5) +.SH BUGS +.sp +.LP +When the command being timed is interrupted, the timing values displayed may be +inaccurate. diff --git a/usr/src/man/man1b/shutdown.1b b/usr/src/man/man1b/shutdown.1b new file mode 100644 index 0000000000..7ee5953d6a --- /dev/null +++ b/usr/src/man/man1b/shutdown.1b @@ -0,0 +1,114 @@ +'\" te +.\" Copyright (c) 1980 Regents of the University of California. All rights reserved. The Berkeley software License Agreement specifies the terms and conditions for redistribution. +.TH shutdown 1B "11 Oct 1994" "SunOS 5.11" "SunOS/BSD Compatibility Package Commands" +.SH NAME +shutdown \- close down the system at a given time +.SH SYNOPSIS +.LP +.nf +\fB/usr/ucb/shutdown\fR [\fB-fhknr\fR] \fItime\fR [\fIwarning-message\fR]... +.fi + +.SH DESCRIPTION +.sp +.LP +\fBshutdown\fR provides an automated procedure to notify users when the system +is to be shut down. \fBtime\fR specifies when \fBshutdown\fR will bring the +system down; it may be the word \fBnow\fR (indicating an immediate shutdown), +or it may specify a future time in one of two formats: \fB+\fR\fInumber\fR and +\fIhour\fR\fB:\fR\fImin.\fR The first form brings the system down in +\fInumber\fR minutes, and the second brings the system down at the time of day +indicated in 24-hour notation. +.sp +.LP +At intervals that get closer as the apocalypse approaches, warning messages are +displayed at terminals of all logged-in users, and of users who have remote +mounts on that machine. +.sp +.LP +At shutdown time a message is written to the system log daemon, +\fBsyslogd\fR(1M), containing the time of shutdown, the instigator of the +shutdown, and the reason. Then a terminate signal is sent to \fBinit\fR, which +brings the system down to single-user mode. +.SH OPTIONS +.sp +.LP +As an alternative to the above procedure, these options can be specified: +.sp +.ne 2 +.mk +.na +\fB\fB-f\fR\fR +.ad +.RS 6n +.rt +Arrange, in the manner of \fBfastboot\fR(1B), that when the system is rebooted, +the file systems will not be checked. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-h\fR\fR +.ad +.RS 6n +.rt +Execute \fBhalt\fR(1M). +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-k\fR\fR +.ad +.RS 6n +.rt +Simulate shutdown of the system. Do not actually shut down the system. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-n\fR\fR +.ad +.RS 6n +.rt +Prevent the normal \fBsync\fR(2) before stopping. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-r\fR\fR +.ad +.RS 6n +.rt +Execute \fBreboot\fR(1M). +.RE + +.SH FILES +.sp +.ne 2 +.mk +.na +\fB\fB/etc/rmtab\fR\fR +.ad +.RS 14n +.rt +remote mounted file system table +.RE + +.SH SEE ALSO +.sp +.LP +\fBfastboot\fR(1B), \fBlogin\fR(1), \fBhalt\fR(1M), \fBreboot\fR(1M), +\fBsyslogd\fR(1M), \fBsync\fR(2), \fBrmtab\fR(4), \fBattributes\fR(5) +.SH NOTES +.sp +.LP +Only allows you to bring the system down between \fBnow\fR and 23:59 if you use +the absolute time for shutdown. diff --git a/usr/src/man/man1b/stty.1b b/usr/src/man/man1b/stty.1b new file mode 100644 index 0000000000..95b4958810 --- /dev/null +++ b/usr/src/man/man1b/stty.1b @@ -0,0 +1,1466 @@ +'\" te +.\" Copyright (c) 2005, Sun Microsystems, Inc. +.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. +.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. +.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] +.TH stty 1B "14 Feb 2005" "SunOS 5.11" "SunOS/BSD Compatibility Package Commands" +.SH NAME +stty \- set the options for a terminal +.SH SYNOPSIS +.LP +.nf +\fB/usr/ucb/stty\fR [\fB-a\fR] [\fB-g\fR] [\fB-h\fR] [\fImodes\fR] +.fi + +.SH DESCRIPTION +.sp +.LP +\fBstty\fR sets certain terminal I/O options for the device that is the current +standard output. Without arguments, \fBstty\fR reports the settings of certain +options. +.SH OPTIONS +.sp +.LP +In this report, if a character is preceded by a caret (\fB^\fR), then the value +of that option is the corresponding CTRL character (for example, \fB^h\fR is +CTRL-h. In this case, recall that CTRL-h is the same as the BACKSPACE key.) The +sequence \fB^@\fR means that an option has a null value. +.sp +.ne 2 +.mk +.na +\fB\fB-a\fR\fR +.ad +.RS 6n +.rt +Reports all of the option settings. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-g\fR\fR +.ad +.RS 6n +.rt +Reports current settings in a form that can be used as an argument to another +\fBstty\fR command. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-h\fR\fR +.ad +.RS 6n +.rt +Reports all the option settings with the control characters in an easy to read +column format. +.RE + +.sp +.LP +Options in the last group are implemented using options in the previous groups. +Many combinations of options make no sense, but no sanity checking is +performed. Hardware flow control and clock modes options might not be supported +by all hardware interfaces. The options are selected from the following: +.SS "Special Requests" +.sp +.ne 2 +.mk +.na +\fB\fBall\fR\fR +.ad +.RS 14n +.rt +Reports the same option settings as \fBstty\fR without arguments, but with the +control characters in column format. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBeverything\fR\fR +.ad +.RS 14n +.rt +Everything \fBstty\fR knows about is printed. Same as \fB-h\fR option. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBspeed\fR\fR +.ad +.RS 14n +.rt +The terminal speed alone is reported on the standard output. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBsize\fR\fR +.ad +.RS 14n +.rt +The terminal (window) sizes are printed on the standard output, first rows and +then columns. This option is only appropriate if currently running a window +system. +.sp +\fBsize\fR and \fBspeed\fR always report on the settings of \fB/dev/tty\fR, and +always report the settings to the standard output. +.RE + +.SS "Control Modes" +.sp +.ne 2 +.mk +.na +\fB\fBparenb\fR (\fB-parenb\fR)\fR +.ad +.sp .6 +.RS 4n +Enable (disable) parity generation and detection. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBparext\fR (\fB\fR\fB-parext\fR\fB)\fR\fR +.ad +.sp .6 +.RS 4n +Enable (disable) extended parity generation and detection for mark and space +parity. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBparodd\fR (\fB-parodd\fR)\fR +.ad +.sp .6 +.RS 4n +Select odd (even) parity, or mark (space) parity if \fBparext\fR is enabled. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBcs5 cs6 cs7 cs8\fR\fR +.ad +.sp .6 +.RS 4n +Select character size (see \fBtermio\fR(7I)). +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB0\fR\fR +.ad +.sp .6 +.RS 4n +Hang up line immediately. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB110 300 600 1200 1800 2400 4800 9600 19200 exta 38400 extb\fR\fR +.ad +.sp .6 +.RS 4n +Set terminal baud rate to the number given, if possible. (All speeds are not +supported by all hardware interfaces.) +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBispeed 0 110 300 600 1200 1800 2400 4800 9600 19200 exta 38400 extb\fR\fR +.ad +.sp .6 +.RS 4n +Set terminal input baud rate to the number given, if possible. (Not all +hardware supports split baud rates.) If the input baud rate is set to zero, +the input baud rate is specified by the value of the output baud rate. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBospeed 0 110 300 600 1200 1800 2400 4800 9600 19200 exta 38400 extb\fR\fR +.ad +.sp .6 +.RS 4n +Set terminal output baud rate to the number given, if possible. (Not all +hardware supports split baud rates.) If the baud rate is set to zero, the +line is hung up immediately. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBhupcl\fR (\fB-hupcl\fR)\fR +.ad +.sp .6 +.RS 4n +Hang up (do not hang up) connection on last close. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBhup\fR (\fB-hup\fR)\fR +.ad +.sp .6 +.RS 4n +Same as \fBhupcl\fR (\fB-hupcl\fR). +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBcstopb\fR (\fB-cstopb\fR)\fR +.ad +.sp .6 +.RS 4n +Use two (one) stop bits per character. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBcread\fR (\fB-cread\fR)\fR +.ad +.sp .6 +.RS 4n +Enable (disable) the receiver. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBclocal\fR (\fB-clocal\fR)\fR +.ad +.sp .6 +.RS 4n +Assume a line without (with) modem control. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBcrtscts\fR (\fB-crtscts\fR)\fR +.ad +.sp .6 +.RS 4n +Enable hardware flow control. Raise the RTS (Request to Send) modem control +line. Suspends output until the \fBCTS\fR (Clear to Send) line is raised. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBloblk\fR (\fB-loblk\fR)\fR +.ad +.sp .6 +.RS 4n +Block (do not block) output from a non-current layer. +.RE + +.SS "Input Modes" +.sp +.ne 2 +.mk +.na +\fB\fBignbrk\fR (\fB-ignbrk\fR)\fR +.ad +.RS 22n +.rt +Ignore (do not ignore) break on input. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBbrkint\fR (\fB-brkint\fR)\fR +.ad +.RS 22n +.rt +Signal (do not signal) INTR on break. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBignpar\fR (\fB-ignpar\fR)\fR +.ad +.RS 22n +.rt +Ignore (do not ignore) parity errors. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBparmrk\fR (\fB-parmrk\fR)\fR +.ad +.RS 22n +.rt +Mark (do not mark) parity errors (see \fBtermio\fR(7I)). +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBinpck\fR (\fB-inpck\fR)\fR +.ad +.RS 22n +.rt +Enable (disable) input parity checking. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBistrip\fR (\fB-istrip\fR)\fR +.ad +.RS 22n +.rt +Strip (do not strip) input characters to seven bits. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBinlcr\fR (\fB-inlcr\fR)\fR +.ad +.RS 22n +.rt +Map (do not map) NL to CR on input. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBigncr\fR (\fB-igncr\fR)\fR +.ad +.RS 22n +.rt +Ignore (do not ignore) CR on input. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBicrnl\fR (\fB-icrnl\fR)\fR +.ad +.RS 22n +.rt +Map (do not map) CR to NL on input. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBiuclc\fR (\fB-iuclc\fR)\fR +.ad +.RS 22n +.rt +Map (do not map) upper-case alphabetics to lower case on input. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBixon\fR (\fB-ixon\fR)\fR +.ad +.RS 22n +.rt +Enable (disable) START/STOP output control. Output is stopped by sending an +STOP and started by sending an START. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBixany\fR (\fB-ixany\fR)\fR +.ad +.RS 22n +.rt +Allow any character (only START) to restart output. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBdecctlq\fR (\fB-decctlq\fR)\fR +.ad +.RS 22n +.rt +Same as \fB-ixany\fR. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBixoff\fR (\fB-ixoff\fR)\fR +.ad +.RS 22n +.rt +Request that the system send (not send) START/STOP characters when the input +queue is nearly empty/full. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBtandem\fR (\fB\fR\fB-tandem\fR\fB)\fR\fR +.ad +.RS 22n +.rt +Same as \fBixoff\fR. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBimaxbel\fR (\fB\fR\fB-imaxbel\fR\fB)\fR\fR +.ad +.RS 22n +.rt +Echo (do not echo) \fBBEL\fR when the input line is too long. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBiexten\fR (\fB\fR\fB-iexten\fR\fB)\fR\fR +.ad +.RS 22n +.rt +Enable (disable) extended (implementation-defined) functions for input data. +.RE + +.SS "Output Modes" +.sp +.ne 2 +.mk +.na +\fB\fBopost\fR (\fB-opost\fR)\fR +.ad +.RS 23n +.rt +Post-process output (do not post-process output; ignore all other output +modes). +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBolcuc\fR (\fB-olcuc\fR)\fR +.ad +.RS 23n +.rt +Map (do not map) lower-case alphabetics to upper case on output. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBonlcr\fR (\fB-onlcr\fR)\fR +.ad +.RS 23n +.rt +Map (do not map) NL to CR-NL on output. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBocrnl\fR (\fB-ocrnl\fR)\fR +.ad +.RS 23n +.rt +Map (do not map) CR to NL on output. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBonocr\fR (\fB-onocr\fR)\fR +.ad +.RS 23n +.rt +Do not (do) output CRs at column zero. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBonlret\fR (\fB-onlret\fR)\fR +.ad +.RS 23n +.rt +On the terminal NL performs (does not perform) the CR function. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBofill\fR (\fB-ofill\fR)\fR +.ad +.RS 23n +.rt +Use fill characters (use timing) for delays. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBofdel\fR (\fB-ofdel\fR)\fR +.ad +.RS 23n +.rt +Fill characters are DELs (NULs). +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBcr0 cr1 cr2 cr3\fR\fR +.ad +.RS 23n +.rt +Select style of delay for carriage returns (see \fBtermio\fR(7I)). +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBnl0 nl1\fR\fR +.ad +.RS 23n +.rt +Select style of delay for line-feeds (see \fBtermio\fR(7I)). +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBtab0 tab1 tab2 tab3\fR\fR +.ad +.RS 23n +.rt +Select style of delay for horizontal tabs (see \fBtermio\fR(7I)). +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBbs0 bs1\fR\fR +.ad +.RS 23n +.rt +Select style of delay for backspaces (see \fBtermio\fR(7I)). +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBff0 ff1\fR\fR +.ad +.RS 23n +.rt +Select style of delay for form-feeds (see \fBtermio\fR(7I)). +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBvt0 vt1\fR\fR +.ad +.RS 23n +.rt +Select style of delay for vertical tabs (see \fBtermio\fR(7I)). +.RE + +.SS "Local Modes" +.sp +.ne 2 +.mk +.na +\fB\fBisig\fR (\fB-isig\fR)\fR +.ad +.RS 24n +.rt +Enable (disable) the checking of characters against the special control +characters INTR, QUIT, and SWTCH. For information on \fBSWTCH\fR, see +\fBNOTES\fR. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBicanon\fR (\fB-icanon\fR)\fR +.ad +.RS 24n +.rt +Enable (disable) canonical input (ERASE and KILL processing). Does not set MIN +or TIME. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBcbreak\fR (\fB-cbreak\fR)\fR +.ad +.RS 24n +.rt +Equivalent to \fB-icanon min 1 time 0\fR. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBxcase\fR (\fB-xcase\fR)\fR +.ad +.RS 24n +.rt +Canonical (unprocessed) upper/lower-case presentation. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBecho\fR (\fB-echo\fR)\fR +.ad +.RS 24n +.rt +Echo back (do not echo back) every character typed. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBechoe\fR (\fB-echoe\fR)\fR +.ad +.RS 24n +.rt +Echo (do not echo) ERASE character as a backspace-space-backspace string. +Note: This mode erases the ERASEed character on many CRT terminals; however, +it does \fInot\fR keep track of column position and, as a result, can be +confusing on escaped characters, tabs, and backspaces. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBcrterase\fR (\fB-crterase\fR)\fR +.ad +.RS 24n +.rt +Same as \fBechoe\fR. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBechok\fR (\fB-echok\fR)\fR +.ad +.RS 24n +.rt +Echo (do not echo) NL after KILL character. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBlfkc\fR (\fB-lfkc\fR)\fR +.ad +.RS 24n +.rt +The same as \fBechok\fR (\fB-echok\fR); obsolete. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBechonl\fR (\fB-echonl\fR)\fR +.ad +.RS 24n +.rt +Echo (do not echo) NL. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBnoflsh\fR (\fB-noflsh\fR)\fR +.ad +.RS 24n +.rt +Disable (enable) flush after INTR, QUIT, or SWTCH. For information on +\fBSWTCH\fR, see \fBNOTES\fR. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBstwrap\fR (\fB-stwrap\fR)\fR +.ad +.RS 24n +.rt +Disable (enable) truncation of lines longer than 79 characters on a synchronous +line. (Does not apply to the 3B2.) +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBtostop\fR (\fB-tostop\fR)\fR +.ad +.RS 24n +.rt +Send (do not send) \fBSIGTTOU\fR for background processes. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBechoctl\fR (\fB\fR\fB-echoctl\fR\fB)\fR\fR +.ad +.RS 24n +.rt +Echo (do not echo) control characters as ^\fIchar\fR, delete as ^? +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBctlecho\fR (\fB\fR\fB-ctlecho\fR\fB)\fR\fR +.ad +.RS 24n +.rt +Same as \fBechoctl\fR. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBechoprt\fR (\fB\fR\fB-echoprt\fR\fB)\fR\fR +.ad +.RS 24n +.rt +Echo (do not echo) erase character as character is ``erased''. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBprterase\fR (\fB-prterase\fR)\fR +.ad +.RS 24n +.rt +Same as \fBechoprt\fR. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBechoke\fR (\fB\fR\fB-echoke\fR\fB)\fR\fR +.ad +.RS 24n +.rt +BS-SP-BS erase (do not BS-SP-BS erase) entire line on line kill. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBcrtkill\fR (\fB-crtkill\fR)\fR +.ad +.RS 24n +.rt +Same as \fBechoke\fR. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBflusho\fR (\fB\fR\fB-flusho\fR\fB)\fR\fR +.ad +.RS 24n +.rt +Output is (is not) being flushed. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBpendin\fR (\fB\fR\fB-pendin\fR\fB)\fR\fR +.ad +.RS 24n +.rt +Retype (do not retype) pending input at next read or input character. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBstflush\fR (\fB-stflush\fR)\fR +.ad +.RS 24n +.rt +Enable (disable) flush on a synchronous line after every \fBwrite\fR(2). (Does +not apply to the 3B2.) +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBstappl\fR (\fB-stappl\fR)\fR +.ad +.RS 24n +.rt +Use application mode (use line mode) on a synchronous line. (Does not apply to +the 3B2.) +.RE + +.SS "Hardware Flow Control Modes" +.sp +.ne 2 +.mk +.na +\fB\fBrtsxoff\fR (\fB-rtsxoff\fR)\fR +.ad +.RS 24n +.rt +Enable (disable) RTS hardware flow control on input. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBctsxon\fR (\fB-ctsxon\fR)\fR +.ad +.RS 24n +.rt +Enable (disable) CTS hardware flow control on output. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBdterxoff\fR (\fB-dterxoff\fR)\fR +.ad +.RS 24n +.rt +Enable (disable) DTER hardware flow control on input. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBrlsdxon\fR (\fB-rlsdxon\fR)\fR +.ad +.RS 24n +.rt +Enable (disable) RLSD hardware flow control on output. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBisxoff\fR (\fB-isxoff\fR)\fR +.ad +.RS 24n +.rt +Enable (disable) isochronous hardware flow control on input. +.RE + +.SS "Clock Modes" +.sp +.ne 2 +.mk +.na +\fB\fBxcibrg\fR\fR +.ad +.RS 12n +.rt +Get transmit clock from internal baud rate generator. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBxctset\fR\fR +.ad +.RS 12n +.rt +Get the transmit clock from transmitter signal element timing (DCE source) +lead, CCITT V.24 circuit 114, EIA-232-D pin 15. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBxcrset\fR\fR +.ad +.RS 12n +.rt +Get transmit clock from receiver signal element timing (DCE source) lead, CCITT +V.24 circuit 115, EIA-232-D pin 17. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBrcibrg\fR\fR +.ad +.RS 12n +.rt +Get receive clock from internal baud rate generator. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBrctset\fR\fR +.ad +.RS 12n +.rt +Get receive clock from transmitter signal element timing (DCE source) lead, +CCITT V.24 circuit 114, EIA-232-D pin 15. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBrcrset\fR\fR +.ad +.RS 12n +.rt +Get receive clock from receiver signal element timing (DCE source) lead, CCITT +V.24 circuit 115, EIA-232-D pin 17. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBtsetcoff\fR\fR +.ad +.RS 12n +.rt +Transmitter signal element timing clock not provided. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBtsetcrc\fR\fR +.ad +.RS 12n +.rt +Output receive clock on transmitter signal element timing (DTE source) lead, +CCITT V.24 circuit 113, EIA-232-D pin 24, clock source. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBtsetcxc\fR\fR +.ad +.RS 12n +.rt +Output transmit clock on transmitter signal element timing (DTE source) lead, +CCITT V.24 circuit 113, EIA-232-D pin 24, clock source. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBrsetcoff\fR\fR +.ad +.RS 12n +.rt +Receiver signal element timing clock not provided. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBrsetcrc\fR\fR +.ad +.RS 12n +.rt +Output receive clock on receiver signal element timing (DTE source) lead, CCITT +V.24 circuit 128, no EIA-232-D pin, clock source. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBrsetcxc\fR\fR +.ad +.RS 12n +.rt +Output transmit clock on receiver signal element timing (DTE source) lead, +CCITT V.24 circuit 128, no EIA-232-D pin, clock source. +.RE + +.SS "Control Assignments" +.sp +.ne 2 +.mk +.na +\fB\fIcontrol-character c\fR\fR +.ad +.RS 23n +.rt +Set \fIcontrol-character\fR to \fIc\fR, where \fIcontrol-character\fR is +\fBintr\fR, \fBquit\fR, \fBerase\fR, \fBkill\fR, \fBeof\fR, \fBeol\fR, +\fBeol2\fR, \fBswtch\fR, \fBstart\fR, \fBstop\fR, \fBsusp\fR, \fBdsusp\fR, +\fBrprnt\fR, \fBflush\fR, \fBwerase\fR, \fBlnext\fR \fBmin\fR, \fBctab\fR, +\fBtime\fR, or \fBbrk\fR) (\fBctab\fR is used with \fB-stappl\fR; \fBmin\fR and +\fBtime\fR are used with \fB-icanon\fR; see \fBtermio\fR(7I)). If \fIc\fR is +preceded by an (escaped from the shell) caret (\fB^\fR), then the value used is +the corresponding CTRL character (for example, ``^d'' is a Control-d). ``^?'' +is interpreted as DEL and ``\fB^\(mi\fR'' is interpreted as undefined. For +information on \fBSWTCH\fR, see \fBNOTES\fR. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBline\fR\fI i\fR\fR +.ad +.RS 23n +.rt +Set line discipline to \fIi\fR (0 < \fIi\fR < 127 ). +.RE + +.SS "Combination Modes" +.sp +.ne 2 +.mk +.na +\fB\fBevenp\fR or \fBparity\fR\fR +.ad +.RS 24n +.rt +Enable \fBparenb\fR and \fBcs7\fR. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-evenp\fR, or \fB-parity\fR\fR +.ad +.RS 24n +.rt +Disable \fBparenb\fR, and set \fBcs8\fR. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBeven\fR (\fB-even\fR)\fR +.ad +.RS 24n +.rt +Same as \fBevenp\fR (\fB-evenp\fR). +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBoddp\fR\fR +.ad +.RS 24n +.rt +Enable \fBparenb\fR, \fBcs7\fR, and \fBparodd\fR. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-oddp\fR\fR +.ad +.RS 24n +.rt +Disable \fBparenb\fR and \fBparodd\fR, and set \fBcs8\fR. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBodd\fR (\fB-odd\fR)\fR +.ad +.RS 24n +.rt +Same as \fBoddp\fR (\fB-oddp\fR). +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBspacep\fR\fR +.ad +.RS 24n +.rt +Enable \fBparenb\fR, \fBcs7\fR, and \fBparext\fR. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-spacep\fR\fR +.ad +.RS 24n +.rt +Disable \fBparenb\fR and \fBparext\fR, and set \fBcs8\fR. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBmarkp\fR\fR +.ad +.RS 24n +.rt +Enable \fBparenb\fR, \fBcs7\fR, \fBparodd\fR, and \fBparext\fR. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-markp\fR\fR +.ad +.RS 24n +.rt +Disable \fBparenb\fR, \fBparodd\fR, and \fBparext\fR, and set \fBcs8\fR. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBraw\fR (\fB-raw\fR or \fBcooked\fR)\fR +.ad +.RS 24n +.rt +Enable (disable) raw input and output (no ERASE, KILL, INTR, QUIT, SWTCH, EOT, +or output post processing). For information on \fBSWTCH\fR, see \fBNOTES\fR. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBnl\fR (\fB-nl\fR)\fR +.ad +.RS 24n +.rt +Unset (set) \fBicrnl\fR, \fBonlcr\fR. In addition \fB-nl\fR unsets \fBinlcr\fR, +\fBigncr\fR, \fBocrnl\fR, and \fBonlret\fR. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBlcase\fR (\fB-lcase\fR)\fR +.ad +.RS 24n +.rt +Set (unset) \fBxcase\fR, \fBiuclc\fR, and \fBolcuc\fR. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBLCASE\fR (\fB-LCASE\fR)\fR +.ad +.RS 24n +.rt +Same as \fBlcase\fR (\fB-lcase\fR). +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBtabs\fR (\fB-tabs\fR or \fBtab3\fR)\fR +.ad +.RS 24n +.rt +Preserve (expand to spaces) tabs when printing. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBek\fR\fR +.ad +.RS 24n +.rt +Reset ERASE and KILL characters back to normal DEL and CTRL-u, respectively. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBsane\fR\fR +.ad +.RS 24n +.rt +Reset all modes to some reasonable values. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBterm\fR\fR +.ad +.RS 24n +.rt +Set all modes suitable for the terminal type \fIterm\fR, where \fIterm\fR is +one of \fBtty33\fR, \fBtty37\fR, \fBvt05\fR, \fBtn300\fR, \fBti700\fR, or +\fBtek\fR. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBasync\fR\fR +.ad +.RS 24n +.rt +Set normal asynchronous communications where clock settings are \fBxcibrg\fR, +\fBrcibrg\fR, \fBtsetcoff\fR and \fBrsetcoff\fR. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBlitout (\fR\fB-litout\fR\fB)\fR\fR +.ad +.RS 24n +.rt +Disable (enable) \fBparenb\fR, \fBistrip\fR, and \fBopost\fR, and set \fBcs8\fR +(\fBcs7\fR). +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBpass8 (\fR\fB-pass8\fR\fB)\fR\fR +.ad +.RS 24n +.rt +Disable (enable) \fBparenb\fR and \fBistrip\fR, and set \fBcs8 \fR (\fBcs7\fR). +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBcrt\fR\fR +.ad +.RS 24n +.rt +Set options for a \fBCRT\fR (\fBechoe\fR, \fBechoctl\fR, and, if >= 1200 baud, +\fBechoke\fR.) +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBdec\fR\fR +.ad +.RS 24n +.rt +Set all modes suitable for Digital Equipment Corp. operating systems users +ERASE, KILL, and INTR characters to \fB^?\fR, \fB^U\fR, and \fB^C\fR, +\fBdecctlq\fR, and \fBcrt\fR.) +.RE + +.SS "Window Size" +.sp +.ne 2 +.mk +.na +\fB\fBrows\fR\fIn\fR\fR +.ad +.RS 12n +.rt +Set window size to \fIn\fR \fIrows\fR. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBcolumns\fR\fIn\fR\fR +.ad +.RS 12n +.rt +Set window size to \fIn\fR \fIcolumns\fR. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBcols\fR\fIn\fR\fR +.ad +.RS 12n +.rt +An alias for \fBcolumns\fR\fI n\fR. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBypixels\fR\fIn\fR\fR +.ad +.RS 12n +.rt +Set vertical window size to \fIn\fR \fIpixels\fR. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBxpixels\fR\fIn\fR\fR +.ad +.RS 12n +.rt +Set horizontal window size to \fIn\fR \fIpixels\fR. +.RE + +.SH SEE ALSO +.sp +.LP +\fBtabs\fR(1), \fBioctl\fR(2), \fBattributes\fR(5), \fBtermio\fR(7I), +\fBtermiox\fR(7I) +.SH NOTES +.sp +.LP +Solaris does not support any of the actions implied by \fBswtch\fR, which was +used by the \fBsxt\fR driver on System V release 4. Solaris allows the +\fBswtch\fR value to be set, and prints it out if set, but it does not perform +the \fBswtch\fR action. +.sp +.LP +The job switch functionality on Solaris is actually handled by job control. +\fBsusp\fR is the correct setting for this. diff --git a/usr/src/man/man1b/sum.1b b/usr/src/man/man1b/sum.1b new file mode 100644 index 0000000000..172630d888 --- /dev/null +++ b/usr/src/man/man1b/sum.1b @@ -0,0 +1,45 @@ +'\" te +.\" Copyright (c) 1996, Sun Microsystems, Inc. All Rights Reserved +.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. +.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. +.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] +.TH sum 1B "8 Nov 1995" "SunOS 5.11" "SunOS/BSD Compatibility Package Commands" +.SH NAME +sum \- calculate a checksum for a file +.SH SYNOPSIS +.LP +.nf +\fB/usr/ucb/sum\fR \fIfile\fR... +.fi + +.SH DESCRIPTION +.sp +.LP +\fBsum\fR calculates and displays a 16-bit checksum for the named file and +displays the size of the file in kilobytes. It is typically used to look for +bad spots, or to validate a file communicated over some transmission line. The +checksum is calculated by an algorithm which may yield different results on +machines with 16-bit \fBint\fRs and machines with 32-bit \fBint\fRs, so it +cannot always be used to validate that a file has been transferred between +machines with different-sized \fBint\fRs. +.SH USAGE +.sp +.LP +See \fBlargefile\fR(5) for the description of the behavior of \fBsum\fR when +encountering files greater than or equal to 2 Gbyte ( 2^31 bytes). +.SH SEE ALSO +.sp +.LP +\fBsum\fR(1), \fBwc\fR(1), \fBattributes\fR(5), \fBlargefile\fR(5) +.SH DIAGNOSTICS +.sp +.LP +\fBRead error\fR is indistinguishable from \fBEOF\fR on most devices; check the +block count. +.SH NOTES +.sp +.LP +\fBsum\fR and \fB/usr/bin/sum\fR (see \fBsum\fR(1)) return different checksums. +.sp +.LP +This utility is obsolete. diff --git a/usr/src/man/man1b/test.1b b/usr/src/man/man1b/test.1b new file mode 100644 index 0000000000..168981b9e0 --- /dev/null +++ b/usr/src/man/man1b/test.1b @@ -0,0 +1,330 @@ +'\" te +.\" Copyright (c) 1996 Sun Microsystems, Inc - All Rights Reserved. +.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. +.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. +.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] +.TH test 1B "1 Apr 1996" "SunOS 5.11" "SunOS/BSD Compatibility Package Commands" +.SH NAME +test \- condition evaluation command +.SH SYNOPSIS +.LP +.nf +\fB/usr/ucb/test\fR \fIexpression\fR +.fi + +.LP +.nf + \fIexpression\fR +.fi + +.SH DESCRIPTION +.sp +.LP +\fBtest\fR evaluates the expression \fIexpression\fR and, if its value is true, +sets \fB0\fR (true) exit status; otherwise, a non-zero (false) exit status is +set. \fBtest\fR also sets a non-zero exit status if there are no arguments. +When permissions are tested, the effective user \fBID\fR of the process is +used. +.sp +.LP +All operators, flags, and brackets (brackets used as shown in the second +\fBSYNOPSIS\fR line) must be separate arguments to the \fBtest\fR command; +normally these items are separated by spaces. +.SH USAGE +.SS "Primitives" +.sp +.LP +The following primitives are used to construct \fIexpression\fR: +.sp +.ne 2 +.mk +.na +\fB\fB-r\fR \fIfilename\fR\fR +.ad +.RS 16n +.rt +True if \fIfilename\fR exists and is readable. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-w\fR \fIfilename\fR\fR +.ad +.RS 16n +.rt +True if \fIfilename\fR exists and is writable. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-x\fR \fIfilename\fR\fR +.ad +.RS 16n +.rt +True if \fIfilename\fR exists and is executable. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-f\fR \fIfilename\fR\fR +.ad +.RS 16n +.rt +True if \fIfilename\fR exists and is a regular file. Alternatively, if +\fB/usr/bin/sh\fR users specify \fB/usr/ucb\fR before \fB/usr/bin\fR in their +\fBPATH\fR environment variable, then \fBtest\fR will return true if +\fIfilename\fR exists and is (\fBnot\(mia\(midirectory\fR). This is also the +default for \fB/usr/bin/csh\fR users. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-d\fR \fIfilename\fR\fR +.ad +.RS 16n +.rt +True if \fIfilename\fR exists and is a directory. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-c\fR \fIfilename\fR\fR +.ad +.RS 16n +.rt +True if \fIfilename\fR exists and is a character special file. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-b\fR \fIfilename\fR\fR +.ad +.RS 16n +.rt +True if \fIfilename\fR exists and is a block special file. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-p\fR \fIfilename\fR\fR +.ad +.RS 16n +.rt +True if \fIfilename\fR exists and is a named pipe (fifo). +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-u\fR \fIfilename\fR\fR +.ad +.RS 16n +.rt +True if \fIfilename\fR exists and its set-user- \fBID\fR bit is set. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-g\fR \fIfilename\fR\fR +.ad +.RS 16n +.rt +True if \fIfilename\fR exists and its set-group- \fBID\fR bit is set. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-k\fR \fIfilename\fR\fR +.ad +.RS 16n +.rt +True if \fIfilename\fR exists and its sticky bit is set. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-s\fR \fIfilename\fR\fR +.ad +.RS 16n +.rt +True if \fIfilename\fR exists and has a size greater than zero. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-t\fR[ \fIfildes\fR ]\fR +.ad +.RS 16n +.rt +True if the open file whose file descriptor number is \fIfildes\fR (1 by +default) is associated with a terminal device. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-z\fR \fIs1\fR\fR +.ad +.RS 16n +.rt +True if the length of string \fIs1\fR is zero. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-n\fR \fIs1\fR\fR +.ad +.RS 16n +.rt +True if the length of the string \fIs1\fR is non-zero. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fIs1\fR\fB = \fR\fIs2\fR\fR +.ad +.RS 16n +.rt +True if strings \fIs1\fR and \fIs2\fR are identical. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fIs1\fR\fB != \fR\fIs2\fR\fR +.ad +.RS 16n +.rt +True if strings \fIs1\fR and \fIs2\fR are \fInot\fR identical. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fIs1\fR\fR +.ad +.RS 16n +.rt +True if \fIs1\fR is \fInot\fR the null string. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fIn1\fR\fB \(mieq \fR\fIn2\fR\fR +.ad +.RS 16n +.rt +True if the integers \fIn1\fR and \fIn2\fR are algebraically equal. Any of the +comparisons \fB\(mine\fR, \fB\(migt\fR, \fB\(mige\fR, \fB\(milt\fR, and +\fB\(mile\fR may be used in place of \fB\(mieq\fR\&. +.RE + +.SS "Operators" +.sp +.LP +These primaries may be combined with the following operators: +.sp +.ne 2 +.mk +.na +\fB\fB!\fR\fR +.ad +.RS 16n +.rt +Unary negation operator. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-a\fR\fR +.ad +.RS 16n +.rt +Binary \fIand\fR operator. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-o\fR\fR +.ad +.RS 16n +.rt +Binary \fIor\fR operator (\fB-a\fR has higher precedence than \fB-o\fR). +.RE + +.sp +.ne 2 +.mk +.na +\fB(\fIexpression\fR)\fR +.ad +.RS 16n +.rt +Parentheses for grouping. Notice also that parentheses are meaningful to the +shell and, therefore, must be quoted. +.RE + +.SH SEE ALSO +.sp +.LP +\fBfind\fR(1), \fBsh\fR(1), \fBattributes\fR(5) +.SH NOTES +.sp +.LP +The \fBnot\(mia\(midirectory\fR alternative to the \fB-f\fR option is a +transition aid for \fBBSD\fR applications and may not be supported in future +releases. +.sp +.LP +If you test a file you own (the \fB-r\fR \fB,\fR \fB-w\fR \fB,\fR or \fB-x\fR +tests), but the permission tested does not have the \fIowner\fR bit set, a +non-zero (false) exit status will be returned even though the file may have the +\fIgroup\fR or \fIother\fR bit set for that permission. The correct exit status +will be set if you are super-user. +.sp +.LP +The \fB=\fR and \fB!=\fR operators have a higher precedence than the \fB-r\fR +through \fB-n\fR operators, and \fB=\fR and \fB!=\fR always expect arguments; +therefore, \fB=\fR and \fB!=\fR cannot be used with the \fB-r\fR through +\fB-n\fR operators. +.sp +.LP +If more than one argument follows the \fB-r\fR through \fB-n\fR operators, only +the first argument is examined; the others are ignored, unless a \fB-a\fR or a +\fB-o\fR is the second argument. diff --git a/usr/src/man/man1b/touch.1b b/usr/src/man/man1b/touch.1b new file mode 100644 index 0000000000..be3cec3897 --- /dev/null +++ b/usr/src/man/man1b/touch.1b @@ -0,0 +1,103 @@ +'\" te +.\" Copyright (c) 1996, Sun Microsystems, Inc. All Rights Reserved +.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. +.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. +.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] +.TH touch 1B "26 Oct 1995" "SunOS 5.11" "SunOS/BSD Compatibility Package Commands" +.SH NAME +touch \- change file access and modification times +.SH SYNOPSIS +.LP +.nf +\fB/usr/ucb/touch\fR [\fB-acfm\fR] \fIfile\fR... +.fi + +.SH DESCRIPTION +.sp +.LP +\fBtouch\fR sets the access and modification times of each file to the current +time. \fBfile\fR is created if it does not already exist. +.SH OPTIONS +.sp +.ne 2 +.mk +.na +\fB\fB-a\fR\fR +.ad +.RS 6n +.rt +Change the access time of \fBfile\fR. Do not change the modification time +unless \fB-m\fR is also specified. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-c\fR\fR +.ad +.RS 6n +.rt +Do not create \fBfile\fR if it does not exist. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-f\fR\fR +.ad +.RS 6n +.rt +Attempt to force the touch in spite of read and write permissions on +\fBfile\fR. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-m\fR\fR +.ad +.RS 6n +.rt +Change the modification time of \fBfile\fR. Do not change the access time +unless \fB-a\fR is also specified. +.RE + +.SH USAGE +.sp +.LP +See \fBlargefile\fR(5) for the description of the behavior of \fBtouch\fR when +encountering files greater than or equal to 2 Gbyte ( 2^31 bytes). +.SH EXIT STATUS +.sp +.LP +The following exit values are returned: +.sp +.ne 2 +.mk +.na +\fB\fB0\fR\fR +.ad +.RS 6n +.rt +\fBtouch\fR executed successfully and all requested changes were made. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB>0\fR\fR +.ad +.RS 6n +.rt +An error occurred. \fBtouch\fR returns the number of files for which the times +could not be successfully modified. +.RE + +.SH SEE ALSO +.sp +.LP +\fBtouch\fR(1), \fBattributes\fR(5), \fBlargefile\fR(5) diff --git a/usr/src/man/man1b/tset.1b b/usr/src/man/man1b/tset.1b new file mode 100644 index 0000000000..5654a655b4 --- /dev/null +++ b/usr/src/man/man1b/tset.1b @@ -0,0 +1,506 @@ +'\" te +.\" Copyright (c) 1988, 1995 Sun Microsystems, Inc. All Rights Reserved +.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. +.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. +.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] +.TH tset 1B "15 Feb 1995" "SunOS 5.11" "SunOS/BSD Compatibility Package Commands" +.SH NAME +tset, reset \- establish or restore terminal characteristics +.SH SYNOPSIS +.LP +.nf +\fBtset\fR [\fB-InQrs\fR] [\fB-e\fR\fIc\fR] [\fB-k\fR\fIc\fR] + [\fB-m\fR [\fIport-ID\fR [\fIbaudrate\fR] : \fItype\fR]...] [\fItype\fR] +.fi + +.LP +.nf +\fBreset\fR [\fB-\fR] [\fB-e\fR\fIc\fR] [\fB-I\fR] [\fB-k\fR\fIc\fR] + [\fB-n\fR] [\fB-Q\fR] [\fB-r\fR] [\fB-s\fR] + [\fB-m\fR [\fIindent\fR] [\fItest\fR \fIbaudrate\fR] : \fItype\fR]... [\fItype\fR] +.fi + +.SH DESCRIPTION +.sp +.LP +The \fBtset\fR utility sets up your terminal, typically when you first log in. +It does terminal dependent processing such as setting erase and kill +characters, setting or resetting delays, sending any sequences needed to +properly initialized the terminal, and the like. \fBtset\fR first determines +the \fBtype\fR of terminal involved, and then does necessary initializations +and mode settings. If a port is not wired permanently to a specific terminal +(not hardwired) it is given an appropriate generic identifier such as +\fBdialup\fR. +.sp +.LP +\fBreset\fR clears the terminal settings by turning off CBREAK and RAW modes, +output delays and parity checking, turns on NEWLINE translation, echo and TAB +expansion, and restores undefined special characters to their default state. +It then sets the modes as usual, based on the terminal type (which will +probably override some of the above). See \fBstty\fR(1) for more information. +All arguments to \fBtset\fR may be used with \fBreset\fR. \fBreset\fR also uses +\fBrs=\fR and \fBrf=\fR to reset the initialization string and file. This is +useful after a program dies and leaves the terminal in a funny state. Often in +this situation, characters will not echo as you type them. You may have to type +LINEFEED \fBreset\fR LINEFEED since RETURN may not work. +.sp +.LP +When no arguments are specified, \fBtset\fR reads the terminal type from the +\fBTERM\fR environment variable and re-initializes the terminal, and performs +initialization of mode, environment and other options at login time to +determine the terminal type and set up terminal modes. +.sp +.LP +When used in a startup script (\fB\&.profile\fR for \fBsh\fR(1) users or +\fB\&.login\fR for \fBcsh\fR(1) users) it is desirable to give information +about the type of terminal you will usually use on ports that are not +hardwired. Any of the alternate generic names given in the file +\fB/etc/termcap\fR are possible identifiers. Refer to the \fB-m\fR option below +for more information. If no mapping applies and a final \fBtype\fR option, not +preceded by a \fB-m\fR, is given on the command line then that type is used. +.sp +.LP +It is usually desirable to return the terminal type, as finally determined by +\fBtset\fR, and information about the terminal's capabilities, to a shell's +environment. This can be done using the \fB\(mi\fR, \fB-s\fR, or \fB-S\fR +options. +.sp +.LP +For the Bourne shell, put this command in your \fB\&.profile\fR file: +.sp +.in +2 +.nf +eval `tset \fB-s\fR \fIoptions...\fR` +.fi +.in -2 + +.sp +.LP +or using the C shell, put these commands in your \fB\&.login\fR file: +.sp +.in +2 +.nf +set noglob +eval `tset \fB-s\fR \fIoptions...\fR\fB`\fRunset noglob +.fi +.in -2 + +.sp +.LP +With the C shell, it is also convenient to make an alias in your \fB\&.cshrc\fR +file: +.sp +.in +2 +.nf +alias ts 'eval `tset \fB-s\fR \e!*`' +.fi +.in -2 + +.sp +.LP +This also allows the command: +.sp +.in +2 +.nf +ts 2621 +.fi +.in -2 + +.sp +.LP +to be invoked at any time to set the terminal and environment. It is not +possible to get this aliasing effect with a Bourne shell script, because shell +scripts cannot set the environment of their parent. If a process could set its +parent's environment, none of this nonsense would be necessary in the first +place. +.sp +.LP +Once the terminal type is known, \fBtset\fR sets the terminal driver mode. This +normally involves sending an initialization sequence to the terminal, setting +the single character erase (and optionally the line-kill (full line erase)) +characters, and setting special character delays. TAB and NEWLINE expansion are +turned off during transmission of the terminal initialization sequence. +.sp +.LP +On terminals that can backspace but not overstrike (such as a CRT), and when +the erase character is `\fB#\fR', the erase character is changed as if \fB-e\fR +had been used. +.SH OPTIONS +.sp +.ne 2 +.mk +.na +\fB\fB\(mi\fR\fR +.ad +.RS 8n +.rt +The name of the terminal finally decided upon is output on the standard output. +This is intended to be captured by the shell and placed in the \fBTERM\fR +environment variable. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-e\fR\fIc\fR\fR +.ad +.RS 8n +.rt +Set the erase character to be the named character \fIc\fR on all terminals. +Default is the BACKSPACE key on the keyboard, usually \fB^H\fR (CTRL-H). The +character \fIc\fR can either be typed directly, or entered using the +circumflex-character notation used here. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-i\fR\fIc\fR\fR +.ad +.RS 8n +.rt +Set the interrupt character to be the named character \fIc\fR on all terminals. +Default is \fB^C\fR (CTRL-C). The character \fIc\fR can either be typed +directly, or entered using the circumflex-character notation used here. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-I\fR\fR +.ad +.RS 8n +.rt +Suppress transmitting terminal-initialization strings. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-k\fR\fIc\fR\fR +.ad +.RS 8n +.rt +Set the line kill character to be the named character \fIc\fR on all terminals. +Default is \fB^U\fR (CTRL-U). The kill character is left alone if \fB-k\fR is +not specified. Control characters can be specified by prefixing the +alphabetical character with a circumflex (as in CTRL-U) instead of entering the +actual control key itself. This allows you to specify control keys that are +currently assigned. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-n\fR\fR +.ad +.RS 8n +.rt +Specify that the new tty driver modes should be initialized for this terminal. +Probably useless since \fBstty new\fR is the default. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-Q\fR\fR +.ad +.RS 8n +.rt +Suppress printing the `\fBErase set to\fR' and `\fBKill set to\fR' messages. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-r\fR\fR +.ad +.RS 8n +.rt +In addition to other actions, reports the terminal type. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-s\fR\fR +.ad +.RS 8n +.rt +Output commands to set and export \fBTERM\fR. This can be used with +.sp +.in +2 +.nf +\fBset noglob +eval `tset \fR\fB-s\fR\fB .\|.\|.` +unset noglob\fR +.fi +.in -2 +.sp + +to bring the terminal information into the environment. Doing so makes programs +such as \fBvi\fR(1) start up faster. If the \fBSHELL\fR environment variable +ends with \fBcsh\fR, C shell commands are output, otherwise Bourne shell +commands are output. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-m\fR [ \fIport-ID\fR [ \fIbaudrate\fR ] \fB:\fR \fBtype\fR ] .\|.\|.\fR +.ad +.sp .6 +.RS 4n +Specify (map) a terminal type when connected to a generic port (such as +\fIdialup\fR or \fIplugboard\fR) identified by \fIport-ID\fR. The +\fIbaudrate\fR argument can be used to check the baudrate of the port and set +the terminal type accordingly. The target rate is prefixed by any combination +of the following operators to specify the conditions under which the mapping is +made: +.sp +.ne 2 +.mk +.na +\fB\fB>\fR\fR +.ad +.RS 5n +.rt +Greater than +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB@\fR\fR +.ad +.RS 5n +.rt +Equals or ``at'' +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB<\fR\fR +.ad +.RS 5n +.rt +Less than +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB!\fR\fR +.ad +.RS 5n +.rt +It is not the case that (negates the above operators) +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB?\fR\fR +.ad +.RS 5n +.rt +Prompt for the terminal type. If no response is given, then \fBtype\fR is +selected by default. +.RE + +In the following example, the terminal type is set to \fBadm3a\fR if the port +is a dialup with a speed of greater than 300 or to \fBdw2\fR if the port is a +dialup at 300 baud or less. In the third case, the question mark preceding the +terminal type indicates that the user is to verify the type desired. A +\fINULL\fR response indicates that the named type is correct. Otherwise, the +user's response is taken to be the type desired. +.sp +.in +2 +.nf +\fBtset \fR\fB-m\fR\fB 'dialup>300:adm3a' \fR\fB-m\fR\fB 'dialup:dw2' \fR\fB-m\fR\fB 'plugboard:?adm3a'\fR +.fi +.in -2 +.sp + +To prevent interpretation as metacharacters, the entire argument to \fB-m\fR +should be enclosed in single quotes. When using the C shell, exclamation +points should be preceded by a backslash (\e). +.RE + +.SH EXAMPLES +.sp +.LP +These examples all use the `\fB\(mi\fR\&' option. A typical use of \fBtset\fR +in a \fB\&.profile\fR or \fB\&.login\fR will also use the \fB-e\fR and \fB-k\fR +options, and often the \fB-n\fR or \fB-Q\fR options as well. These options have +been omitted here to keep the examples short. +.LP +\fBExample 1 \fRSelecting a terminal +.sp +.LP +To select a 2621, you might put the following sequence of commands in your +\fB\&.login\fR file (or \fB\&.profile\fR for Bourne shell users). + +.sp +.in +2 +.nf +\fBset noglob +eval `tset \fR\fB-s\fR\fB 2621` +unset noglob\fR +.fi +.in -2 +.sp + +.sp +.LP +If you want to make the selection based only on the baud rate, you might use +the following: + +.sp +.in +2 +.nf +\fBset noglob +eval `tset \fR\fB-s\fR\fB \fR\fB-m\fR\fB '>1200:wy' 2621` +unset noglob\fR +.fi +.in -2 +.sp + +.LP +\fBExample 2 \fRSelecting terminals according to speed or baud rate +.sp +.LP +If you have a switch which connects to various ports (making it impractical to +identify which port you may be connected to), and use various terminals from +time to time, you can select from among those terminals according to the +\fIspeed\fR or baud rate. In the example below, \fBtset\fR will prompt you for +a terminal type if the baud rate is greater than 1200 (say, 9600 for a terminal +connected by an RS-232 line), and use a Wyse\(rg 50 by default. If the baud +rate is less than or equal to 1200, it will select a 2621. Note the placement +of the question mark, and the quotes to protect the \fB>\fR and \fB?\fR from +interpretation by the shell. + +.sp +.in +2 +.nf +\fBset noglob +eval `tset \fR\fB-s\fR\fB \fR\fB-m\fR\fB 'switch>1200:?wy' \fR\fB-m\fR\fB 'switch<=1200:2621'` +unset noglob\fR +.fi +.in -2 +.sp + +.LP +\fBExample 3 \fRSelecting the terminal used most often +.sp +.LP +The following entry is appropriate if you always dial up, always at the same +baud rate, on many different kinds of terminals, and the terminal you use most +often is an \fBadm3a\fR. + +.sp +.in +2 +.nf +\fBset noglob +eval `tset \fR\fB-s\fR\fB ?adm3a` +unset noglob\fR +.fi +.in -2 +.sp + +.LP +\fBExample 4 \fRSelecting a terminal with specific settings +.sp +.LP +The following example quietly sets the erase character to \fBBACKSPACE,\fR and +kill to \fBCTRL-U.\fR If the port is switched, it selects a Concept\(tm 100 for +speeds less than or equal to 1200, and asks for the terminal type otherwise +(the default in this case is a Wyse 50). If the port is a direct dialup, it +selects Concept 100 as the terminal type. If logging in over the \fBARPANET,\fR +the terminal type selected is a Datamedia\(rg 2500 terminal or emulator. Note +the backslash escaping the \fBNEWLINE\fR at the end of the first line in the +example. + +.sp +.in +2 +.nf +set noglob +eval `tset \fB-e\fR \fB-k\fR^U \fB-Q\fR \fB-s\fR \fB-m\fR 'switch<=1200:concept100' \fB-m\fR\e + 'switch:?wy' \fB-m\fR dialup:concept100 \fB-m\fR arpanet:dm2500` +unset noglob +.fi +.in -2 +.sp + +.SH FILES +.sp +.ne 2 +.mk +.na +\fB\fB\&.login\fR\fR +.ad +.RS 16n +.rt + +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB\&.profile\fR\fR +.ad +.RS 16n +.rt + +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB/etc/termcap\fR\fR +.ad +.RS 16n +.rt + +.RE + +.SH SEE ALSO +.sp +.LP +\fBcsh\fR(1), \fBsh\fR(1), \fBstty\fR(1), \fBvi\fR(1), \fBattributes\fR(5), +\fBenviron\fR(5) +.SH NOTES +.sp +.LP +The \fBtset\fR command is one of the first commands a user must master when +getting started on a \fBUNIX\fR system. Unfortunately, it is one of the most +complex, largely because of the extra effort the user must go through to get +the environment of the login shell set. Something needs to be done to make all +this simpler, either the \fBlogin\fR program should do this stuff, or a default +shell alias should be made, or a way to set the environment of the parent +should exist. +.sp +.LP +This program cannot intuit personal choices for erase, interrupt and line kill +characters, so it leaves these set to the local system standards. +.sp +.LP +It could well be argued that the shell should be responsible for ensuring that +the terminal remains in a sane state; this would eliminate the need for the +\fBreset\fR program. diff --git a/usr/src/man/man1b/users.1b b/usr/src/man/man1b/users.1b new file mode 100644 index 0000000000..2288d713b1 --- /dev/null +++ b/usr/src/man/man1b/users.1b @@ -0,0 +1,54 @@ +'\" te +.\" Copyright (c) 1998, Sun Microsystems, Inc. +.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. +.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. +.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] +.TH users 1B "16 Nov 1998" "SunOS 5.11" "SunOS/BSD Compatibility Package Commands" +.SH NAME +users \- display a compact list of users logged in +.SH SYNOPSIS +.LP +.nf +\fB/usr/ucb/users\fR [\fIfilename\fR] +.fi + +.SH DESCRIPTION +.sp +.LP +The \fBusers\fR utility lists the login names of the users currently on the +system in a compact, one-line format. +.sp +.LP +Specifying \fIfilename\fR tells \fBusers\fR where to find its information; by +default it checks \fB/var/adm/utmpx\fR. +.sp +.LP +Typing \fBusers\fR is equivalent to typing \fBwho\fR \fB-q\fR. +.SH EXAMPLES +.LP +\fBExample 1 \fRListing current users +.sp +.in +2 +.nf +example% \fBusers +paul george ringo\fRexample% +.fi +.in -2 +.sp + +.SH FILES +.sp +.ne 2 +.mk +.na +\fB\fB/var/adm/utmpx\fR\fR +.ad +.RS 18n +.rt + +.RE + +.SH SEE ALSO +.sp +.LP +\fBwho\fR(1), \fBattributes\fR(5) diff --git a/usr/src/man/man1b/vipw.1b b/usr/src/man/man1b/vipw.1b new file mode 100644 index 0000000000..08f527427f --- /dev/null +++ b/usr/src/man/man1b/vipw.1b @@ -0,0 +1,53 @@ +'\" te +.\" Copyright (c) 1996, Sun Microsystems, Inc. All Rights Reserved. +.\" Copyright (c) 1980 Regents of the University of California. All rights reserved. The Berkeley software License Agreement specifies the terms and conditions for redistribution. +.TH vipw 1B "14 Sep 1992" "SunOS 5.11" "SunOS/BSD Compatibility Package Commands" +.SH NAME +vipw \- edit the password file +.SH SYNOPSIS +.LP +.nf +\fB/usr/ucb/vipw\fR +.fi + +.SH DESCRIPTION +.sp +.LP +\fBvipw\fR edits the password file while setting the appropriate locks, and +does any necessary processing after the password file is unlocked. If the +password file is already being edited, then you will be told to try again +later. The \fBvi\fR(1) editor will be used unless the environment variable +\fBVISUAL\fR or \fBEDITOR\fR indicates an alternate editor. +.sp +.LP +\fBvipw\fR performs a number of consistency checks on the password entry for +root, and will not allow a password file with a "mangled" root entry to be +installed. It also checks the \fB/etc/shells\fR file to verify the login shell +for root. +.SH FILES +.sp +.ne 2 +.mk +.na +\fB\fB/etc/ptmp\fR\fR +.ad +.RS 15n +.rt + +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB/etc/shells\fR\fR +.ad +.RS 15n +.rt + +.RE + +.SH SEE ALSO +.sp +.LP +\fBpasswd\fR(1), \fBvi\fR(1), \fBpasswd\fR(4), \fBattributes\fR(5) diff --git a/usr/src/man/man1b/whereis.1b b/usr/src/man/man1b/whereis.1b new file mode 100644 index 0000000000..5bdce1e1ea --- /dev/null +++ b/usr/src/man/man1b/whereis.1b @@ -0,0 +1,195 @@ +'\" te +.\" Copyright (c) 2000, Sun Microsystems, Inc. +.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. +.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. +.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] +.TH whereis 1B "10 Jan 2000" "SunOS 5.11" "SunOS/BSD Compatibility Package Commands" +.SH NAME +whereis \- locate the binary, source, and manual page files for a command +.SH SYNOPSIS +.LP +.nf +\fB/usr/ucb/whereis\fR [\fB-bmsu\fR] [\fB-BMS\fR \fIdirectory\fR... \fB-f\fR] \fIfilename\fR... +.fi + +.SH DESCRIPTION +.sp +.LP +The \fBwhereis\fR utility locates source/binary and manuals sections for +specified files. The supplied names are first stripped of leading pathname +components and any (single) trailing extension of the form \fB\&.\fR\fIext\fR, +for example, \fB\&.c\fR. Prefixes of \fBs.\fR resulting from use of source code +control are also dealt with. \fBwhereis\fR then attempts to locate the desired +program in a list of standard places: +.sp +.in +2 +.nf +\fBetc +/sbin +/usr/bin +/usr/ccs/bin +/usr/ccs/lib +/usr/lang +/usr/lbin +/usr/lib +/usr/sbin +/usr/ucb +/usr/ucblib +/usr/ucbinclude +/usr/games +/usr/local +/usr/local/bin +/usr/new +/usr/old +/usr/hosts +/usr/include +/usr/etc\fR +.fi +.in -2 +.sp + +.SH OPTIONS +.sp +.LP +The following options are supported: +.sp +.ne 2 +.mk +.na +\fB\fB-b\fR\fR +.ad +.RS 6n +.rt +Searches only for binaries. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-B\fR\fR +.ad +.RS 6n +.rt +Changes or otherwise limits the places where \fBwhereis\fR searches for +binaries. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-f\fR\fR +.ad +.RS 6n +.rt +Terminates the last directory list and signals the start of file names, and +\fImust\fR be used when any of the \fB-B\fR, \fB-M\fR, or \fB-S\fR options are +used. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-m\fR\fR +.ad +.RS 6n +.rt +Searches only for manual sections. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-M\fR\fR +.ad +.RS 6n +.rt +Changes or otherwise limits the places where \fBwhereis\fR searches for manual +sections. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-s\fR\fR +.ad +.RS 6n +.rt +Searches only for sources. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-S\fR\fR +.ad +.RS 6n +.rt +Changes or otherwise limit the places where \fBwhereis\fR searches for sources. +.RE + +.sp +.ne 2 +.mk +.na +\fB\fB-u\fR\fR +.ad +.RS 6n +.rt +Searches for unusual entries. A file is said to be unusual if it does not have +one entry of each requested type. Thus `\fBwhereis\fR \fB-m\fR \fB-u\fR +\fB*\fR' asks for those files in the current directory which have no +documentation. +.RE + +.SH EXAMPLES +.LP +\fBExample 1 \fRFinding files +.sp +.LP +Find all files in \fB/usr/bin\fR which are not documented in +\fB/usr/share/man/man1\fR with source in \fB/usr/src/cmd\fR: + +.sp +.in +2 +.nf +example% \fBcd /usr/ucb\fR +example% \fBwhereis -u -M /usr/share/man/man1 -S /usr/src/cmd -f *\fR +.fi +.in -2 +.sp + +.SH FILES +.RS +4 +.TP +.ie t \(bu +.el o +\fB/usr/src/*\fR +.RE +.RS +4 +.TP +.ie t \(bu +.el o +\fB/usr/{doc,man}/*\fR +.RE +.RS +4 +.TP +.ie t \(bu +.el o +\fB/etc, /usr/{lib,bin,ucb,old,new,local}\fR +.RE +.SH SEE ALSO +.sp +.LP +\fBchdir\fR(2), \fBattributes\fR(5) +.SH BUGS +.sp +.LP +Since \fBwhereis\fR uses \fBchdir\fR(2) to run faster, pathnames given with the +\fB-M\fR, \fB-S\fR, or \fB-B\fR must be full; that is, they must begin with a +`\fB/\fR'. diff --git a/usr/src/man/man1b/whoami.1b b/usr/src/man/man1b/whoami.1b new file mode 100644 index 0000000000..ebd088139f --- /dev/null +++ b/usr/src/man/man1b/whoami.1b @@ -0,0 +1,39 @@ +'\" te +.\" Copyright (c) 1992, Sun Microsystems, Inc. +.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. +.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. +.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] +.TH whoami 1B "14 Sep 1992" "SunOS 5.11" "SunOS/BSD Compatibility Package Commands" +.SH NAME +whoami \- display the effective current username +.SH SYNOPSIS +.LP +.nf +\fB/usr/ucb/whoami\fR +.fi + +.SH DESCRIPTION +.sp +.LP +\fBwhoami\fR displays the login name corresponding to the current effective +user \fBID.\fR If you have used \fBsu\fR to temporarily adopt another user, +\fBwhoami\fR will report the login name associated with that user \fBID.\fR +\fBwhoami\fR gets its information from the \fBgeteuid\fR and \fBgetpwuid\fR +library routines (see \fBgetuid\fR and \fBgetpwnam\fR(3C), respectively). +.SH FILES +.sp +.ne 2 +.mk +.na +\fB\fB/etc/passwd\fR\fR +.ad +.RS 15n +.rt +username data base +.RE + +.SH SEE ALSO +.sp +.LP +\fBsu\fR(1M), \fBwho\fR(1), \fBgetuid\fR(2), \fBgetpwnam\fR(3C), +\fBattributes\fR(5) |