diff options
Diffstat (limited to 'usr/src/man/man1')
| -rw-r--r-- | usr/src/man/man1/Intro.1 | 28 | ||||
| -rw-r--r-- | usr/src/man/man1/audioplay.1 | 12 | ||||
| -rw-r--r-- | usr/src/man/man1/audiorecord.1 | 4 | ||||
| -rw-r--r-- | usr/src/man/man1/audiotest.1 | 10 | ||||
| -rw-r--r-- | usr/src/man/man1/cdrw.1 | 24 | ||||
| -rw-r--r-- | usr/src/man/man1/download.1 | 20 | ||||
| -rw-r--r-- | usr/src/man/man1/dpost.1 | 47 | ||||
| -rw-r--r-- | usr/src/man/man1/history.1 | 22 | ||||
| -rw-r--r-- | usr/src/man/man1/lastcomm.1 | 8 | ||||
| -rw-r--r-- | usr/src/man/man1/ld.1 | 12 | ||||
| -rw-r--r-- | usr/src/man/man1/ldaplist.1 | 6 | ||||
| -rw-r--r-- | usr/src/man/man1/man.1 | 4 | ||||
| -rw-r--r-- | usr/src/man/man1/mdb.1 | 51 | ||||
| -rw-r--r-- | usr/src/man/man1/postio.1 | 44 | ||||
| -rw-r--r-- | usr/src/man/man1/postprint.1 | 44 | ||||
| -rw-r--r-- | usr/src/man/man1/postreverse.1 | 10 | ||||
| -rw-r--r-- | usr/src/man/man1/rup.1 | 16 | ||||
| -rw-r--r-- | usr/src/man/man1/sar.1 | 9 | ||||
| -rw-r--r-- | usr/src/man/man1/sleep.1 | 20 | ||||
| -rw-r--r-- | usr/src/man/man1/uname.1 | 11 | ||||
| -rw-r--r-- | usr/src/man/man1/vacation.1 | 18 | ||||
| -rw-r--r-- | usr/src/man/man1/who.1 | 20 |
22 files changed, 115 insertions, 325 deletions
diff --git a/usr/src/man/man1/Intro.1 b/usr/src/man/man1/Intro.1 index 9512d0a4e2..72236e4926 100644 --- a/usr/src/man/man1/Intro.1 +++ b/usr/src/man/man1/Intro.1 @@ -4,11 +4,10 @@ .\" 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 INTRO 1 "Nov 18, 2008" +.TH INTRO 1 "May 13, 2017" .SH NAME Intro, intro \- introduction to commands and application programs .SH DESCRIPTION -.sp .LP This section describes, in alphabetical order, commands available with this operating system. @@ -36,15 +35,6 @@ Commands for communicating with other systems. .sp .ne 2 .na -\fB1F\fR -.ad -.RS 6n -Commands associated with \fIForm and Menu Language Interpreter\fR (FMLI). -.RE - -.sp -.ne 2 -.na \fB1S\fR .ad .RS 6n @@ -52,7 +42,6 @@ Commands specific to SunOS. .RE .SS "OTHER SECTIONS" -.sp .LP See the following sections of the SunOS Reference Manual for more information. .RS +4 @@ -79,7 +68,6 @@ information pages. For tutorial information about these commands and procedures, see \fISolaris Advanced User\&'s Guide\fR. .SS "Manual Page Command Syntax" -.sp .LP Unless otherwise noted, commands described in the SYNOPSIS section of a manual page accept options and other arguments according to the following syntax and @@ -208,7 +196,6 @@ are syntactically recognized as numeric values. Ranges greater than those listed here are allowed. .RE .SS "Command Syntax Standard: Guidelines" -.sp .LP These command syntax guidelines are not followed by all current commands, but new commands are likely to obey them. \fBgetopts\fR(1) should be used by all @@ -414,7 +401,7 @@ long-option. The form \fB--name argument\fR is also accepted. All utilities should support two standard long-options: \fB--version\fR (with the short-option synonym \fB-V\fR ) and \fB--help\fR (with the short-option synonym \fB-?\fR ). The short option synonyms for \fB--\fRversion can vary if -the preferred synonym is already in use (but a synonym shall be provided). +the preferred synonym is already in use (but a synonym shall be provided). Both of these options stop further argument processing when encountered and after displaying the appropriate output, the utility successfully exits. .RE @@ -473,7 +460,7 @@ arbitrary character. If a long-option name consists of a single character, it must use the same character as the short-option name. Single character long-options should be avoided. They are only allowed for the exceptionally rare case that a single -character is the most descriptive name. +character is the most descriptive name. .RE .sp @@ -498,12 +485,10 @@ Several of these guidelines are only of interest to the authors of utilities. They are provided here for the use of anyone wanting to author utilities following this syntax. .SH ATTRIBUTES -.sp .LP See \fBattributes\fR(5) for a discussion of the attributes listed in this section. .SH ACKNOWLEDGMENTS -.sp .LP Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation @@ -532,23 +517,20 @@ http://www.opengroup.org/unix/online.html\&. .LP This notice shall appear on any product containing this material. .SH SEE ALSO -.sp .LP \fBgetopts\fR(1), \fBwait\fR(1), \fBexit\fR(2), \fBgetopt\fR(3C), -\fBwait\fR(3UCB), \fBattributes\fR(5) +\fBattributes\fR(5) .SH DIAGNOSTICS -.sp .LP Upon termination, each command returns two bytes of status, one supplied by the system and giving the cause for termination, and (in the case of "normal" -termination) one supplied by the program [see \fBwait\fR(3UCB) and +termination) one supplied by the program [see \fBexit\fR(2)]. The former byte is \fB0\fR for normal termination. The latter byte is customarily \fB0\fR for successful execution and non-zero to indicate troubles such as erroneous parameters, or bad or inaccessible data. It is called variously "exit code", "exit status", or "return code", and is described only where special conventions are involved. .SH WARNINGS -.sp .LP Some commands produce unexpected results when processing files containing null characters. These commands often treat text input lines as strings and diff --git a/usr/src/man/man1/audioplay.1 b/usr/src/man/man1/audioplay.1 index 4e5f391f5a..324e26940b 100644 --- a/usr/src/man/man1/audioplay.1 +++ b/usr/src/man/man1/audioplay.1 @@ -3,7 +3,7 @@ .\" 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 AUDIOPLAY 1 "May 1, 2009" +.TH AUDIOPLAY 1 "May 13, 2017" .SH NAME audioplay \- play audio files .SH SYNOPSIS @@ -13,7 +13,6 @@ audioplay \- play audio files .fi .SH DESCRIPTION -.sp .LP The \fBaudioplay\fR utility copies the named audio files (or the standard input if no filenames are present) to the audio device. If no input file is specified @@ -32,7 +31,6 @@ ignored. This allows, for instance, data sampled at 8012 Hz to be played on an audio device that only supports 8000 Hz. If the \fB-V\fR option is present, such deviations are flagged with warning messages. .SH OPTIONS -.sp .LP The following options are supported: .sp @@ -93,7 +91,6 @@ the audio device or when sample rate deviations are detected. .RE .SH OPERANDS -.sp .ne 2 .na \fB\fIfile\fR\fR @@ -108,12 +105,10 @@ variable is consulted (see below). .RE .SH USAGE -.sp .LP See \fBlargefile\fR(5) for the description of the behavior of \fBaudioplay\fR when encountering files greater than or equal to 2 Gbyte ( 2^31 bytes). .SH ENVIRONMENT VARIABLES -.sp .ne 2 .na \fB\fBAUDIODEV\fR\fR @@ -136,7 +131,6 @@ set, only the current directory is searched. .RE .SH ATTRIBUTES -.sp .LP See \fBattributes\fR(5) for descriptions of the following attributes: .sp @@ -154,12 +148,10 @@ Interface Stability Committed .TE .SH SEE ALSO -.sp .LP -\fBaudioconvert\fR(1), \fBaudiorecord\fR(1), \fBmixerctl\fR(1), +\fBaudioconvert\fR(1), \fBaudiorecord\fR(1), \fBattributes\fR(5), \fBlargefile\fR(5), \fBaudio\fR(7I) .SH BUGS -.sp .LP \fBaudioplay\fR currently supports a limited set of audio format conversions. If the audio file is not in a format supported by the audio device, it must diff --git a/usr/src/man/man1/audiorecord.1 b/usr/src/man/man1/audiorecord.1 index 185f565c9a..8f4354a524 100644 --- a/usr/src/man/man1/audiorecord.1 +++ b/usr/src/man/man1/audiorecord.1 @@ -3,7 +3,7 @@ .\" 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 AUDIORECORD 1 "April 9, 2016" +.TH AUDIORECORD 1 "May 13, 2017" .SH NAME audiorecord \- record an audio file .SH SYNOPSIS @@ -214,5 +214,5 @@ Interface Stability Committed .SH SEE ALSO .LP -\fBaudioconvert\fR(1), \fBaudioplay\fR(1), \fBmixerctl\fR(1), +\fBaudioconvert\fR(1), \fBaudioplay\fR(1), \fBattributes\fR(5), \fBlargefile\fR(5), \fBaudio\fR(7I) diff --git a/usr/src/man/man1/audiotest.1 b/usr/src/man/man1/audiotest.1 index 67f6033963..8c122094df 100644 --- a/usr/src/man/man1/audiotest.1 +++ b/usr/src/man/man1/audiotest.1 @@ -3,7 +3,7 @@ .\" 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 AUDIOTEST 1 "May 5, 2009" +.TH AUDIOTEST 1 "May 13, 2017" .SH NAME audiotest \- test audio device .SH SYNOPSIS @@ -13,14 +13,12 @@ audiotest \- test audio device .fi .SH DESCRIPTION -.sp .LP The \fBaudiotest\fR utility runs a test for the named audio device (or all audio devices found on the system if none is given). The test includes playing an audio sample over each channel and measuring the rate of playback for clock drift. .SH OPTIONS -.sp .LP The following options are supported: .sp @@ -75,7 +73,6 @@ The low frequency effects channel is not tested. .RE .SH OPERANDS -.sp .ne 2 .na \fB\fIdev\fR\fR @@ -85,7 +82,6 @@ The path the device to test, for example, \fB/dev/dsp0\fR. .RE .SH ATTRIBUTES -.sp .LP See \fBattributes\fR(5) for descriptions of the following attributes: .sp @@ -103,12 +99,10 @@ Interface Stability Committed .TE .SH SEE ALSO -.sp .LP -\fBaudioconvert\fR(1), \fBaudiorecord\fR(1), \fBmixerctl\fR(1), +\fBaudioconvert\fR(1), \fBaudiorecord\fR(1), \fBattributes\fR(5), \fBaudio\fR(7I) .SH BUGS -.sp .LP \fBaudiotest\fR has no way to detect the number of actual audio channels supported by the physical device. diff --git a/usr/src/man/man1/cdrw.1 b/usr/src/man/man1/cdrw.1 index 81f5a8fd80..74133c4698 100644 --- a/usr/src/man/man1/cdrw.1 +++ b/usr/src/man/man1/cdrw.1 @@ -4,7 +4,7 @@ .\" 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 CDRW 1 "Dec 1, 2012" +.TH CDRW 1 "May 13, 2017" .SH NAME cdrw \- CD read and write .SH SYNOPSIS @@ -56,7 +56,6 @@ cdrw \- CD read and write .fi .SH DESCRIPTION -.sp .LP The \fBcdrw\fR command provides the ability to create data and audio CDs. This command also provides the ability to extract audio tracks from an audio CD and @@ -79,7 +78,6 @@ the \fB-l\fR option provides a list of CD or DVD writers. For instructions on adding a USB-mass-storage-class-compliant CD-RW or DVD-RW device to your system, see \fBscsa2usb\fR(7D). .SS "Creating Data CDs" -.sp .LP When creating data CDs, \fBcdrw\fR uses the Track-At-Once mode of writing. Use the \fB-i\fR option to specify a file that contains the data to write on CD @@ -91,7 +89,6 @@ In either case, the data is typically prepared by using the \fBmkisofs\fR command to convert the file and file information into the ISO 9660 format used on CDs. See the examples that include use of this command. .SS "Creating Data DVDs" -.sp .LP \fBcdrw\fR can create single-session data DVDs on DVD+RW or DVD-RW devices using images generated from \fBmkisofs\fR. These disks can be mounted as HSFS @@ -101,7 +98,6 @@ further sessions from being added. The image should be prepared in advance when writing an image to the DVD media since DAO mode requires that the size of the image be known in advance. .SS "Creating Audio CDs" -.sp .LP Use the \fB-a\fR option to create an audio CD. Single or multiple audio files can be specified with this option. All of the audio files should be in a @@ -152,7 +148,6 @@ to be the audio file type for all the files specified. Also, using the \fB-c\fR option closes the session after writing the audio tracks. Therefore, the tracks to be written should be specified in a single command line. .SS "Extracting Audio" -.sp .LP \fBcdrw\fR can also be used for extracting audio data from an audio CD with the \fB-x\fR option. The CD should have tracks in Red Book CDDA form. By default, @@ -160,7 +155,6 @@ the output format is based on the file extension. A user can specify a \fBsun\fR, \fBwav\fR, \fBcda\fR, or \fBaur\fR output format with the \fB-T\fR option. .SS "Copying CDs" -.sp .LP \fBcdrw\fR can be used to copy single session data CD-ROMs and Red Book audio CDs. When copying a CD, \fBcdrw\fR looks for a specified source device. If no @@ -171,7 +165,6 @@ current CD writer. If no media is found, insert a blank writable CD media in the current CD writer. If the default temporary directory does not have enough space, an alternate directory can be specified by using the \fB-m\fR option. .SS "Erasing CD-RW or DVD-RW Media" -.sp .LP Users have to erase the CD-RW media before it can be rewritten. With the \fB-b\fR option, the following flavors of erasing are currently supported: @@ -227,18 +220,14 @@ DVD+RW media does not support erasing. To re-use DVD+RW media, simply write a new image onto the media. \fBcdrw\fR formats and overwrites the existing media automatically. .SS "Checking device-list or media-status" -.sp .LP You can list a system's CD or DVD writers by using the \fB-l\fR option. Also, for a particular media, you can get the blanking status and table of contents by using the \fB-M\fR option. The \fB-M\fR option also prints information about the last session's start address and the next writable address. This information, along with the \fB-O\fR option, can be used to create multisession -CDs. Refer to the \fBmkisofs\fR(8) man page, -(\fB/usr/share/man/man8/mkisofs.8\fR), in the SUNWfsman package for more -information. +CDs. Refer to the \fBmkisofs\fR(8) man page for more information. .SH OPTIONS -.sp .LP The following options are supported: .sp @@ -601,19 +590,14 @@ example% \fBmkisofs -o /tmp/image2 -r -C 0,173464 -M \e .sp .SH SEE ALSO -.sp .LP \fBaudioconvert\fR(1), \fBpriocntl\fR(1), \fBpolicy.conf\fR(4), -\fBattributes\fR(5), \fBrbac\fR(5), \fBscsa2usb\fR(7D), \fBsd\fR(7D) -.sp -.LP -\fBmkisofs\fR(8), (\fB/usr/share/man/man8/mkisofs.8\fR), in the SUNWfsman -package +\fBattributes\fR(5), \fBrbac\fR(5), \fBscsa2usb\fR(7D), \fBsd\fR(7D), +\fBmkisofs\fR(8) .sp .LP \fISystem Administration Guide: Devices and File Systems\fR .SH NOTES -.sp .LP The CD writing process requires data to be supplied at a constant rate to the drive. Keep I/O activity to a minimum and shut down any related I/O diff --git a/usr/src/man/man1/download.1 b/usr/src/man/man1/download.1 index f7ae7da5a7..e11751d54c 100644 --- a/usr/src/man/man1/download.1 +++ b/usr/src/man/man1/download.1 @@ -3,7 +3,7 @@ .\" 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 DOWNLOAD 1 "Sep 9, 1996" +.TH DOWNLOAD 1 "May 13, 2017" .SH NAME download \- host resident PostScript font downloader .SH SYNOPSIS @@ -19,7 +19,6 @@ download \- host resident PostScript font downloader .fi .SH DESCRIPTION -.sp .LP \fBdownload\fR prepends host resident fonts to \fIfiles\fR and writes the results on the standard output. If no \fIfiles\fR are specified, or if @@ -41,12 +40,11 @@ font directory. Comments are introduced by % (as in PostScript) and extend to the end of the line. .sp .LP -The only candidates for downloading are fonts listed in the map table that +The only candidates for downloading are fonts listed in the map table that point \fBdownload\fR to readable files. A font is downloaded once, at most. Requests for unlisted fonts or inaccessible files are ignored. All requests are ignored if the map table can not be read. .SH OPTIONS -.sp .ne 2 .na \fB\fB-f\fR\fR @@ -74,7 +72,7 @@ Check the list of printer-resident fonts in .ad .RS 16n Use \fIname\fR as the font map table. A \fIname\fR that begins with \fB/\fR is -the full pathname of the map table and is used as is. Otherwise \fIname\fR is +the full pathname of the map table and is used as is. Otherwise \fIname\fR is appended to the pathname of the host font directory. .RE @@ -93,7 +91,7 @@ Use \fIdir\fR as the host font directory. The default is \fBExample 1 \fRExamples of the \fBdownload\fR command. .sp .LP -The following map table could be used to control the downloading of the +The following map table could be used to control the downloading of the Bookman font family: .sp @@ -114,8 +112,8 @@ Bookman font family: .sp .LP -Using the file \fBmyprinter/map\fR (in the default host font directory) as the -map table, you could download fonts by issuing the following command: +Using the file \fBmyprinter/map\fR (in the default host font directory) as the +map table, you could download fonts by issuing the following command: .sp .in +2 @@ -126,7 +124,6 @@ map table, you could download fonts by issuing the following command: .sp .SH EXIT STATUS -.sp .LP The following exit values are returned: .sp @@ -148,12 +145,9 @@ An error occurred. .RE .SH SEE ALSO -.sp .LP -\fBdpost\fR(1), \fBpostdaisy\fR(1), \fBpostdmd\fR(1), \fBpostio\fR(1), -\fBpostmd\fR(1), \fBpostprint\fR(1), \fBposttek\fR(1), \fBattributes\fR(5) +\fBdpost\fR(1), \fBpostio\fR(1), \fBpostprint\fR(1), \fBattributes\fR(5) .SH NOTES -.sp .LP The \fBdownload\fR program should be part of a more general program. .sp diff --git a/usr/src/man/man1/dpost.1 b/usr/src/man/man1/dpost.1 index 104eb59e43..c977e416ad 100644 --- a/usr/src/man/man1/dpost.1 +++ b/usr/src/man/man1/dpost.1 @@ -3,7 +3,7 @@ .\" 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 DPOST 1 "Sep 9, 1996" +.TH DPOST 1 "May 13, 2017" .SH NAME dpost \- troff postprocessor for PostScript printers .SH SYNOPSIS @@ -20,7 +20,6 @@ dpost \- troff postprocessor for PostScript printers .fi .SH DESCRIPTION -.sp .LP \fBdpost\fR translates \fIfiles\fR created by \fBtroff\fR(1) into PostScript and writes the results on the standard output. If no \fIfiles\fR are specified, @@ -43,7 +42,6 @@ command sets the resolution used to translate the input \fIfiles\fR, the resolution used in the binary font files, and the PostScript prologue is responsible for setting up an appropriate user coordinate system. .SH OPTIONS -.sp .ne 2 .na \fB\fB-c\fR\fI num\fR\fR @@ -73,7 +71,7 @@ previous versions of \fBdpost\fR. .RS 11n Magnify each logical page by the factor \fInum\fR. Pages are scaled uniformly about the origin, which is located near the upper left corner of each page. The -default magnification is \fB1.0\fR. +default magnification is \fB1.0\fR. .RE .sp @@ -83,7 +81,7 @@ default magnification is \fB1.0\fR. .ad .RS 11n Print \fInum\fR logical pages on each piece of paper, where \fInum\fR can be -any positive integer. By default, \fInum\fR is set to \fB1\fR. +any positive integer. By default, \fInum\fR is set to \fB1\fR. .RE .sp @@ -122,7 +120,7 @@ character of \fImode\fR is significant. The default \fImode\fR is portrait. .RS 11n Set the line width used to implement \fBtroff\fR graphics commands to \fInum\fR points, where a point is approximately 1/72 of an inch. By default, \fInum\fR -is set to \fB0.3\fR points. +is set to \fB0.3\fR points. .RE .sp @@ -134,7 +132,7 @@ is set to \fB0.3\fR points. Translate the origin \fInum\fR inches along the positive x axis. The default coordinate system has the origin fixed near the upper left corner of the page, with positive x to the right and positive y down the page. Positive \fInum\fR -moves everything right. The default offset is \fB0\fR inches. +moves everything right. The default offset is \fB0\fR inches. .RE .sp @@ -144,7 +142,7 @@ moves everything right. The default offset is \fB0\fR inches. .ad .RS 11n Translate the origin \fInum\fR inches along the positive y axis. Positive -\fInum\fR moves text up the page. The default offset is \fB0\fR. +\fInum\fR moves text up the page. The default offset is \fB0\fR. .RE .sp @@ -236,7 +234,6 @@ example% \fBpic \fR\fBfile\fR\fB | tbl | eqn | troff \fR\fB-mm\fR\fB \fR\fB-Tpos should give the best results. .SH EXIT STATUS -.sp .LP The following exit values are returned: .sp @@ -258,7 +255,6 @@ An error occurred. .RE .SH FILES -.sp .ne 2 .na \fB\fB/usr/lib/font/devpost/*.out\fR\fR @@ -318,38 +314,15 @@ An error occurred. .RE -.sp -.ne 2 -.na -\fB\fB/usr/lib/macros/pictures\fR\fR -.ad -.sp .6 -.RS 4n - -.RE - -.sp -.ne 2 -.na -\fB\fB/usr/lib/macros/color\fR\fR -.ad -.sp .6 -.RS 4n - -.RE - .SH SEE ALSO -.sp .LP -\fBdownload\fR(1), \fBpostdaisy\fR(1), \fBpostdmd\fR(1), \fBpostio\fR(1), -\fBpostmd\fR(1), \fBpostprint\fR(1), \fBpostreverse\fR(1), \fBposttek\fR(1), +\fBdownload\fR(1), \fBpostio\fR(1), \fBpostprint\fR(1), \fBpostreverse\fR(1), \fBtroff\fR(1), \fBattributes\fR(5) .SH NOTES -.sp .LP Output files often do not conform to Adobe's file structuring conventions. -Piping the output of \fBdpost\fR through \fBpostreverse\fR(1) should produce a -minimally conforming PostScript file. +Piping the output of \fBdpost\fR(1) through \fBpostreverse\fR(1) should produce +a minimally conforming PostScript file. .sp .LP Although \fBdpost\fR can handle files formatted for any device, emulation is @@ -360,7 +333,7 @@ white space, and unrecognized fonts will usually default to one of the Times fonts (that is, \fBR\fR, \fBI\fR, \fBB\fR, or \fBBI\fR). .sp .LP -An \fBx res\fR command must precede the first \fBx init\fR command, and all +An \fBx res\fR command must precede the first \fBx init\fR command, and all the input \fIfiles\fR should have been prepared for the same output device. .sp .LP diff --git a/usr/src/man/man1/history.1 b/usr/src/man/man1/history.1 index 1edabba9a0..ccecac365e 100644 --- a/usr/src/man/man1/history.1 +++ b/usr/src/man/man1/history.1 @@ -10,7 +10,7 @@ .\" 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 HISTORY 1 "Nov 2, 2007" +.TH HISTORY 1 "May 13, 2017" .SH NAME history, fc, hist \- process command history list .SH SYNOPSIS @@ -59,7 +59,6 @@ history, fc, hist \- process command history list .SH DESCRIPTION .SS "/usr/bin/fc" -.sp .LP The \fBfc\fR utility lists or edits and reexecutes, commands previously entered to an interactive \fBsh\fR. @@ -99,7 +98,6 @@ the \fBfc\fR command itself as well as the command that results, for example: reinvokes the previous command, suppressing standard error for both \fBfc\fR and the previous command. .SS "csh" -.sp .LP Display the history list. If \fIn\fR is given, display only the \fIn\fR most recent events. @@ -124,7 +122,6 @@ command, \fBsource\fR(1). .RE .SS "History Substitution:" -.sp .LP History substitution allows you to use words from previous command lines in the command line you are typing. This simplifies spelling corrections and the @@ -155,7 +152,6 @@ Input lines containing history substitutions are echoed on the terminal after being expanded, but before any other substitutions take place or the command gets executed. .SS "Event Designators:" -.sp .LP An event designator is a reference to a command line entry in the history list. .sp @@ -273,7 +269,6 @@ say, re-executing command #6: .RE .SS "Word Designators:" -.sp .LP A `\fB:\fR' (colon) separates the event specification from the word designator. 2It can be omitted if the word designator begins with a \fB^\fR, \fB$\fR, @@ -373,7 +368,6 @@ Like \fIx\fR\fB*\fR but omitting word \fB$\fR. .RE .SS "Modifiers:" -.sp .LP After the optional word designator, you can add a sequence of one or more of the following modifiers, each preceded by a \fB:\fR. @@ -499,7 +493,6 @@ Without an event specification, a history reference refers either to the previous command, or to a previous history reference on the command line (if any). .SS "ksh" -.sp .LP Using \fBfc\fR, in the form of .sp @@ -576,7 +569,6 @@ or equal to this number. The default is \fB128\fR. .RE .SS "Command Re-entry:" -.sp .LP The text of the last \fBHISTSIZE\fR (default 128) commands entered from a terminal device is saved in a \fBhistory\fR file. The file @@ -602,7 +594,6 @@ modify the command before execution. For example, if \fBr\fR is aliased to Using the \fBfc\fR built-in command within a compound command causes the whole command to disappear from the history file. .SS "ksh93" -.sp .LP \fBhist\fR lists, edits, or re-executes commands previously entered into the current shell environment. @@ -671,7 +662,6 @@ If no editor is specified, then the editor specified by the \fBHISTEDIT\fR variable is used if set, or the \fBFCEDIT\fR variable is used if set, otherwise, \fBed\fR is used. .SH OPTIONS -.sp .LP The following options are supported: .sp @@ -727,7 +717,6 @@ Re-executes the command without invoking an editor. .RE .SS "ksh93" -.sp .LP \fBksh93\fR supports the following options: .sp @@ -798,7 +787,6 @@ string \fIold\fR in the command to \fInew\fR before re-executing the command. .RE .SH OPERANDS -.sp .LP The following operands are supported: .sp @@ -918,7 +906,6 @@ reexecuted by the string \fInew\fR. .RE .SH OUTPUT -.sp .LP When the \fB-l\fR option is used to list commands, the format of each command in the list is as follows: @@ -985,7 +972,6 @@ after the first are displayed as: .in -2 .SH ENVIRONMENT VARIABLES -.sp .LP See \fBenviron\fR(5) for descriptions of the following environment variables that affect the execution of \fBfc\fR: \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and @@ -1026,7 +1012,7 @@ definition commands are recorded in the history file, unless the \fBset\fR function definitions in some system startup file called before the \fBENV\fR file, the history file is initialized before the user gets a chance to influence its characteristics.) The variable \fBHISTFILE\fR is accessed -initially when the shell is invoked. Any changes to \fBHISTFILE\fR does not +initially when the shell is invoked. Any change to \fBHISTFILE\fR does not take effect until another shell is invoked. .RE @@ -1044,7 +1030,6 @@ take effect until another shell is invoked. .RE .SH EXIT STATUS -.sp .LP The following exit values are returned: .sp @@ -1070,8 +1055,7 @@ An error occurred. Otherwise, the exit status is that of the commands executed by \fBfc\fR or \fBhist\fR. .SH SEE ALSO -.sp .LP \fBcsh\fR(1), \fBed\fR(1), \fBksh\fR(1), \fBksh93\fR(1), \fBset\fR(1), -\fBset\fR(1F), \fBsh\fR(1), \fBsource\fR(1), \fBattributes\fR(5), +\fBsh\fR(1), \fBsource\fR(1), \fBattributes\fR(5), \fBenviron\fR(5) diff --git a/usr/src/man/man1/lastcomm.1 b/usr/src/man/man1/lastcomm.1 index 4915a97dc0..5c1eb3dc00 100644 --- a/usr/src/man/man1/lastcomm.1 +++ b/usr/src/man/man1/lastcomm.1 @@ -4,7 +4,7 @@ .\" 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 LASTCOMM 1 "Jan 10, 2000" +.TH LASTCOMM 1 "May 13, 2017" .SH NAME lastcomm \- display the last commands executed, in reverse order .SH SYNOPSIS @@ -15,7 +15,6 @@ lastcomm \- display the last commands executed, in reverse order .fi .SH DESCRIPTION -.sp .LP The \fBlastcomm\fR command gives information on previously executed commands. \fBlastcomm\fR with no arguments displays information about all the commands @@ -97,7 +96,6 @@ The amount of \fBCPU\fR time used by the process (in seconds). The date and time the process exited. .RE .SH OPTIONS -.sp .LP The following options are supported: .sp @@ -159,7 +157,6 @@ example% \fBlastcomm root\fR produces a listing of all the commands executed by user \fBroot\fR. .SH FILES -.sp .ne 2 .na \fB\fB/var/adm/pacct\fR\fR @@ -178,7 +175,6 @@ extended accounting file .RE .SH SEE ALSO -.sp .LP \fBlast\fR(1), \fBacctadm\fR(1M), \fBacct\fR(2), \fBacct.h\fR(3HEAD), -\fBsigvec\fR(3UCB), \fBcore\fR(4), \fBattributes\fR(5) +\fBcore\fR(4), \fBattributes\fR(5) diff --git a/usr/src/man/man1/ld.1 b/usr/src/man/man1/ld.1 index 7fc0277160..5d26bbb556 100644 --- a/usr/src/man/man1/ld.1 +++ b/usr/src/man/man1/ld.1 @@ -5,7 +5,7 @@ .\" 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 LD 1 "Jun 6, 2016" +.TH LD 1 "May 13, 2017" .SH NAME ld \- link-editor for object files .SH SYNOPSIS @@ -113,7 +113,7 @@ drawbacks. .TP .ie t \(bu .el o -The executable is immune to the benefits of system patches delivered as shared +The executable is immune to the benefits of system updates delivered as shared objects. The executable therefore, must be rebuilt to take advantage of many system improvements. .RE @@ -1486,7 +1486,7 @@ no new members are extracted. \fB-z\fR \fBrescan\fR is a position independent option. The link-editor defers the rescan operation until after it has processed the entire command line, and then initiates a final rescan operation over all archives seen on the command -line. The \fB-z\fR \fBrescan\fR operation can interact incorrectly +line. The \fB-z\fR \fBrescan\fR operation can interact incorrectly with objects that contain initialization (.init) or finalization (.fini) sections, preventing the code in those sections from running. For this reason, \fB-z\fR \fBrescan\fR is deprecated, and use of \fB-z\fR \fBrescan-now\fR is @@ -1511,9 +1511,9 @@ advised. Defines an archive rescan group. This is a positional construct, and is processed by the link-editor immediately upon encountering the closing delimiter option. Archives found within the group delimiter options are -reprocessed as a group in an attempt to locate additional archive members that -resolve symbol references. This archive rescanning is repeated until a pass -over the archives On the occurs in which no new members are extracted. +reprocessed as a group in an attempt to locate additional archive members that +resolve symbol references. This archive rescanning is repeated until a pass +over the archives occurs in which no new members are extracted. Archive rescan groups cannot be nested. .RE diff --git a/usr/src/man/man1/ldaplist.1 b/usr/src/man/man1/ldaplist.1 index 97d016235f..d5b823d68a 100644 --- a/usr/src/man/man1/ldaplist.1 +++ b/usr/src/man/man1/ldaplist.1 @@ -3,7 +3,7 @@ .\" 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 LDAPLIST 1 "Mar 6, 2017" +.TH LDAPLIST 1 "May 13, 2017" .SH NAME ldaplist \- search and list naming information from an LDAP directory using the configured profile @@ -38,7 +38,7 @@ configuration obtained. By default (if the \fB-h\fR \fILDAP_server\fR\fB[:\fR\fIserverPort\fR\fB]\fR option is not specified), the utility searches for and lists the naming information from the LDAP directory service defined in the LDAP configuration -files generated by\fBldapclient\fR(1M) during the client initialization phase. +files generated by \fBldapclient\fR(1M) during the client initialization phase. To use the utility in the default mode, the Solaris LDAP client must be set up in advance. .sp @@ -495,7 +495,7 @@ Interface Stability Committed \fBldap\fR(1), \fBldapadd\fR(1), \fBldapdelete\fR(1), \fBldapmodify\fR(1), \fBldapmodrdn\fR(1), \fBldapsearch\fR(1), \fBidsconfig\fR(1M), \fBldap_cachemgr\fR(1M), \fBldapaddent\fR(1M), \fBldapclient\fR(1M), -\fBsuninstall\fR(1M), \fBresolv.conf\fR(4), \fBattributes\fR(5) +\fBresolv.conf\fR(4), \fBattributes\fR(5) .SH NOTES .LP \fIRFC 2307bis\fR is an IETF informational document in draft stage that defines diff --git a/usr/src/man/man1/man.1 b/usr/src/man/man1/man.1 index c4a16b60bb..1df42e4b1a 100644 --- a/usr/src/man/man1/man.1 +++ b/usr/src/man/man1/man.1 @@ -8,7 +8,7 @@ .\" Copyright 2014 Garrett D'Amore <garrett@damore.org> .\" Copyright 2016 Nexenta Systems, Inc. .\" -.Dd February 12, 2016 +.Dd May 13, 2017 .Dt MAN 1 .Os .Sh NAME @@ -175,7 +175,7 @@ are limited to those specified by .Ar section can be a numerical digit, perhaps followed by one or more letters to match the desired section of the manual, for example, -.Li "3libucb". +.Li "3head". Also, .Ar section can be a word, for example, diff --git a/usr/src/man/man1/mdb.1 b/usr/src/man/man1/mdb.1 index f3a084d151..a27eabc543 100644 --- a/usr/src/man/man1/mdb.1 +++ b/usr/src/man/man1/mdb.1 @@ -4,7 +4,7 @@ .\" 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 MDB 1 "Oct 05, 2012" +.TH MDB 1 "May 13, 2017" .SH NAME mdb \- modular debugger .SH SYNOPSIS @@ -17,7 +17,6 @@ mdb \- modular debugger .SH DESCRIPTION .SS "Introduction" -.sp .LP The \fBmdb\fR utility is an extensible utility for low-level debugging and editing of the live operating system, operating system crash dumps, user @@ -47,7 +46,6 @@ can use to implement their own debugging commands to perform program-specific analysis. Each \fBmdb\fR module can be used to examine the program in several different contexts, including live and post-mortem. .SS "Definitions" -.sp .LP The \fItarget\fR is the program being inspected by the debugger. \fBmdb\fR currently provides support for the following types of targets: user processes, @@ -93,7 +91,6 @@ execution of macro files written for \fBadb\fR(1), and the Solaris installation includes a set of macro files for debugging the Solaris kernel that can be used with either tool. .SS "Syntax" -.sp .LP The debugger processes commands from standard input. If standard input is a terminal, \fBmdb\fR provides terminal editing capabilities. \fBmdb\fR can also @@ -165,7 +162,6 @@ An \fIexpression\fR is a sequence of words that is evaluated to compute a 64-bit unsigned integer value. The words are evaluated using the rules described under \fBArithmetic Expansion\fR below. .SS "Commands" -.sp .LP A \fIcommand\fR is one of the following: .sp @@ -273,12 +269,10 @@ concatenating the words after the \fB!\fR character. .RE .SS "Comments" -.sp .LP A word beginning with \fB//\fR causes that word and all the subsequent characters up to a \fINEWLINE\fR to be ignored. .SS "Arithmetic Expansion" -.sp .LP Arithmetic expansion is performed when an \fBmdb\fR command is preceded by an optional expression representing a start address, or a start address and a @@ -598,7 +592,6 @@ Bitwise inclusive OR. .RE .SS "Quoting" -.sp .LP Each metacharacter described above (see \fBSyntax\fR) terminates a word unless quoted. Characters can be quoted (forcing \fBmdb\fR to interpret each character @@ -607,7 +600,6 @@ single (\fB\&' '\fR) or double (\fB" "\fR) quote marks. A single quote cannot appear within single quotes. Inside double quotes, \fBmdb\fR recognizes the C programming language character escape sequences. .SS "Shell Escapes" -.sp .LP The \fB!\fR character can be used to create a pipeline between an \fBmdb\fR command and the user's shell. If the $\fBSHELL\fR environment variable is set, @@ -621,7 +613,6 @@ to the shell. The output of shell commands can not be piped to \fBmdb\fR dcmds. Commands executed by a shell escape have their output sent directly to the terminal, not to \fBmdb\fR. .SS "Variables" -.sp .LP A \fIvariable\fR is a variable name, a corresponding integer value, and a set of attributes. A variable name is a sequence of letters, digits, underscores, @@ -727,7 +718,6 @@ of the representative thread's register set as named variables. The names of these variables depend on the target's platform and instruction set architecture. .SS "Symbol Name Resolution" -.sp .LP As explained in the \fBSyntax\fR description above, a symbol identifier present in an expression context evaluates to the value of this symbol. The value @@ -840,7 +830,6 @@ either refer to the decimal integer value \fB15\fR specified in hexadecimal symbol table. If a symbol with an ambiguous name is present, the integer value can be specified by using an explicit \fB0x\fR or \fB0X\fR prefix. .SS "dcmd and Walker Name Resolution" -.sp .LP As described earlier, each \fBmdb\fR dmod provides a set of dcmds and walkers. dcmds and walkers are tracked in two distinct, global namespaces. \fBmdb\fR @@ -889,7 +878,6 @@ definition of a dcmd or walker can be determined using the \fB::which\fR dcmd, described below. The global definition list can be displayed using the \fB::which\fR \fB-v\fR option. .SS "dcmd Pipelines" -.sp .LP dcmds can be composed into a pipeline using the \fB|\fR operator. The purpose of a pipeline is to pass a list of values, typically virtual addresses, from @@ -920,7 +908,6 @@ output printed to standard output. If any dcmd in the pipeline produces output to standard error, these messages are printed directly to standard error and are not processed as part of the pipeline. .SS "Signal Handling" -.sp .LP The debugger ignores the \fBPIPE\fR and \fBQUIT\fR signals. The \fBINT\fR signal aborts the command that is currently executing. The debugger intercepts @@ -939,14 +926,12 @@ resume option provides limited protection against buggy dcmds. Refer to WARNINGS, \fBUse of the Error Recovery Mechanism\fR, below for information about the risks associated with the resume option. .SS "Command Re-entry" -.sp .LP The text of the last \fBHISTSIZE \fR (default 128) commands entered from a terminal device are saved in memory. The in-line editing facility, described next, provides key mappings for searching and fetching elements from the history list. .SS "In-line Editing" -.sp .LP If standard input is a terminal device, \fBmdb\fR provides some simple emacs-style facilities for editing the command line. The \fBsearch\fR, @@ -1194,7 +1179,6 @@ Move cursor forward one character (same as \fB^F\fR). .RE .SS "Output Pager" -.sp .LP \fBmdb\fR provides a built-in output pager. The output pager is enabled if the debugger's standard output is a terminal device. Each time a command is @@ -1258,7 +1242,6 @@ Quit (abort) the current dcmd only. .RE .SS "Formatting dcmds" -.sp .LP The \fB/\fR, \fB\e\fR, \fB?\fR, and \fB=\fR metacharacters are used to denote the special output formatting dcmds. Each of these dcmds accepts an argument @@ -1484,7 +1467,6 @@ address that does not have a corresponding segment. If a search reaches a segment boundary without finding a match, it aborts when the read past the end of the segment boundary fails. .SS "Execution Control" -.sp .LP \fBmdb\fR provides facilities for controlling and tracing the execution of a live running program. Currently, only the user process target provides support @@ -1532,7 +1514,6 @@ target that does not support execution control. For more information about the interaction of exec, attach, release, and job control with debugger execution control, refer to NOTES, below. .SS "Event Callbacks" -.sp .LP The \fB::evset\fR dcmd and event tracing dcmds allow you to associate an event callback (using the \fB-c\fR option) with each event specifier. The event @@ -1557,7 +1538,6 @@ the highest precedence determines what type of continue occurs. The order of precedence from highest to lowest is: step, step-over (next), step-out, continue. .SS "Thread Support" -.sp .LP \fBmdb\fR provides facilities to examine the stacks and registers of each thread associated with the target. The persistent "\fBthread\fR" variable @@ -1591,7 +1571,6 @@ corresponding to the current representative thread. The \fB::tls\fR built-in dcmd can be used to display the value of the symbol for threads other than the representative thread. .SS "Built-in dcmds" -.sp .LP \fBmdb\fR provides a set of built-in dcmds that are always defined. Some of these dcmds are only applicable to certain targets: if a dcmd is not applicable @@ -2148,7 +2127,7 @@ Displays paragraphs at 16-byte paragraphs per line. The default number of .sp .6 .RS 4n Print the arguments separated by blanks and terminated by a \fINEWLINE\fR to -standard output. Expressions enclosed in \fB$[ ]\fR is evaluated to a value +standard output. Expressions enclosed in \fB$[ ]\fR is evaluated to a value and printed in the default base. .RE @@ -3699,7 +3678,6 @@ specifiers can also be deleted using \fB::delete\fR. .RE .SH OPTIONS -.sp .LP The following options are supported: .sp @@ -4220,14 +4198,13 @@ only when debugging device drivers and with caution. \fB\fB-y\fR\fR .ad .RS 15n -Sends explicit terminal initialization sequences for tty mode. Some terminals, -such as \fBcmdtool\fR(1), require explicit initialization sequences to switch +Sends explicit terminal initialization sequences for tty mode. Some legacy +terminal emulators require explicit initialization sequences to switch into a tty mode. Without this initialization sequence, terminal features such -as standout mode can not be available to \fBmdb\fR. +as standout mode will not be available to \fBmdb\fR. .RE .SH OPERANDS -.sp .LP The following operands are supported: .sp @@ -4270,14 +4247,12 @@ present in the current directory. .RE .SH USAGE -.sp .LP \fBmdb\fR processes all input files (including scripts, object files, core files, and raw data files) in a large file aware fashion. See \fBlargefile\fR(5) for more information about the processing of large files, which are files greater than or equal to 2 Gbytes (2^31 bytes). .SH EXIT STATUS -.sp .LP The following exit values are returned: .sp @@ -4308,7 +4283,6 @@ Invalid command line options were specified. .RE .SH ENVIRONMENT VARIABLES -.sp .ne 2 .na \fB\fBHISTSIZE\fR\fR @@ -4341,7 +4315,6 @@ not present, \fB/bin/sh\fR is used. .RE .SH FILES -.sp .ne 2 .na \fB\fB$HOME/.mdbrc\fR\fR @@ -4421,7 +4394,6 @@ information in a core file or crash dump, or from the current machine as if by .RE .SH ATTRIBUTES -.sp .LP See \fBattributes\fR(5) for descriptions of the following attributes: .sp @@ -4437,7 +4409,6 @@ Interface Stability Evolving .TE .SH SEE ALSO -.sp .LP \fBadb\fR(1), \fBcmdtool\fR(1), \fBgcore\fR(1), \fBproc\fR(1), \fBpgrep\fR(1), \fBps\fR(1), \fBstty\fR(1), \fBtruss\fR(1), \fBuname\fR(1), \fBcoreadm\fR(1M), @@ -4455,7 +4426,6 @@ Interface Stability Evolving \fISolaris Modular Debugger Guide\fR .SH WARNINGS .SS "Use of the Error Recovery Mechanism" -.sp .LP The debugger and its dmods execute in the same address space, and thus it is quite possible that a buggy dmod can cause \fBmdb\fR to dump core or otherwise @@ -4468,14 +4438,12 @@ subsequent crash of the debugger. The safest course of action following a resume is to save any important debug information, and then quit and restart the debugger. .SS "Use of the Debugger to Modify the Live Operating System" -.sp .LP The use of the debugger to modify (that is, write to) the address space of live running operating system is extremely dangerous, and can result in a system panic in the event the user damages a kernel data structure. .SH NOTES .SS "Limitations on Examining Process Core Files" -.sp .LP \fBmdb\fR does not provide support for examining process core files that were generated by a release of Solaris preceding Solaris 2.6. When debugging core @@ -4490,7 +4458,6 @@ core files using \fBcoreadm\fR(1M). Thus, the information presented by time the process dumped core. Core files from Solaris x86 systems can not be examined on Solaris SPARC systems, and vice-versa. .SS "Limitations on Examining Crash Dump Files" -.sp .LP Crash dumps from Solaris 7 and earlier releases can only be examined with the aid of the libkvm from the corresponding operating system release. If a crash @@ -4500,7 +4467,6 @@ prevent some dcmds or walkers from working properly. \fBmdb\fR issues a warning message if it detects this condition. Crash dumps from Solaris x86 systems can not be examined on Solaris SPARC systems, and vice-versa. .SS "Relationship Between 32-bit and 64-bit Debugger" -.sp .LP \fBmdb\fR provides support for debugging both 32-bit and 64-bit programs. Once it has examined the target and determined its data model, \fBmdb\fR @@ -4516,7 +4482,6 @@ The debugger can also need to re-execute itself when debugging a 32-bit process that execs a 64-bit process, or vice-versa. The handling of this situation is discussed in more detail under \fBInteraction with Exec\fR, below. .SS "Interaction with Exec" -.sp .LP When a controlled process performs a successful \fBexec\fR(2), the behavior of the debugger is controlled by the \fB::set\fR \fB-o\fR \fBfollow_exec_mode\fR @@ -4544,7 +4509,6 @@ dcmds do not since they do not perform data model conversion of structures. The user should release and re-attach the debugger to the process as described above in order to restore full debugging capabilities. .SS "Interaction with Job Control" -.sp .LP If the debugger is attached to a process that is stopped by job control (that is, it stopped in response to \fBSIGTSTP\fR, \fBSIGTTIN\fR, or \fBSIGTTOU\fR), @@ -4561,7 +4525,6 @@ stopped by job control. \fBmdb\fR prints a warning in this case, and the user must issue an "\fBfg\fR" command from the appropriate shell in order to resume the process. .SS "Process Attach and Release" -.sp .LP When \fBmdb\fR attaches to a running process, the process is stopped and remains stopped until one of the continue dcmds is applied, or the debugger @@ -4585,19 +4548,17 @@ released. If the process was already running prior to attaching \fBmdb\fR to it, it is set running again when it is released. A process can be released and left stopped and abandoned using the \fB::release\fR \fB-a\fR option. .SS "Symbolic Debugging Information" -.sp .LP The \fB::list\fR, \fB::offsetof\fR, \fB::print\fR, and \fB::sizeof\fR dcmds require that one or more load objects contain compressed symbolic debugging information suitable for use with \fBmdb\fR. This information is currently only available for certain Solaris kernel modules. .SS "Developer Information" -.sp .LP The \fISolaris Modular Debugger Guide\fR provides a more detailed description of \fBmdb\fR features, as well as information for debugger module developers. .sp .LP The header file \fB<sys/mdb_modapi.h>\fR contains prototypes for the functions -in the MDB Module \fBAPI\fR, and the SUNWmdbdm package provides source code for +in the MDB Module \fBAPI\fR, and distributions may provide source code for an example module in the directory \fB/usr/demo/mdb\fR. diff --git a/usr/src/man/man1/postio.1 b/usr/src/man/man1/postio.1 index ffd7084208..3a4b1e7fec 100644 --- a/usr/src/man/man1/postio.1 +++ b/usr/src/man/man1/postio.1 @@ -3,7 +3,7 @@ .\" 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 POSTIO 1 "Sep 9, 1996" +.TH POSTIO 1 "May 13, 2017" .SH NAME postio \- serial interface for PostScript printers .SH SYNOPSIS @@ -19,12 +19,10 @@ postio \- serial interface for PostScript printers .fi .SH DESCRIPTION -.sp .LP \fBpostio\fR sends \fIfiles\fR to the PostScript printer attached to \fIline.\fR If no \fIfiles\fR are specified the standard input is sent. .SH OPTIONS -.sp .LP The first group of \fIoptions\fR should be sufficient for most applications: .sp @@ -55,7 +53,7 @@ each block is transmitted. .ad .RS 13n Transmit data over \fBline\fR at baud rate \fIspeed\fR. Recognized baud rates -are 1200, 2400, 4800, 9600, and 19200. The default \fIspeed\fR is \fB9600\fR +are 1200, 2400, 4800, 9600, and 19200. The default \fIspeed\fR is \fB9600\fR baud. .RE @@ -66,7 +64,7 @@ baud. .ad .RS 13n Set the internal buffer size for reading and writing \fIfiles\fR to \fInum\fR -bytes. By default \fInum\fR is \fB2048\fR bytes. +bytes. By default \fInum\fR is \fB2048\fR bytes. .RE .sp @@ -76,7 +74,7 @@ bytes. By default \fInum\fR is \fB2048\fR bytes. .ad .RS 13n Connect to the printer attached to \fBline\fR. In most cases there is no -default and \fBpostio\fR must be able to read and write \fBline\fR. If the +default and \fBpostio\fR must be able to read and write \fBline\fR. If the \fBline\fR does not begin with a \fB/\fR it may be treated as a Datakit destination. .RE @@ -170,7 +168,7 @@ one process is used, only data sent to the printer is flow controlled. .sp .LP The \fIoptions\fR are not all mutually exclusive. The \fB-i\fR option always -wins, selecting its own settings for whatever is needed to run interactive +wins, selecting its own settings for whatever is needed to run interactive mode, independent of anything else found on the command line. Interactive mode runs as separate read and write processes and few of the other \fIoptions\fR accomplish anything in the presence of the \fB-i\fR option. The \fB-t\fR option @@ -181,12 +179,12 @@ process. .sp .LP In most cases \fBpostio\fR starts by making a connection to \fBline\fR and then -attempts to force the printer into the IDLE state by sending an appropriate -sequence of \fB^T\fR (status query), \fB^C\fR (interrupt), and \fB^D\fR (end +attempts to force the printer into the IDLE state by sending an appropriate +sequence of \fB^T\fR (status query), \fB^C\fR (interrupt), and \fB^D\fR (end of job) characters. When the printer goes IDLE, \fIfiles\fR are transmitted -along with an occasional \fB^T\fR (unless the \fB-q\fR option was used). After +along with an occasional \fB^T\fR (unless the \fB-q\fR option was used). After all the \fIfiles\fR are sent the program waits until it's reasonably sure the -job is complete. Printer generated error messages received at any time except +job is complete. Printer generated error messages received at any time except while establishing the initial connection (or when running interactive mode) cause \fB postio\fR to exit with a non-zero status. In addition to being added to the log file, printer error messages are also echoed to standard error. @@ -195,7 +193,7 @@ to the log file, printer error messages are also echoed to standard error. \fBExample 1 \fRExamples of the \fBpostio\fR command. .sp .LP -Run as a single process at 9600 baud and send \fIfile1\fR and \fIfile2\fR to +Run as a single process at 9600 baud and send \fIfile1\fR and \fIfile2\fR to the printer attached to \fB/dev/tty01\fR: .sp @@ -221,7 +219,7 @@ bytes, and data returned by the printer gets put in file \fIlog\fR: .sp .LP -Establish an interactive connection with the printer at Datakit destination +Establish an interactive connection with the printer at Datakit destination \fImy/printer\fR: .sp @@ -234,8 +232,8 @@ Establish an interactive connection with the printer at Datakit destination .sp .LP -Send file program to the printer connected to \fB/dev/tty22\fR, recover any -data in file results, and put log messages in file \fIlog\fR: +Send file program to the printer connected to \fB/dev/tty22\fR, recover any +data in file results, and put log messages in file \fIlog\fR: .sp .in +2 @@ -246,7 +244,6 @@ data in file results, and put log messages in file \fIlog\fR: .sp .SH EXIT STATUS -.sp .LP The following exit values are returned: .sp @@ -268,13 +265,10 @@ An error occurred. .RE .SH SEE ALSO -.sp .LP -\fBdownload\fR(1), \fBdpost\fR(1), \fBpostdaisy\fR(1), \fBpostdmd\fR(1), -\fBpostmd\fR(1), \fBpostprint\fR(1), \fBpostreverse\fR(1), \fBposttek\fR(1), +\fBdownload\fR(1), \fBdpost\fR(1), \fBpostprint\fR(1), \fBpostreverse\fR(1), \fBattributes\fR(5) .SH NOTES -.sp .LP The input \fIfiles\fR are handled as a single PostScript job. Sending several different jobs, each with their own internal end of job mark (\fB^D\fR) is not @@ -283,15 +277,15 @@ completed and could be restarted before the last one finishes. .sp .LP All the capabilities described above may not be available on every machine or -even across the different versions of the UNIX system that are currently +even across the different versions of the UNIX system that are currently supported by the program. .sp .LP -There may be no default \fBline\fR, so using the \fB-l\fR option is strongly +There may be no default \fBline\fR, so using the \fB-l\fR option is strongly recommended. If omitted, \fBpostio\fR may attempt to connect to the printer -using the standard output. If Datakit is involved, the \fB-b\fR option may be -ineffective and attempts by \fBpostio\fR to impose flow control over data in +using the standard output. If Datakit is involved, the \fB-b\fR option may be +ineffective and attempts by \fBpostio\fR to impose flow control over data in both directions may not work. The \fB-q\fR option can help if the printer is -connected to RADIAN. The \fB-S\fR option is not generally recommended and +connected to RADIAN. The \fB-S\fR option is not generally recommended and should be used only if all other attempts to establish a reliable connection fail. diff --git a/usr/src/man/man1/postprint.1 b/usr/src/man/man1/postprint.1 index f31d69235e..e28054b1d6 100644 --- a/usr/src/man/man1/postprint.1 +++ b/usr/src/man/man1/postprint.1 @@ -3,7 +3,7 @@ .\" 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 POSTPRINT 1 "Sep 9, 1996" +.TH POSTPRINT 1 "May 13, 2017" .SH NAME postprint \- PostScript translator for text files .SH SYNOPSIS @@ -20,13 +20,11 @@ postprint \- PostScript translator for text files .fi .SH DESCRIPTION -.sp .LP The \fBpostprint\fR filter translates text \fIfiles\fR into PostScript and writes the results on the standard output. If no \fIfiles\fR are specified, or if \fB\(mi\fR is one of the input \fIfiles\fR, the standard input is read. .SH OPTIONS -.sp .ne 2 .na \fB\fB-c\fR\fI num\fR\fR @@ -53,7 +51,7 @@ default font is Courier. .ad .RS 11n Set the length of a page to \fInum\fR lines. By default, \fInum\fR is \fB66\fR. -Setting \fInum\fR to \fB0\fR is allowed, and will cause \fBpostprint\fR to +Setting \fInum\fR to \fB0\fR is allowed, and will cause \fBpostprint\fR to guess a value, based on the point size that's being used. .RE @@ -65,7 +63,7 @@ guess a value, based on the point size that's being used. .RS 11n Magnify each logical page by the factor \fInum\fR. Pages are scaled uniformly about the origin, which is located near the upper left corner of each page. The -default magnification is \fB1.0\fR. +default magnification is \fB1.0\fR. .RE .sp @@ -75,7 +73,7 @@ default magnification is \fB1.0\fR. .ad .RS 11n Print \fInum\fR logical pages on each piece of paper, where \fInum\fR can be -any positive integer. By default, \fInum\fR is set to \fB1\fR. +any positive integer. By default, \fInum\fR is set to \fB1\fR. .RE .sp @@ -87,12 +85,12 @@ any positive integer. By default, \fInum\fR is set to \fB1\fR. Print pages whose numbers are given in the comma-separated \fIlist\fR. The \fIlist\fR contains single numbers \fIN\fR and ranges \fIN1 \fR\(mi\fI N2\fR. A missing \fIN1\fR means the lowest numbered page, a missing \fIN2\fR means the -highest. The page range is an expression of logical pages rather than physical +highest. The page range is an expression of logical pages rather than physical sheets of paper. For example, if you are printing two logical pages to a -sheet, and you specified a range of \fB4\fR, then two sheets of paper would -print, containing four page layouts. If you specified a page range of -\fB3-4\fR, when requesting two logical pages to a sheet; then \fIonly\fR page -3 and page 4 layouts would print, and they would appear on one physical sheet +sheet, and you specified a range of \fB4\fR, then two sheets of paper would +print, containing four page layouts. If you specified a page range of +\fB3-4\fR, when requesting two logical pages to a sheet; then \fIonly\fR page +3 and page 4 layouts would print, and they would appear on one physical sheet of paper. .RE @@ -113,8 +111,8 @@ character of \fImode\fR is significant. The default \fImode\fR is portrait. .ad .RS 11n Selects carriage return behavior. Carriage returns are ignored if \fInum\fR is -\fB0\fR, cause a return to column 1 if \fInum\fR is \fB1\fR, and generate a -newline if \fInum\fR is \fB2\fR. The default \fInum\fR is \fB0\fR. +\fB0\fR, cause a return to column 1 if \fInum\fR is \fB1\fR, and generate a +newline if \fInum\fR is \fB2\fR. The default \fInum\fR is \fB0\fR. .RE .sp @@ -125,7 +123,7 @@ newline if \fInum\fR is \fB2\fR. The default \fInum\fR is \fB0\fR. .RS 11n Print \fIfiles\fR using point size \fInum\fR. When printing in landscape mode \fInum\fR is scaled by a factor that depends on the imaging area of the device. -The default size for portrait mode is \fB10\fR. Note that increasing point +The default size for portrait mode is \fB10\fR. Note that increasing point size increases virtual image size, so you either need to load larger paper, or use the \fB\(mil0\fR option to scale the number of lines per page. .RE @@ -137,7 +135,7 @@ use the \fB\(mil0\fR option to scale the number of lines per page. .ad .RS 11n Assume tabs are set every \fInum\fR columns, starting with the first column. By -default, tabs are set every \fB8\fR columns. +default, tabs are set every \fB8\fR columns. .RE .sp @@ -149,7 +147,7 @@ default, tabs are set every \fB8\fR columns. Translate the origin \fInum\fR inches along the positive x axis. The default coordinate system has the origin fixed near the upper left corner of the page, with positive x to the right and positive y down the page. Positive \fInum\fR -moves everything to the right. The default offset is \fB0.25\fR inches. +moves everything to the right. The default offset is \fB0.25\fR inches. .RE .sp @@ -159,13 +157,13 @@ moves everything to the right. The default offset is \fB0.25\fR inches. .ad .RS 11n Translate the origin \fInum\fR inches along the positive y axis. Positive -\fInum\fR moves text up the page. The default offset is \fB\(mi0.25\fR inches. +\fInum\fR moves text up the page. The default offset is \fB\(mi0.25\fR inches. .RE .sp .LP -A new logical page is started after 66 lines have been printed on the current -page, or whenever an ASCII form feed character is read. The number of lines +A new logical page is started after 66 lines have been printed on the current +page, or whenever an ASCII form feed character is read. The number of lines per page can be changed using the \fB-l\fR option. Unprintable ASCII characters are ignored, and lines that are too long are silently truncated by the printer. .SH EXAMPLES @@ -173,7 +171,7 @@ are ignored, and lines that are too long are silently truncated by the printer. \fBExample 1 \fRExamples of \fBpostprint\fR. .sp .LP -To print \fIfile1\fR and \fIfile2\fR in landscape mode, issue the following +To print \fIfile1\fR and \fIfile2\fR in landscape mode, issue the following command: .sp @@ -197,7 +195,6 @@ To print three logical pages on each physical page in portrait mode: .sp .SH EXIT STATUS -.sp .LP The following exit values are returned: .sp @@ -219,7 +216,6 @@ An error occurred. .RE .SH FILES -.sp .ne 2 .na \fB\fB/usr/lib/lp/postscript/forms.ps\fR\fR @@ -240,8 +236,6 @@ An error occurred. .RE .SH SEE ALSO -.sp .LP -\fBdownload\fR(1), \fBdpost\fR(1), \fBpostdaisy\fR(1), \fBpostdmd\fR(1), -\fBpostio\fR(1), \fBpostmd\fR(1), \fBpostreverse\fR(1), \fBposttek\fR(1), +\fBdownload\fR(1), \fBdpost\fR(1), \fBpostio\fR(1), \fBpostreverse\fR(1), \fBattributes\fR(5) diff --git a/usr/src/man/man1/postreverse.1 b/usr/src/man/man1/postreverse.1 index f514561cff..a44d70fc42 100644 --- a/usr/src/man/man1/postreverse.1 +++ b/usr/src/man/man1/postreverse.1 @@ -3,7 +3,7 @@ .\" 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 POSTREVERSE 1 "Sep 9, 1996" +.TH POSTREVERSE 1 "May 13, 2017" .SH NAME postreverse \- reverse the page order in a PostScript file .SH SYNOPSIS @@ -18,7 +18,6 @@ postreverse \- reverse the page order in a PostScript file .fi .SH DESCRIPTION -.sp .LP The \fBpostreverse\fR filter reverses the page order in files that conform to Adobe's Version 1.0 or Version 2.0 file structuring conventions, and writes the @@ -40,7 +39,6 @@ Because global definitions are extracted from individual pages and put in the prologue, the output file can be minimally conforming, even if the input \fBfile\fR was not. .SH OPTIONS -.sp .ne 2 .na \fB\fB-o\fR\fI list\fR\fR @@ -107,7 +105,6 @@ without reversing the pages: .sp .SH EXIT STATUS -.sp .LP The following exit values are returned: .sp @@ -129,13 +126,10 @@ An error occurred. .RE .SH SEE ALSO -.sp .LP -\fBdownload\fR(1), \fBdpost\fR(1), \fBpostdaisy\fR(1), \fBpostdmd\fR(1), -\fBpostio\fR(1), \fBpostmd\fR(1), \fBpostprint\fR(1), \fBposttek\fR(1), +\fBdownload\fR(1), \fBdpost\fR(1), \fBpostio\fR(1), \fBpostprint\fR(1), \fBattributes\fR(5) .SH NOTES -.sp .LP No attempt has been made to deal with redefinitions of global variables or procedures. If standard input is used, the input \fBfile\fR will be read three diff --git a/usr/src/man/man1/rup.1 b/usr/src/man/man1/rup.1 index dccc894b01..d8c7b1c883 100644 --- a/usr/src/man/man1/rup.1 +++ b/usr/src/man/man1/rup.1 @@ -3,7 +3,7 @@ .\" 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 RUP 1 "Mar 7, 2003" +.TH RUP 1 "May 13, 2017" .SH NAME rup \- show host status of remote machines (RPC version) .SH SYNOPSIS @@ -18,7 +18,6 @@ rup \- show host status of remote machines (RPC version) .fi .SH DESCRIPTION -.sp .LP \fBrup\fR gives a status similar to \fBuptime\fR for remote machines. It broadcasts on the local network, and displays the responses it receives. @@ -32,14 +31,12 @@ When \fIhost\fR arguments are given, rather than broadcasting \fBrup\fR will only query the list of specified hosts. .sp .LP -A remote host will only respond if it is running the \fBrstatd\fR daemon, which -is normally started up from \fBinetd\fR(1M). +A remote host will only respond if it is running the \fBrstatd\fR daemon. .sp .LP -In the absence of a name service, such as LDAP or NIS, \fBrup\fR displays host +In the absence of a name service, \fBrup\fR displays host names as numeric IP addresses. .SH OPTIONS -.sp .ne 2 .na \fB\fB-h\fR\fR @@ -67,13 +64,8 @@ Sort the display by up time. .RE .SH SEE ALSO -.sp .LP -\fBruptime\fR(1), \fBinetd\fR(1M), \fBattributes\fR(5) -.sp -.LP -\fISolaris Express Installation Guide: Basic Installations\fR +\fBruptime\fR(1), \fBattributes\fR(5) .SH BUGS -.sp .LP Broadcasting does not work through gateways. diff --git a/usr/src/man/man1/sar.1 b/usr/src/man/man1/sar.1 index 8ea0c0b20c..9318d3d394 100644 --- a/usr/src/man/man1/sar.1 +++ b/usr/src/man/man1/sar.1 @@ -4,7 +4,7 @@ .\" 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 SAR 1 "Jul 24, 2004" +.TH SAR 1 "May 13, 2017" .SH NAME sar \- system activity reporter .SH SYNOPSIS @@ -20,7 +20,6 @@ sar \- system activity reporter .fi .SH DESCRIPTION -.sp .LP In the first instance, the \fBsar\fR utility samples cumulative activity counters in the operating system at \fIn\fR intervals of \fIt\fR seconds, where @@ -41,7 +40,6 @@ arguments with \fItime\fR specified in the form \fIhh\fR[:\fImm\fR[:\fIss\fR]]. The \fB-i\fR option selects records at \fIsec\fR second intervals. Otherwise, all intervals found in the data file are reported. .SH OPTIONS -.sp .LP The following options modify the subsets of information reported by \fBsar\fR. .sp @@ -663,7 +661,6 @@ example% sar -d -f temp .sp .SH FILES -.sp .ne 2 .na \fB\fB/var/adm/sa/sa\fIdd\fR\fR\fR @@ -673,15 +670,13 @@ daily data file, where \fIdd\fR are digits representing the day of the month .RE .SH SEE ALSO -.sp .LP -\fBsag\fR(1), \fBiostat\fR(1M), \fBsar\fR(1M), \fBvmstat\fR(1M), \fBexec\fR(2), +\fBiostat\fR(1M), \fBsar\fR(1M), \fBvmstat\fR(1M), \fBexec\fR(2), \fBfork\fR(2), \fBattributes\fR(5) .sp .LP \fISystem Administration Guide: Advanced Administration\fR .SH NOTES -.sp .LP The sum of CPU utilization might vary slightly from 100 because of rounding errors in the production of a percentage figure. diff --git a/usr/src/man/man1/sleep.1 b/usr/src/man/man1/sleep.1 index c5307221c5..102ae2272c 100644 --- a/usr/src/man/man1/sleep.1 +++ b/usr/src/man/man1/sleep.1 @@ -11,7 +11,7 @@ .\" 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 SLEEP 1 "Sep 10, 2013" +.TH SLEEP 1 "May 13, 2017" .SH NAME sleep \- suspend execution for an interval .SH SYNOPSIS @@ -28,7 +28,6 @@ sleep \- suspend execution for an interval .fi .SH DESCRIPTION -.sp .LP \fBsleep\fR suspends execution for at least the time in seconds specified by \fIseconds\fR or until a \fBSIGALRM\fR signal is received. The \fIseconds\fR @@ -36,7 +35,6 @@ operand can be specified as a floating point number but the actual granularity normally depends on the underlying system. .SH OPERANDS .SS "/usr/bin/sleep" -.sp .LP The following operands are supported for \fB/usr/bin/sleep\fR and \fBksh93\fR's \fBsleep\fR built-in command: @@ -48,11 +46,10 @@ The following operands are supported for \fB/usr/bin/sleep\fR and \fBksh93\fR's .RS 11n A non-negative floating-point number specifying the number of seconds for which to suspend execution. The floating-point number may be specified in all formats -required by C99/XPG6, including constants such as "Inf" or "infinite". +required by C99/XPG6, including constants such as "Inf" or "infinity". .RE .SS "ksh93" -.sp .LP The following operands are supported: .sp @@ -134,13 +131,11 @@ example% sleep 0x1.0000000000000000000000000000p-01 .sp .SH ENVIRONMENT VARIABLES -.sp .LP See \fBenviron\fR(5) for descriptions of the following environment variables that affect the execution of \fBsleep\fR: \fBLANG\fR, \fBLC_ALL\fR, \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and \fBNLSPATH\fR. .SH EXIT STATUS -.sp .LP The following exit values are returned: .sp @@ -163,13 +158,9 @@ An error has occurred. .RE .SH ATTRIBUTES -.sp .LP See \fBattributes\fR(5) for descriptions of the following attributes: .SS "/usr/bin/sleep" -.sp - -.sp .TS box; c | c @@ -182,9 +173,6 @@ Standard See \fBstandards\fR(5). .TE .SS "ksh93" -.sp - -.sp .TS box; c | c @@ -195,12 +183,10 @@ Interface Stability Uncommitted .TE .SH SEE ALSO -.sp .LP \fBksh93\fR(1), \fBwait\fR(1), \fBalarm\fR(2), \fBsleep\fR(3C), -\fBwait\fR(3UCB), \fBattributes\fR(5), \fBenviron\fR(5), \fBstandards\fR(5) +\fBattributes\fR(5), \fBenviron\fR(5), \fBstandards\fR(5) .SH NOTES -.sp .LP If the \fBsleep\fR utility receives a \fBSIGALRM\fR signal, one of the following actions is taken: diff --git a/usr/src/man/man1/uname.1 b/usr/src/man/man1/uname.1 index f5e0c57f59..a8e879fab2 100644 --- a/usr/src/man/man1/uname.1 +++ b/usr/src/man/man1/uname.1 @@ -9,7 +9,7 @@ .\" 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 UNAME 1 "Apr 14, 2016" +.TH UNAME 1 "May 13, 2017" .SH NAME uname \- print name of current system .SH SYNOPSIS @@ -109,8 +109,8 @@ The nodename may be changed by specifying a system name argument. The system name argument is restricted to \fBSYS_NMLN\fR characters. \fBSYS_NMLN\fR is an implementation specific value defined in \fB<sys/utsname.h>\fR\&. Only the super-user is allowed this capability. This change does not persist across -reboots of the system. Use \fBsys-unconfig\fR(1M) to change a host's name -permanently. +reboots of the system. See \fBnodename\fR(4) for details of how to change a +host's name permanently. .RE .sp @@ -214,7 +214,7 @@ Interface Stability Standard .SH SEE ALSO .LP -\fBarch\fR(1), \fBisalist\fR(1), \fBsys-unconfig\fR(1M), \fBsysinfo\fR(2), +\fBarch\fR(1), \fBisalist\fR(1), \fBsysinfo\fR(2), \fBuname\fR(2), \fBnodename\fR(4), \fBattributes\fR(5), \fBenviron\fR(5), \fBstandards\fR(5) .SH NOTES @@ -228,8 +228,7 @@ To determine the operating system name and release level, use \fBuname \fR\fB-sr\fR. To determine only the operating system release level, use \fBuname \fR\fB-r\fR. Notice that operating system release levels are not guaranteed to be in \fIx.y\fR format (such as 5.3, 5.4, 5.5, and so forth); -future releases could be in the \fIx.y.z\fR format (such as 5.3.1, 5.3.2, -5.4.1, and so forth). +but could be in the \fIx.y.z\fR format (such as 5.5.1). .sp .LP In SunOS 4.\fIx\fR releases, the \fBarch\fR(1) command was often used to obtain diff --git a/usr/src/man/man1/vacation.1 b/usr/src/man/man1/vacation.1 index 40c61a55fe..744de3ff18 100644 --- a/usr/src/man/man1/vacation.1 +++ b/usr/src/man/man1/vacation.1 @@ -4,7 +4,7 @@ .\" 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 VACATION 1 "Aug 20, 2005" +.TH VACATION 1 "May 13, 2017" .SH NAME vacation \- reply to mail automatically .SH SYNOPSIS @@ -25,17 +25,15 @@ vacation \- reply to mail automatically .fi .SH DESCRIPTION -.sp .LP The \fBvacation\fR utility automatically replies to incoming mail. .SS "Installation" -.sp .LP The installation consists of an interactive program which sets up \fBvacation\fR's basic configuration. .sp .LP -To install \fBvacation\fR, type it with no arguments on the command line. The +To install \fBvacation\fR, type it with no arguments on the command line. The program creates a \fB\&.vacation.msg\fR file, which contains the message that is automatically sent to all senders when \fBvacation\fR is enabled, and starts an editor for you to modify the message. (See USAGE section.) Which editor is @@ -68,29 +66,24 @@ The program automatically creates \fB\&.vacation.pag\fR and \fB\&.vacation.dir\fR, which contain a list of senders when \fBvacation\fR is enabled. .SS "Activation and Deactivation" -.sp .LP The presence of the \fB\&.forward\fR file determines whether or not \fBvacation\fR is disabled or enabled. To disable \fBvacation\fR, remove the \fB\&.forward\fR file, or move it to a new name. .SS "Initialization" -.sp .LP The \fB-I\fR option clears the \fBvacation\fR log files, \fB\&.vacation.pag\fR and \fB\&.vacation.dir\fR, erasing the list of senders from a previous \fBvacation\fR session. (See OPTIONS section.) .SS "Additional Configuration" -.sp .LP \fBvacation\fR provides configuration options that are not part of the installation, these being \fB-a\fR, \fB-e\fR, \fB-f\fR, \fB-j\fR, \fB-m\fR, \fB-s\fR, and \fB-t\fR. (See OPTIONS section.) .SS "Reporting" -.sp .LP \fBvacation\fR provides a reporting option, \fB-l\fR. See \fBOPTIONS\fR. .SH OPTIONS -.sp .LP The following options are supported: .sp @@ -212,7 +205,6 @@ of \fBvacation -I\fR, along with a date and time stamp. .RE .SH USAGE -.sp .LP \fB\&.vacation.msg\fR should include a header with at least a \fBSubject:\fR line (it should not include a \fBTo:\fR line). For example: @@ -293,9 +285,8 @@ anotherfriend@herisp.com .sp .LP -Blank lines and lines starting with "\fB#\fR" are ignored. +Blank lines and lines starting with "\fB#\fR" are ignored. .SH FILES -.sp .LP \fB~/.forward\fR .sp @@ -310,7 +301,6 @@ A list of senders is kept in the \fBdbm\fR format files \fB\&.vacation.pag\fR and \fB\&.vacation.dir\fR in your home directory. These files are \fBdbm\fR files and cannot be viewed directly with text editors. .SH SEE ALSO -.sp .LP -\fBvi\fR(1), \fBsendmail\fR(1M), \fBdbm\fR(3UCB), \fBgetusershell\fR(3C), +\fBvi\fR(1), \fBsendmail\fR(1M), \fBgetusershell\fR(3C), \fBaliases\fR(4), \fBshells\fR(4), \fBattributes\fR(5) diff --git a/usr/src/man/man1/who.1 b/usr/src/man/man1/who.1 index 3e2c121ee7..326d3bff60 100644 --- a/usr/src/man/man1/who.1 +++ b/usr/src/man/man1/who.1 @@ -9,7 +9,7 @@ .\" 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 WHO 1 "Nov 3, 2000" +.TH WHO 1 "May 13, 2017" .SH NAME who \- who is on the system .SH SYNOPSIS @@ -59,7 +59,6 @@ who \- who is on the system .fi .SH DESCRIPTION -.sp .LP The \fBwho\fR utility can list the user's name, terminal line, login time, elapsed time since activity occurred on the line, and the process-ID of the @@ -155,7 +154,6 @@ Exit status for dead processes .RE .SH OPTIONS -.sp .LP The following options are supported: .sp @@ -186,7 +184,7 @@ Indicates the time and date of the last reboot. .RS 9n Displays all processes that have expired and not been respawned by \fBinit\fR. The \fBexit\fR field appears for dead processes and contains the termination -and exit values (as returned by \fBwait\fR(3UCB)), of the dead process. This +and exit values of the dead process. This can be useful in determining why a process terminated. .RE @@ -273,7 +271,6 @@ Indicates the current \fIrun-level\fR of the \fBinit\fR process. .RE .SS "/usr/bin/who" -.sp .ne 2 .na \fB\fB-T\fR \fR @@ -312,7 +309,6 @@ The terminal write-access state cannot be determined. .RE .SS "/usr/xpg4/bin/who" -.sp .ne 2 .na \fB\fB-T\fR \fR @@ -357,7 +353,6 @@ and so forth. .RE .SH OPERANDS -.sp .LP The following operands are supported: .sp @@ -386,13 +381,11 @@ users that \fBwho\fR uses by default. .RE .SH ENVIRONMENT VARIABLES -.sp .LP See \fBenviron\fR(5) for descriptions of the following environment variables that affect the execution of \fBwho\fR: \fBLANG\fR, \fBLC_ALL\fR, \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, \fBLC_TIME\fR, and \fBNLSPATH\fR. .SH EXIT STATUS -.sp .LP The following exit values are returned: .sp @@ -414,7 +407,6 @@ An error occurred. .RE .SH FILES -.sp .ne 2 .na \fB\fB/sbin/inittab\fR \fR @@ -442,13 +434,9 @@ Historic user and accounting information .RE .SH ATTRIBUTES -.sp .LP See \fBattributes\fR(5) for descriptions of the following attributes: .SS "/usr/xpg4/bin/who" -.sp - -.sp .TS box; c | c @@ -459,13 +447,11 @@ Interface Stability Standard .TE .SH SEE ALSO -.sp .LP \fBdate\fR(1), \fBlogin\fR(1), \fBmesg\fR(1), \fBinit\fR(1M), \fBsu\fR(1M), -\fBwait\fR(3UCB), \fBinittab\fR(4), \fButmpx\fR(4), \fBattributes\fR(5), +\fBinittab\fR(4), \fButmpx\fR(4), \fBattributes\fR(5), \fBenviron\fR(5), \fBstandards\fR(5) .SH NOTES -.sp .LP \fBSuperuser:\fR After a shutdown to the single-user state, \fBwho\fR returns a prompt. Since \fB/var/adm/utmpx\fR is updated at login time and there is no |