diff options
Diffstat (limited to 'usr/src/man/man1')
410 files changed, 3434 insertions, 18385 deletions
diff --git a/usr/src/man/man1/Intro.1 b/usr/src/man/man1/Intro.1 index a252f24c0e..9512d0a4e2 100644 --- a/usr/src/man/man1/Intro.1 +++ b/usr/src/man/man1/Intro.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 Intro 1 "18 Nov 2008" "SunOS 5.11" "User Commands" +.TH INTRO 1 "Nov 18, 2008" .SH NAME Intro, intro \- introduction to commands and application programs .SH DESCRIPTION @@ -17,45 +17,37 @@ operating system. Pages of special interest are categorized as follows: .sp .ne 2 -.mk .na \fB1B\fR .ad .RS 6n -.rt Commands found only in the \fISunOS/BSD Compatibility Package\fR. .RE .sp .ne 2 -.mk .na \fB1C\fR .ad .RS 6n -.rt Commands for communicating with other systems. .RE .sp .ne 2 -.mk .na \fB1F\fR .ad .RS 6n -.rt Commands associated with \fIForm and Menu Language Interpreter\fR (FMLI). .RE .sp .ne 2 -.mk .na \fB1S\fR .ad .RS 6n -.rt Commands specific to SunOS. .RE @@ -97,69 +89,57 @@ should be interpreted as explained below. \fIname\fR [\fB-\fR\fIoption\fR...] [\fIcmdarg\fR...] where: .sp .ne 2 -.mk .na \fB[ ]\fR .ad .RS 15n -.rt Surround an \fIoption\fR or \fIcmdarg\fR that is not required. .RE .sp .ne 2 -.mk .na \fB\fI\&...\fR\fR .ad .RS 15n -.rt Indicates multiple occurrences of the \fIoption\fR or \fIcmdarg\fR. .RE .sp .ne 2 -.mk .na \fB\fIname\fR\fR .ad .RS 15n -.rt The name of an executable file. .RE .sp .ne 2 -.mk .na \fB{ }\fR .ad .RS 15n -.rt The options and/or arguments enclosed within braces are interdependent, such that everything enclosed must be treated as a unit. .RE .sp .ne 2 -.mk .na \fB\fIoption\fR\fR .ad .RS 15n -.rt (Always preceded by a "\(mi".) \fInoargletter\fR... or, \fIargletter\fR \fIoptarg\fR[\fB,\fR...] .RE .sp .ne 2 -.mk .na \fB\fInoargletter\fR\fR .ad .RS 15n -.rt A single letter representing an option without an option-argument. Notice that more than one \fInoargletter\fR option can be grouped after one "\(mi" (Guideline 5, below). @@ -167,23 +147,19 @@ more than one \fInoargletter\fR option can be grouped after one "\(mi" .sp .ne 2 -.mk .na \fB\fIargletter\fR\fR .ad .RS 15n -.rt A single letter representing an option requiring an option-argument. .RE .sp .ne 2 -.mk .na \fB\fIoptarg\fR\fR .ad .RS 15n -.rt An option-argument (character string) satisfying a preceding \fIargletter\fR. Notice that groups of \fIoptargs\fR following an \fIargletter\fR must be separated by commas, or separated by a tab or space character and quoted @@ -192,12 +168,10 @@ separated by commas, or separated by a tab or space character and quoted .sp .ne 2 -.mk .na \fB\fIcmdarg\fR\fR .ad .RS 15n -.rt Path name (or other command argument) \fInot\fR beginning with "\(mi", or "\(mi" by itself indicating the standard input. .RE @@ -401,12 +375,10 @@ option_argument\fR in the example). CLIP expands the guidelines discussed with the following additional guidelines: .sp .ne 2 -.mk .na \fB14.\fR .ad .RS 7n -.rt The form \fBcommand subcommand [options] [operands]\fR is appropriate for grouping similar operations. Subcommand names should follow the same conventions as command names as specified in guidelines 1 and 2. @@ -414,12 +386,10 @@ conventions as command names as specified in guidelines 1 and 2. .sp .ne 2 -.mk .na \fB15.\fR .ad .RS 7n -.rt Long-options should be preceded by \fB--\fR and should include only alphanumeric characters and hyphens from the portable character set. Option names are typically one to three words long, with hyphens to separate words. @@ -427,24 +397,20 @@ names are typically one to three words long, with hyphens to separate words. .sp .ne 2 -.mk .na \fB16.\fR .ad .RS 7n -.rt \fB--name=argument\fR should be used to specify an option-argument for a long-option. The form \fB--name argument\fR is also accepted. .RE .sp .ne 2 -.mk .na \fB17.\fR .ad .RS 7n -.rt 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 @@ -455,12 +421,10 @@ after displaying the appropriate output, the utility successfully exits. .sp .ne 2 -.mk .na \fB18.\fR .ad .RS 7n -.rt Every short-option should have exactly one corresponding long-option and every long-option should have exactly one corresponding short-option. Synonymous options can be allowed in the interest of compatibility with historical @@ -469,12 +433,10 @@ practice or community versions of equivalent utilities. .sp .ne 2 -.mk .na \fB19.\fR .ad .RS 7n -.rt The short-option name should get its name from the long-option name according to these rules: .RS +4 @@ -504,12 +466,10 @@ arbitrary character. .sp .ne 2 -.mk .na \fB20.\fR .ad .RS 7n -.rt 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 @@ -518,12 +478,10 @@ character is the most descriptive name. .sp .ne 2 -.mk .na \fB21.\fR .ad .RS 7n -.rt The subcommand in the form described in guideline 1 of the additional CLIP guidelines is generally required. In the case where it is omitted, the command shall take no operands and only options which are defined to stop further diff --git a/usr/src/man/man1/acctcom.1 b/usr/src/man/man1/acctcom.1 index 9f24e556c5..8a44c7af7c 100644 --- a/usr/src/man/man1/acctcom.1 +++ b/usr/src/man/man1/acctcom.1 @@ -1,18 +1,18 @@ '\" te -.\" Copyright 1989 AT&T +.\" Copyright 1989 AT&T .\" 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 acctcom 1 "11 Jan 1996" "SunOS 5.11" "User Commands" +.TH ACCTCOM 1 "Jan 11, 1996" .SH NAME acctcom \- search and print process accounting files .SH SYNOPSIS .LP .nf -\fBacctcom\fR [\fB-abfhikmqrtv\fR] [\fB-C\fR \fIsec\fR] [\fB-e\fR \fItime\fR] [\fB-E\fR \fItime\fR] - [\fB-g\fR \fIgroup\fR] [\fB-H\fR \fIfactor\fR] [\fB-I\fR \fIchars\fR] [\fB-l\fR \fIline\fR] - [\fB-n\fR \fIpattern\fR] [\fB-o\fR \fIoutput-file\fR] [\fB-O\fR \fIsec\fR] [\fB-s\fR \fItime\fR] +\fBacctcom\fR [\fB-abfhikmqrtv\fR] [\fB-C\fR \fIsec\fR] [\fB-e\fR \fItime\fR] [\fB-E\fR \fItime\fR] + [\fB-g\fR \fIgroup\fR] [\fB-H\fR \fIfactor\fR] [\fB-I\fR \fIchars\fR] [\fB-l\fR \fIline\fR] + [\fB-n\fR \fIpattern\fR] [\fB-o\fR \fIoutput-file\fR] [\fB-O\fR \fIsec\fR] [\fB-s\fR \fItime\fR] [\fB-S\fR \fItime\fR] [\fB-u\fR \fIuser\fR] [\fIfilename\fR]... .fi @@ -53,48 +53,40 @@ the current file are found in \fB/var/adm/pacct\fIincr\fR\fR. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 18n -.rt Show some average statistics about the processes selected. The statistics will be printed after the output records. .RE .sp .ne 2 -.mk .na \fB\fB-b\fR\fR .ad .RS 18n -.rt Read backwards, showing latest commands first. This option has no effect when standard input is read. .RE .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 18n -.rt Print the \fBfork()\fR/\fBexec()\fR flag and system exit status columns in the output. The numeric output for this option will be in octal. .RE .sp .ne 2 -.mk .na \fB\fB-h\fR\fR .ad .RS 18n -.rt Instead of mean memory size, show the fraction of total available \fBCPU\fR time consumed by the process during its execution. This "hog factor" is computed as (total \fBCPU\fR time)/(elapsed time). @@ -102,230 +94,190 @@ computed as (total \fBCPU\fR time)/(elapsed time). .sp .ne 2 -.mk .na \fB\fB-i\fR\fR .ad .RS 18n -.rt Print columns containing the \fBI/O\fR counts in the output. .RE .sp .ne 2 -.mk .na \fB\fB-k\fR\fR .ad .RS 18n -.rt Instead of memory size, show total kcore-minutes. .RE .sp .ne 2 -.mk .na \fB\fB-m\fR\fR .ad .RS 18n -.rt Show mean core size (the default). .RE .sp .ne 2 -.mk .na \fB\fB-q\fR\fR .ad .RS 18n -.rt Do not print any output records, just print the average statistics as with the \fB-a\fR option. .RE .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 18n -.rt Show \fBCPU\fR factor (user-time/(system-time + user-time)). .RE .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad .RS 18n -.rt Show separate system and user \fBCPU\fR times. .RE .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 18n -.rt Exclude column headings from the output. .RE .sp .ne 2 -.mk .na \fB\fB-C\fR \fIsec\fR\fR .ad .RS 18n -.rt Show only processes with total \fBCPU\fR time (system-time + user-time) exceeding \fIsec\fR seconds. .RE .sp .ne 2 -.mk .na \fB\fB-e\fR \fItime\fR\fR .ad .RS 18n -.rt Select processes existing at or before \fItime\fR. .RE .sp .ne 2 -.mk .na \fB\fB-E\fR \fItime\fR\fR .ad .RS 18n -.rt Select processes ending at or before \fItime\fR. Using the same \fItime\fR for both \fB-S\fR and \fB-E\fR shows the processes that existed at \fItime\fR. .RE .sp .ne 2 -.mk .na \fB\fB-g\fR \fIgroup\fR\fR .ad .RS 18n -.rt Show only processes belonging to \fIgroup\fR. The \fIgroup\fR may be designated by either the group \fBID\fR or group name. .RE .sp .ne 2 -.mk .na \fB\fB-H\fR \fIfactor\fR\fR .ad .RS 18n -.rt Show only processes that exceed \fBfactor\fR, where factor is the "hog factor" as explained in option \fB-h\fR above. .RE .sp .ne 2 -.mk .na \fB\fB-I\fR \fIchars\fR\fR .ad .RS 18n -.rt Show only processes transferring more characters than the cutoff number given by \fIchars\fR. .RE .sp .ne 2 -.mk .na \fB\fB-l\fR \fIline\fR\fR .ad .RS 18n -.rt Show only processes belonging to terminal \fB/dev/term/line\fR. .RE .sp .ne 2 -.mk .na \fB\fB-n\fR \fIpattern\fR\fR .ad .RS 18n -.rt Show only commands matching \fIpattern\fR that may be a regular expression as in \fBregcmp\fR(3C), except \fB+\fR means one or more occurrences. .RE .sp .ne 2 -.mk .na \fB\fB-o\fR \fIoutput-file\fR\fR .ad .RS 18n -.rt Copy selected process records in the input data format to \fIoutput-file\fR; suppress printing to standard output. .RE .sp .ne 2 -.mk .na \fB\fB-O\fR \fIsec\fR\fR .ad .RS 18n -.rt Show only processes with \fBCPU\fR system time exceeding \fIsec\fR seconds. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR \fItime\fR\fR .ad .RS 18n -.rt Select processes existing at or after \fItime\fR, given in the format \fIhr\fR\|[\|:\fImin\fR\|[\|:\fIsec\fR\|]\|]. .RE .sp .ne 2 -.mk .na \fB\fB-S\fR \fItime\fR\fR .ad .RS 18n -.rt Select processes starting at or after \fItime\fR. .RE .sp .ne 2 -.mk .na \fB\fB-u\fR \fIuser\fR\fR .ad .RS 18n -.rt Show only processes belonging to \fIuser\fR. The user may be specified by a user \fBID\fR, a login name that is then converted to a user \fBID\fR, `\fB#\fR' (which designates only those processes executed with superuser @@ -336,34 +288,28 @@ with unknown user \fBID\fRs). .SH FILES .sp .ne 2 -.mk .na \fB\fB/etc/group\fR\fR .ad .RS 22n -.rt system group file .RE .sp .ne 2 -.mk .na \fB\fB/etc/passwd\fR\fR .ad .RS 22n -.rt system password file .RE .sp .ne 2 -.mk .na \fB\fB/var/adm/pacct\fIincr\fR\fR\fR .ad .RS 22n -.rt active processes accounting file .RE @@ -375,13 +321,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled .TE .SH SEE ALSO diff --git a/usr/src/man/man1/adb.1 b/usr/src/man/man1/adb.1 index b74e7031ef..49c687ba21 100644 --- a/usr/src/man/man1/adb.1 +++ b/usr/src/man/man1/adb.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 adb 1 "29 Nov 2005" "SunOS 5.11" "User Commands" +.TH ADB 1 "Nov 29, 2005" .SH NAME adb \- general-purpose debugger .SH SYNOPSIS diff --git a/usr/src/man/man1/addbib.1 b/usr/src/man/man1/addbib.1 index 54ec130f97..127e6f01aa 100644 --- a/usr/src/man/man1/addbib.1 +++ b/usr/src/man/man1/addbib.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 addbib 1 "14 Sep 1992" "SunOS 5.11" "User Commands" +.TH ADDBIB 1 "Sep 14, 1992" .SH NAME addbib \- create or extend a bibliographic database .SH SYNOPSIS @@ -31,24 +31,20 @@ with any system editor (see \fBvi\fR(1), \fBex\fR(1), \fBed\fR(1)). The following options are supported: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 17n -.rt Suppresses prompting for an abstract. Asking for an abstract is the default. Abstracts are ended with a Control\(miD. .RE .sp .ne 2 -.mk .na \fB\fB-p\fR \fIpromptfile\fR\fR .ad .RS 17n -.rt Uses a new prompting skeleton, defined in \fIpromptfile\fR. This file should contain prompt strings, a TAB, and the key-letters to be written to the \fIdatabase\fR. @@ -64,254 +60,208 @@ but if you edit the bibliography file later on, you will need to know this information. .sp .ne 2 -.mk .na \fB\fB%A\fR\fR .ad .RS 8n -.rt Author's name .RE .sp .ne 2 -.mk .na \fB\fB%B\fR\fR .ad .RS 8n -.rt Book containing article referenced .RE .sp .ne 2 -.mk .na \fB\fB%C\fR\fR .ad .RS 8n -.rt City (place of publication) .RE .sp .ne 2 -.mk .na \fB\fB%D\fR\fR .ad .RS 8n -.rt Date of publication .RE .sp .ne 2 -.mk .na \fB\fB%E\fR\fR .ad .RS 8n -.rt Editor of book containing article referenced .RE .sp .ne 2 -.mk .na \fB\fB%F\fR\fR .ad .RS 8n -.rt Footnote number or label (supplied by \fBrefer\fR) .RE .sp .ne 2 -.mk .na \fB\fB%G\fR\fR .ad .RS 8n -.rt Government order number .RE .sp .ne 2 -.mk .na \fB\fB%H\fR\fR .ad .RS 8n -.rt Header commentary, printed before reference .RE .sp .ne 2 -.mk .na \fB\fB%I\fR\fR .ad .RS 8n -.rt Issuer (publisher) .RE .sp .ne 2 -.mk .na \fB\fB%J\fR\fR .ad .RS 8n -.rt Journal containing article .RE .sp .ne 2 -.mk .na \fB\fB%K\fR\fR .ad .RS 8n -.rt Keywords to use in locating reference .RE .sp .ne 2 -.mk .na \fB\fB%L\fR\fR .ad .RS 8n -.rt Label field used by \fB-k\fR option of \fBrefer\fR .RE .sp .ne 2 -.mk .na \fB\fB%M\fR\fR .ad .RS 8n -.rt Bell Labs Memorandum (undefined) .RE .sp .ne 2 -.mk .na \fB\fB%N\fR\fR .ad .RS 8n -.rt Number within volume .RE .sp .ne 2 -.mk .na \fB\fB%O\fR\fR .ad .RS 8n -.rt Other commentary, printed at end of reference .RE .sp .ne 2 -.mk .na \fB\fB%P\fR\fR .ad .RS 8n -.rt Page number(s) .RE .sp .ne 2 -.mk .na \fB\fB%Q\fR\fR .ad .RS 8n -.rt Corporate or Foreign Author (unreversed) .RE .sp .ne 2 -.mk .na \fB\fB%R\fR\fR .ad .RS 8n -.rt Report, paper, or thesis (unpublished) .RE .sp .ne 2 -.mk .na \fB\fB%S\fR\fR .ad .RS 8n -.rt Series title .RE .sp .ne 2 -.mk .na \fB\fB%T\fR\fR .ad .RS 8n -.rt Title of article or book .RE .sp .ne 2 -.mk .na \fB\fB%V\fR\fR .ad .RS 8n -.rt Volume number .RE .sp .ne 2 -.mk .na \fB\fB%X\fR\fR .ad .RS 8n -.rt Abstract \(em used by \fBroffbib\fR, not by \fBrefer\fR .RE .sp .ne 2 -.mk .na \fB\fB%Y,Z\fR\fR .ad .RS 8n -.rt Ignored by \fBrefer\fR .RE diff --git a/usr/src/man/man1/alias.1 b/usr/src/man/man1/alias.1 index 60b94d7e50..c3b2fefac5 100644 --- a/usr/src/man/man1/alias.1 +++ b/usr/src/man/man1/alias.1 @@ -1,16 +1,16 @@ '\" te -.\" Copyright 1989 AT&T -.\" Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved +.\" Copyright 1989 AT&T +.\" Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved .\" Portions Copyright (c) 1982-2007 AT&T Knowledge Ventures -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 alias 1 "8 Apr 2008" "SunOS 5.11" "User Commands" +.TH ALIAS 1 "Apr 8, 2008" .SH NAME alias, unalias \- create or remove a pseudonym or shorthand for a command or series of commands @@ -165,12 +165,10 @@ affect any commands that have already been read and subsequently executed. The following option is supported by \fBunalias\fR: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 6n -.rt Removes all alias definitions from the current shell execution environment. .RE @@ -180,12 +178,10 @@ Removes all alias definitions from the current shell execution environment. The following option is supported by \fBalias\fR: .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad .RS 6n -.rt Sets and lists tracked aliases. .RE @@ -195,24 +191,20 @@ Sets and lists tracked aliases. The following options are supported by \fBalias\fR: .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 6n -.rt Causes the output to be in the form of \fBalias\fR commands that can be used as input to the shell to recreate the current aliases. .RE .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad .RS 6n -.rt Specifies tracked aliases. .sp Tracked aliases connect a command name to the command's pathname, and are reset @@ -222,12 +214,10 @@ obsolete. .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad .RS 6n -.rt Ignored, this option is obsolete. .RE @@ -236,12 +226,10 @@ Ignored, this option is obsolete. The following option is supported by \fBunalias\fR: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 6n -.rt Causes all alias definitions to be removed. \fIname\fR operands are optional and ignored if specified. .RE @@ -253,35 +241,29 @@ The following operands are supported: .SS "\fBalias\fR" .sp .ne 2 -.mk .na \fB\fIalias-name\fR\fR .ad .RS 14n -.rt Write the alias definition to standard output. .RE .SS "\fBunalias\fR" .sp .ne 2 -.mk .na \fB\fIalias-name\fR\fR .ad .RS 21n -.rt The name of an alias to be removed. .RE .sp .ne 2 -.mk .na \fB\fIalias-name\fR\fB=\fR\fIstring\fR\fR .ad .RS 21n -.rt Assign the value of \fIstring\fR to the alias \fIalias-name\fR. .RE @@ -379,24 +361,20 @@ that affect the execution of \fBalias\fR and \fBunalias\fR: \fBLANG\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt Successful completion. .RE .SS "\fBalias\fR" .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt One of the \fIalias-name\fR operands specified did not have an alias definition, or an error occurred. .RE @@ -404,12 +382,10 @@ definition, or an error occurred. .SS "\fBunalias\fR" .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt One of the \fIalias-name\fR operands specified did not represent a valid alias definition, or an error occurred. .RE @@ -423,15 +399,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .SS "\fBksh93\fR" @@ -439,13 +414,12 @@ StandardSee \fBstandards\fR(5). .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityUncommitted +Interface Stability Uncommitted .TE .SH SEE ALSO diff --git a/usr/src/man/man1/allocate.1 b/usr/src/man/man1/allocate.1 index 95da6dcaf8..94c265798b 100644 --- a/usr/src/man/man1/allocate.1 +++ b/usr/src/man/man1/allocate.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 allocate 1 "30 Apr 2008" "SunOS 5.11" "User Commands" +.TH ALLOCATE 1 "Apr 30, 2008" .SH NAME allocate \- device allocation .SH SYNOPSIS @@ -48,12 +48,10 @@ device. For devices with removable media that have a mountable file system, The following options are supported: .sp .ne 2 -.mk .na \fB\fB-F\fR \fIdevice\fR\fR .ad .RS 18n -.rt Force allocates either free or pre-allocated devices. This option is often used with the \fB-U\fR option to allocate/reallocate devices to a specific user. Only those users that have \fBsolaris.device.revoke\fR authorization are @@ -62,35 +60,29 @@ allowed to use this option. .sp .ne 2 -.mk .na \fB\fB-g\fR \fIdev\(mitype\fR\fR .ad .RS 18n -.rt Allocates devices with a device\(mitype matching \fIdev\(mitype\fR. The \fIdev\(mitype\fR argument specifies the device type to be operated on. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 18n -.rt Silent. Suppresses any diagnostic output. .RE .sp .ne 2 -.mk .na \fB\fB-U\fR \fIuname\fR\fR .ad .RS 18n -.rt Uses the user ID \fIuname\fR instead of the user ID of the current process when performing the allocate operation. Only a user with the \fBsolaris.device.revoke\fR authorization is permitted to use this option. @@ -101,12 +93,10 @@ performing the allocate operation. Only a user with the The following options are supported with Trusted Extensions: .sp .ne 2 -.mk .na \fB\fB-w\fR\fR .ad .RS 15n -.rt Runs the device cleaning program in a windowing environment. If a windowing version of the program exists, it is used. Otherwise, the standard version is run in a terminal window. @@ -114,12 +104,10 @@ run in a terminal window. .sp .ne 2 -.mk .na \fB\fB-z\fR \fIzonename\fR\fR .ad .RS 15n -.rt Allocates device to the zone specified by \fIzonename\fR. .RE @@ -129,12 +117,10 @@ Allocates device to the zone specified by \fIzonename\fR. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIdevice\fR\fR .ad .RS 10n -.rt Specifies the name of the device to be allocated. .RE @@ -144,34 +130,28 @@ Specifies the name of the device to be allocated. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 15n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB20\fR\fR .ad .RS 15n -.rt No entry for the specified device. .RE .sp .ne 2 -.mk .na \fB\fIother value\fR\fR .ad .RS 15n -.rt An error occurred. .RE @@ -196,13 +176,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilitySee below. +Interface Stability See below. .TE .sp diff --git a/usr/src/man/man1/amt.1 b/usr/src/man/man1/amt.1 index 0a485e1d1b..7c192c6461 100644 --- a/usr/src/man/man1/amt.1 +++ b/usr/src/man/man1/amt.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 amt 1 "19 Aug 2003" "SunOS 5.11" "User Commands" +.TH AMT 1 "Aug 19, 2003" .SH NAME amt \- run abstract machine test .SH SYNOPSIS @@ -32,12 +32,10 @@ performs, unless output is suppressed with the \fB-s\fR option. The following option is supported: .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 6n -.rt Suppresses output. .RE @@ -47,34 +45,28 @@ Suppresses output. The following error values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt All tests passed. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt Count of the number of tests that failed. .RE .sp .ne 2 -.mk .na \fB\fB<0\fR\fR .ad .RS 6n -.rt Incorrect command line argument. .RE @@ -86,13 +78,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed .TE .SH SEE ALSO diff --git a/usr/src/man/man1/appcert.1 b/usr/src/man/man1/appcert.1 index 01a63280c3..78577f4ba9 100644 --- a/usr/src/man/man1/appcert.1 +++ b/usr/src/man/man1/appcert.1 @@ -3,14 +3,14 @@ .\" 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 appcert 1 "29 Jan 2007" "SunOS 5.11" "User Commands" +.TH APPCERT 1 "Jan 29, 2007" .SH NAME appcert \- examine application-level products for unstable use of Solaris interfaces .SH SYNOPSIS .LP .nf -\fBappcert\fR [\fB-h\fR] [\fB-n\fR] [\fB-f\fR \fIinfile\fR] [\fB-w\fR \fIworking_dir\fR] [\fB-B\fR] [\fB-L\fR] +\fBappcert\fR [\fB-h\fR] [\fB-n\fR] [\fB-f\fR \fIinfile\fR] [\fB-w\fR \fIworking_dir\fR] [\fB-B\fR] [\fB-L\fR] [\fB-S\fR] {\fIobj\fR | \fIdir\fR}... .fi @@ -95,12 +95,10 @@ application being checked runs. See NOTES. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-B\fR\fR .ad .RS 18n -.rt If \fBappcert\fR is run in batch mode, the output report will contain one line per binary, beginning with \fBPASS\fR if no problems were detected for the binary, \fBFAIL\fR if any problems were found, or \fBINC\fR if the binary could @@ -112,12 +110,10 @@ triggered. These strings are flush left and so can be selected via \fBgrep\fR .sp .ne 2 -.mk .na \fB\fB-f\fR \fIinfile\fR\fR .ad .RS 18n -.rt Specifies the file \fIinfile\fR that contains a list of files (one per line) to check. This list is appended to the list determined from the command line operands (see OPERANDS below). @@ -125,23 +121,19 @@ operands (see OPERANDS below). .sp .ne 2 -.mk .na \fB\fB-h\fR\fR .ad .RS 18n -.rt Prints out the usage information. .RE .sp .ne 2 -.mk .na \fB\fB-L\fR\fR .ad .RS 18n -.rt \fBappcert\fR examines your product for the presence of shared objects. If it finds some, it appends the directories they reside in to \fBLD_LIBRARY_PATH\fR. Use this flag to prevent \fBappcert\fR from doing this. @@ -149,36 +141,30 @@ Use this flag to prevent \fBappcert\fR from doing this. .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 18n -.rt When searching directories for binaries to check, this option does not follow symbolic links. See \fBfind\fR(1). .RE .sp .ne 2 -.mk .na \fB\fB-S\fR\fR .ad .RS 18n -.rt Appends Solaris library directories (that is, \fB/usr/openwin/lib:/usr/dt/lib\fR) to \fBLD_LIBRARY_PATH\fR. .RE .sp .ne 2 -.mk .na \fB\fB-w\fR \fIworking_dir\fR\fR .ad .RS 18n -.rt Identifies the directory in which to run the library components and create temporary files (default is \fB/tmp\fR). .RE @@ -189,12 +175,10 @@ temporary files (default is \fB/tmp\fR). The following operands are supported: .sp .ne 2 -.mk .na \fB{\fIobj\fR | \fIdir\fR} ...\fR .ad .RS 20n -.rt A complete list of objects and/or directories that contain the objects constituting the product to be checked. \fBappcert\fR recursively searches directories looking for object files; non-object files are ignored. @@ -206,46 +190,38 @@ directories looking for object files; non-object files are ignored. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt \fBappcert\fR ran successfully and found no potential binary stability problems. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt \fBappcert\fR failed to run successfully. .RE .sp .ne 2 -.mk .na \fB\fB2\fR\fR .ad .RS 5n -.rt Some of the objects checked have potential binary stability problems. .RE .sp .ne 2 -.mk .na \fB\fB3\fR\fR .ad .RS 5n -.rt No binary objects were located that could be checked. .RE @@ -322,36 +298,30 @@ in C. directory (\fB/tmp/appcert.\fI?????\fR\fR by default): .sp .ne 2 -.mk .na \fB\fBIndex\fR\fR .ad .RS 11n -.rt A mapping between checked binaries and the subdirectory in the working directory in which the output specific to that binary can be found. .RE .sp .ne 2 -.mk .na \fB\fBReport\fR\fR .ad .RS 11n -.rt A copy of the rollup report that was displayed on stdout when \fBappcert\fR was run. .RE .sp .ne 2 -.mk .na \fB\fBSkipped\fR\fR .ad .RS 11n -.rt A list of binaries that \fBappcert\fR was asked to check but had to skip, along with a brief reason why each was skipped. .RE @@ -362,45 +332,37 @@ In addition, there is per-object information in the subdirectories under \fBappcert.\fI?????\fR/objects/\fR, in the following files: .sp .ne 2 -.mk .na \fB\fBcheck.demoted_symbols\fR\fR .ad .RS 25n -.rt A list of symbols suspected to be demoted Solaris symbols. .RE .sp .ne 2 -.mk .na \fB\fBcheck.dynamic.private\fR\fR .ad .RS 25n -.rt A list of private Solaris symbols to which the object makes direct bindings. .RE .sp .ne 2 -.mk .na \fB\fBcheck.dynamic.public\fR\fR .ad .RS 25n -.rt A list of public Solaris symbols to which the object makes direct bindings. .RE .sp .ne 2 -.mk .na \fB\fBcheck.dynamic.unbound\fR\fR .ad .RS 25n -.rt A list of symbols not bound by the dynamic linker when \fBldd\fR \fB-r\fR was run. For convenience, \fBldd\fR output lines containing \fBfile not found\fR are also included. @@ -408,12 +370,10 @@ are also included. .sp .ne 2 -.mk .na \fB\fBsummary.dynamic\fR\fR .ad .RS 25n -.rt A pretty-printed summary of dynamic bindings for the objects examined, including tables of Public and Private symbols used from each Solaris library. .RE @@ -707,13 +667,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface stabilityStable +Interface stability Stable .TE .SH SEE ALSO diff --git a/usr/src/man/man1/apptrace.1 b/usr/src/man/man1/apptrace.1 index d0e5df1200..87214993d7 100644 --- a/usr/src/man/man1/apptrace.1 +++ b/usr/src/man/man1/apptrace.1 @@ -3,14 +3,14 @@ .\" 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 apptrace 1 "29 Nov 2004" "SunOS 5.11" "User Commands" +.TH APPTRACE 1 "Nov 29, 2004" .SH NAME apptrace \- trace application function calls to Solaris shared libraries .SH SYNOPSIS .LP .nf -\fBapptrace\fR [\fB-f\fR] [\fB-F\fR [!] \fItracefromlist\fR] [\fB-T\fR [!] \fItracetolist\fR] - [\fB-o\fR \fIoutputfile\fR] [ [\fB-tv\fR] [!] \fIcall\fR ,...] \fIcommand\fR +\fBapptrace\fR [\fB-f\fR] [\fB-F\fR [!] \fItracefromlist\fR] [\fB-T\fR [!] \fItracetolist\fR] + [\fB-o\fR \fIoutputfile\fR] [ [\fB-tv\fR] [!] \fIcall\fR ,...] \fIcommand\fR [\fIcommand\fR \fIarguments\fR] .fi @@ -63,24 +63,20 @@ Guide\fR. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-f\fR \fR .ad .RS 24n -.rt Follows all children created by \fBfork\fR(2). This option will also cause the process id to be printed at the beginning of each line. .RE .sp .ne 2 -.mk .na \fB\fB-F\fR \fB[!]\fR\fItracefromlist\fR \fR .ad .RS 24n -.rt Traces calls from a comma-separated list of shared objects. Only calls from these shared objects will be traced. The default is to trace calls from the main executable only. Only the basename of the shared object is required. For @@ -93,12 +89,10 @@ be traced. If the tracing of calls from \fIcommand\fR is required, then .sp .ne 2 -.mk .na \fB\fB-o\fR \fIoutputfile\fR \fR .ad .RS 24n -.rt \fBapptrace\fR output will be directed to the \fIoutputfile\fR. By default, \fBapptrace\fR output is placed on the stderr stream of the process being traced. @@ -106,12 +100,10 @@ traced. .sp .ne 2 -.mk .na \fB\fB-t\fR [\fB!\fR]\fIcall,\|.\|.\|.\fR\fR .ad .RS 24n -.rt Traces or excludes function calls. Those calls specified in the comma-separated list \fIcall\fR are traced. If the list begins with a !, the specified function calls are excluded from the trace output. The default is \fB-t\fR \fB*\fR. The @@ -120,12 +112,10 @@ use of shell style wildcards is allowed. .sp .ne 2 -.mk .na \fB\fB-T\fR \fB[!]\fR\fItracetolist\fR \fR .ad .RS 24n -.rt Traces calls to a comma-separated list of shared objects. The default is to trace calls to all shared objects. As above, the basename is all that is required and wildcarding is allowed. A list preceded by a ``!'' denotes a list @@ -134,12 +124,10 @@ of objects to which calls should not be traced. .sp .ne 2 -.mk .na \fB\fB-v\fR [\fB!\fR]\fIcall,\|.\|.\|.\fR\fR .ad .RS 24n -.rt Provides verbose, formatted output of the arguments and return values of the function calls specified (as above in the \fB-t\fR option). Unlike \fBtruss\fR(1), calls named by the \fB-v\fR option do not have to be named by @@ -271,7 +259,7 @@ For security reasons, only those processes with appropriate privileges can use .LP Tracing functions whose usage requires the inclusion of <\fBvarargs.h\fR>, such as \fBvwprintw\fR(3XCURSES) and \fBvwscanw\fR(3XCURSES), will not provide -formatted printing of arguments. +formatted printing of arguments. .SH ATTRIBUTES .sp .LP @@ -280,13 +268,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityUnstable +Interface Stability Unstable .TE .SH SEE ALSO diff --git a/usr/src/man/man1/apropos.1 b/usr/src/man/man1/apropos.1 index 1430f61f92..5a998a86d2 100644 --- a/usr/src/man/man1/apropos.1 +++ b/usr/src/man/man1/apropos.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 apropos 1 "20 Dec 1996" "SunOS 5.11" "User Commands" +.TH APROPOS 1 "Dec 20, 1996" .SH NAME apropos \- locate commands by keyword lookup .SH SYNOPSIS @@ -102,12 +102,10 @@ to get the manual page on the subroutine \fBprintf()\fR. .SH FILES .sp .ne 2 -.mk .na \fB\fB/usr/share/man/windex\fR \fR .ad .RS 26n -.rt table of contents and keyword database .RE @@ -119,13 +117,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled .TE .SH SEE ALSO @@ -135,7 +132,6 @@ CSIEnabled .SH DIAGNOSTICS .sp .ne 2 -.mk .na \fB\f(CW/usr/share/man/windex: No such file or directory\fR\fR .ad diff --git a/usr/src/man/man1/ar.1 b/usr/src/man/man1/ar.1 index 54e192e21e..641f1f8ba7 100644 --- a/usr/src/man/man1/ar.1 +++ b/usr/src/man/man1/ar.1 @@ -1,7 +1,7 @@ '\" te -.\" Copyright 1989 AT&T +.\" Copyright 1989 AT&T .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Copyright (c) 2009, Sun Microsystems, Inc. All Rights Reserved +.\" Copyright (c) 2009, Sun Microsystems, Inc. All Rights Reserved .\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text .\" are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical @@ -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 ar 1 "24 Aug 2009" "SunOS 5.11" "User Commands" +.TH AR 1 "Aug 24, 2009" .SH NAME ar \- maintain portable archive or library .SH SYNOPSIS @@ -111,48 +111,40 @@ update the contents of such an archive, the symbol table is rebuilt. The The following options are supported: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 6n -.rt Positions new \fIfile\fRs in \fIarchive\fR after the file named by the \fIposname\fR operand. .RE .sp .ne 2 -.mk .na \fB\fB-b\fR\fR .ad .RS 6n -.rt Positions new \fIfile\fRs in \fIarchive\fR before the file named by the \fIposname\fR operand. .RE .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad .RS 6n -.rt Suppresses the diagnostic message that is written to standard error by default when \fIarchive\fR is created. .RE .sp .ne 2 -.mk .na \fB\fB-C\fR\fR .ad .RS 6n -.rt Prevents extracted files from replacing like-named files in the file system. This option is useful when \fB-T\fR is also used to prevent truncated file names from replacing files with the same prefix. @@ -160,35 +152,29 @@ names from replacing files with the same prefix. .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad .RS 6n -.rt Deletes one or more \fIfile\fRs from \fIarchive\fR. .RE .sp .ne 2 -.mk .na \fB\fB-i\fR\fR .ad .RS 6n -.rt Positions new \fIfile\fRs in \fIarchive\fR before the file named by the \fIposname\fR operand. This option is quivalent to \fB-b\fR. .RE .sp .ne 2 -.mk .na \fB\fB-m\fR\fR .ad .RS 6n -.rt Moves \fIfile\fRs. If \fB-a\fR, \fB-b\fR, or \fB-i\fR with the \fIposname\fR operand are specified, the \fB-m\fR option moves \fIfile\fRs to the new position. Otherwise, \fB-m\fR moves \fIfile\fRs to the end of \fIarchive\fR. @@ -196,12 +182,10 @@ position. Otherwise, \fB-m\fR moves \fIfile\fRs to the end of \fIarchive\fR. .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 6n -.rt Prints the contents of \fIfile\fRs in \fIarchive\fR to standard output. If no \fIfile\fRs are specified, the contents of all files in \fIarchive\fR are written in the order of the archive. @@ -209,12 +193,10 @@ written in the order of the archive. .sp .ne 2 -.mk .na \fB\fB-q\fR\fR .ad .RS 6n -.rt Quickly appends \fIfile\fRs to the end of \fIarchive\fR. Positioning options \fB-a\fR, \fB-b\fR, and \fB-i\fR are invalid. The command does not check whether the added \fIfile\fRs are already in \fIarchive\fR. This option is @@ -224,12 +206,10 @@ piece-by-piece. .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 6n -.rt Replaces or adds \fIfile\fRs in \fIarchive\fR. If \fIarchive\fR does not exist, a new archive file is created and a diagnostic message is written to standard error, unless the \fB-c\fR option is specified. If no \fIfile\fRs are specified @@ -244,12 +224,10 @@ or \fB-i\fR) \fIposname\fR. Otherwise, the new files are placed at the end. .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 6n -.rt Forces the regeneration of the archive symbol table even if \fBar\fR is not invoked with an option that will modify the archive contents. This command is useful to restore the archive symbol table after the \fBstrip\fR(1) command has @@ -258,12 +236,10 @@ been used on the archive. .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad .RS 6n -.rt Prints a table of contents of \fIarchive\fR. The files specified by the \fIfile\fR operands are included in the written list. If no \fIfile\fR operands are specified, all files in \fIarchive\fR are included in the order of the @@ -272,12 +248,10 @@ archive. .sp .ne 2 -.mk .na \fB\fB-T\fR\fR .ad .RS 6n -.rt Allows file name truncation of extracted files whose archive names are longer than the file system can support. By default, extracting a file with a name that is too long is an error. In that case, a diagnostic message is written and @@ -286,12 +260,10 @@ the file is not extracted. .sp .ne 2 -.mk .na \fB\fB-u\fR\fR .ad .RS 6n -.rt Updates older files. When used with the \fB-r\fR option, files within \fIarchive\fR are replaced only if the corresponding \fIfile\fR has a modification time that is at least as new as the modification time of the file @@ -300,12 +272,10 @@ within \fIarchive\fR. .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 6n -.rt Gives verbose output. When used with options \fB-d\fR, \fB-r\fR, or \fB-x\fR, the \fB-v\fR option writes a detailed file-by-file description of the archive creation and the constituent \fIfile\fRs, and maintenance activity. When used @@ -319,12 +289,10 @@ standard error. .sp .ne 2 -.mk .na \fB\fB-V\fR\fR .ad .RS 6n -.rt Prints its version number on standard error. .RE @@ -334,24 +302,20 @@ Prints its version number on standard error. The following options are supported for \fB/usr/xpg4/bin/ar\fR: .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 6n -.rt Same as the \fB/usr/bin/ar\fR version, except when writing to an archive, no message is written to the standard error. .RE .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad .RS 6n -.rt Extracts the files named by the \fIfile\fR operands from \fIarchive\fR. The contents of \fIarchive\fR are not changed. If no \fIfile\fR operands are given, all files in \fIarchive\fR are extracted. If the file name of a file extracted @@ -367,23 +331,19 @@ is being extracted, the results are undefined. The modification time of each The following operands are supported: .sp .ne 2 -.mk .na \fB\fIarchive\fR\fR .ad .RS 11n -.rt A path name of the archive file. .RE .sp .ne 2 -.mk .na \fB\fIfile\fR\fR .ad .RS 11n -.rt A path name. Only the last component is used when comparing against the names of files in the archive. If two or more \fIfile\fR operands have the same last path name component (see \fBbasename\fR(1)), the results are unspecified. The @@ -393,12 +353,10 @@ added to or replaced in the archive. .sp .ne 2 -.mk .na \fB\fIposname\fR\fR .ad .RS 11n -.rt The name of a file in the archive file, used for relative positioning. See options \fB-m\fR and \fB-r\fR. .RE @@ -411,24 +369,20 @@ that affect the execution of \fBar\fR: \fBLANG\fR, \fBLC_ALL\fR, \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, \fBLC_TIME\fR, and \fBNLSPATH\fR. .sp .ne 2 -.mk .na \fB\fBTMPDIR\fR\fR .ad .RS 10n -.rt Determine the pathname that overrides the default directory for temporary files, if any. .RE .sp .ne 2 -.mk .na \fB\fBTZ\fR\fR .ad .RS 10n -.rt Determine the timezone used to calculate date and time strings written by \fBar\fR \fB-tv\fR. If \fBTZ\fR is unset or null, an unspecified default timezone is used. @@ -440,23 +394,19 @@ timezone is used. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -469,13 +419,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed .TE .SS "\fB/usr/xpg4/bin/ar\fR" @@ -483,15 +432,14 @@ Interface StabilityCommitted .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .SH SEE ALSO diff --git a/usr/src/man/man1/arch.1 b/usr/src/man/man1/arch.1 index c7df0f0a4f..5bfef3971e 100644 --- a/usr/src/man/man1/arch.1 +++ b/usr/src/man/man1/arch.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 arch 1 "21 Oct 2002" "SunOS 5.11" "User Commands" +.TH ARCH 1 "Oct 21, 2002" .SH NAME arch \- display the architecture of the current host .SH SYNOPSIS @@ -30,12 +30,10 @@ hardware differences may be able to run the same application programs. .SH OPTIONS .sp .ne 2 -.mk .na \fB\fB-k\fR\fR .ad .RS 6n -.rt Displays the kernel architecture, such as \fBsun4u\fR. This defines which specific SunOS kernel will run on the machine, and has implications only for programs that depend on the kernel explicitly (for example, \fBps\fR(1)). @@ -47,12 +45,10 @@ programs that depend on the kernel explicitly (for example, \fBps\fR(1)). The following operand is supported: .sp .ne 2 -.mk .na \fB\fIarchname\fR\fR .ad .RS 12n -.rt Use \fIarchname\fR to determine whether the application binaries for this application architecture can run on the current host system. The \fIarchname\fR must be a valid application architecture, such as @@ -69,23 +65,19 @@ returned. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE diff --git a/usr/src/man/man1/asa.1 b/usr/src/man/man1/asa.1 index a1b85084cd..6d45787c26 100644 --- a/usr/src/man/man1/asa.1 +++ b/usr/src/man/man1/asa.1 @@ -1,14 +1,14 @@ '\" te .\" Copyright (c) 1992, X/Open Company Limited All Rights Reserved .\" Portions Copyright (c) 1995, Sun Microsystems, All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 asa 1 "18 Apr 1995" "SunOS 5.11" "User Commands" +.TH ASA 1 "Apr 18, 1995" .SH NAME asa \- convert FORTRAN carriage-control output to printable form .SH SYNOPSIS @@ -32,47 +32,39 @@ following actions will be performed. If the character removed is: .sp .ne 2 -.mk .na \fB\fBSPACE\fR\fR .ad .RS 9n -.rt The rest of the line will be output without change. .RE .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 9n -.rt It is replaced by a newline control sequence followed by the rest of the input line. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 9n -.rt It is replaced by a newpage control sequence followed by the rest of the input line. .RE .sp .ne 2 -.mk .na \fB\fB+\fR\fR .ad .RS 9n -.rt It is replaced by a control sequence that causes printing to return to the first column of the previous line, where the rest of the input line is printed. @@ -92,12 +84,10 @@ is used. The following option is supported: .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 6n -.rt Start each file on a new page. .RE @@ -107,12 +97,10 @@ Start each file on a new page. The following operand is supported: .sp .ne 2 -.mk .na \fB\fBfile\fR\fR .ad .RS 8n -.rt A pathname of a text file used for input. If no \fBfile\fR operands are specified, or `\fB\|\(mi\|\fR\&' is specified, then the standard input will be used. @@ -223,23 +211,19 @@ that affect the execution of \fBasa\fR: \fBLANG\fR, \fBLC_ALL\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt All input files were output successfully. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -251,13 +235,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man1/at.1 b/usr/src/man/man1/at.1 index 0eeb6a2a0e..7ca300a266 100644 --- a/usr/src/man/man1/at.1 +++ b/usr/src/man/man1/at.1 @@ -2,26 +2,26 @@ .\" Copyright (c) 1992, X/Open Company Limited. All Rights Reserved. .\" Copyright 1989 AT&T .\" Portions Copyright (c) 2005, Sun Microsystems, Inc. All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 at 1 "13 Apr 2005" "SunOS 5.11" "User Commands" +.TH AT 1 "Apr 13, 2005" .SH NAME at, batch \- execute commands at a later time .SH SYNOPSIS .LP .nf -\fB/usr/bin/at\fR [\fB-c\fR | \fB-k\fR | \fB-s\fR] [\fB-m\fR] [\fB-f\fR \fIfile\fR] [\fB-p\fR \fIproject\fR] +\fB/usr/bin/at\fR [\fB-c\fR | \fB-k\fR | \fB-s\fR] [\fB-m\fR] [\fB-f\fR \fIfile\fR] [\fB-p\fR \fIproject\fR] [\fB-q\fR \fIqueuename\fR] \fB-t\fR \fItime\fR .fi .LP .nf -\fB/usr/bin/at\fR [\fB-c\fR | \fB-k\fR | \fB-s\fR] [\fB-m\fR] [\fB-f\fR \fIfile\fR] [\fB-p\fR \fIproject\fR] +\fB/usr/bin/at\fR [\fB-c\fR | \fB-k\fR | \fB-s\fR] [\fB-m\fR] [\fB-f\fR \fIfile\fR] [\fB-p\fR \fIproject\fR] [\fB-q\fR \fIqueuename\fR] \fItimespec\fR... .fi @@ -42,19 +42,19 @@ at, batch \- execute commands at a later time .LP .nf -\fB/usr/xpg4/bin/at\fR [\fB-c\fR | \fB-k\fR | \fB-s\fR] [\fB-m\fR] [\fB-f\fR \fIfile\fR] [\fB-p\fR \fIproject\fR] +\fB/usr/xpg4/bin/at\fR [\fB-c\fR | \fB-k\fR | \fB-s\fR] [\fB-m\fR] [\fB-f\fR \fIfile\fR] [\fB-p\fR \fIproject\fR] [\fB-q\fR \fIqueuename\fR] \fB-t\fR \fItime\fR .fi .LP .nf -\fB/usr/xpg4/bin/at\fR [\fB-c\fR | \fB-k\fR | \fB-s\fR] [\fB-m\fR] [\fB-f\fR \fIfile\fR] [\fB-p\fR \fIproject\fR] +\fB/usr/xpg4/bin/at\fR [\fB-c\fR | \fB-k\fR | \fB-s\fR] [\fB-m\fR] [\fB-f\fR \fIfile\fR] [\fB-p\fR \fIproject\fR] [\fB-q\fR \fIqueuename\fR] \fItimespec\fR... .fi .LP .nf -\fB/usr/xpg4/bin/at\fR \fB-l\fR [\fB-p\fR \fIproject\fR] [\fB-q\fR \fIqueuename\fR] +\fB/usr/xpg4/bin/at\fR \fB-l\fR [\fB-p\fR \fIproject\fR] [\fB-q\fR \fIqueuename\fR] [\fIat_job_id.\fR \fI\&..\fR] .fi @@ -154,57 +154,47 @@ If \fBSHELL\fR is unset or \fBNULL\fR, \fB/usr/bin/sh\fR is used. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-c\fR \fR .ad .RS 17n -.rt C shell. \fBcsh\fR(1) is used to execute the at-job. .RE .sp .ne 2 -.mk .na \fB\fB-k\fR \fR .ad .RS 17n -.rt Korn shell. \fBksh\fR(1) is used to execute the at-job. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR \fR .ad .RS 17n -.rt Bourne shell. \fBsh\fR(1) is used to execute the at-job. .RE .sp .ne 2 -.mk .na \fB\fB-f\fR \fIfile\fR \fR .ad .RS 17n -.rt Specifies the path of a file to be used as the source of the at-job, instead of standard input. .RE .sp .ne 2 -.mk .na \fB\fB-l\fR \fR .ad .RS 17n -.rt (The letter ell.) Reports all jobs scheduled for the invoking user if no \fIat_job_id\fR operands are specified. If \fIat_job_id\fRs are specified, reports only information for these jobs. @@ -212,12 +202,10 @@ reports only information for these jobs. .sp .ne 2 -.mk .na \fB\fB-m\fR \fR .ad .RS 17n -.rt Sends mail to the invoking user after the at-job has run, announcing its completion. Standard output and standard error produced by the at-job are mailed to the user as well, unless redirected elsewhere. Mail is sent even if @@ -231,12 +219,10 @@ completion. .sp .ne 2 -.mk .na \fB\fB-p\fR \fIproject\fR\fR .ad .RS 17n -.rt Specifies under which project the \fBat\fR or \fBbatch\fR job is run. When used with the \fB-l\fR option, limits the search to that particular project. Values for \fIproject\fR is interpreted first as a project name, and then as a @@ -246,12 +232,10 @@ project is used. .sp .ne 2 -.mk .na \fB\fB-q\fR \fIqueuename\fR \fR .ad .RS 17n -.rt Specifies in which queue to schedule a job for submission. When used with the \fB-l\fR option, limits the search to that particular queue. Values for \fIqueuename\fR are limited to the lower case letters \fBa\fR through \fBz\fR. @@ -262,24 +246,20 @@ can not be used with the \fB-q\fR option. .sp .ne 2 -.mk .na \fB\fB-r\fR \fIat_job_id\fR \fR .ad .RS 17n -.rt Removes the jobs with the specified \fIat_job_id\fR operands that were previously scheduled by the \fBat\fR utility. .RE .sp .ne 2 -.mk .na \fB\fB-t\fR \fItime\fR \fR .ad .RS 17n -.rt Submits the job to be run at the time specified by the \fItime\fR option-argument, which must have the format as specified by the \fBtouch\fR(1) utility. @@ -291,24 +271,20 @@ utility. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIat_job_id\fR \fR .ad .RS 14n -.rt The name reported by a previous invocation of the \fBat\fR utility at the time the job was scheduled. .RE .sp .ne 2 -.mk .na \fB\fItimespec\fR \fR .ad .RS 14n -.rt Submit the job to be run at the date and time specified. All of the \fItimespec\fR operands are interpreted as if they were separated by space characters and concatenated. The date and time are interpreted as being in the @@ -320,12 +296,10 @@ specification string. All of the values from the \fBLC_TIME\fR categories in the "C" locale are recognized in a case-insensitive manner. .sp .ne 2 -.mk .na \fB\fItime\fR \fR .ad .RS 14n -.rt The \fItime\fR can be specified as one, two or four digits. One- and two-digit numbers are taken to be hours, four-digit numbers to be hours and minutes. The time can alternatively be specified as two numbers separated by a colon, @@ -338,34 +312,28 @@ specified using the \fBTZ\fR environment variable. The \fItime\fR field can also be one of the following tokens in the "C" locale: .sp .ne 2 -.mk .na \fB\fBmidnight\fR \fR .ad .RS 13n -.rt Indicates the time 12:00 am (00:00). .RE .sp .ne 2 -.mk .na \fB\fBnoon\fR \fR .ad .RS 13n -.rt Indicates the time 12:00 pm. .RE .sp .ne 2 -.mk .na \fB\fBnow\fR \fR .ad .RS 13n -.rt Indicate the current day and time. Invoking \fBat\fR \fBnow\fR submits an at-job for potentially immediate execution (that is, subject only to unspecified scheduling delays). @@ -375,12 +343,10 @@ unspecified scheduling delays). .sp .ne 2 -.mk .na \fB\fIdate\fR \fR .ad .RS 14n -.rt An optional \fIdate\fR can be specified as either a month name (one of the values from the \fBmon\fR or \fBabmon\fR keywords in the \fBLC_TIME\fR locale category) followed by a day number (and possibly year number preceded by a @@ -389,23 +355,19 @@ comma) or a day of the week (one of the values from the \fBday\fR or are recognized in the "C" locale: .sp .ne 2 -.mk .na \fB\fBtoday\fR \fR .ad .RS 13n -.rt Indicates the current day. .RE .sp .ne 2 -.mk .na \fB\fBtomorrow\fR \fR .ad .RS 13n -.rt Indicates the day following the current day. .RE @@ -417,12 +379,10 @@ assumed. .sp .ne 2 -.mk .na \fB\fIincrement\fR \fR .ad .RS 14n -.rt The optional \fIincrement\fR is a number preceded by a plus sign (\fB+\fR) and suffixed by one of the following: \fBminutes\fR, \fBhours\fR, \fBdays\fR, \fBweeks\fR, \fBmonths\fR, or \fByears\fR. (The singular forms are also @@ -573,12 +533,10 @@ that affect the execution of \fBat\fR and \fBbatch\fR: \fBLANG\fR, \fBLC_TIME\fR. .sp .ne 2 -.mk .na \fB\fBDATEMSK\fR \fR .ad .RS 12n -.rt If the environment variable \fBDATEMSK\fR is set, \fBat\fR uses its value as the full path name of a template file containing format strings. The strings consist of format specifiers and text characters that are used to provide a @@ -593,12 +551,10 @@ not recognized when \fBDATEMSK\fR is set. .sp .ne 2 -.mk .na \fB\fBSHELL\fR \fR .ad .RS 12n -.rt Determine a name of a command interpreter to be used to invoke the at-job. If the variable is unset or \fINULL\fR, \fBsh\fR is used. If it is set to a value other than \fBsh\fR, the implementation uses that shell; a warning diagnostic @@ -607,12 +563,10 @@ is printed telling which shell will be used. .sp .ne 2 -.mk .na \fB\fBTZ\fR \fR .ad .RS 12n -.rt Determine the timezone. The job is submitted for execution at the time specified by \fItimespec\fR or \fB-t\fR \fItime\fR relative to the timezone specified by the \fBTZ\fR variable. If \fItimespec\fR specifies a timezone, it @@ -626,47 +580,39 @@ is unset or \fINULL\fR, an unspecified default timezone is used. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR \fR .ad .RS 7n -.rt The \fBat\fR utility successfully submitted, removed or listed a job or jobs. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR \fR .ad .RS 7n -.rt An error occurred, and the job will not be scheduled. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB/usr/lib/cron/at.allow\fR \fR .ad .RS 27n -.rt names of users, one per line, who are authorized access to the \fBat\fR and \fBbatch\fR utilities .RE .sp .ne 2 -.mk .na \fB\fB/usr/lib/cron/at.deny\fR \fR .ad .RS 27n -.rt names of users, one per line, who are denied access to the \fBat\fR and \fBbatch\fR utilities .RE @@ -680,15 +626,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSINot enabled +CSI Not enabled _ -Interface StabilityStandard +Interface Stability Standard .TE .SS "/usr/xpg4/bin/at" @@ -696,15 +641,14 @@ Interface StabilityStandard .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSINot enabled +CSI Not enabled _ -Interface StabilityStandard +Interface Stability Standard .TE .SS "/usr/bin/batch" @@ -712,15 +656,14 @@ Interface StabilityStandard .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityStandard +Interface Stability Standard .TE .SS "/usr/xpg4/bin/batch" @@ -728,15 +671,14 @@ Interface StabilityStandard .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man1/atq.1 b/usr/src/man/man1/atq.1 index 46c39a4962..35ef28c941 100644 --- a/usr/src/man/man1/atq.1 +++ b/usr/src/man/man1/atq.1 @@ -2,7 +2,7 @@ .\" Copyright 1989 AT&T .\" 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) 1999 Sun Microsystems, Inc., All Rights Reserved. -.TH atq 1 "13 Aug 1999" "SunOS 5.11" "User Commands" +.TH ATQ 1 "Aug 13, 1999" .SH NAME atq \- display the jobs queued to run at specified times .SH SYNOPSIS @@ -33,36 +33,30 @@ jobs belonging to the named user are displayed. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad .RS 6n -.rt Displays the queued jobs in the order they were created (that is, the time that the \fBat\fR command was given). .RE .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 6n -.rt Displays only the total number of jobs currently in the queue. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB/var/spool/cron/atjobs\fR\fR .ad .RS 26n -.rt spool area for at jobs. .RE diff --git a/usr/src/man/man1/atrm.1 b/usr/src/man/man1/atrm.1 index 8b6307c0a9..ad1ce8c87c 100644 --- a/usr/src/man/man1/atrm.1 +++ b/usr/src/man/man1/atrm.1 @@ -2,7 +2,7 @@ .\" Copyright 1989 AT&T .\" 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) 2007 Sun Microsystems, Inc., All Rights Reserved. -.TH atrm 1 "16 Jul 2007" "SunOS 5.11" "User Commands" +.TH ATRM 1 "Jul 16, 2007" .SH NAME atrm \- remove jobs spooled by at or batch .SH SYNOPSIS @@ -31,36 +31,30 @@ You can only remove jobs belonging to other users if you have The following options are supported: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 6n -.rt All. Removes all unexecuted jobs that were created by the current user. If invoked by the privileged user, the entire queue is flushed. .RE .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 6n -.rt Force. All information regarding the removal of the specified jobs is suppressed. .RE .sp .ne 2 -.mk .na \fB\fB-i\fR\fR .ad .RS 6n -.rt Interactive. \fBatrm\fR asks if a job should be removed. If the response is affirmative, the job is removed. .RE @@ -68,12 +62,10 @@ affirmative, the job is removed. .SH FILES .sp .ne 2 -.mk .na \fB\fB/var/spool/cron/atjobs\fR\fR .ad .RS 26n -.rt Spool area for \fBat\fR jobs .RE diff --git a/usr/src/man/man1/audioconvert.1 b/usr/src/man/man1/audioconvert.1 index 72c8a9c972..3e674ce292 100644 --- a/usr/src/man/man1/audioconvert.1 +++ b/usr/src/man/man1/audioconvert.1 @@ -3,13 +3,13 @@ .\" 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 audioconvert 1 "16 Feb 2001" "SunOS 5.11" "User Commands" +.TH AUDIOCONVERT 1 "Feb 16, 2001" .SH NAME audioconvert \- convert audio file formats .SH SYNOPSIS .LP .nf -\fBaudioconvert\fR [\fB-pF\fR] [\fB-f\fR \fIoutfmt\fR] [\fB-o\fR \fIoutfile\fR] +\fBaudioconvert\fR [\fB-pF\fR] [\fB-f\fR \fIoutfmt\fR] [\fB-o\fR \fIoutfile\fR] [ [\fB-i\fR \fIinfmt\fR] [\fIfile\fR]...] ... .fi @@ -55,12 +55,10 @@ files. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 14n -.rt \fIIn Place\fR: The input files are individually converted to the format specified by the \fB-f\fR option and rewritten. If a target file is a symbolic link, the underlying file will be rewritten. The \fB-o\fR option may not be @@ -69,12 +67,10 @@ specified with \fB-p\fR. .sp .ne 2 -.mk .na \fB\fB-F\fR\fR .ad .RS 14n -.rt \fIForce\fR: This option forces \fBaudioconvert\fR to ignore any file header for input files whose format is specified by the \fB-i\fR option. If \fB-F\fR is not specified, \fBaudioconvert\fR ignores the \fB-i\fR option for input @@ -83,12 +79,10 @@ files that contain valid audio file headers. .sp .ne 2 -.mk .na \fB\fB-f\fR \fIoutfmt\fR\fR .ad .RS 14n -.rt \fIOutput Format\fR: This option is used to specify the file format and data encoding of the output file. Defaults for unspecified fields are derived from the input file format. Valid keywords and values are listed in the next @@ -97,12 +91,10 @@ section. .sp .ne 2 -.mk .na \fB\fB-o\fR \fIoutfile\fR\fR .ad .RS 14n -.rt \fIOutput File\fR: All input files are concatenated, converted to the output format, and written to the named output file. If \fB-o\fR and \fB-p\fR are not specified, the concatenated output is written to the standard output. The @@ -111,12 +103,10 @@ specified, the concatenated output is written to the standard output. The .sp .ne 2 -.mk .na \fB\fB-i\fR \fIinfmt\fR\fR .ad .RS 14n -.rt \fIInput Format\fR: This option is used to specify the data encoding of raw input files. Ordinarily, the input data format is derived from the audio file header. This option is required when converting audio data that is not preceded @@ -131,12 +121,10 @@ files following that specification, until a new input format is specified. .sp .ne 2 -.mk .na \fB\fIfile\fR\fR .ad .RS 14n -.rt \fIFile Specification\fR: The named audio files are concatenated, converted to the output format, and written out. If no file name is present, or if the special file name `\(mi' is specified, audio data is read from the standard @@ -145,12 +133,10 @@ input. .sp .ne 2 -.mk .na \fB\fB-?\fR\fR .ad .RS 14n -.rt \fIHelp\fR: Prints a command line usage message. .RE @@ -167,12 +153,10 @@ with no intervening whitespace. Unambiguous values may be used without the preceding \fIkeyword\fR=. .sp .ne 2 -.mk .na \fB\fBrate\fR\fR .ad .RS 12n -.rt The audio sampling rate is specified in samples per second. If a number is followed by the letter \fBk\fR, it is multiplied by 1000 (for example, 44.1k = 44100). Standard of the commonly used sample rates are: 8k, 16k, 32k, 44.1k, @@ -181,12 +165,10 @@ and 48k. .sp .ne 2 -.mk .na \fB\fBchannels\fR\fR .ad .RS 12n -.rt The number of interleaved channels is specified as an integer. The words \fBmono\fR and \fBstereo\fR may also be used to specify one and two channel data, respectively. @@ -194,43 +176,36 @@ data, respectively. .sp .ne 2 -.mk .na \fB\fBencoding\fR\fR .ad .RS 12n -.rt This option specifies the digital audio data representation. Encodings determine precision implicitly (\fBulaw\fR implies 8-bit precision) or explicitly as part of the name (for example, \fBlinear16\fR). Valid encoding values are: .sp .ne 2 -.mk .na \fB\fBulaw\fR\fR .ad .RS 13n -.rt \fBCCITT G.711\fR -law encoding. This is an 8-bit format primarily used for telephone quality speech. .RE .sp .ne 2 -.mk .na \fB\fBalaw\fR\fR .ad .RS 13n -.rt \fBCCITT G.711\fR A-law encoding. This is an 8-bit format primarily used for telephone quality speech in Europe. .RE .sp .ne 2 -.mk .na \fB\fBlinear8\fR,\fR .ad @@ -243,7 +218,6 @@ telephone quality speech in Europe. \fB\fBlinear32\fR\fR .ad .RS 13n -.rt Linear Pulse Code Modulation (PCM) encoding. The name identifies the number of bits of precision. \fBlinear16\fR is typically used for high quality audio data. @@ -251,23 +225,19 @@ data. .sp .ne 2 -.mk .na \fB\fBpcm\fR\fR .ad .RS 13n -.rt Same as \fBlinear16\fR. .RE .sp .ne 2 -.mk .na \fB\fBg721\fR\fR .ad .RS 13n -.rt \fBCCITT G.721\fR compression format. This encoding uses Adaptive Delta Pulse Code Modulation (ADPCM) with 4-bit precision. It is primarily used for compressing -law voice data (achieving a 2:1 compression ratio). @@ -275,12 +245,10 @@ compressing -law voice data (achieving a 2:1 compression ratio). .sp .ne 2 -.mk .na \fB\fBg723\fR\fR .ad .RS 13n -.rt \fBCCITT G.723\fR compression format. This encoding uses Adaptive Delta Pulse Code Modulation (ADPCM) with 3-bit precision. It is primarily used for compressing -law voice data (achieving an 8:3 compression ratio). The audio @@ -292,34 +260,28 @@ The following encoding values are also accepted as shorthand to set the sample rate, channels, and encoding: .sp .ne 2 -.mk .na \fB\fBvoice\fR\fR .ad .RS 9n -.rt Equivalent to \fBencoding=ulaw,rate=8k,channels=mono\fR. .RE .sp .ne 2 -.mk .na \fB\fBcd\fR\fR .ad .RS 9n -.rt Equivalent to \fBencoding=linear16,rate=44.1k,channels=stereo\fR. .RE .sp .ne 2 -.mk .na \fB\fBdat\fR\fR .ad .RS 9n -.rt Equivalent to \fBencoding=linear16,rate=48k,channels=stereo\fR. .RE @@ -327,32 +289,26 @@ Equivalent to \fBencoding=linear16,rate=48k,channels=stereo\fR. .sp .ne 2 -.mk .na \fB\fBformat\fR\fR .ad .RS 12n -.rt This option specifies the audio file format. Valid formats are: .sp .ne 2 -.mk .na \fB\fBsun\fR\fR .ad .RS 7n -.rt Sun compatible file format (the default). .RE .sp .ne 2 -.mk .na \fB\fBraw\fR\fR .ad .RS 7n -.rt Use this format when reading or writing raw audio data (with no audio header), or in conjunction with an \fBoffset\fR to import a foreign audio file format. .RE @@ -361,12 +317,10 @@ or in conjunction with an \fBoffset\fR to import a foreign audio file format. .sp .ne 2 -.mk .na \fB\fBoffset\fR\fR .ad .RS 12n -.rt (\fB-i\fR \fIonly\fR) Specifies a byte offset to locate the start of the audio data. This option may be used to import audio data that contains an unrecognized file header. @@ -431,15 +385,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -ArchitectureSPARC, x86 +Architecture SPARC, x86 _ -Interface StabilityEvolving +Interface Stability Evolving .TE .SH SEE ALSO diff --git a/usr/src/man/man1/audioctl.1 b/usr/src/man/man1/audioctl.1 index b8a9d23490..78f7df7327 100644 --- a/usr/src/man/man1/audioctl.1 +++ b/usr/src/man/man1/audioctl.1 @@ -12,7 +12,7 @@ .\" .\" Copyright 2011 Nexenta Systems, Inc. All rights reserved. .\" -.TH audioctl 1 "18 Mar 2011" "SunOS 5.11" "User Commands" +.TH AUDIOCTL 1 "Mar 18, 2011" .SH NAME audioctl - audio device control command line interface .SH SYNOPSIS @@ -56,7 +56,6 @@ record gain. The \fRaudioctl\fB command supports the following subcommands. .sp .ne 2 -.mk .na \fBlist-devices\fR .ad @@ -67,7 +66,6 @@ List all the audio devices on the system. .sp .ne 2 -.mk .na \fBshow-device\fR [\fB-v\fR] [\fB-d\fR \fIdevice\fR] [\fBcontrol\fR ... ] .ad @@ -80,7 +78,6 @@ will be displayed. .sp .ne 2 -.mk .na \fBshow-control\fR [\fB-v\fR] [\fB-d\fR \fIdevice\fR] .ad @@ -94,7 +91,6 @@ the \fB-v\fR option is specified, then more detail will be displayed. .sp .ne 2 -.mk .na \fBset-control\fR [\fB-v\fR] [\fB-d\fR \fIdevice\fB] \fIcontrol\fR \fIvalue\fR .ad @@ -107,7 +103,6 @@ option is specified, then more verbose output be displayed. .sp .ne 2 -.mk .na \fBsave-controls\fR [\fB-f\fR] [\fB-d\fR \fIdevice\fB] \fIfile\fR .ad @@ -120,13 +115,12 @@ or modify an existing file unless \fB-f\fR (force) is specified. .sp .ne 2 -.mk .na \fBload-controls\fR [\fB-d\fR \fIdevice\fB] \fIfile\fR .ad .sp .6 .RS 4n -Load previously saved control settings from a \fIfile\fR +Load previously saved control settings from a \fIfile\fR into a \fIdevice\fR (or all audio devices if not specified). .RE @@ -135,12 +129,10 @@ specified). .sp .sp .ne 2 -.mk .na \fB\fBAUDIODEV\fR\fR .ad .RS 12n -.rt The full path name of the default audio device to use if on is not specified on the command line. If this variable is not set, \fB/dev/audio\fR is used. @@ -155,13 +147,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilitySee below. +Interface Stability See below. .TE .LP The \fBaudioctl\fR command and its subcommands are Committed. The diff --git a/usr/src/man/man1/audioplay.1 b/usr/src/man/man1/audioplay.1 index e9b74b7cba..4e5f391f5a 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 "1 May 2009" "SunOS 5.11" "User Commands" +.TH AUDIOPLAY 1 "May 1, 2009" .SH NAME audioplay \- play audio files .SH SYNOPSIS @@ -37,12 +37,10 @@ such deviations are flagged with warning messages. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-d\fR \fIdev\fR\fR .ad .RS 11n -.rt \fIDevice\fR: The \fIdev\fR argument specifies an alternate audio device to which output should be directed. If the \fB-d\fR option is not specified, the \fBAUDIODEV\fR environment variable is consulted (see below). Otherwise, @@ -51,12 +49,10 @@ which output should be directed. If the \fB-d\fR option is not specified, the .sp .ne 2 -.mk .na \fB\fB-i\fR\fR .ad .RS 11n -.rt \fIImmediate\fR: If the audio device is unavailable (that is, another process currently has write access), \fBaudioplay\fR ordinarily waits until it can obtain access to the device. When the \fB-i\fR option is present, @@ -66,12 +62,10 @@ busy. .sp .ne 2 -.mk .na \fB\fB-v\fR \fIvol\fR\fR .ad .RS 11n -.rt \fIVolume\fR: The output volume is set to the specified value before playing begins, and is reset to its previous level when \fBaudioplay\fR exits. The \fIvol\fR argument is an integer value between 0 and 100, inclusive. If this @@ -81,36 +75,30 @@ set by any process. .sp .ne 2 -.mk .na \fB\fB-V\fR\fR .ad .RS 11n -.rt \fIVerbose\fR: Prints messages on the standard error when waiting for access to the audio device or when sample rate deviations are detected. .RE .sp .ne 2 -.mk .na \fB\fB\(mi\e?\fR\fR .ad .RS 11n -.rt \fIHelp\fR: Prints a command line usage message. .RE .SH OPERANDS .sp .ne 2 -.mk .na \fB\fIfile\fR\fR .ad .RS 8n -.rt \fIFile Specification\fR: Audio files named on the command line are played sequentially. If no filenames are present, the standard input stream (if it is not a tty) is played (it, too, must contain an audio file header). The special @@ -127,24 +115,20 @@ when encountering files greater than or equal to 2 Gbyte ( 2^31 bytes). .SH ENVIRONMENT VARIABLES .sp .ne 2 -.mk .na \fB\fBAUDIODEV\fR\fR .ad .RS 13n -.rt The full path name of the audio device to write to, if no \fB-d\fR argument is supplied. If the \fBAUDIODEV\fR variable is not set, \fB/dev/audio\fR is used. .RE .sp .ne 2 -.mk .na \fB\fBAUDIOPATH\fR\fR .ad .RS 13n -.rt A colon-separated list of directories in which to search for audio files whose names are given by relative pathnames. The current directory (\fB\&.\fR) can be specified explicitly in the search path. If the \fBAUDIOPATH\fR variable is not @@ -159,15 +143,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -ArchitectureSPARC, x86 +Architecture SPARC, x86 _ -Interface StabilityCommitted +Interface Stability Committed .TE .SH SEE ALSO diff --git a/usr/src/man/man1/audiorecord.1 b/usr/src/man/man1/audiorecord.1 index 4db99e4ea8..ba1e0a99ac 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 "5 May 2009" "SunOS 5.11" "User Commands" +.TH AUDIORECORD 1 "May 5, 2009" .SH NAME audiorecord \- record an audio file .SH SYNOPSIS @@ -43,35 +43,29 @@ read access, \fBaudiorecord\fR prints an error message and exits immediately. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-\e?\fR\fR .ad .RS 24n -.rt \fIHelp\fR: Prints a command line usage message. .RE .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 24n -.rt \fIAppend\fR: Appends the data on the end of the named audio file. The audio device must support the audio data format of the existing file. .RE .sp .ne 2 -.mk .na \fB\fB-c\fR \fIchannels\fR\fR .ad .RS 24n -.rt \fIChannels\fR: Specifies the number of audio channels (1 or 2). The value may be specified as an integer or as the string \fBmono\fR or \fBstereo\fR. The default value is \fBmono\fR. @@ -79,12 +73,10 @@ default value is \fBmono\fR. .sp .ne 2 -.mk .na \fB\fB-d\fR \fIdev\fR\fR .ad .RS 24n -.rt \fIDevice\fR: The \fIdev\fR argument specifies an alternate audio device from which input should be taken. If the \fB-d\fR option is not specified, the \fBAUDIODEV\fR environment variable is consulted (see below). Otherwise, @@ -93,24 +85,20 @@ which input should be taken. If the \fB-d\fR option is not specified, the .sp .ne 2 -.mk .na \fB\fB-e\fR \fIencoding\fR\fR .ad .RS 24n -.rt \fIEncoding\fR: Specifies the audio data encoding. This value may be one of \fBulaw\fR, \fBalaw\fR, or \fBlinear\fR. The default encoding is \fBulaw\fR. .RE .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 24n -.rt \fIForce\fR: When the \fB-a\fR flag is specified, the sample rate of the audio device must match the sample rate at which the original file was recorded. If the \fB-f\fR flag is also specified, sample rate differences are ignored, with @@ -119,12 +107,10 @@ a warning message printed on the standard error. .sp .ne 2 -.mk .na \fB\fB-i\fR \fIinfo\fR\fR .ad .RS 24n -.rt \fIInformation\fR: The `information' field of the output file header is set to the string specified by the \fIinfo\fR argument. This option cannot be specified in conjunction with the \fB-a\fR argument. @@ -132,12 +118,10 @@ specified in conjunction with the \fB-a\fR argument. .sp .ne 2 -.mk .na \fB\fB-s\fR \fIrate\fR\fR .ad .RS 24n -.rt \fISample Rate\fR: Specifies the sample rate, in samples per second. If a number is followed by the letter \fBk\fR, it is multiplied by 1000 (for example, 44.1k = 44100). The default sample rate is 8 kHz. @@ -145,12 +129,10 @@ example, 44.1k = 44100). The default sample rate is 8 kHz. .sp .ne 2 -.mk .na \fB\fB-t\fR \fItime\fR\fR .ad .RS 24n -.rt \fITime\fR: The \fItime\fR argument specifies the maximum length of time to record. Time can be specified as a floating-point value, indicating the number of seconds, or in the form: \fIhh:mm:ss.dd\fR, where the hour and minute @@ -159,12 +141,10 @@ specifications are optional. .sp .ne 2 -.mk .na \fB\fB-T\fR \fBau\fR | \fBaif\fR[\fBf\fR] | \fBwav\fR\fR .ad .RS 24n -.rt Specifies the audio file type to create. If the \fB-a\fR option is used, the file type must match the file to which it is being appended. Regardless of the file suffix, the type is set as specified in this option. If this option is not @@ -173,12 +153,10 @@ specified, the file suffix determines the type. .sp .ne 2 -.mk .na \fB\fB-v\fR \fIvol\fR\fR .ad .RS 24n -.rt \fIVolume\fR: The recording gain is set to the specified value before recording begins, and is reset to its previous level when \fBaudiorecord\fR exits. The \fIvol\fR argument is an integer value between 0 and 100, inclusive. If this @@ -189,7 +167,6 @@ set by any process. .SH OPERANDS .sp .ne 2 -.mk .na \fB\fIfile\fR[\fB\&.au\fR|\fB\&.aif\fR[\fBf\fR]]|\fB\&.wav\fR\fR .ad @@ -214,12 +191,10 @@ when encountering files greater than or equal to 2 Gbyte ( 2^31 bytes). .SH ENVIRONMENT VARIABLES .sp .ne 2 -.mk .na \fB\fBAUDIODEV\fR\fR .ad .RS 12n -.rt The full path name of the audio device to record from, if no \fB-d\fR argument is supplied. If the \fBAUDIODEV\fR variable is not set, \fB/dev/audio\fR is used. @@ -233,15 +208,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -ArchitectureSPARC, x86 +Architecture SPARC, x86 _ -Interface StabilityCommitted +Interface Stability Committed .TE .SH SEE ALSO diff --git a/usr/src/man/man1/audiotest.1 b/usr/src/man/man1/audiotest.1 index 43c7761d3a..67f6033963 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 "5 May 2009" "SunOS 5.11" "User Commands" +.TH AUDIOTEST 1 "May 5, 2009" .SH NAME audiotest \- test audio device .SH SYNOPSIS @@ -25,47 +25,39 @@ drift. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-1\fR\fR .ad .RS 6n -.rt Loop mode. The test is run in an infinite loop. .RE .sp .ne 2 -.mk .na \fB\fB-2\fR\fR .ad .RS 6n -.rt Stereo (2-channel) mode. This is the default mode. Playback assumes 2 channels are present. .RE .sp .ne 2 -.mk .na \fB\fB-4\fR\fR .ad .RS 6n -.rt Quadraphonic mode (4-channel surround). The test assumes that four surround channels are present. .RE .sp .ne 2 -.mk .na \fB\fB-5\fR\fR .ad .RS 6n -.rt Surround sound mode (5.1). The test checks the left, right, surround left, surround right, and center channels. The low frequency effects channel is not tested. @@ -73,12 +65,10 @@ tested. .sp .ne 2 -.mk .na \fB\fB-7\fR\fR .ad .RS 6n -.rt Surround sound mode (7.1). The test checks the left, right, surround left, surround right, back surround left, back surround right, and center channels. The low frequency effects channel is not tested. @@ -87,12 +77,10 @@ The low frequency effects channel is not tested. .SH OPERANDS .sp .ne 2 -.mk .na \fB\fIdev\fR\fR .ad .RS 7n -.rt The path the device to test, for example, \fB/dev/dsp0\fR. .RE @@ -104,15 +92,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -ArchitectureSPARC, x86 +Architecture SPARC, x86 _ -Interface StabilityCommitted +Interface Stability Committed .TE .SH SEE ALSO diff --git a/usr/src/man/man1/auths.1 b/usr/src/man/man1/auths.1 index 77ae765179..0708da4105 100644 --- a/usr/src/man/man1/auths.1 +++ b/usr/src/man/man1/auths.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 auths 1 "25 Mar 2004" "SunOS 5.11" "User Commands" +.TH AUTHS 1 "Mar 25, 2004" .SH NAME auths \- print authorizations granted to a user .SH SYNOPSIS @@ -68,23 +68,19 @@ names in \fBtester01\fR. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt An error occurred. .RE diff --git a/usr/src/man/man1/awk.1 b/usr/src/man/man1/awk.1 index 14d5a145ec..b32c4d84ee 100644 --- a/usr/src/man/man1/awk.1 +++ b/usr/src/man/man1/awk.1 @@ -2,26 +2,26 @@ .\" Copyright (c) 2005, Sun Microsystems, Inc. All Rights Reserved .\" Copyright 1989 AT&T .\" Portions Copyright (c) 1992, X/Open Company Limited. All Rights Reserved. -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 awk 1 "22 Jun 2005" "SunOS 5.11" "User Commands" +.TH AWK 1 "Jun 22, 2005" .SH NAME awk \- pattern scanning and processing language .SH SYNOPSIS .LP .nf -\fB/usr/bin/awk\fR [\fB-f\fR \fIprogfile\fR] [\fB-F\fIc\fR\fR] [' \fIprog\fR '] [\fIparameters\fR] +\fB/usr/bin/awk\fR [\fB-f\fR \fIprogfile\fR] [\fB-F\fIc\fR\fR] [' \fIprog\fR '] [\fIparameters\fR] [\fIfilename\fR]... .fi .LP .nf -\fB/usr/xpg4/bin/awk\fR [\fB-F\fR\fIcERE\fR] [\fB-v\fR \fIassignment\fR]... \fI\&'program'\fR \fB-f\fR \fIprogfile\fR... +\fB/usr/xpg4/bin/awk\fR [\fB-F\fR\fIcERE\fR] [\fB-v\fR \fIassignment\fR]... \fI\&'program'\fR \fB-f\fR \fIprogfile\fR... [\fIargument\fR]... .fi @@ -47,23 +47,19 @@ standard input. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-f\fR\fI progfile\fR \fR .ad .RS 16n -.rt \fBawk\fR uses the set of patterns it reads from \fIprogfile\fR. .RE .sp .ne 2 -.mk .na \fB\fB-F\fR\fIc\fR \fR .ad .RS 16n -.rt Uses the character \fIc\fR as the field separator (FS) character. See the discussion of \fBFS\fR below. .RE @@ -153,89 +149,73 @@ been read respectively. These keywords do not combine with any other patterns. Built-in variables include: .sp .ne 2 -.mk .na \fB\fBFILENAME\fR \fR .ad .RS 13n -.rt name of the current input file .RE .sp .ne 2 -.mk .na \fB\fBFS\fR \fR .ad .RS 13n -.rt input field separator regular expression (default blank and tab) .RE .sp .ne 2 -.mk .na \fB\fBNF\fR \fR .ad .RS 13n -.rt number of fields in the current record .RE .sp .ne 2 -.mk .na \fB\fBNR\fR \fR .ad .RS 13n -.rt ordinal number of the current record .RE .sp .ne 2 -.mk .na \fB\fBOFMT\fR \fR .ad .RS 13n -.rt output format for numbers (default \fB%.6g\fR) .RE .sp .ne 2 -.mk .na \fB\fBOFS\fR \fR .ad .RS 13n -.rt output field separator (default blank) .RE .sp .ne 2 -.mk .na \fB\fBORS\fR \fR .ad .RS 13n -.rt output record separator (default new-line) .RE .sp .ne 2 -.mk .na \fB\fBRS\fR \fR .ad .RS 13n -.rt input record separator (default new-line) .RE @@ -246,10 +226,10 @@ An action is a sequence of statements. A statement can be one of the following: .in +2 .nf if ( \fIexpression\fR ) \fIstatement\fR [ else \fIstatement\fR ] -while ( \fIexpression\fR ) \fIstatement\fR +while ( \fIexpression\fR ) \fIstatement\fR do \fIstatement\fR while ( \fIexpression\fR ) -for ( \fIexpression\fR ; \fIexpression\fR ; \fIexpression\fR ) \fIstatement\fR -for ( \fIvar\fR in \fIarray\fR ) \fIstatement\fR +for ( \fIexpression\fR ; \fIexpression\fR ; \fIexpression\fR ) \fIstatement\fR +for ( \fIvar\fR in \fIarray\fR ) \fIstatement\fR break continue { [ \fIstatement\fR ] .\|.\|. } @@ -288,69 +268,57 @@ according to the format (see \fBprintf\fR(3C)). The arithmetic functions are as follows: .sp .ne 2 -.mk .na \fB\fBcos\fR(\fIx\fR)\fR .ad .RS 11n -.rt Return cosine of \fIx\fR, where \fIx\fR is in radians. (In \fB/usr/xpg4/bin/awk\fR only. See \fBnawk\fR(1).) .RE .sp .ne 2 -.mk .na \fB\fBsin\fR(\fIx\fR)\fR .ad .RS 11n -.rt Return sine of \fIx\fR, where \fIx\fR is in radians. (In \fB/usr/xpg4/bin/awk\fR only. See \fBnawk\fR(1).) .RE .sp .ne 2 -.mk .na \fB\fBexp\fR(\fIx\fR)\fR .ad .RS 11n -.rt Return the exponential function of \fIx\fR. .RE .sp .ne 2 -.mk .na \fB\fBlog\fR(\fIx\fR)\fR .ad .RS 11n -.rt Return the natural logarithm of \fIx\fR. .RE .sp .ne 2 -.mk .na \fB\fBsqrt\fR(\fIx\fR)\fR .ad .RS 11n -.rt Return the square root of \fIx\fR. .RE .sp .ne 2 -.mk .na \fB\fBint\fR(\fIx\fR)\fR .ad .RS 11n -.rt Truncate its argument to an integer. It is truncated toward \fB0\fR when \fIx\fR >\fB 0\fR. .RE @@ -360,7 +328,6 @@ Truncate its argument to an integer. It is truncated toward \fB0\fR when The string functions are as follows: .sp .ne 2 -.mk .na \fB\fBindex(\fR\fIs\fR\fB, \fR\fIt\fR\fB)\fR\fR .ad @@ -372,7 +339,6 @@ Return the position in string \fIs\fR where string \fIt\fR first occurs, or .sp .ne 2 -.mk .na \fB\fBint(\fR\fIs\fR\fB)\fR\fR .ad @@ -383,7 +349,6 @@ truncates \fIs\fR to an integer value. If \fIs\fR is not specified, $0 is used. .sp .ne 2 -.mk .na \fB\fBlength(\fR\fIs\fR\fB)\fR\fR .ad @@ -395,7 +360,6 @@ there is no argument. .sp .ne 2 -.mk .na \fB\fBsplit(\fR\fIs\fR, \fIa\fR, \fIfs\fR\fB)\fR\fR .ad @@ -409,7 +373,6 @@ separator \fBFS\fR if \fIfs\fR is not given. .sp .ne 2 -.mk .na \fB\fBsprintf(\fR\fIfmt\fR, \fIexpr\fR, \fIexpr\fR,\|.\|.\|.\|\fB)\fR\fR .ad @@ -421,7 +384,6 @@ Format the expressions according to the \fBprintf\fR(3C) format given by .sp .ne 2 -.mk .na \fB\fBsubstr(\fR\fIs\fR, \fIm\fR, \fIn\fR\fB)\fR\fR .ad @@ -436,12 +398,10 @@ returns the \fIn\fR-character substring of \fIs\fR that begins at position The input/output function is as follows: .sp .ne 2 -.mk .na \fB\fBgetline\fR\fR .ad .RS 11n -.rt Set \fB$0\fR to the next input record from the current input file. \fBgetline\fR returns \fB1\fR for successful input, \fB0\fR for end of file, and \fB\(mi1\fR for an error. @@ -609,12 +569,10 @@ that affect the execution of \fBawk\fR: \fBLANG\fR, \fBLC_ALL\fR, \fBPATH\fR. .sp .ne 2 -.mk .na \fB\fBLC_NUMERIC\fR\fR .ad .RS 14n -.rt Determine the radix character used when interpreting numeric input, performing conversions between numeric and string values and formatting numeric output. Regardless of locale, the period character (the decimal-point character of the @@ -631,13 +589,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSINot Enabled +CSI Not Enabled .TE .SS "/usr/xpg4/bin/awk" @@ -645,15 +602,14 @@ CSINot Enabled .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man1/banner.1 b/usr/src/man/man1/banner.1 index d5cbccea9f..b61ac24088 100644 --- a/usr/src/man/man1/banner.1 +++ b/usr/src/man/man1/banner.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 banner 1 "14 Sep 1992" "SunOS 5.11" "User Commands" +.TH BANNER 1 "Sep 14, 1992" .SH NAME banner \- make posters .SH SYNOPSIS diff --git a/usr/src/man/man1/basename.1 b/usr/src/man/man1/basename.1 index 3b10233463..ac7962b4be 100644 --- a/usr/src/man/man1/basename.1 +++ b/usr/src/man/man1/basename.1 @@ -1,13 +1,13 @@ '\" te .\" Copyright 1989 AT&T Copyright (c) 2001, Sun Microsystems, Inc. All Rights Reserved Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 1 "18 Mar 1997" "SunOS 5.11" "User Commands" +.TH BASENAME 1 "Mar 18, 1997" .SH NAME basename, dirname \- deliver portions of path names .SH SYNOPSIS @@ -93,23 +93,19 @@ that affect the execution of \fBbasename\fR and \fBdirname\fR: \fBLANG\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE diff --git a/usr/src/man/man1/bc.1 b/usr/src/man/man1/bc.1 index 733d542c85..ef53dd46e1 100644 --- a/usr/src/man/man1/bc.1 +++ b/usr/src/man/man1/bc.1 @@ -1,13 +1,13 @@ '\" te .\" Copyright 1989 AT&T Copyright (c) 2003, Sun Microsystems, Inc. All Rights Reserved Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 bc 1 "29 Aug 2003" "SunOS 5.11" "User Commands" +.TH BC 1 "Aug 29, 2003" .SH NAME bc \- arbitrary precision arithmetic language .SH SYNOPSIS @@ -38,35 +38,29 @@ case the \fBdc\fR input is sent to the standard output instead. The syntax for \fBbc\fR programs is as follows: .sp .ne 2 -.mk .na \fB\fIL\fR\fR .ad .RS 5n -.rt Means a letter \fBa\fR\(mi\fBz\fR, .RE .sp .ne 2 -.mk .na \fB\fIE\fR\fR .ad .RS 5n -.rt Means an expression: a (mathematical or logical) value, an operand that takes a value, or a combination of operands and operators that evaluates to a value, .RE .sp .ne 2 -.mk .na \fB\fIS\fR\fR .ad .RS 5n -.rt Means a statement. .RE @@ -96,52 +90,43 @@ than \fBBC_STRING_MAX\fR characters, between double quotes ("). \fB(\fR \fIE\fR \fB)\fR .sp .ne 2 -.mk .na \fB\fBsqrt ( \fR\fIE\fR\fB )\fR\fR .ad .RS 21n -.rt Square root .RE .sp .ne 2 -.mk .na \fB\fBlength ( \fR\fIE\fR\fB )\fR\fR .ad .RS 21n -.rt Number of significant decimal digits. .RE .sp .ne 2 -.mk .na \fB\fBscale ( \fR\fIE\fR\fB )\fR\fR .ad .RS 21n -.rt Number of digits right of decimal point. .RE .sp .ne 2 -.mk .na \fB\fIL \fR\fB( \fR\fIE\fR , ... , \fIE\fR\fB )\fR\fR .ad .RS 21n -.rt - + .RE .SS "Operators" .sp .ne 2 -.mk .na \fB\fB+ \(mi * / % ^\fR\fR .ad @@ -152,7 +137,6 @@ Number of digits right of decimal point. .sp .ne 2 -.mk .na \fB\fB++ \(mi\(mi \fR\fR .ad @@ -163,24 +147,22 @@ Number of digits right of decimal point. .sp .ne 2 -.mk .na \fB\fB== <= >= != < >\fR\fR .ad .sp .6 .RS 4n - + .RE .sp .ne 2 -.mk .na \fB\fB= =+ =\(mi =* =/ =% =^\fR\fR .ad .sp .6 .RS 4n - + .RE .SS "Statements" @@ -226,15 +208,15 @@ null statement .in -2 .br .in +2 -\fB auto\fR \fIL\fR \fB,\fR.\|.\|.\|\fB,\fR \fIL\fR +\fBauto\fR \fIL\fR \fB,\fR.\|.\|.\|\fB,\fR \fIL\fR .in -2 .br .in +2 -\fI S\fR \fB;\fR.\|.\|.\| \fIS\fR +\fIS\fR \fB;\fR.\|.\|.\| \fIS\fR .in -2 .br .in +2 -\fB return (\fR \fIE\fR \fB)\fR +\fBreturn (\fR \fIE\fR \fB)\fR .in -2 .br .in +2 @@ -243,67 +225,55 @@ null statement .SS "Functions in \fB-l\fR Math Library" .sp .ne 2 -.mk .na \fB\fBs(\fR\fIx\fR\fB)\fR\fR .ad .RS 10n -.rt sine .RE .sp .ne 2 -.mk .na \fB\fBc(\fR\fIx\fR\fB)\fR\fR .ad .RS 10n -.rt cosine .RE .sp .ne 2 -.mk .na \fB\fBe(\fR\fIx\fR\fB)\fR\fR .ad .RS 10n -.rt exponential .RE .sp .ne 2 -.mk .na \fB\fBl(\fR\fIx\fR\fB)\fR\fR .ad .RS 10n -.rt log .RE .sp .ne 2 -.mk .na \fB\fBa(\fR\fIx\fR\fB)\fR\fR .ad .RS 10n -.rt arctangent .RE .sp .ne 2 -.mk .na \fB\fBj(\fR\fIn\fR\fB,\fR\fIx)\fR\fR .ad .RS 10n -.rt Bessel function .RE @@ -330,12 +300,10 @@ array name. The following operands are supported: .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad .RS 6n -.rt Compiles only. The output is \fBdc\fR commands that are sent to the standard output. .RE @@ -343,12 +311,10 @@ output. .SS "/usr/bin/bc" .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 6n -.rt Defines the math functions and initializes \fBscale\fR to \fB20\fR, instead of the default zero. .RE @@ -356,12 +322,10 @@ the default zero. .SS "/usr/xpg6/bin/bc" .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 6n -.rt Defines the math functions and initializes \fBscale\fR to \fB20\fR, instead of the default zero. All math results have the scale of \fB20\fR. .RE @@ -372,12 +336,10 @@ the default zero. All math results have the scale of \fB20\fR. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIfile\fR\fR .ad .RS 8n -.rt A pathname of a text file containing \fBbc\fR program statements. After all cases of \fIfile\fR have been read, \fBbc\fR reads the standard input. .RE @@ -464,46 +426,38 @@ that affect the execution of \fBbc\fR: \fBLANG\fR, \fBLC_ALL\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 15n -.rt All input files were processed successfully. .RE .sp .ne 2 -.mk .na \fB\fBunspecified\fR\fR .ad .RS 15n -.rt An error occurred. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB/usr/lib/lib.b\fR\fR .ad .RS 25n -.rt mathematical library .RE .sp .ne 2 -.mk .na \fB\fB/usr/include/limits.h\fR\fR .ad .RS 25n -.rt to define BC_ parameters .RE @@ -515,13 +469,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man1/bdiff.1 b/usr/src/man/man1/bdiff.1 index 71b8d44488..ce4e29c439 100644 --- a/usr/src/man/man1/bdiff.1 +++ b/usr/src/man/man1/bdiff.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 bdiff 1 "14 Sep 1992" "SunOS 5.11" "User Commands" +.TH BDIFF 1 "Sep 14, 1992" .SH NAME bdiff \- big diff .SH SYNOPSIS @@ -36,12 +36,10 @@ file differences. .SH OPTIONS .sp .ne 2 -.mk .na \fB\fIn\fR \fR .ad .RS 7n -.rt The number of line segments. The value of \fIn\fR is 3500 by default. If the optional third argument is given and it is numeric, it is used as the value for \fIn\fR. This is useful in those cases in which 3500-line segments are too @@ -50,12 +48,10 @@ large for \fBdiff\fR, causing it to fail. .sp .ne 2 -.mk .na \fB\fB-s\fR \fR .ad .RS 7n -.rt Specifies that no diagnostics are to be printed by \fBbdiff\fR (silent option). Note: However, this does not suppress possible diagnostic messages from \fBdiff\fR, which \fBbdiff\fR calls. @@ -78,13 +74,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIenabled +CSI enabled .TE .SH SEE ALSO diff --git a/usr/src/man/man1/bfs.1 b/usr/src/man/man1/bfs.1 index ddfece0fc0..4c36bf0b62 100644 --- a/usr/src/man/man1/bfs.1 +++ b/usr/src/man/man1/bfs.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 bfs 1 "20 May 1996" "SunOS 5.11" "User Commands" +.TH BFS 1 "May 20, 1996" .SH NAME bfs \- big file scanner .SH SYNOPSIS @@ -37,23 +37,19 @@ regular expressions may be surrounded with two symbols besides \fB/\fR and \fB?\fR: .sp .ne 2 -.mk .na \fB\fB>\fR\fR .ad .RS 5n -.rt indicates downward search without wrap-around, and .RE .sp .ne 2 -.mk .na \fB\fB<\fR\fR .ad .RS 5n -.rt indicates upward search without wrap-around. .RE @@ -75,7 +71,6 @@ xt\fR, and\fB xc\fR commands, below). The following additional commands are available: .sp .ne 2 -.mk .na \fB\fBxf\fR\fI file\fR\fR .ad @@ -89,7 +84,6 @@ depth of 10. .sp .ne 2 -.mk .na \fB\fBxn\fR\fR .ad @@ -100,7 +94,6 @@ List the marks currently in use (marks are set by the \fBk\fR command). .sp .ne 2 -.mk .na \fB\fBxo\fR\fI [\|file\|]\fR\fR .ad @@ -115,7 +108,6 @@ Note that each diversion causes truncation or creation of the file. .sp .ne 2 -.mk .na \fB\fB:\fR\fI label\fR\fR .ad @@ -129,7 +121,6 @@ a command file, since labels need not be referenced. .sp .ne 2 -.mk .na \fB( \fB\&. \fR, \fB\&. \fR)\fBxb\fR/\fIregular expression\fR/\fIlabel\fR\fR .ad @@ -165,7 +156,6 @@ terminal. If it is read from a pipe, only a downward jump is possible. .sp .ne 2 -.mk .na \fB\fBxt\fR\fI number\fR\fR .ad @@ -177,7 +167,6 @@ Output from the \fBp\fR and null commands is truncated to, at most, .sp .ne 2 -.mk .na \fB\fBxv\fR[\fIdigit\fR]\|[\fIspaces\fR]\|[\fIvalue\fR]\fR .ad @@ -237,7 +226,6 @@ stores the value \fB!date\fR into variable \fB7\fR. .sp .ne 2 -.mk .na \fB\fBxbz\fR\fI label\fR\fR .ad @@ -253,12 +241,10 @@ value, respectively, to the specified label. The two examples below both search for the next five lines containing the string \fBsize\fR: .sp .ne 2 -.mk .na \fBExample 1:\fR .ad .RS 14n -.rt .sp .in +2 .nf @@ -276,12 +262,10 @@ xbn l\fR .sp .ne 2 -.mk .na \fBExample 2:\fR .ad .RS 14n -.rt .sp .in +2 .nf @@ -301,7 +285,6 @@ xbz l\fR .sp .ne 2 -.mk .na \fB\fBxc\fR [\fBswitch\fR]\fR .ad @@ -320,12 +303,10 @@ lines suppressed. The following operand is supported: .sp .ne 2 -.mk .na \fB\fIfilename\fR\fR .ad .RS 12n -.rt Any file up to 1024K bytes and 32K lines, with up to 512 characters, including new-line, per line (255 for 16-bit machines). \fIfilename\fR can be a section of a larger file which has been divided into more manageable sections for @@ -338,23 +319,19 @@ editing by the use of \fBcsplit\fR(1). The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion without any file or command errors. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE diff --git a/usr/src/man/man1/break.1 b/usr/src/man/man1/break.1 index 15949c8bc5..ac065495a7 100644 --- a/usr/src/man/man1/break.1 +++ b/usr/src/man/man1/break.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 break 1 "8 Apr 2008" "SunOS 5.11" "User Commands" +.TH BREAK 1 "Apr 8, 2008" .SH NAME break, continue \- shell built-in functions to escape from or advance within a controlling while, for, foreach, or until loop @@ -24,12 +24,12 @@ controlling while, for, foreach, or until loop .SS "\fBcsh\fR" .LP .nf -\fBbreak\fR +\fBbreak\fR .fi .LP .nf -\fBcontinue\fR +\fBcontinue\fR .fi .SS "\fBksh\fR" diff --git a/usr/src/man/man1/builtin.1 b/usr/src/man/man1/builtin.1 index fdf651aa9e..1625cf2551 100644 --- a/usr/src/man/man1/builtin.1 +++ b/usr/src/man/man1/builtin.1 @@ -2,7 +2,7 @@ .\" Copyright (c) 1982-2007 AT&T Knowledge Ventures .\" To view license terms, see http://www.opensource.org/licenses/cpl1.0.txt .\" Portions Copyright (c) 2007, Sun Microsystems, Inc. -.TH builtin 1 "1 May 2007" "SunOS 5.11" "User Commands" +.TH BUILTIN 1 "May 1, 2007" .SH NAME builtin \- ksh93 built-in function to add, delete, or display shell built-ins .SH SYNOPSIS @@ -55,23 +55,19 @@ shell. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad .RS 10n -.rt Delete each of the specified built-ins. Special built-ins cannot be deleted. .RE .sp .ne 2 -.mk .na \fB\fB-f\fR \fIlib\fR\fR .ad .RS 10n -.rt On systems with dynamic linking, load and search for built-ins in the shared library, \fIlib\fR. .sp @@ -85,12 +81,10 @@ the reverse order in which they are specified. .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 10n -.rt Display only the special built-ins. .RE @@ -100,12 +94,10 @@ Display only the special built-ins. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIpathname\fR\fR .ad .RS 12n -.rt Specifies the \fIpathname\fR. The basename of the pathname determines the name of the built-in. .RE @@ -116,23 +108,19 @@ of the built-in. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -164,13 +152,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityUncommitted +Interface Stability Uncommitted .TE .SH SEE ALSO diff --git a/usr/src/man/man1/cal.1 b/usr/src/man/man1/cal.1 index 7581b7da42..3ac61ca07b 100644 --- a/usr/src/man/man1/cal.1 +++ b/usr/src/man/man1/cal.1 @@ -1,13 +1,13 @@ '\" te .\" Copyright 1989 AT&T Copyright (c) 1995, Sun Microsystems, Inc. All Rights Reserved Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 cal 1 "1 Feb 1995" "SunOS 5.11" "User Commands" +.TH CAL 1 "Feb 1, 1995" .SH NAME cal \- display a calendar .SH SYNOPSIS @@ -28,24 +28,20 @@ operands are specified, a calendar for the current month is written. The following operands are supported: .sp .ne 2 -.mk .na \fB\fImonth\fR\fR .ad .RS 9n -.rt Specify the month to be displayed, represented as a decimal integer from \fB1\fR (January) to \fB12\fR (December). The default is the current month. .RE .sp .ne 2 -.mk .na \fB\fIyear\fR\fR .ad .RS 9n -.rt Specify the year for which the calendar is displayed, represented as a decimal integer from \fB1\fR to \fB9999\fR. The default is the current year. .RE @@ -58,12 +54,10 @@ that affect the execution of \fBcal\fR: \fBLANG\fR, \fBLC_ALL\fR, \fBLC_CTYPE\fR, \fBLC_TIME\fR, \fBLC_MESSAGES\fR, and \fBNLSPATH\fR. .sp .ne 2 -.mk .na \fB\fBTZ\fR\fR .ad .RS 6n -.rt Determine the timezone used to calculate the value of the current month. .RE @@ -73,23 +67,19 @@ Determine the timezone used to calculate the value of the current month. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -101,13 +91,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man1/calendar.1 b/usr/src/man/man1/calendar.1 index be55d5f852..3053e49bd3 100644 --- a/usr/src/man/man1/calendar.1 +++ b/usr/src/man/man1/calendar.1 @@ -1,13 +1,13 @@ '\" te .\" Copyright 1989 AT&T Copyright (c) 2001, Sun Microsystems, Inc. All Rights Reserved Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 calendar 1 "1 Feb 1995" "SunOS 5.11" "User Commands" +.TH CALENDAR 1 "Feb 1, 1995" .SH NAME calendar \- reminder service .SH SYNOPSIS @@ -83,57 +83,47 @@ that affect the execution of \fBcalendar\fR: \fBLC_CTYPE\fR, \fBLC_TIME\fR, .SH EXIT STATUS .sp .ne 2 -.mk .na \fB\fB0\fR \fR .ad .RS 7n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR \fR .ad .RS 7n -.rt An error occurred. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB/etc/passwd\fR \fR .ad .RS 21n -.rt system password file .RE .sp .ne 2 -.mk .na \fB\fB/tmp/cal*\fR \fR .ad .RS 21n -.rt temporary files used by \fBcalendar\fR .RE .sp .ne 2 -.mk .na \fB\fB/usr/lib/calprog\fR \fR .ad .RS 21n -.rt program used to determine dates for today and tomorrow .RE .SH SEE ALSO diff --git a/usr/src/man/man1/cancel.1 b/usr/src/man/man1/cancel.1 index 1f286366ec..fed3d09e4e 100644 --- a/usr/src/man/man1/cancel.1 +++ b/usr/src/man/man1/cancel.1 @@ -1,10 +1,10 @@ '\" te -.\" Copyright 1989 AT&T +.\" Copyright 1989 AT&T .\" Copyright (C) 2005, 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 cancel 1 "26 May 2006" "SunOS 5.11" "User Commands" +.TH CANCEL 1 "May 26, 2006" .SH NAME cancel \- cancel print request .SH SYNOPSIS @@ -55,12 +55,10 @@ The print client commands locate destination information using the The following options are supported: .sp .ne 2 -.mk .na \fB\fB-u\fR \fIuser\fR\fR .ad .RS 11n -.rt The name of the user for which print requests are to be cancelled. Specify \fIuser\fR as a username. .RE @@ -71,12 +69,10 @@ The name of the user for which print requests are to be cancelled. Specify The following operands are supported: .sp .ne 2 -.mk .na \fB\fIdestination\fR\fR .ad .RS 15n -.rt The destination on which the print requests are to be canceled. \fIdestination\fR is the name of a printer or class of printers (see \fBlpadmin\fR(1M)). If \fIdestination\fR is not specified, \fBcancel\fR cancels @@ -89,24 +85,20 @@ See \fBprinters.conf\fR(4) for more information. .sp .ne 2 -.mk .na \fB\fIrequest-ID\fR\fR .ad .RS 15n -.rt The print request to be canceled. Specify \fIrequest-ID\fR using \fBLP-style\fR request \fBIDs\fR (\fIdestination\fR-\fInumber\fR). .RE .sp .ne 2 -.mk .na \fB\fIuser\fR\fR .ad .RS 15n -.rt The name of the user for which the print requests are to be cancelled. Specify \fIuser\fR as a username. .RE @@ -117,79 +109,65 @@ The name of the user for which the print requests are to be cancelled. Specify 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 \fBNIS\fR version of \fB/etc/printers.conf\fR .RE .sp .ne 2 -.mk .na \fB\fBprinters.org_dir\fR\fR .ad .RS 24n -.rt \fBNIS+\fR version of \fB/etc/printers.conf\fR .RE @@ -201,13 +179,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityObsolete +Interface Stability Obsolete .TE .SH SEE ALSO diff --git a/usr/src/man/man1/cat.1 b/usr/src/man/man1/cat.1 index c374aa9108..9e5e87b715 100644 --- a/usr/src/man/man1/cat.1 +++ b/usr/src/man/man1/cat.1 @@ -3,14 +3,14 @@ .\" 2008, Sun Microsystems, Inc. All Rights Reserved .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved .\" Portions Copyright (c) 1982-2007 AT&T Knowledge Ventures -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 cat 1 "8 Apr 2008" "SunOS 5.11" "User Commands" +.TH CAT 1 "Apr 8, 2008" .SH NAME cat \- concatenate and display files .SH SYNOPSIS @@ -72,45 +72,37 @@ copies from standard input starting at the current location. The following options are supported by \fB/usr/bin/cat\fR: .sp .ne 2 -.mk .na \fB\fB-b\fR\fR .ad .RS 6n -.rt Number the lines, as \fB-n\fR, but omit the line numbers from blank lines. .RE .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 6n -.rt Precede each line output with its line number. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 6n -.rt \fBcat\fR is silent about non-existent files. .RE .sp .ne 2 -.mk .na \fB\fB-u\fR\fR .ad .RS 6n -.rt The output is not buffered. .sp Buffered output is the default. @@ -118,12 +110,10 @@ Buffered output is the default. .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 6n -.rt Non-printing characters, with the exception of tabs, NEWLINEs and form feeds, are printed visibly. ASCII control characters (octal \fB000\fR \(mi \fB037\fR) are printed as \fB^\fR\fIn,\fR where \fIn\fR is the corresponding ASCII @@ -138,23 +128,19 @@ the ASCII character specified by the low-order seven bits. When used with the \fB-v\fR option, the following options can be used: .sp .ne 2 -.mk .na \fB\fB-e\fR\fR .ad .RS 6n -.rt A \fB$\fR character is printed at the end of each line, prior to the NEWLINE. .RE .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad .RS 6n -.rt Tabs are printed as \fB^I\fRs and form feeds to be printed as \fB^L\fRs. .RE @@ -168,90 +154,74 @@ specified. \fBksh93\fR \fBcat\fR supports the following options: .sp .ne 2 -.mk .na \fB\fB-b\fR \fB--number-nonblank\fR\fR .ad .RS 25n -.rt Number lines as with \fB-n\fR but omit line numbers from blank lines. .RE .sp .ne 2 -.mk .na \fB\fB-d\fR \fB--dos-input\fR\fR .ad .RS 25n -.rt Open input files in text mode. Removes RETURNs in front of NEWLINEs on some systems. .RE .sp .ne 2 -.mk .na \fB\fB-e\fR\fR .ad .RS 25n -.rt Equivalent to \fB-vE\fR. .RE .sp .ne 2 -.mk .na \fB\fB-n\fR \fB--number\fR\fR .ad .RS 25n -.rt Insert a line number at the beginning of each line. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 25n -.rt Equivalent to \fB-S\fR for \fBatt universe\fR and \fB-B\fR otherwise. .RE .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad .RS 25n -.rt Equivalent to \fB-vT\fR. .RE .sp .ne 2 -.mk .na \fB\fB-u\fR \fB--unbuffer\fR\fR .ad .RS 25n -.rt Do not delay the output by buffering. .RE .sp .ne 2 -.mk .na \fB\fB-v\fR \fB--show-nonprinting\fR\fR .ad .RS 25n -.rt Cause non-printing characters (with the exception of TABs, NEWLINEs, and form feeds) to be output as printable character sequences. \fBASCII\fR control characters are printed as \fB^n\fR, where \fIn\fR is the corresponding @@ -264,68 +234,56 @@ treated as printable characters. .sp .ne 2 -.mk .na \fB\fB-A\fR \fB--show-all\fR\fR .ad .RS 25n -.rt Equivalent to \fB-vET\fR. .RE .sp .ne 2 -.mk .na \fB\fB-B\fR \fB--squeeze-blank\fR\fR .ad .RS 25n -.rt Replace multiple adjacent NEWLINE characters with one NEWLINE. .RE .sp .ne 2 -.mk .na \fB\fB-D\fR \fB--dos-output\fR\fR .ad .RS 25n -.rt Open output files in text mode. Insert RETURNs in front of NEWLINEs on some systems. .RE .sp .ne 2 -.mk .na \fB\fB-E\fR \fB--show-ends\fR\fR .ad .RS 25n -.rt Insert a \fB$\fR before each NEWLINE. .RE .sp .ne 2 -.mk .na \fB\fB-S\fR \fB--silent\fR\fR .ad .RS 25n -.rt \fBcat\fR is silent about non-existent files. .RE .sp .ne 2 -.mk .na \fB\fB-T\fR \fB--show-blank\fR\fR .ad .RS 25n -.rt Copies TABs as \fB^I\fR and form feeds as \fB^L\fR. .RE @@ -335,12 +293,10 @@ Copies TABs as \fB^I\fR and form feeds as \fB^L\fR. The following operand is supported: .sp .ne 2 -.mk .na \fB\fIfile\fR\fR .ad .RS 8n -.rt A path name of an input file. If no \fIfile\fR is specified, the standard input is used. If \fIfile\fR is \fB\|\(mi\|\fR, \fBcat\fR reads from the standard input at that point in the sequence. \fBcat\fR does not close and reopen @@ -448,23 +404,19 @@ that affect the execution of \fBcat\fR: \fBLANG\fR, \fBLC_ALL\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt All input files were output successfully. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -477,17 +429,16 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityCommitted +Interface Stability Committed _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .SS "\fBksh93\fR" @@ -495,13 +446,12 @@ StandardSee \fBstandards\fR(5). .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilitySee below. +Interface Stability See below. .TE .sp diff --git a/usr/src/man/man1/cd.1 b/usr/src/man/man1/cd.1 index 59236a8de6..08f46a9c87 100644 --- a/usr/src/man/man1/cd.1 +++ b/usr/src/man/man1/cd.1 @@ -3,14 +3,14 @@ .\" Copyright (c) 2008, Sun Microsystems, Inc. All Rights Reserved .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved .\" Portions Copyright (c) 1982-2007 AT&T Knowledge Ventures -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 cd 1 "8 Apr 2008" "SunOS 5.11" "User Commands" +.TH CD 1 "Apr 8, 2008" .SH NAME cd, chdir, pushd, popd, dirs \- change working directory .SH SYNOPSIS @@ -124,23 +124,19 @@ by that value. exchange the top two elements. .sp .ne 2 -.mk .na \fB\fB+\fR\fIn\fR\fR .ad .RS 7n -.rt Rotate the \fIn\fR'th entry to the top of the stack and \fBcd\fR to it. .RE .sp .ne 2 -.mk .na \fB\fIdir\fR\fR .ad .RS 7n -.rt Push the current working directory onto the stack and change to \fIdir\fR. .RE @@ -150,12 +146,10 @@ Push the current working directory onto the stack and change to \fIdir\fR. elements of the directory stack are numbered from 0 starting at the top. .sp .ne 2 -.mk .na \fB\fB+\fR\fIn\fR\fR .ad .RS 6n -.rt Discard the \fIn\fR'th entry in the stack. .RE @@ -187,24 +181,20 @@ pathname formed by the concatenation of the value of PWD, a slash character, and arg. .sp .ne 2 -.mk .na \fB\fB-L\fR\fR .ad .RS 6n -.rt Handles the operation dot-dot (\fB\&..\fR) logically. Symbolic link components are \fBnot\fR resolved before dot-dot components are processed. .RE .sp .ne 2 -.mk .na \fB\fB-P\fR\fR .ad .RS 6n -.rt Handles the operand dot-dot physically. Symbolic link components \fBare\fR resolved before dot-dot components are processed. .RE @@ -231,12 +221,10 @@ the Korn shell. (See \fBpwd\fR(1), \fBsh\fR(1), and \fBchdir\fR(2)). The following operands are supported: .sp .ne 2 -.mk .na \fB\fIdirectory\fR\fR .ad .RS 13n -.rt An absolute or relative pathname of the directory that becomes the new working directory. The interpretation of a relative pathname by \fBcd\fR depends on the \fBCDPATH\fR environment variable. @@ -261,12 +249,10 @@ that affect the execution of \fBcd\fR: \fBLANG\fR, \fBLC_ALL\fR, \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and \fBNLSPATH\fR. .sp .ne 2 -.mk .na \fB\fBCDPATH\fR\fR .ad .RS 10n -.rt A colon-separated list of pathnames that refer to directories. If the \fIdirectory\fR operand does not begin with a slash \fB(\fR \fB/\fR \fB)\fR character, and the first component is not dot or dot-dot, \fBcd\fR searches for @@ -279,35 +265,29 @@ an empty string. .sp .ne 2 -.mk .na \fB\fBHOME\fR\fR .ad .RS 10n -.rt The name of the home directory, used when no \fIdirectory\fR operand is specified. .RE .sp .ne 2 -.mk .na \fB\fBOLDPWD\fR\fR .ad .RS 10n -.rt A pathname of the previous working directory, used by \fBcd-\fR. .RE .sp .ne 2 -.mk .na \fB\fBPWD\fR\fR .ad .RS 10n -.rt A pathname of the current working directory, set by \fBcd\fR after it has changed to that directory. .RE @@ -318,23 +298,19 @@ changed to that directory. The following exit values are returned by \fBcd\fR: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt The directory was successfully changed. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -347,15 +323,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .SS "ksh93" @@ -363,13 +338,12 @@ StandardSee \fBstandards\fR(5). .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityUncommitted +Interface Stability Uncommitted .TE .SH SEE ALSO diff --git a/usr/src/man/man1/cdrw.1 b/usr/src/man/man1/cdrw.1 index b6767938b5..74d5b531c0 100644 --- a/usr/src/man/man1/cdrw.1 +++ b/usr/src/man/man1/cdrw.1 @@ -1,9 +1,9 @@ '\" te -.\" Copyright (c) 2008, Sun Microsystems, Inc. All rights reserved. +.\" Copyright (c) 2008, 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 cdrw 1 "10 Jul 2008" "SunOS 5.11" "User Commands" +.TH CDRW 1 "Jul 10, 2008" .SH NAME cdrw \- CD read and write .SH SYNOPSIS @@ -14,7 +14,7 @@ cdrw \- CD read and write .LP .nf -\fBcdrw\fR \fB-a\fR [\fB-vSCO\fR] [\fB-d\fR \fIdevice\fR] [\fB-p\fR \fIspeed\fR] [\fB-T\fR \fIaudio-type\fR] \fIaudio-file1\fR +\fBcdrw\fR \fB-a\fR [\fB-vSCO\fR] [\fB-d\fR \fIdevice\fR] [\fB-p\fR \fIspeed\fR] [\fB-T\fR \fIaudio-type\fR] \fIaudio-file1\fR [\fIaudio-file2\fR]... .fi @@ -25,7 +25,7 @@ cdrw \- CD read and write .LP .nf -\fBcdrw\fR \fB-c\fR [\fB-vSC\fR] [\fB-d\fR \fIdevice\fR] [\fB-p\fR \fIspeed\fR] [\fB-m\fR \fItmp-dir\fR] +\fBcdrw\fR \fB-c\fR [\fB-vSC\fR] [\fB-d\fR \fIdevice\fR] [\fB-p\fR \fIspeed\fR] [\fB-m\fR \fItmp-dir\fR] [\fB-s\fR \fIsrc-device\fR] .fi @@ -107,46 +107,38 @@ can be specified with this option. All of the audio files should be in a supported audio format. Currently approved formats are: .sp .ne 2 -.mk .na \fBsun\fR .ad .RS 7n -.rt Sun .au files with data in Red Book CDDA form .RE .sp .ne 2 -.mk .na \fBwav\fR .ad .RS 7n -.rt RIFF (.wav) files with data in Red Book CDDA form .RE .sp .ne 2 -.mk .na \fBcda\fR .ad .RS 7n -.rt \&.cda files having raw CD audio data (that is, 16 bit PCM stereo at 44.1 KHz sample rate in little-endian byte order) .RE .sp .ne 2 -.mk .na \fBaur\fR .ad .RS 7n -.rt \&.aur files having raw CD data in big-endian byte order .RE @@ -184,34 +176,28 @@ 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: .sp .ne 2 -.mk .na \fB\fBsession\fR\fR .ad .RS 11n -.rt Erases the last session. .RE .sp .ne 2 -.mk .na \fB\fBfast\fR\fR .ad .RS 11n -.rt Minimally erases the media. .RE .sp .ne 2 -.mk .na \fB\fBall\fR\fR .ad .RS 11n -.rt Erases the entire media. .RE @@ -256,12 +242,10 @@ information. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 6n -.rt Creates an audio disk. At least one \fIaudio-file\fR name must be specified. A CD can not have more than 99 audio tracks, so no more than 99 audio files can be specified. @@ -269,12 +253,10 @@ be specified. .sp .ne 2 -.mk .na \fB\fB-b\fR\fR .ad .RS 6n -.rt Blanks CD-RW or DVD-RW media. The type of erasing must be specified by the \fBall\fR, \fBfast\fR, or \fBsession\fR argument. DVD+RW media does not support blanking, but can be rewritten without the need for blanking. @@ -282,12 +264,10 @@ blanking, but can be rewritten without the need for blanking. .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad .RS 6n -.rt Copies a CD. If no other argument is specified, the default CD writing device is assumed to be the source device as well. In this case, the copy operation reads the source media into a temporary directory and prompts you to place a @@ -296,12 +276,10 @@ blank media into the drive for the copy operation to proceed. .sp .ne 2 -.mk .na \fB\fB-C\fR\fR .ad .RS 6n -.rt This option is obsolete. .sp This option used to cause\fBcdrw\fR to query the drive to determine media @@ -310,34 +288,28 @@ capacity. This is now the default behavior. .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad .RS 6n -.rt Specifies the CD or DVD writing device. .RE .sp .ne 2 -.mk .na \fB\fB-h\fR\fR .ad .RS 6n -.rt Help. Prints usage message. .RE .sp .ne 2 -.mk .na \fB\fB-i\fR\fR .ad .RS 6n -.rt Specifies the image file for creating data CDs or DVDs. The file size should be less than what can be written on the media. Also, consider having the file locally available instead of having the file on an NFS-mounted file system. The @@ -347,23 +319,19 @@ interruptions. .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 6n -.rt Lists all the CD or DVD writers available on the system. .RE .sp .ne 2 -.mk .na \fB\fB-L\fR\fR .ad .RS 6n -.rt Closes the disk. If the media was left in an open state after the last write operation, it is closed to prevent any further writing. This operation can only be done on re-writable CD-RW media. @@ -371,12 +339,10 @@ be done on re-writable CD-RW media. .sp .ne 2 -.mk .na \fB\fB-m\fR\fR .ad .RS 6n -.rt Uses an alternate temporary directory instead of the default temporary directory for storing track data while copying a CD or DVD. An alternate temporary directory might be required because the amount of data on a CD can be @@ -387,12 +353,10 @@ not have that much space available. .sp .ne 2 -.mk .na \fB\fB-M\fR\fR .ad .RS 6n -.rt Reports media status. \fBcdrw\fR reports if the media is blank or not, its table of contents, the last session's start address, and the next writable address if the disk is open. DVD+RW does not support erasing and always has @@ -401,24 +365,20 @@ some content on the media. .sp .ne 2 -.mk .na \fB\fB-O\fR\fR .ad .RS 6n -.rt Keeps the disk open. \fBcdrw\fR closes the session, but it keeps the disk open so that another session can be added later on to create a multisession disk. .RE .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 6n -.rt Sets the CD writing speed. For example, \fB-p\fR \fB4\fR sets the speed to 4X. If this option is not specified, \fBcdrw\fR uses the default speed of the CD writer. If this option is specified, \fBcdrw\fR tries to set the drive write @@ -428,23 +388,19 @@ by the drive. .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 6n -.rt Specifies the source device for copying a CD or DVD. .RE .sp .ne 2 -.mk .na \fB\fB-S\fR\fR .ad .RS 6n -.rt Simulation mode. In this mode, \fBcdrw\fR operates with the drive laser turned off, so nothing is written to the media. Use this option to verify if the system can provide data at a rate good enough for CD writing. @@ -456,12 +412,10 @@ others do not support simulation mode (\fB-S\fR). .sp .ne 2 -.mk .na \fB\fB-T\fR\fR .ad .RS 6n -.rt Audio format to use for extracting audio files or for reading audio files for audio CD creation. The \fIaudio-type\fR can be \fBsun\fR, \fBwav\fR, \fBcda\fR, or \fBaur\fR. @@ -469,23 +423,19 @@ or \fBaur\fR. .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 6n -.rt Verbose mode. .RE .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad .RS 6n -.rt Extracts audio data from an audio track. .RE diff --git a/usr/src/man/man1/checknr.1 b/usr/src/man/man1/checknr.1 index 561415c1f8..63c192c256 100644 --- a/usr/src/man/man1/checknr.1 +++ b/usr/src/man/man1/checknr.1 @@ -3,13 +3,13 @@ .\" 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 checknr 1 "14 Sep 1992" "SunOS 5.11" "User Commands" +.TH CHECKNR 1 "Sep 14, 1992" .SH NAME checknr \- check nroff and troff input files; report possible errors .SH SYNOPSIS .LP .nf -\fBchecknr\fR [\fB-fs\fR] [\fB-a\fR . \fIx1\fR . \fIy1\fR . \fIx2\fR . \fIy2\fR ... .\fIxn\fR .\fIyn\fR] +\fBchecknr\fR [\fB-fs\fR] [\fB-a\fR . \fIx1\fR . \fIy1\fR . \fIx2\fR . \fIy2\fR ... .\fIxn\fR .\fIyn\fR] [\fB-c\fR . \fIx1\fR . \fIx2\fR . \fIx3\fR ... .\fIxn\fR] [\fIfilename\fR]... .fi @@ -37,7 +37,6 @@ Size changes using \fB\es\fR\fIx \fR.\|.\|. \fB\es0\fR\&. .ie t \(bu .el o Macros that come in open .\|.\|. close forms, for example, the \fB\&.TS\fR and -\fB\&.TE\fR macros which must always come in pairs. .RE .sp .LP @@ -56,34 +55,28 @@ you should think of this as a contribution to your document preparation style. .SH OPTIONS .sp .ne 2 -.mk .na \fB\fB-f\fR \fR .ad .RS 24n -.rt Ignore \fB\ef\fR font changes. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR \fR .ad .RS 24n -.rt Ignore \fB\es\fR size changes. .RE .sp .ne 2 -.mk .na \fB\fB\fR\fB-a\fR\fB .\fR\fIx1 \fR\fB\&.\fR\fIy1.\|.\|.\fR \fR .ad .RS 24n -.rt Add pairs of macros to the list. The pairs of macros are assumed to be those (such as \fB\&.DS\fR and \fB\&.DE\fR) that should be checked for balance. The \fB-a\fR option must be followed by groups of six characters, each group @@ -94,12 +87,10 @@ name, another period, and the second macro name. For example, to define a pair .sp .ne 2 -.mk .na \fB\fB\fR\fB-c\fR\fB .\fR\fIx1\|.\|.\|.\fR \fR .ad .RS 24n -.rt Define commands which \fBchecknr\fR would otherwise complain about as undefined. .RE diff --git a/usr/src/man/man1/chgrp.1 b/usr/src/man/man1/chgrp.1 index 3d2ead95f5..bb9d62a8e3 100644 --- a/usr/src/man/man1/chgrp.1 +++ b/usr/src/man/man1/chgrp.1 @@ -2,14 +2,14 @@ .\" Copyright 1989 AT&T 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) 2003, Sun Microsystems, Inc. All Rights Reserved .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 chgrp 1 "11 Jul 2008" "SunOS 5.11" "User Commands" +.TH CHGRP 1 "Jul 11, 2008" .SH NAME chgrp \- change file group ownership .SH SYNOPSIS @@ -102,23 +102,19 @@ The following options are supported. .SS "/usr/bin/chgrp and /usr/xpg4/bin/chgrp" .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 6n -.rt Force. Does not report errors. .RE .sp .ne 2 -.mk .na \fB\fB-h\fR\fR .ad .RS 6n -.rt If the file is a symbolic link, this option changes the group of the symbolic link. Without this option, the group of the file referenced by the symbolic link is changed. @@ -126,12 +122,10 @@ link is changed. .sp .ne 2 -.mk .na \fB\fB-H\fR\fR .ad .RS 6n -.rt If the file specified on the command line is a symbolic link referencing a file of type directory, this option changes the group of the directory referenced by the symbolic link and all the files in the file hierarchy below it. If a @@ -141,12 +135,10 @@ target file is changed, but no recursion takes place. .sp .ne 2 -.mk .na \fB\fB-L\fR\fR .ad .RS 6n -.rt If the file is a symbolic link, this option changes the group of the file referenced by the symbolic link. If the file specified on the command line, or encountered during the traversal of the file hierarchy, is a symbolic link @@ -157,12 +149,10 @@ below it. .sp .ne 2 -.mk .na \fB\fB-P\fR\fR .ad .RS 6n -.rt If the file specified on the command line or encountered during the traversal of a file hierarchy is a symbolic link, this option changes the group of the symbolic link. This option does not follow the symbolic link to any other part @@ -171,12 +161,10 @@ of the file hierarchy. .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 6n -.rt The specified group is Windows SID. This option requires a file system that supports storing SIDs, such as ZFS. .RE @@ -189,12 +177,10 @@ the behavior of \fBchgrp\fR. .SS "/usr/bin/chgrp" .sp .ne 2 -.mk .na \fB\fB-R\fR\fR .ad .RS 6n -.rt Recursive. \fBchgrp\fR descends through the directory, and any subdirectories, setting the specified group \fBID\fR as it proceeds. When a symbolic link is encountered, the group of the target file is changed, unless the \fB-h\fR or @@ -205,12 +191,10 @@ encountered, the group of the target file is changed, unless the \fB-h\fR or .SS "/usr/xpg4/bin/chgrp" .sp .ne 2 -.mk .na \fB\fB-R\fR\fR .ad .RS 6n -.rt Recursive. \fBchgrp\fR descends through the directory, and any subdirectories, setting the specified group \fBID\fR as it proceeds. When a symbolic link is encountered, the group of the target file is changed, unless the \fB-h\fR or @@ -224,12 +208,10 @@ is specified, the \fB-L\fR option is used as the default mode. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIgroup\fR\fR .ad .RS 9n -.rt A group name from the group database or a numeric group ID. Either specifies a group ID to be given to each file named by one of the \fIfile\fR operands. If a numeric \fIgroup\fR operand exists in the group database as a group name, the @@ -238,12 +220,10 @@ group ID number associated with that group name is used as the group ID. .sp .ne 2 -.mk .na \fB\fIfile\fR\fR .ad .RS 9n -.rt A path name of a file whose group ID is to be modified. .RE @@ -264,35 +244,29 @@ that affect the execution of \fBchgrp\fR: \fBLANG\fR, \fBLC_ALL\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt The utility 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. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB/etc/group\fR\fR .ad .RS 14n -.rt group file .RE @@ -305,17 +279,16 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled. See NOTES. +CSI Enabled. See NOTES. _ -Interface StabilityCommitted +Interface Stability Committed _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .SS "/usr/xpg4/bin/chgrp" @@ -323,17 +296,16 @@ StandardSee \fBstandards\fR(5). .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled. See NOTES. +CSI Enabled. See NOTES. _ -Interface StabilityCommitted +Interface Stability Committed _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .SH SEE ALSO diff --git a/usr/src/man/man1/chkey.1 b/usr/src/man/man1/chkey.1 index 96bd92b118..fe88f28bee 100644 --- a/usr/src/man/man1/chkey.1 +++ b/usr/src/man/man1/chkey.1 @@ -4,13 +4,13 @@ .\" 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 chkey 1 "29 Nov 2005" "SunOS 5.11" "User Commands" +.TH CHKEY 1 "Nov 29, 2005" .SH NAME chkey \- change user's secure RPC key pair .SH SYNOPSIS .LP .nf -\fBchkey\fR [\fB-p\fR] [\fB-s\fR nisplus | nis | files | ldap] +\fBchkey\fR [\fB-p\fR] [\fB-s\fR nisplus | nis | files | ldap] [\fB-m\fR \fI<mechanism>\fR] .fi @@ -64,90 +64,74 @@ database. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 18n -.rt Re-encrypt the existing secret key with the user's login password. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR \fBnisplus\fR\fR .ad .RS 18n -.rt Update the \fBNIS+\fR database. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR \fBnis\fR\fR .ad .RS 18n -.rt Update the \fBNIS\fR database. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR \fBfiles\fR\fR .ad .RS 18n -.rt Update the \fBfiles\fR database. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR \fBldap\fR\fR .ad .RS 18n -.rt Update the LDAP database. .RE .sp .ne 2 -.mk .na \fB\fB-m\fR\fI <mechanism>\fR\fR .ad .RS 18n -.rt Changes or re-encrypt the secret key for the specified mechanism. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB/etc/nsswitch.conf\fR\fR .ad .RS 22n -.rt .RE .sp .ne 2 -.mk .na \fB\fB/etc/publickey\fR\fR .ad .RS 22n -.rt .RE diff --git a/usr/src/man/man1/chmod.1 b/usr/src/man/man1/chmod.1 index eee0b053c7..b5c0ca924d 100644 --- a/usr/src/man/man1/chmod.1 +++ b/usr/src/man/man1/chmod.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 chmod 1 "11 Dec 2008" "SunOS 5.11" "User Commands" +.TH CHMOD 1 "Dec 11, 2008" .SH NAME chmod \- change the permissions mode of a file .SH SYNOPSIS @@ -56,33 +56,27 @@ where \fIabsolute-mode\fR is specified using octal numbers \fInnnn\fR defined as follows: .sp .ne 2 -.mk .na \fB\fIn\fR\fR .ad .RS 5n -.rt a number from \fB0\fR to \fB7\fR. An absolute mode is constructed from the OR of any of the following modes: .sp .ne 2 -.mk .na \fB\fB4000\fR\fR .ad .RS 12n -.rt Set user \fBID\fR on execution. .RE .sp .ne 2 -.mk .na \fB\fB20\fR\fI\|#\|\fR\fB0\fR\fR .ad .RS 12n -.rt Set group \fBID\fR on execution if \fI#\fR is \fB7\fR, \fB5\fR, \fB3\fR, or \fB1\fR. .sp @@ -96,144 +90,118 @@ directories, the set-gid bit can only be set or cleared by using symbolic mode. .sp .ne 2 -.mk .na \fB\fB1000\fR\fR .ad .RS 12n -.rt Turn on sticky bit. See \fBchmod\fR(2). .RE .sp .ne 2 -.mk .na \fB\fB0400\fR\fR .ad .RS 12n -.rt Allow read by owner. .RE .sp .ne 2 -.mk .na \fB\fB0200\fR\fR .ad .RS 12n -.rt Allow write by owner. .RE .sp .ne 2 -.mk .na \fB\fB0100\fR\fR .ad .RS 12n -.rt Allow execute (search in directory) by owner. .RE .sp .ne 2 -.mk .na \fB\fB0700\fR\fR .ad .RS 12n -.rt Allow read, write, and execute (search) by owner. .RE .sp .ne 2 -.mk .na \fB\fB0040\fR\fR .ad .RS 12n -.rt Allow read by group. .RE .sp .ne 2 -.mk .na \fB\fB0020\fR\fR .ad .RS 12n -.rt Allow write by group. .RE .sp .ne 2 -.mk .na \fB\fB0010\fR\fR .ad .RS 12n -.rt Allow execute (search in directory) by group. .RE .sp .ne 2 -.mk .na \fB\fB0070\fR\fR .ad .RS 12n -.rt Allow read, write, and execute (search) by group. .RE .sp .ne 2 -.mk .na \fB\fB0004\fR\fR .ad .RS 12n -.rt Allow read by others. .RE .sp .ne 2 -.mk .na \fB\fB0002\fR\fR .ad .RS 12n -.rt Allow write by others. .RE .sp .ne 2 -.mk .na \fB\fB0001\fR\fR .ad .RS 12n -.rt Allow execute (search in directory) by others. .RE .sp .ne 2 -.mk .na \fB\fB0007\fR\fR .ad .RS 12n -.rt Allow read, write, and execute (search) by others. .RE @@ -265,55 +233,45 @@ following a single operator cause the corresponding operations to be performed simultaneously. .sp .ne 2 -.mk .na \fB\fBwho\fR\fR .ad .RS 14n -.rt zero or more of the characters \fBu\fR, \fBg\fR, \fBo\fR, and \fBa\fR specifying whose permissions are to be changed or assigned: .sp .ne 2 -.mk .na \fB\fBu\fR\fR .ad .RS 5n -.rt user's permissions .RE .sp .ne 2 -.mk .na \fB\fBg\fR\fR .ad .RS 5n -.rt group's permissions .RE .sp .ne 2 -.mk .na \fB\fBo\fR\fR .ad .RS 5n -.rt others' permissions .RE .sp .ne 2 -.mk .na \fB\fBa\fR\fR .ad .RS 5n -.rt all permissions (user, group, and other) .RE @@ -325,22 +283,18 @@ not override the restrictions of your user mask. .sp .ne 2 -.mk .na \fB\fIoperator\fR\fR .ad .RS 14n -.rt either \fB+\fR, \fB\(mi\fR, or \fB=\fR, signifying how permissions are to be changed: .sp .ne 2 -.mk .na \fB\fB+\fR\fR .ad .RS 8n -.rt Add permissions. .sp If \fIpermissions\fR are omitted, nothing is added. @@ -355,12 +309,10 @@ If \fBwho\fR is present, add the file mode bits represented by the .sp .ne 2 -.mk .na \fB\fB\(mi\fR\fR .ad .RS 8n -.rt Take away permissions. .sp If \fIpermissions\fR are omitted, do nothing. @@ -375,12 +327,10 @@ If \fBwho\fR is present, clear the file mode bits represented by .sp .ne 2 -.mk .na \fB\fB=\fR\fR .ad .RS 8n -.rt Assign permissions absolutely. .sp If \fBwho\fR is omitted, clear all file mode bits; if \fBwho\fR is present, @@ -403,99 +353,81 @@ useful only with \fB=\fR to take away all permissions. .sp .ne 2 -.mk .na \fB\fIpermission\fR\fR .ad .RS 14n -.rt any compatible combination of the following letters: .sp .ne 2 -.mk .na \fB\fBl\fR\fR .ad .RS 9n -.rt mandatory locking .RE .sp .ne 2 -.mk .na \fB\fBr\fR\fR .ad .RS 9n -.rt read permission .RE .sp .ne 2 -.mk .na \fB\fBs\fR\fR .ad .RS 9n -.rt user or group set-ID .RE .sp .ne 2 -.mk .na \fB\fBt\fR\fR .ad .RS 9n -.rt sticky bit .RE .sp .ne 2 -.mk .na \fB\fBw\fR\fR .ad .RS 9n -.rt write permission .RE .sp .ne 2 -.mk .na \fB\fBx\fR\fR .ad .RS 9n -.rt execute permission .RE .sp .ne 2 -.mk .na \fB\fBX\fR\fR .ad .RS 9n -.rt execute permission if the file is a directory or if there is execute permission for one of the other user classes .RE .sp .ne 2 -.mk .na \fB\fBu\fR,\fBg\fR,\fBo\fR\fR .ad .RS 9n -.rt indicate that \fIpermission\fR is to be taken from the current user, group or other mode respectively. .RE @@ -507,12 +439,10 @@ sequences each having three characters: .sp .TS -tab(); -lw(1.83i) lw(1.83i) lw(1.83i) -lw(1.83i) lw(1.83i) lw(1.83i) -. -UserGroupOther -rwxrwxrwx +l l l +l l l . +User Group Other +rwx rwx rwx .TE This example (user, group, and others all have permission to read, write, and @@ -572,12 +502,10 @@ Where \fIacl_specification\fR is a comma-separated list (with no intervening white space) of an ACL specification of the form: .sp .ne 2 -.mk .na \fB\fBA[\fIindex\fR]+\fIacl_specification\fR\fR\fR .ad .RS 30n -.rt Prepends the access control entries (ACE) specified in \fIacl_specification\fR to the beginning of the file's ACL. Depending on the file system, the ACL can be reordered when applied to the file. If "optional" number is specified then @@ -586,30 +514,25 @@ new ACEs are inserted before specified number. .sp .ne 2 -.mk .na \fB\fBA-\fR\fR .ad .RS 30n -.rt Removes all ACEs for current ACL on file and replaces current ACL with new ACL that represents only the current mode of the file. .RE .sp .ne 2 -.mk .na \fB\fBA\fIindex\fR\fR-\fR .ad .RS 30n -.rt Removes ACE specified by \fIindex\fR number. .RE .sp .ne 2 -.mk .na \fB\fBA-\fIacl_specification\fR\fR\fR .ad @@ -618,30 +541,25 @@ Removes ACE specified by \fIindex\fR number. \fB\fR .ad .RS 30n -.rt Removes ACEs specified by \fIacl_specification\fR, if they exist in current file's ACL. .RE .sp .ne 2 -.mk .na \fB\fBA=\fIacl_specification\fR\fR\fR .ad .RS 30n -.rt Replaces a files entire ACL with \fIacl_specification\fR. .RE .sp .ne 2 -.mk .na \fB\fBA[\fIindex\fR]=\fIacl_specification\fR\fR\fR .ad .RS 30n -.rt Replaces ACEs starting at a specific index number in the current ACL on the file. If multiple ACEs are specified, then each subsequent ACE in \fIacl_specification\fR replaces the corresponding ACE in the current ACL. @@ -656,7 +574,6 @@ POSIX-draft ACLs (as supported by UFS) are specified as colon (\fB:\fR) separated fields of the following. .sp .ne 2 -.mk .na \fBuser::perms\fR .ad @@ -667,7 +584,6 @@ File owner permissions. .sp .ne 2 -.mk .na \fBuser:\fIusername\fR:perms\fR .ad @@ -678,7 +594,6 @@ Permissions for a specific user. .sp .ne 2 -.mk .na \fBgroup::perms\fR .ad @@ -689,7 +604,6 @@ File group owner permissions. .sp .ne 2 -.mk .na \fBgroup:\fIgroupname:\fRperms\fR .ad @@ -700,7 +614,6 @@ Permissions for a specific group. .sp .ne 2 -.mk .na \fBother::perms\fR .ad @@ -711,7 +624,6 @@ Permissions for user other than the file owner or members of file group owner. .sp .ne 2 -.mk .na \fBmask:perms\fR .ad @@ -723,7 +635,6 @@ The ACL mask. The mask entry specifies the maximum permissions allowed for user .sp .ne 2 -.mk .na \fBdefault:user::perms\fR .ad @@ -734,7 +645,6 @@ Default file owner permissions. .sp .ne 2 -.mk .na \fBdefault:user:\fIusername\fR:perms\fR .ad @@ -745,7 +655,6 @@ Default permissions for a specific user. .sp .ne 2 -.mk .na \fBdefault:group::perms\fR .ad @@ -756,7 +665,6 @@ Default file group owner permissions. .sp .ne 2 -.mk .na \fBdefault:group:\fIgroupname\fR:perms\fR .ad @@ -767,7 +675,6 @@ Default permissions for a specific group. .sp .ne 2 -.mk .na \fBdefault:other:perms\fR .ad @@ -779,7 +686,6 @@ group owner. .sp .ne 2 -.mk .na \fBdefault:mask:perms\fR .ad @@ -811,7 +717,6 @@ entries, finer grained permissions, and enhanced inheritance control. NFSv4 ACLs are specified as colon (\fB:\fR) separated fields of the following. .sp .ne 2 -.mk .na \fBowner@:<perms>[:inheritance flags]:<allow|deny>\fR .ad @@ -822,7 +727,6 @@ Permissions for file owner. .sp .ne 2 -.mk .na \fBgroup@:<perms>[:inheritance flags]:<allow|deny>\fR .ad @@ -833,7 +737,6 @@ Permissions for file group owner. .sp .ne 2 -.mk .na \fBeveryone@:<perms>[:inheritance flags]:<allow|deny>\fR .ad @@ -844,7 +747,6 @@ Permissions for everyone, including file owner and group owner. .sp .ne 2 -.mk .na \fBuser:<username>:<perms>[:inheritance flags]:<allow|deny>\fR .ad @@ -855,7 +757,6 @@ Permissions for a specific user. .sp .ne 2 -.mk .na \fBusersid:<sid string>:<perms>[:inheritance flags]:<allow|deny>\fR .ad @@ -866,7 +767,6 @@ Permissions for a specific user, but user is specified by SID. .sp .ne 2 -.mk .na \fBgroup:<groupname>:<perms>[:inheritance flags]:<allow|deny>\fR .ad @@ -877,7 +777,6 @@ Permissions for a specific group. .sp .ne 2 -.mk .na \fBgroupsid:<sid string>:<perms>[:inheritance flags]:<allow|deny>\fR .ad @@ -888,7 +787,6 @@ Permissions for a specific group, but group is specified by SID. .sp .ne 2 -.mk .na \fBsid:<sid string>:<perms>[:inheritance flags]:<allow|deny>\fR .ad @@ -911,56 +809,46 @@ The permissions for verbose mode and their abbreviated form in parentheses for compact and positional mode are described as follows: .sp .ne 2 -.mk .na \fBread_data (\fBr\fR)\fR .ad .RS 24n -.rt Permission to read the data of a file. .RE .sp .ne 2 -.mk .na \fBlist_directory (\fBr\fR)\fR .ad .RS 24n -.rt Permission to list the contents of a directory. .RE .sp .ne 2 -.mk .na \fBwrite_data (\fBw\fR)\fR .ad .RS 24n -.rt Permission to modify a file's data. anywhere in the file's offset range. .RE .sp .ne 2 -.mk .na \fBadd_file (\fBw\fR)\fR .ad .RS 24n -.rt Permission to add a new file to a directory. .RE .sp .ne 2 -.mk .na \fBappend_data (\fBp\fR)\fR .ad .RS 24n -.rt The ability to modify a file's data, but only starting at EOF. .sp Currently, this permission is not supported. @@ -968,135 +856,111 @@ Currently, this permission is not supported. .sp .ne 2 -.mk .na \fBadd_subdirectory (\fBp\fR)\fR .ad .RS 24n -.rt Permission to create a subdirectory to a directory. .RE .sp .ne 2 -.mk .na \fBread_xattr (\fBR\fR)\fR .ad .RS 24n -.rt Ability to read the extended attributes of a file. .RE .sp .ne 2 -.mk .na \fBwrite_xattr (\fBW\fR)\fR .ad .RS 24n -.rt Ability to create extended attributes or write to the extended attribute directory. .RE .sp .ne 2 -.mk .na \fBexecute (\fBx\fR)\fR .ad .RS 24n -.rt Permission to execute a file. .RE .sp .ne 2 -.mk .na \fBread_attributes (\fBa\fR)\fR .ad .RS 24n -.rt The ability to read basic attributes (non-ACLs) of a file. .RE .sp .ne 2 -.mk .na \fBwrite_attributes (\fBA\fR)\fR .ad .RS 24n -.rt Permission to change the times associated with a file or directory to an arbitrary value. .RE .sp .ne 2 -.mk .na \fBdelete (\fBd\fR)\fR .ad .RS 24n -.rt Permission to delete a file. .RE .sp .ne 2 -.mk .na \fBdelete_child (\fBD\fR)\fR .ad .RS 24n -.rt Permission to delete a file within a directory. .RE .sp .ne 2 -.mk .na \fBread_acl (\fBc\fR)\fR .ad .RS 24n -.rt Permission to read the ACL of a file. .RE .sp .ne 2 -.mk .na \fBwrite_acl (\fBC\fR)\fR .ad .RS 24n -.rt Permission to write the ACL of a file. .RE .sp .ne 2 -.mk .na \fBwrite_owner (\fBo\fR)\fR .ad .RS 24n -.rt Permission to change the owner of a file. .RE .sp .ne 2 -.mk .na \fBsynchronize (\fBs\fR)\fR .ad .RS 24n -.rt Permission to access file locally at server with synchronize reads and writes. .sp Currently, this permission is not supported. @@ -1144,45 +1008,37 @@ Several special permission sets or aliases are also supported. The following permission sets are used the same way that verbose permissions are specified. .sp .ne 2 -.mk .na \fB\fBfull_set\fR\fR .ad .RS 14n -.rt All permissions. .RE .sp .ne 2 -.mk .na \fB\fBmodify_set\fR\fR .ad .RS 14n -.rt All permissions except \fBwrite_acl\fR and \fBwrite_owner\fR. .RE .sp .ne 2 -.mk .na \fB\fBread_set\fR\fR .ad .RS 14n -.rt \fBread_data, read_acl, read_attributes,\fR and \fBread_xattr\fR. .RE .sp .ne 2 -.mk .na \fB\fBwrite_set\fR\fR .ad .RS 14n -.rt \fBwrite_data, append_data, write_attributes\fR, and \fBwrite_xattr\fR .RE @@ -1193,34 +1049,28 @@ format uses words to indicate the various inheritance flags separated with a forward slash (\fB/\fR) character. .sp .ne 2 -.mk .na \fBfile_inherit (\fBf\fR)\fR .ad .RS 20n -.rt Inherit to all newly created files. .RE .sp .ne 2 -.mk .na \fBdir_inherit (\fBd\fR)\fR .ad .RS 20n -.rt Inherit to all newly created directories. .RE .sp .ne 2 -.mk .na \fBinherit_only (\fBi\fR)\fR .ad .RS 20n -.rt When placed on a directory, do not apply to the directory, only to newly created files and directories. This flag requires that either \fBfile_inherit\fR and or \fBdir_inherit\fR is also specified. @@ -1228,12 +1078,10 @@ created files and directories. This flag requires that either .sp .ne 2 -.mk .na \fBno_propagate (\fBn\fR)\fR .ad .RS 20n -.rt Indicates that ACL entries should be inherited to objects in a directory, but inheritance should stop after descending one level. This flag is dependent upon either \fBfile_inherit\fR and or \fBdir_inherit\fR also being specified. @@ -1316,24 +1164,20 @@ comma-separated list of one or more \fIattribute_specifications\fR. Each An \fIoperator\fR is one of the following: .sp .ne 2 -.mk .na \fB\fB+\fR\fR .ad .RS 5n -.rt Each attribute specified by the associated \fIattribute_specifier\fR is adjusted to match the value specified by the \fIattribute_specifier\fR. .RE .sp .ne 2 -.mk .na \fB\fB-\fR\fR .ad .RS 5n -.rt Each attribute specified by the associated \fIattribute_specifier\fR is adjusted to match the inverse of the value specified by the \fIattribute_specifier\fR. @@ -1341,12 +1185,10 @@ adjusted to match the inverse of the value specified by the .sp .ne 2 -.mk .na \fB\fB=\fR\fR .ad .RS 5n -.rt Each attribute specified by the associated \fIattribute_specifier\fR is adjusted to match the value specified by the \fIattribute_specifier\fR. Any boolean read-write extended system attributes associated with the current file @@ -1362,7 +1204,6 @@ If an \fIoperator\fR is not specified in an \fIattribute_specification\fR, An \fIattribute_specifier\fR takes one of the following forms: .sp .ne 2 -.mk .na \fB\fBa\fR\fR .ad @@ -1374,7 +1215,6 @@ current file. .sp .ne 2 -.mk .na \fB\fBc[\fIcompact_attribute_list\fR]\fR\fR .ad @@ -1390,7 +1230,6 @@ Set each boolean read-write extended system attribute identified by .sp .ne 2 -.mk .na \fB\fBv[\fIverbose_attribute_setting\fR]\fR\fR .ad @@ -1432,122 +1271,100 @@ specified operation is applied. The following is a list of \fBAttribute Names and Abbreviation Characters\fR: .sp .ne 2 -.mk .na \fB\fBAttribute Name\fR\fR .ad .RS 18n -.rt \fBAbbreviation Character\fR .RE .sp .ne 2 -.mk .na \fB\fBhidden\fR\fR .ad .RS 18n -.rt \fBH\fR .RE .sp .ne 2 -.mk .na \fB\fBsystem\fR\fR .ad .RS 18n -.rt \fBS\fR .RE .sp .ne 2 -.mk .na \fB\fBreadonly\fR\fR .ad .RS 18n -.rt \fBR\fR .RE .sp .ne 2 -.mk .na \fB\fBarchive\fR\fR .ad .RS 18n -.rt \fBA\fR .RE .sp .ne 2 -.mk .na \fB\fBnounlink\fR\fR .ad .RS 18n -.rt \fBu\fR .RE .sp .ne 2 -.mk .na \fB\fBimmutable\fR\fR .ad .RS 18n -.rt \fBi\fR .RE .sp .ne 2 -.mk .na \fB\fBappendonly\fR\fR .ad .RS 18n -.rt \fBa\fR .RE .sp .ne 2 -.mk .na \fB\fBnodump\fR\fR .ad .RS 18n -.rt \fBd\fR .RE .sp .ne 2 -.mk .na \fB\fBav_quarantined\fR\fR .ad .RS 18n -.rt \fBq\fR .RE .sp .ne 2 -.mk .na \fB\fBav_modified\fR\fR .ad .RS 18n -.rt \fBm\fR .RE @@ -1557,23 +1374,19 @@ The following is a list of \fBAttribute Names and Abbreviation Characters\fR: The following options are supported: .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 22n -.rt Force. \fBchmod\fR does not complain if it fails to change the mode of a file. .RE .sp .ne 2 -.mk .na \fB\fB-R\fR\fR .ad .RS 22n -.rt Recursively descend through directory arguments, setting the mode for each file. When symbolic links are encountered, the mode of the target file is changed, but no recursion takes place. @@ -1581,12 +1394,10 @@ changed, but no recursion takes place. .sp .ne 2 -.mk .na \fB\fB-@\fR \fInamed_attribute\fR\fR .ad .RS 22n -.rt Perform the attribute operation on the named extended attribute file of each file operand instead of the file operand itself. If multiple \fB-@\fR operations are supplied, the attribute specification mode is applied to each of @@ -1608,7 +1419,6 @@ attribute file of the file operand and the file operand itself. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIabsolute-mode\fR\fR .ad @@ -1625,7 +1435,6 @@ in the \fBDESCRIPTION\fR section of this manual page for more information. .sp .ne 2 -.mk .na \fB\fIacl_operation\fR\fR .ad @@ -1640,7 +1449,7 @@ Operation\fR in the \fBDESCRIPTION\fR section for more information. .nf \fBA[\fR\fInumber\fR\fB] -\fR \fBA-\fR\fIacl_specification\fR -\fBA[\fR\fIindex\fR\fB]{+|=}\fR\fBacl_specification\fR +\fBA[\fR\fIindex\fR\fB]{+|=}\fR\fBacl_specification\fR .fi .in -2 .sp @@ -1649,7 +1458,6 @@ Operation\fR in the \fBDESCRIPTION\fR section for more information. .sp .ne 2 -.mk .na \fB\fIattribute_specification_list\fR\fR .ad @@ -1662,7 +1470,6 @@ more information. .sp .ne 2 -.mk .na \fB\fIfile\fR\fR .ad @@ -1716,7 +1523,7 @@ others: .in +2 .nf % chmod go+rw \fIfile\fR -% chmod 066 \fIfile\fR +% chmod 066 \fIfile\fR .fi .in -2 .sp @@ -2272,7 +2079,7 @@ Now, change the allow access to a deny for user marks: $ chmod A0=user:marks:read_data:deny file.5 $ ls -v file.5 -rw-r--r--+ 1 marks staff 0 Aug 23 09:11 file.5 -0:user:marks:read_data:deny +0:user:marks:read_data:deny 1:owner@:read_data/write_data/append_data/write_xattr/write_attributes /write_acl/write_owner:allow 2:group@:write_data/append_data/execute:deny @@ -2345,12 +2152,12 @@ $ chmod A+user:lp:read_data:file_inherit:allow test.dir $ ls -dv test.dir drwxr-xr-x+ 2 marks staff 2 Aug 23 09:08 test.dir/ 0:user:lp:read_data:file_inherit:allow -1:owner@::deny +1:owner@::deny 2:owner@:list_directory/read_data/add_file/write_data/add_subdirectory /append_data/write_xattr/execute/write_attributes/write_acl /write_owner:allow 3:group@:add_file/write_data/add_subdirectory/append_data:deny -4:group@:list_directory/read_data/execute:allow +4:group@:list_directory/read_data/execute:allow 5:everyone@:add_file/write_data/add_subdirectory/append_data/write_xattr /write_attributes/write_acl/write_owner:deny 6:everyone@:list_directory/read_data/read_xattr/execute/read_attributes @@ -2754,23 +2561,19 @@ that affect the execution of \fBchmod\fR: \fBLANG\fR, \fBLC_ALL\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -2782,15 +2585,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityCommitted +Interface Stability Committed .TE .SH SEE ALSO diff --git a/usr/src/man/man1/chown.1 b/usr/src/man/man1/chown.1 index 9d8209b132..66a80566ad 100644 --- a/usr/src/man/man1/chown.1 +++ b/usr/src/man/man1/chown.1 @@ -1,16 +1,16 @@ '\" te -.\" Copyright 1989 AT&T -.\" Copyright (c) 2008, Sun Microsystems, Inc. All Rights Reserved +.\" Copyright 1989 AT&T +.\" Copyright (c) 2008, Sun Microsystems, Inc. All Rights Reserved .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved .\" Portions Copyright (c) 1982-2007 AT&T Knowledge Ventures -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 chown 1 "11 Jul 2008" "SunOS 5.11" "User Commands" +.TH CHOWN 1 "Jul 11, 2008" .SH NAME chown \- change file ownership .SH SYNOPSIS @@ -127,23 +127,19 @@ user name. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 6n -.rt Force. Does not report errors. .RE .sp .ne 2 -.mk .na \fB\fB-h\fR\fR .ad .RS 6n -.rt If the file is a symbolic link, this option changes the owner of the symbolic link. Without this option, the owner of the file referenced by the symbolic link is changed. @@ -151,12 +147,10 @@ link is changed. .sp .ne 2 -.mk .na \fB\fB-H\fR\fR .ad .RS 6n -.rt If the file specified on the command line is a symbolic link referencing a file of type directory, this option changes the owner of the directory referenced by the symbolic link and all the files in the file hierarchy below it. If a @@ -166,12 +160,10 @@ target file is changed, but no recursion takes place. .sp .ne 2 -.mk .na \fB\fB-L\fR\fR .ad .RS 6n -.rt If the file is a symbolic link, this option changes the owner of the file referenced by the symbolic link. If the file specified on the command line, or encountered during the traversal of the file hierarchy, is a symbolic link @@ -182,12 +174,10 @@ below it. .sp .ne 2 -.mk .na \fB\fB-P\fR\fR .ad .RS 6n -.rt If the file specified on the command line or encountered during the traversal of a file hierarchy is a symbolic link, this option changes the owner of the symbolic link. This option does not follow the symbolic link to any other part @@ -196,12 +186,10 @@ of the file hierarchy. .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 6n -.rt The owner and/or group arguments are Windows SID strings. This option requires a file system that supports storing SIDs, such as ZFS. .RE @@ -217,12 +205,10 @@ the behavior of \fBchown\fR. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-R\fR\fR .ad .RS 6n -.rt Recursive. \fBchown\fR descends through the directory, and any subdirectories, setting the specified ownership \fBID\fR as it proceeds. When a symbolic link is encountered, the owner of the target file is changed, unless the \fB-h\fR or @@ -236,12 +222,10 @@ is encountered, the owner of the target file is changed, unless the \fB-h\fR or The following options are supported: .sp .ne 2 -.mk .na \fB\fB-R\fR\fR .ad .RS 6n -.rt Recursive. \fBchown\fR descends through the directory, and any subdirectories, setting the specified ownership \fBID\fR as it proceeds. When a symbolic link is encountered, the owner of the target file is changed, unless the \fB-h\fR or @@ -256,7 +240,6 @@ The following options are supported by the \fBksh93\fR built-in \fBchown\fR command: .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad @@ -271,7 +254,6 @@ Describe only files whose ownership actually changes. .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad @@ -286,7 +268,6 @@ Do not report files whose ownership fails to change. .sp .ne 2 -.mk .na \fB\fB-l | h\fR\fR .ad @@ -301,7 +282,6 @@ Change the ownership of the symbolic links on systems that support this option. .sp .ne 2 -.mk .na \fB\fB-m\fR\fR .ad @@ -327,7 +307,6 @@ match for each file. Unmatched files are silently ignored. .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad @@ -342,7 +321,6 @@ Show actions but do not execute. .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad @@ -357,7 +335,6 @@ Omit the explicit ownership operand and use the ownership of the file instead. .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad @@ -372,7 +349,6 @@ Describe the changed permissions of all files. .sp .ne 2 -.mk .na \fB\fB-H\fR\fR .ad @@ -388,7 +364,6 @@ links when traversing directories. .sp .ne 2 -.mk .na \fB\fB-L\fR\fR .ad @@ -403,7 +378,6 @@ Follow symbolic links when traversing directories. .sp .ne 2 -.mk .na \fB\fB-P\fR\fR .ad @@ -418,7 +392,6 @@ Do not follow symbolic links when traversing directories. .sp .ne 2 -.mk .na \fB\fB-R\fR\fR .ad @@ -433,7 +406,6 @@ Recursively change ownership of directories and their contents. .sp .ne 2 -.mk .na \fB\fB-X\fR\fR .ad @@ -452,12 +424,10 @@ Canonicalize output for testing. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIowner\fR[\fB:\fR\fIgroup\fR]\fR .ad .RS 17n -.rt A user \fBID\fR and optional group \fBID\fR to be assigned to \fBfile\fR. The \fIowner\fR portion of this operand must be a user name from the user database or a numeric user \fBID\fR. Either specifies a user \fBID\fR to be given to @@ -473,12 +443,10 @@ the group \fBID\fR number associated with that group name is used as the group .sp .ne 2 -.mk .na \fB\fIfile\fR\fR .ad .RS 17n -.rt A path name of a file whose user \fBID\fR is to be modified. .RE @@ -515,35 +483,29 @@ that affect the execution of \fBchown\fR: \fBLANG\fR, \fBLC_ALL\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt The utility 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. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB/etc/passwd\fR\fR .ad .RS 15n -.rt System password file .RE @@ -556,17 +518,16 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled. See NOTES. +CSI Enabled. See NOTES. _ -Interface StabilityCommitted +Interface Stability Committed _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .SS "/usr/xpg4/bin/chown" @@ -574,17 +535,16 @@ StandardSee \fBstandards\fR(5). .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled. See \fBNOTES\fR. +CSI Enabled. See \fBNOTES\fR. _ -Interface StabilityCommitted +Interface Stability Committed _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .SS "ksh93" @@ -592,13 +552,12 @@ StandardSee \fBstandards\fR(5). .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilitySee below. +Interface Stability See below. .TE .sp diff --git a/usr/src/man/man1/ckdate.1 b/usr/src/man/man1/ckdate.1 index 4c71d21bcd..4425a0b2d8 100644 --- a/usr/src/man/man1/ckdate.1 +++ b/usr/src/man/man1/ckdate.1 @@ -3,13 +3,13 @@ .\" 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 ckdate 1 "14 Sep 1992" "SunOS 5.11" "User Commands" +.TH CKDATE 1 "Sep 14, 1992" .SH NAME ckdate, errdate, helpdate, valdate \- prompts for and validates a date .SH SYNOPSIS .LP .nf -\fBckdate\fR [\fB-Q\fR] [\fB-W\fR \fIwidth\fR] [\fB-f\fR \fIformat\fR] [\fB-d\fR \fIdefault\fR] [\fB-h\fR \fIhelp\fR] +\fBckdate\fR [\fB-Q\fR] [\fB-W\fR \fIwidth\fR] [\fB-f\fR \fIformat\fR] [\fB-d\fR \fIdefault\fR] [\fB-h\fR \fIhelp\fR] [\fB-e\fR \fIerror\fR] [\fB-p\fR \fIprompt\fR] [\fB-k\fR \fIpid\fR [\fB-s\fR \fIsignal\fR]] .fi @@ -63,122 +63,100 @@ expected format. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-d\fR \fIdefault\fR\fR .ad .RS 14n -.rt Defines the default value as \fIdefault\fR. The default does not have to meet the format criteria. .RE .sp .ne 2 -.mk .na \fB\fB-e\fR \fIerror\fR\fR .ad .RS 14n -.rt Defines the error message as \fIerror\fR. .RE .sp .ne 2 -.mk .na \fB\fB-f\fR \fIformat\fR\fR .ad .RS 14n -.rt Specifies the format against which the input will be verified. Possible formats and their definitions are: .sp .ne 2 -.mk .na \fB\fB%b\fR =\fR .ad .RS 9n -.rt abbreviated month name (jan, feb, mar) .RE .sp .ne 2 -.mk .na \fB\fB%B\fR =\fR .ad .RS 9n -.rt full month name \fB%d\fR = day of month (01 - 31) .RE .sp .ne 2 -.mk .na \fB\fB%D\fR =\fR .ad .RS 9n -.rt date as %m/%d/%y (the default format) .RE .sp .ne 2 -.mk .na \fB\fB%e\fR =\fR .ad .RS 9n -.rt day of month (1 - 31; single digits are preceded by a blank) .RE .sp .ne 2 -.mk .na \fB\fB%h\fR =\fR .ad .RS 9n -.rt abbreviated month name, identical to \fB%b%\fR .RE .sp .ne 2 -.mk .na \fB\fB%m\fR =\fR .ad .RS 9n -.rt month number (01 - 12) .RE .sp .ne 2 -.mk .na \fB\fB%y\fR =\fR .ad .RS 9n -.rt year within century (for instance, 89) .RE .sp .ne 2 -.mk .na \fB\fB%Y\fR =\fR .ad .RS 9n -.rt year as \fBCCYY\fR (for instance, 1989) .RE @@ -186,57 +164,47 @@ year as \fBCCYY\fR (for instance, 1989) .sp .ne 2 -.mk .na \fB\fB-h\fR\fI help\fR\fR .ad .RS 14n -.rt Defines the help messages as \fBhelp\fR. .RE .sp .ne 2 -.mk .na \fB\fB-k\fR\fI pid\fR\fR .ad .RS 14n -.rt Specifies that process \fBID\fR \fIpid\fR is to be sent a signal if the user chooses to abort. .RE .sp .ne 2 -.mk .na \fB\fB-p\fR\fI prompt\fR\fR .ad .RS 14n -.rt Defines the prompt message as \fIprompt\fR. .RE .sp .ne 2 -.mk .na \fB\fB-Q\fR\fR .ad .RS 14n -.rt Specifies that quit will not be allowed as a valid response. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fI signal\fR\fR .ad .RS 14n -.rt Specifies that the process \fBID\fR \fIpid\fR defined with the \fB-k\fR option is to be sent signal \fBsignal\fR when quit is chosen. If no signal is specified, \fBSIGTERM\fR is used. @@ -244,12 +212,10 @@ specified, \fBSIGTERM\fR is used. .sp .ne 2 -.mk .na \fB\fB-W\fR\fI width\fR\fR .ad .RS 14n -.rt Specifies that prompt, help and error messages will be formatted to a line length of \fBwidth\fR. .RE @@ -260,12 +226,10 @@ length of \fBwidth\fR. The following operand is supported: .sp .ne 2 -.mk .na \fB\fIinput\fR\fR .ad .RS 9n -.rt Input to be verified against format criteria. .RE @@ -275,45 +239,37 @@ Input to be verified against format criteria. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt Successful execution. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt \fBEOF\fR on input, or negative width on \fB-W\fR option, or usage error. .RE .sp .ne 2 -.mk .na \fB\fB3\fR\fR .ad .RS 5n -.rt User termination (quit). .RE .sp .ne 2 -.mk .na \fB\fB4\fR\fR .ad .RS 5n -.rt Garbled format argument. .RE diff --git a/usr/src/man/man1/ckgid.1 b/usr/src/man/man1/ckgid.1 index 12bf45f6fd..2265acdf21 100644 --- a/usr/src/man/man1/ckgid.1 +++ b/usr/src/man/man1/ckgid.1 @@ -3,13 +3,13 @@ .\" 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 ckgid 1 "14 Sep 1992" "SunOS 5.11" "User Commands" +.TH CKGID 1 "Sep 14, 1992" .SH NAME ckgid, errgid, helpgid, valgid \- prompts for and validates a group id .SH SYNOPSIS .LP .nf -\fBckgid\fR [\fB-Q\fR] [\fB-W\fR \fIwidth\fR] [\fB-m\fR] [\fB-d\fR \fIdefault\fR] [\fB-h\fR \fIhelp\fR] +\fBckgid\fR [\fB-Q\fR] [\fB-W\fR \fIwidth\fR] [\fB-m\fR] [\fB-d\fR \fIdefault\fR] [\fB-h\fR \fIhelp\fR] [\fB-e\fR \fIerror\fR] [\fB-p\fR \fIprompt\fR] [\fB-k\fR \fIpid\fR [\fB-s\fR \fIsignal\fR]] .fi @@ -60,92 +60,76 @@ objects. In this instance, the \fBFML\fR object defines the prompt. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-d\fR\fI default\fR\fR .ad .RS 14n -.rt Defines the default value as \fIdefault\fR. The default is not validated and so does not have to meet any criteria. .RE .sp .ne 2 -.mk .na \fB\fB-e\fR\fI error\fR\fR .ad .RS 14n -.rt Defines the error message as \fI error\fR. .RE .sp .ne 2 -.mk .na \fB\fB-h\fR\fI help\fR\fR .ad .RS 14n -.rt Defines the help messages as \fI help\fR. .RE .sp .ne 2 -.mk .na \fB\fB-k\fR\fI pid\fR\fR .ad .RS 14n -.rt Specifies that process \fBID\fR \fIpid\fR is to be sent a signal if the user chooses to abort. .RE .sp .ne 2 -.mk .na \fB\fB-m\fR\fR .ad .RS 14n -.rt Displays a list of all groups when help is requested or when the user makes an error. .RE .sp .ne 2 -.mk .na \fB\fB-p\fR\fI prompt\fR\fR .ad .RS 14n -.rt Defines the prompt message as \fIprompt\fR. .RE .sp .ne 2 -.mk .na \fB\fB-Q\fR\fR .ad .RS 14n -.rt Specifies that quit will not be allowed as a valid response. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fI signal\fR\fR .ad .RS 14n -.rt Specifies that the process \fBID\fR \fIpid\fR defined with the \fB-k\fR option is to be sent signal \fI signal\fR when quit is chosen. If no signal is specified, \fBSIGTERM\fR is used. @@ -153,12 +137,10 @@ specified, \fBSIGTERM\fR is used. .sp .ne 2 -.mk .na \fB\fB-W\fR\fI width\fR\fR .ad .RS 14n -.rt Specifies that prompt, help and error messages will be formatted to a line length of \fIwidth\fR. .RE @@ -169,12 +151,10 @@ length of \fIwidth\fR. The following operand is supported: .sp .ne 2 -.mk .na \fB\fIinput\fR\fR .ad .RS 9n -.rt Input to be verified against \fB/etc/group\fR. .RE @@ -184,34 +164,28 @@ Input to be verified against \fB/etc/group\fR. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt Successful execution. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt \fBEOF\fR on input, or negative width on \fB-W\fR option, or usage error. .RE .sp .ne 2 -.mk .na \fB\fB3\fR\fR .ad .RS 5n -.rt User termination (quit). .RE diff --git a/usr/src/man/man1/ckint.1 b/usr/src/man/man1/ckint.1 index 2b95b5f551..f7d43e2229 100644 --- a/usr/src/man/man1/ckint.1 +++ b/usr/src/man/man1/ckint.1 @@ -3,14 +3,14 @@ .\" 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 ckint 1 "14 Sep 1992" "SunOS 5.11" "User Commands" +.TH CKINT 1 "Sep 14, 1992" .SH NAME ckint, errint, helpint, valint \- display a prompt; verify and return an integer value .SH SYNOPSIS .LP .nf -\fBckint\fR [\fB-Q\fR] [\fB-W\fR \fIwidth\fR] [\fB-b\fR \fIbase\fR] [\fB-d\fR \fIdefault\fR] [\fB-h\fR \fIhelp\fR] +\fBckint\fR [\fB-Q\fR] [\fB-W\fR \fIwidth\fR] [\fB-b\fR \fIbase\fR] [\fB-d\fR \fIdefault\fR] [\fB-h\fR \fIhelp\fR] [\fB-e\fR \fIerror\fR] [\fB-p\fR \fIprompt\fR] [\fB-k\fR \fIpid\fR [\fB-s\fR \fIsignal\fR]] .fi @@ -63,92 +63,76 @@ expected base of the input. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-b\fR\fI base\fR\fR .ad .RS 14n -.rt Defines the base for input. Must be \fB2\fR to \fB36\fR, default is \fB10\fR. .RE .sp .ne 2 -.mk .na \fB\fB-d\fR\fI default\fR\fR .ad .RS 14n -.rt Defines the default value as \fIdefault\fR. The default is not validated and so does not have to meet any criteria. .RE .sp .ne 2 -.mk .na \fB\fB-e\fR\fI error\fR\fR .ad .RS 14n -.rt Defines the error message as \fI error\fR. .RE .sp .ne 2 -.mk .na \fB\fB-h\fR\fI help\fR\fR .ad .RS 14n -.rt Defines the help messages as \fI help\fR. .RE .sp .ne 2 -.mk .na \fB\fB-k\fR\fI pid\fR\fR .ad .RS 14n -.rt Specifies that process \fBID\fR \fIpid\fR is to be sent a signal if the user chooses to abort. .RE .sp .ne 2 -.mk .na \fB\fB-p\fR\fI prompt\fR\fR .ad .RS 14n -.rt Defines the prompt message as \fIprompt\fR. .RE .sp .ne 2 -.mk .na \fB\fB-Q\fR\fR .ad .RS 14n -.rt Specifies that quit will not be allowed as a valid response. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fI signal\fR\fR .ad .RS 14n -.rt Specifies that the process \fBID\fR \fIpid\fR defined with the \fB-k\fR option is to be sent signal \fI signal\fR when quit is chosen. If no signal is specified, \fBSIGTERM\fR is used. @@ -156,12 +140,10 @@ specified, \fBSIGTERM\fR is used. .sp .ne 2 -.mk .na \fB\fB-W\fR\fI width\fR\fR .ad .RS 14n -.rt Specifies that prompt, help and error messages will be formatted to a line length of \fIwidth\fR. .RE @@ -172,12 +154,10 @@ length of \fIwidth\fR. The following operand is supported: .sp .ne 2 -.mk .na \fB\fIinput\fR\fR .ad .RS 9n -.rt Input to be verified against \fIbase\fR criterion. .RE @@ -187,34 +167,28 @@ Input to be verified against \fIbase\fR criterion. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt Successful execution. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt \fBEOF\fR on input, or negative width on \fB-W\fR option, or usage error. .RE .sp .ne 2 -.mk .na \fB\fB3\fR\fR .ad .RS 5n -.rt User termination (quit). .RE diff --git a/usr/src/man/man1/ckitem.1 b/usr/src/man/man1/ckitem.1 index b32b433c82..bd71006491 100644 --- a/usr/src/man/man1/ckitem.1 +++ b/usr/src/man/man1/ckitem.1 @@ -3,15 +3,15 @@ .\" 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 ckitem 1 "14 Sep 1992" "SunOS 5.11" "User Commands" +.TH CKITEM 1 "Sep 14, 1992" .SH NAME ckitem, erritem, helpitem \- build a menu; prompt for and return a menu item .SH SYNOPSIS .LP .nf -\fBckitem\fR [\fB-Q\fR] [\fB-W\fR \fIwidth\fR] [\fB-uno\fR] [\fB-f\fR \fIfilename\fR] [\fB-l\fR \fIlabel\fR] - [ [\fB-i\fR \fIinvis\fR] [,]...] [\fB-m\fR \fImax\fR] [\fB-d\fR \fIdefault\fR] [\fB-h\fR \fIhelp\fR] - [\fB-e\fR \fI error\fR] [\fB-p\fR \fIprompt\fR] [\fB-k\fR \fIpid\fR [\fB-s\fR \fIsignal\fR]] +\fBckitem\fR [\fB-Q\fR] [\fB-W\fR \fIwidth\fR] [\fB-uno\fR] [\fB-f\fR \fIfilename\fR] [\fB-l\fR \fIlabel\fR] + [ [\fB-i\fR \fIinvis\fR] [,]...] [\fB-m\fR \fImax\fR] [\fB-d\fR \fIdefault\fR] [\fB-h\fR \fIhelp\fR] + [\fB-e\fR \fI error\fR] [\fB-p\fR \fIprompt\fR] [\fB-k\fR \fIpid\fR [\fB-s\fR \fIsignal\fR]] [\fIchoice\fR [...]] .fi @@ -64,35 +64,29 @@ will describe the available menu choice (or choices). The following options are supported: .sp .ne 2 -.mk .na \fB\fB-d\fR\fI default\fR\fR .ad .RS 15n -.rt Define the default value as \fIdefault\fR. The default is not validated and so does not have to meet any criteria. .RE .sp .ne 2 -.mk .na \fB\fB-e\fR\fI error\fR\fR .ad .RS 15n -.rt Define the error message as \fI error\fR. .RE .sp .ne 2 -.mk .na \fB\fB-f\fR\fI filename\fR\fR .ad .RS 15n -.rt Define a file, \fIfilename\fR, which contains a list of menu items to be displayed. (The format of this file is: \fBtoken<tab>description\fR. Lines beginning with a pound sign (#) are designated as comments and ignored.) @@ -100,23 +94,19 @@ beginning with a pound sign (#) are designated as comments and ignored.) .sp .ne 2 -.mk .na \fB\fB-h\fR\fI help\fR\fR .ad .RS 15n -.rt Define the help messages as \fI help\fR. .RE .sp .ne 2 -.mk .na \fB\fB-i\fR\fI invis\fR\fR .ad .RS 15n -.rt Define invisible menu choices (those which will not be printed in the menu). (For example, ``all'' used as an invisible choice would mean it is a legal option but does not appear in the menu. Any number of invisible choices may be @@ -126,91 +116,75 @@ or in a help message. .sp .ne 2 -.mk .na \fB\fB-k\fR\fI pid\fR\fR .ad .RS 15n -.rt Specify that the process \fBID\fR \fIpid\fR is to be sent a signal if the user chooses to abort. .RE .sp .ne 2 -.mk .na \fB\fB-l\fR\fI label\fR\fR .ad .RS 15n -.rt Define a label, \fIlabel\fR, to print above the menu. .RE .sp .ne 2 -.mk .na \fB\fB-m\fR\fI max\fR\fR .ad .RS 15n -.rt Define the maximum number of menu choices that the user can choose. The default is 1. .RE .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 15n -.rt Specify that menu items should not be displayed in alphabetical order. .RE .sp .ne 2 -.mk .na \fB\fB-o\fR\fR .ad .RS 15n -.rt Specify that only one menu token will be returned. .RE .sp .ne 2 -.mk .na \fB\fB-p\fR\fI prompt\fR\fR .ad .RS 15n -.rt Define the prompt message as \fIprompt\fR. .RE .sp .ne 2 -.mk .na \fB\fB-Q\fR\fR .ad .RS 15n -.rt Specify that quit will not be allowed as a valid response. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fI signal\fR\fR .ad .RS 15n -.rt Specify that process \fBID\fR \fIpid\fR defined with the \fB-k\fR option is to be sent signal \fI signal\fR when quit is chosen. If no signal is specified, \fBSIGTERM\fR is used. @@ -218,23 +192,19 @@ be sent signal \fI signal\fR when quit is chosen. If no signal is specified, .sp .ne 2 -.mk .na \fB\fB-u\fR\fR .ad .RS 15n -.rt Specify that menu items should be displayed as an unnumbered list. .RE .sp .ne 2 -.mk .na \fB\fB-W\fR\fI width\fR\fR .ad .RS 15n -.rt Specify that prompt, help and error messages will be formatted to a line length of \fIwidth\fR. .RE @@ -245,12 +215,10 @@ of \fIwidth\fR. The following operand is supported: .sp .ne 2 -.mk .na \fB\fIchoice\fR\fR .ad .RS 10n -.rt Define menu items. Items should be separated by white space or newline. .RE @@ -260,46 +228,38 @@ Define menu items. Items should be separated by white space or newline. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt Successful execution. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt \fBEOF\fR on input, or negative width on \fB-W\fR option, or inability to open file on \fB-f\fR option, or usage error. .RE .sp .ne 2 -.mk .na \fB\fB3\fR\fR .ad .RS 5n -.rt User termination (quit). .RE .sp .ne 2 -.mk .na \fB\fB4\fR\fR .ad .RS 5n -.rt No choices from which to choose. .RE diff --git a/usr/src/man/man1/ckkeywd.1 b/usr/src/man/man1/ckkeywd.1 index 7ff449ab79..296ce82886 100644 --- a/usr/src/man/man1/ckkeywd.1 +++ b/usr/src/man/man1/ckkeywd.1 @@ -3,13 +3,13 @@ .\" 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 ckkeywd 1 "14 Sep 1992" "SunOS 5.11" "User Commands" +.TH CKKEYWD 1 "Sep 14, 1992" .SH NAME ckkeywd \- prompts for and validates a keyword .SH SYNOPSIS .LP .nf -\fBckkeywd\fR [\fB-Q\fR] [\fB-W\fR \fIwidth\fR] [\fB-d\fR \fIdefault\fR] [\fB-h\fR \fIhelp\fR] [\fB-e\fR \fIerror\fR] +\fBckkeywd\fR [\fB-Q\fR] [\fB-W\fR \fIwidth\fR] [\fB-d\fR \fIdefault\fR] [\fB-h\fR \fIhelp\fR] [\fB-e\fR \fIerror\fR] [\fB-p\fR \fIprompt\fR] [\fB-k\fR \fIpid\fR [\fB-s\fR \fIsignal\fR]] \fIkeyword\fR [...] .fi @@ -39,80 +39,66 @@ defined under \fBNOTES\fR) will be displayed. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-d\fR\fI default\fR\fR .ad .RS 14n -.rt Defines the default value as \fIdefault\fR. The default is not validated and so does not have to meet any criteria. .RE .sp .ne 2 -.mk .na \fB\fB-e\fR\fI error\fR\fR .ad .RS 14n -.rt Defines the error message as \fI error\fR. .RE .sp .ne 2 -.mk .na \fB\fB-h\fR\fI help\fR\fR .ad .RS 14n -.rt Defines the help messages as \fI help\fR. .RE .sp .ne 2 -.mk .na \fB\fB-k\fR\fI pid\fR\fR .ad .RS 14n -.rt Specifies that process \fBID\fR \fIpid\fR is to be sent a signal if the user chooses to abort. .RE .sp .ne 2 -.mk .na \fB\fB-p\fR\fI prompt\fR\fR .ad .RS 14n -.rt Defines the prompt message as \fIprompt\fR. .RE .sp .ne 2 -.mk .na \fB\fB-Q\fR\fR .ad .RS 14n -.rt Specifies that quit will not be allowed as a valid response. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fI signal\fR\fR .ad .RS 14n -.rt Specifies that the process \fBID\fR \fIpid\fR defined with the \fB-k\fR option is to be sent signal \fI signal\fR when quit is chosen. If no signal is specified, \fBSIGTERM\fR is used. @@ -120,12 +106,10 @@ specified, \fBSIGTERM\fR is used. .sp .ne 2 -.mk .na \fB\fB-W\fR\fI width\fR\fR .ad .RS 14n -.rt Specifies that prompt, help and error messages will be formatted to a line length of \fIwidth\fR. .RE @@ -136,12 +120,10 @@ length of \fIwidth\fR. The following operand is supported: .sp .ne 2 -.mk .na \fB\fIkeyword\fR\fR .ad .RS 11n -.rt Defines the keyword, or list of keywords, against which the answer will be verified. .RE @@ -152,35 +134,29 @@ verified. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt Successful execution. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt \fBEOF\fR on input, or negative width on \fB-W\fR option, or no keywords from which to choose, or usage error. .RE .sp .ne 2 -.mk .na \fB\fB3\fR\fR .ad .RS 5n -.rt User termination (quit). .RE diff --git a/usr/src/man/man1/ckpath.1 b/usr/src/man/man1/ckpath.1 index 8627d29fbb..b1786bc906 100644 --- a/usr/src/man/man1/ckpath.1 +++ b/usr/src/man/man1/ckpath.1 @@ -3,33 +3,33 @@ .\" 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 ckpath 1 "4 Nov 2005" "SunOS 5.11" "User Commands" +.TH CKPATH 1 "Nov 4, 2005" .SH NAME ckpath, errpath, helppath, valpath \- display a prompt; verify and return a pathname .SH SYNOPSIS .LP .nf -\fBckpath\fR [\fB-Q\fR] [\fB-W\fR \fIwidth\fR] [\fB-a\fR | l] [\fB-b\fR | c | f | y] - [\fB-n\fR [o | z]] [\fB-rtwx\fR] [\fB-d\fR \fIdefault\fR] [\fB-h\fR \fIhelp\fR] +\fBckpath\fR [\fB-Q\fR] [\fB-W\fR \fIwidth\fR] [\fB-a\fR | l] [\fB-b\fR | c | f | y] + [\fB-n\fR [o | z]] [\fB-rtwx\fR] [\fB-d\fR \fIdefault\fR] [\fB-h\fR \fIhelp\fR] [\fB-e\fR \fIerror\fR] [\fB-p\fR \fIprompt\fR] [\fB-k\fR \fIpid\fR [\fB-s\fR \fIsignal\fR]] .fi .LP .nf -\fB/usr/sadm/bin/errpath\fR [\fB-W\fR \fIwidth\fR] [\fB-a\fR | l] [\fB-b\fR | c | f | y] +\fB/usr/sadm/bin/errpath\fR [\fB-W\fR \fIwidth\fR] [\fB-a\fR | l] [\fB-b\fR | c | f | y] [\fB-n\fR [o | z]] [\fB-rtwx\fR] [\fB-e\fR \fIerror\fR] .fi .LP .nf -\fB/usr/sadm/bin/helppath\fR [\fB-W\fR \fIwidth\fR] [\fB-a\fR | l] [\fB-b\fR | c | f | y] +\fB/usr/sadm/bin/helppath\fR [\fB-W\fR \fIwidth\fR] [\fB-a\fR | l] [\fB-b\fR | c | f | y] [\fB-n\fR [o | z]] [\fB-rtwx\fR] [\fB-h\fR \fIhelp\fR] .fi .LP .nf -\fB/usr/sadm/bin/valpath\fR [\fB-a\fR | l] [\fB-b\fR | c | f | y] +\fB/usr/sadm/bin/valpath\fR [\fB-a\fR | l] [\fB-b\fR | c | f | y] [\fB-n\fR [o | z]] [\fB-rtwx\fR] \fIinput\fR .fi @@ -70,168 +70,138 @@ standard output), and \fBvalpath\fR (which validates a response). The following options are supported: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 14n -.rt Pathname must be an absolute path. .RE .sp .ne 2 -.mk .na \fB\fB-b\fR\fR .ad .RS 14n -.rt Pathname must be a block special file. .RE .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad .RS 14n -.rt Pathname must be a character special file. .RE .sp .ne 2 -.mk .na \fB\fB-d\fR \fIdefault\fR\fR .ad .RS 14n -.rt Defines the default value as \fIdefault\fR. The default is not validated and so does not have to meet any criteria. .RE .sp .ne 2 -.mk .na \fB\fB-e\fR \fIerror\fR\fR .ad .RS 14n -.rt Defines the error message as \fI error\fR. .RE .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 14n -.rt Pathname must be a regular file. .RE .sp .ne 2 -.mk .na \fB\fB-h\fR \fIhelp\fR\fR .ad .RS 14n -.rt Defines the help message as \fI help\fR. .RE .sp .ne 2 -.mk .na \fB\fB-k\fR \fIpid\fR\fR .ad .RS 14n -.rt Specifies that process \fBID\fR \fIpid\fR is to be sent a signal if the user chooses to quit. .RE .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 14n -.rt Pathname must be a relative path. .RE .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 14n -.rt Pathname must not exist (must be new). .RE .sp .ne 2 -.mk .na \fB\fB-o\fR\fR .ad .RS 14n -.rt Pathname must exist (must be old). .RE .sp .ne 2 -.mk .na \fB\fB-p\fR \fIprompt\fR\fR .ad .RS 14n -.rt Defines the prompt message as \fIprompt\fR. .RE .sp .ne 2 -.mk .na \fB\fB-Q\fR\fR .ad .RS 14n -.rt Specifies that \fBquit\fR is not allowed as a valid response. .RE .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 14n -.rt Pathname must be readable. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR \fIsignal\fR\fR .ad .RS 14n -.rt Specifies that the process \fBID\fR \fIpid\fR defined with the \fB-k\fR option is to be sent signal \fIsignal\fR when quit is chosen. If no signal is specified, \fBSIGTERM\fR is used. @@ -239,69 +209,57 @@ specified, \fBSIGTERM\fR is used. .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad .RS 14n -.rt Pathname must be creatable (touchable). Pathname will be created if it does not already exist. .RE .sp .ne 2 -.mk .na \fB\fB-w\fR\fR .ad .RS 14n -.rt Pathname must be writable. .RE .sp .ne 2 -.mk .na \fB\fB-W\fR \fIwidth\fR\fR .ad .RS 14n -.rt Specify that prompt, help and error messages be formatted to a line length of \fIwidth\fR. .RE .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad .RS 14n -.rt Pathname must be executable. .RE .sp .ne 2 -.mk .na \fB\fB-y\fR\fR .ad .RS 14n -.rt Pathname must be a directory. .RE .sp .ne 2 -.mk .na \fB\fB-z\fR\fR .ad .RS 14n -.rt Pathname must have a file having a size greater than zero bytes. .RE @@ -311,12 +269,10 @@ Pathname must have a file having a size greater than zero bytes. The following operand is supported: .sp .ne 2 -.mk .na \fB\fIinput\fR\fR .ad .RS 9n -.rt Input to be verified against validation options. .RE @@ -350,7 +306,7 @@ An example default error message (using the \fB-a\fR option) is: .in +2 .nf example% \fB/usr/sadm/bin/errpath \fR\fB-a\fR -ERROR: A pathname is a filename, optionally preceded by parent +ERROR: A pathname is a filename, optionally preceded by parent directories. The pathname you enter: - must begin with a slash (/) .fi @@ -405,56 +361,46 @@ usage: valpath [\fB-[a|l][b|c|f|y][n|[o|z]]rtwx\fR] input The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt Successful execution. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt \fBEOF\fR on input, or negative width on \fB-W\fR option, or usage error. .RE .sp .ne 2 -.mk .na \fB\fB2\fR\fR .ad .RS 5n -.rt Mutually exclusive options. .RE .sp .ne 2 -.mk .na \fB\fB3\fR\fR .ad .RS 5n -.rt User termination (quit). .RE .sp .ne 2 -.mk .na \fB\fB4\fR\fR .ad .RS 5n -.rt Mutually exclusive options. .RE diff --git a/usr/src/man/man1/ckrange.1 b/usr/src/man/man1/ckrange.1 index 6190fd86aa..7ee12795a4 100644 --- a/usr/src/man/man1/ckrange.1 +++ b/usr/src/man/man1/ckrange.1 @@ -3,26 +3,26 @@ .\" 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 ckrange 1 "4 Nov 2005" "SunOS 5.11" "User Commands" +.TH CKRANGE 1 "Nov 4, 2005" .SH NAME ckrange, errange, helprange, valrange \- prompts for and validates an integer .SH SYNOPSIS .LP .nf -\fBckrange\fR [\fB-Q\fR] [\fB-W\fR \fIwidth\fR] [\fB-l\fR \fIlower\fR] [\fB-u\fR \fIupper\fR] [\fB-b\fR \fIbase\fR] - [\fB-d\fR \fIdefault\fR] [\fB-h\fR \fIhelp\fR] [\fB-e\fR \fIerror\fR] [\fB-p\fR \fIprompt\fR] +\fBckrange\fR [\fB-Q\fR] [\fB-W\fR \fIwidth\fR] [\fB-l\fR \fIlower\fR] [\fB-u\fR \fIupper\fR] [\fB-b\fR \fIbase\fR] + [\fB-d\fR \fIdefault\fR] [\fB-h\fR \fIhelp\fR] [\fB-e\fR \fIerror\fR] [\fB-p\fR \fIprompt\fR] [\fB-k\fR \fIpid\fR [\fB-s\fR \fIsignal\fR]] .fi .LP .nf -\fB/usr/sadm/bin/errange\fR [\fB-W\fR \fIwidth\fR] [\fB-e\fR \fIerror\fR] [\fB-l\fR \fIlower\fR] +\fB/usr/sadm/bin/errange\fR [\fB-W\fR \fIwidth\fR] [\fB-e\fR \fIerror\fR] [\fB-l\fR \fIlower\fR] [\fB-u\fR \fIupper\fR] [\fB-b\fR \fIbase\fR] .fi .LP .nf -\fB/usr/sadm/bin/helprange\fR [\fB-W\fR \fIwidth\fR] [\fB-h\fR \fIhelp\fR] [\fB-l\fR \fIlower\fR] +\fB/usr/sadm/bin/helprange\fR [\fB-W\fR \fIwidth\fR] [\fB-h\fR \fIhelp\fR] [\fB-l\fR \fIlower\fR] [\fB-u\fR \fIupper\fR] [\fB-b\fR \fIbase\fR] .fi @@ -74,24 +74,20 @@ options. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-b\fR \fIbase\fR\fR .ad .RS 14n -.rt Defines the base for input. Must be 2 to 36, default is 10. Base conversion uses \fBstrtol\fR(3C). Output is always base 10. .RE .sp .ne 2 -.mk .na \fB\fB-d\fR \fIdefault\fR\fR .ad .RS 14n -.rt Defines the default value as \fIdefault\fR. \fIdefault\fR is converted using \fBstrtol\fR(3C) in the desired base. Any characters invalid in the specified base will terminate the \fBstrtol\fR conversion without error. @@ -99,80 +95,66 @@ base will terminate the \fBstrtol\fR conversion without error. .sp .ne 2 -.mk .na \fB\fB-e\fR \fIerror\fR\fR .ad .RS 14n -.rt Defines the error message as \fI error\fR. .RE .sp .ne 2 -.mk .na \fB\fB-h\fR \fIhelp\fR\fR .ad .RS 14n -.rt Defines the help message as \fI help\fR. .RE .sp .ne 2 -.mk .na \fB\fB-k\fR \fIpid\fR\fR .ad .RS 14n -.rt Specifies that process \fBID\fR \fIpid\fR is to be sent a signal if the user chooses to quit. .RE .sp .ne 2 -.mk .na \fB\fB-l\fR \fIlower\fR\fR .ad .RS 14n -.rt Defines the lower limit of the range as \fIlower\fR. Default is the machine's largest negative long. .RE .sp .ne 2 -.mk .na \fB\fB-p\fR \fIprompt\fR\fR .ad .RS 14n -.rt Defines the prompt message as \fIprompt\fR. .RE .sp .ne 2 -.mk .na \fB\fB-Q\fR\fR .ad .RS 14n -.rt Specifies that quit will not be allowed as a valid response. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR \fIsignal\fR\fR .ad .RS 14n -.rt Specifies that the process \fBID\fR \fIpid\fR defined with the \fB-k\fR option is to be sent signal \fIsignal\fR when quit is chosen. If no signal is specified, \fBSIGTERM\fR is used. @@ -180,24 +162,20 @@ specified, \fBSIGTERM\fR is used. .sp .ne 2 -.mk .na \fB\fB-u\fR \fIupper\fR\fR .ad .RS 14n -.rt Defines the upper limit of the range as \fIupper\fR. Default is the machine's largest positive long. .RE .sp .ne 2 -.mk .na \fB\fB-W\fR \fIwidth\fR\fR .ad .RS 14n -.rt Specifies that prompt, help and error messages will be formatted to a line length of \fIwidth\fR. .RE @@ -208,12 +186,10 @@ length of \fIwidth\fR. The following operand is supported: .sp .ne 2 -.mk .na \fB\fIinput\fR\fR .ad .RS 9n -.rt Input to be verified against upper and lower limits and base. .RE @@ -309,45 +285,37 @@ usage: valrange [-l lower] [-u upper] [-b base] input The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt Successful execution. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt \fBEOF\fR on input, or negative width on \fB-W\fR option, or usage error. .RE .sp .ne 2 -.mk .na \fB\fB2\fR\fR .ad .RS 5n -.rt Usage error. .RE .sp .ne 2 -.mk .na \fB\fB3\fR\fR .ad .RS 5n -.rt User termination (quit). .RE diff --git a/usr/src/man/man1/ckstr.1 b/usr/src/man/man1/ckstr.1 index 0339fb6557..c1d53e5c97 100644 --- a/usr/src/man/man1/ckstr.1 +++ b/usr/src/man/man1/ckstr.1 @@ -3,27 +3,27 @@ .\" 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 ckstr 1 "14 Sep 1992" "SunOS 5.11" "User Commands" +.TH CKSTR 1 "Sep 14, 1992" .SH NAME ckstr, errstr, helpstr, valstr \- display a prompt; verify and return a string answer .SH SYNOPSIS .LP .nf -\fBckstr\fR [\fB-Q\fR] [\fB-W\fR \fIwidth\fR] [ [\fB-r\fR \fIregexp\fR] [...]] [\fB-l\fR \fIlength\fR] - [\fB-d\fR \fIdefault\fR] [\fB-h\fR \fIhelp\fR] [\fB-e\fR \fIerror\fR] [\fB-p\fR \fIprompt\fR] +\fBckstr\fR [\fB-Q\fR] [\fB-W\fR \fIwidth\fR] [ [\fB-r\fR \fIregexp\fR] [...]] [\fB-l\fR \fIlength\fR] + [\fB-d\fR \fIdefault\fR] [\fB-h\fR \fIhelp\fR] [\fB-e\fR \fIerror\fR] [\fB-p\fR \fIprompt\fR] [\fB-k\fR \fIpid\fR [\fB- s\fR \fIsignal\fR]] .fi .LP .nf -\fB/usr/sadm/bin/errstr\fR [\fB-W\fR \fIwidth\fR] [\fB-e\fR \fIerror\fR] [\fB-l\fR \fIlength\fR] +\fB/usr/sadm/bin/errstr\fR [\fB-W\fR \fIwidth\fR] [\fB-e\fR \fIerror\fR] [\fB-l\fR \fIlength\fR] [ [\fB-r\fR \fIregexp\fR] [...]] .fi .LP .nf -\fB/usr/sadm/bin/helpstr\fR [\fB-W\fR \fIwidth\fR] [\fB-h\fR \fIhelp\fR] [\fB-l\fR \fIlength\fR] +\fB/usr/sadm/bin/helpstr\fR [\fB-W\fR \fIwidth\fR] [\fB-h\fR \fIhelp\fR] [\fB-l\fR \fIlength\fR] [ [\fB-r\fR \fIregexp\fR] [...]] .fi @@ -70,91 +70,75 @@ standard output), and \fBvalstr\fR (which validates a response). The following options are supported: .sp .ne 2 -.mk .na \fB\fB-d\fR \fIdefault\fR\fR .ad .RS 14n -.rt Defines the default value as \fIdefault\fR. The default is not validated and so does not have to meet any criteria. .RE .sp .ne 2 -.mk .na \fB\fB-e\fR \fIerror\fR\fR .ad .RS 14n -.rt Defines the error message as \fI error\fR. .RE .sp .ne 2 -.mk .na \fB\fB-h\fR \fIhelp\fR\fR .ad .RS 14n -.rt Defines the help message as \fI help\fR. .RE .sp .ne 2 -.mk .na \fB\fB-k\fR \fIpid\fR\fR .ad .RS 14n -.rt Specifies that process \fBID\fR \fIpid\fR is to be sent a signal if the user chooses to quit. .RE .sp .ne 2 -.mk .na \fB\fB-l\fR \fIlength\fR\fR .ad .RS 14n -.rt Specifies the maximum length of the input. .RE .sp .ne 2 -.mk .na \fB\fB-p\fR \fIprompt\fR\fR .ad .RS 14n -.rt Defines the prompt message as \fIprompt\fR. .RE .sp .ne 2 -.mk .na \fB\fB-Q\fR\fR .ad .RS 14n -.rt Specifies that \fBquit\fR will not be allowed as a valid response. .RE .sp .ne 2 -.mk .na \fB\fB-r\fR \fIregexp\fR\fR .ad .RS 14n -.rt Specifies a regular expression, \fI regexp\fR, against which the input should be validated. May include white space. If multiple expressions are defined, the answer need match only one of them. @@ -162,12 +146,10 @@ answer need match only one of them. .sp .ne 2 -.mk .na \fB\fB-s\fR \fIsignal\fR\fR .ad .RS 14n -.rt Specifies that the process \fBID\fR \fIpid\fR defined with the \fB-k\fR option is to be sent signal \fIsignal\fR when quit is chosen. If no signal is specified, \fBSIGTERM\fR is used. @@ -175,12 +157,10 @@ specified, \fBSIGTERM\fR is used. .sp .ne 2 -.mk .na \fB\fB-W\fR \fIwidth\fR\fR .ad .RS 14n -.rt Specifies that prompt, help and error messages will be formatted to a line length of \fIwidth\fR. .RE @@ -191,12 +171,10 @@ length of \fIwidth\fR. The following operand is supported: .sp .ne 2 -.mk .na \fB\fIinput\fR\fR .ad .RS 9n -.rt Input to be verified against format length and/or regular expression criteria. .RE @@ -284,45 +262,37 @@ usage: valstr [\fB-l\fR length] [[\fB-r\fR regexp] [\|.\|.\|.\|]] input The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt Successful execution. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt \fBEOF\fR on input, or negative width on \fB-W\fR option, or usage error. .RE .sp .ne 2 -.mk .na \fB\fB2\fR\fR .ad .RS 5n -.rt Invalid regular expression. .RE .sp .ne 2 -.mk .na \fB\fB3\fR\fR .ad .RS 5n -.rt User termination (quit). .RE diff --git a/usr/src/man/man1/cksum.1 b/usr/src/man/man1/cksum.1 index 316ca34a8f..0f1d1a8ad1 100644 --- a/usr/src/man/man1/cksum.1 +++ b/usr/src/man/man1/cksum.1 @@ -1,13 +1,13 @@ '\" te .\" Copyright (c) 1992, X/Open Company Limited All Rights Reserved Portions Copyright (c) 2006, Sun Microsystems, Inc. All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 cksum 1 "1 Feb 1995" "SunOS 5.11" "User Commands" +.TH CKSUM 1 "Feb 1, 1995" .SH NAME cksum \- write file checksums and sizes .SH SYNOPSIS @@ -85,12 +85,10 @@ The bit sequence is complemented and the result is the CRC. The following operand is supported: .sp .ne 2 -.mk .na \fB\fIfile\fR\fR .ad .RS 8n -.rt A path name of a file to be checked. If no \fIfile\fR operands are specified, the standard input is used. .RE @@ -134,23 +132,19 @@ that affect the execution of \fBcksum\fR: \fBLANG\fR, \fBLC_ALL\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt All files were processed successfully. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -162,13 +156,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man1/cktime.1 b/usr/src/man/man1/cktime.1 index c73a36d9f0..daf4f94235 100644 --- a/usr/src/man/man1/cktime.1 +++ b/usr/src/man/man1/cktime.1 @@ -3,14 +3,14 @@ .\" 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 cktime 1 "14 Sep 1992" "SunOS 5.11" "User Commands" +.TH CKTIME 1 "Sep 14, 1992" .SH NAME cktime, errtime, helptime, valtime \- display a prompt; verify and return a time of day .SH SYNOPSIS .LP .nf -\fBcktime\fR [\fB-Q\fR] [\fB-W\fR \fIwidth\fR] [\fB-f\fR \fIformat\fR] [\fB-d\fR \fIdefault\fR] [\fB-h\fR \fIhelp\fR] +\fBcktime\fR [\fB-Q\fR] [\fB-W\fR \fIwidth\fR] [\fB-f\fR \fIformat\fR] [\fB-d\fR \fIdefault\fR] [\fB-h\fR \fIhelp\fR] [\fB-e\fR \fIerror\fR] [\fB-p\fR \fIprompt\fR] [\fB-k\fR \fIpid\fR [\fB-s\fR \fIsignal\fR]] .fi @@ -64,35 +64,29 @@ messages will describe the expected format. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-d\fR\fI default\fR\fR .ad .RS 14n -.rt Defines the default value as \fIdefault\fR. The default is not validated and so does not have to meet any criteria. .RE .sp .ne 2 -.mk .na \fB\fB-e\fR \fIerror\fR\fR .ad .RS 14n -.rt Defines the error message as \fIerror\fR. .RE .sp .ne 2 -.mk .na \fB\fB-f\fR \fIformat\fR\fR .ad .RS 14n -.rt Specifies the format against which the input will be verified. Possible formats and their definitions are: .sp @@ -114,57 +108,47 @@ and their definitions are: .sp .ne 2 -.mk .na \fB\fB-h\fR \fIhelp\fR\fR .ad .RS 14n -.rt Defines the help messages as \fIhelp\fR. .RE .sp .ne 2 -.mk .na \fB\fB-k\fR\fI pid\fR\fR .ad .RS 14n -.rt Specifies that process \fBID\fR \fIpid\fR is to be sent a signal if the user chooses to abort. .RE .sp .ne 2 -.mk .na \fB\fB-p\fR\fI prompt\fR\fR .ad .RS 14n -.rt Defines the prompt message as \fIprompt\fR. .RE .sp .ne 2 -.mk .na \fB\fB-Q\fR\fR .ad .RS 14n -.rt Specifies that quit will not be allowed as a valid response. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR \fIsignal\fR\fR .ad .RS 14n -.rt Specifies that the process \fBID\fR \fIpid\fR defined with the \fB-k\fR option is to be sent signal \fIsignal\fR when quit is chosen. If no signal is specified, \fBSIGTERM\fR is used. @@ -172,12 +156,10 @@ specified, \fBSIGTERM\fR is used. .sp .ne 2 -.mk .na \fB\fB-W\fR\fI width\fR\fR .ad .RS 14n -.rt Specifies that prompt, help and error messages will be formatted to a line length of \fIwidth\fR. .RE @@ -188,12 +170,10 @@ length of \fIwidth\fR. The following operand is supported: .sp .ne 2 -.mk .na \fB\fIinput\fR\fR .ad .RS 9n -.rt Input to be verified against format criteria. .RE @@ -203,45 +183,37 @@ Input to be verified against format criteria. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt Successful execution. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt \fBEOF\fR on input, or negative width on \fB-W\fR option, or usage error . .RE .sp .ne 2 -.mk .na \fB\fB3\fR\fR .ad .RS 5n -.rt User termination (quit) . .RE .sp .ne 2 -.mk .na \fB\fB4\fR\fR .ad .RS 5n -.rt Garbled format argument. .RE diff --git a/usr/src/man/man1/ckuid.1 b/usr/src/man/man1/ckuid.1 index ddb5b51baa..fc896ae7ab 100644 --- a/usr/src/man/man1/ckuid.1 +++ b/usr/src/man/man1/ckuid.1 @@ -3,13 +3,13 @@ .\" 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 ckuid 1 "14 Sep 1992" "SunOS 5.11" "User Commands" +.TH CKUID 1 "Sep 14, 1992" .SH NAME ckuid, erruid, helpuid, valuid \- prompts for and validates a user ID .SH SYNOPSIS .LP .nf -\fBckuid\fR [\fB-Q\fR] [\fB-W\fR \fIwidth\fR] [\fB-m\fR] [\fB-d\fR \fIdefault\fR] [\fB-h\fR \fIhelp\fR] +\fBckuid\fR [\fB-Q\fR] [\fB-W\fR \fIwidth\fR] [\fB-m\fR] [\fB-d\fR \fIdefault\fR] [\fB-h\fR \fIhelp\fR] [\fB-e\fR \fIerror\fR] [\fB-p\fR \fIprompt\fR] [\fB-k\fR \fIpid\fR [\fB-s\fR \fIsignal\fR]] .fi @@ -60,92 +60,76 @@ objects. In this instance, the \fBFML\fR object defines the prompt. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-d\fR\fI default\fR\fR .ad .RS 14n -.rt Defines the default value as \fIdefault\fR. The default is not validated and so does not have to meet any criteria. .RE .sp .ne 2 -.mk .na \fB\fB-e\fR \fIerror\fR\fR .ad .RS 14n -.rt Defines the error message as \fIerror\fR. .RE .sp .ne 2 -.mk .na \fB\fB-h\fR \fIhelp\fR\fR .ad .RS 14n -.rt Defines the help messages as \fIhelp\fR. .RE .sp .ne 2 -.mk .na \fB\fB-k\fR\fI pid\fR\fR .ad .RS 14n -.rt Specifies that process \fBID\fR \fIpid\fR is to be sent a signal if the user chooses to abort. .RE .sp .ne 2 -.mk .na \fB\fB-m\fR\fR .ad .RS 14n -.rt Displays a list of all logins when help is requested or when the user makes an error. .RE .sp .ne 2 -.mk .na \fB\fB-p\fR\fI prompt\fR\fR .ad .RS 14n -.rt Defines the prompt message as \fIprompt\fR. .RE .sp .ne 2 -.mk .na \fB\fB-Q\fR\fR .ad .RS 14n -.rt Specifies that quit will not be allowed as a valid response. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR \fIsignal\fR\fR .ad .RS 14n -.rt Specifies that the process \fBID\fR \fIpid\fR defined with the \fB-k\fR option is to be sent signal \fIsignal\fR when quit is chosen. If no signal is specified, \fBSIGTERM\fR is used. @@ -153,12 +137,10 @@ specified, \fBSIGTERM\fR is used. .sp .ne 2 -.mk .na \fB\fB-W\fR\fI width\fR\fR .ad .RS 14n -.rt Specifies that prompt, help and error messages will be formatted to a line length of \fIwidth\fR. .RE @@ -169,12 +151,10 @@ length of \fIwidth\fR. The following operand is supported: .sp .ne 2 -.mk .na \fB\fIinput\fR\fR .ad .RS 9n -.rt Input to be verified against \fB/etc/passwd\fR. .RE @@ -184,45 +164,37 @@ Input to be verified against \fB/etc/passwd\fR. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt Successful execution. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt \fBEOF\fR on input, or negative width on \fB-W\fR option, or usage error. .RE .sp .ne 2 -.mk .na \fB\fB2\fR\fR .ad .RS 5n -.rt Usage error. .RE .sp .ne 2 -.mk .na \fB\fB3\fR\fR .ad .RS 5n -.rt User termination (quit). .RE diff --git a/usr/src/man/man1/ckyorn.1 b/usr/src/man/man1/ckyorn.1 index 6f55cb5545..ec471294d7 100644 --- a/usr/src/man/man1/ckyorn.1 +++ b/usr/src/man/man1/ckyorn.1 @@ -3,13 +3,13 @@ .\" 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 ckyorn 1 "14 Sep 1992" "SunOS 5.11" "User Commands" +.TH CKYORN 1 "Sep 14, 1992" .SH NAME ckyorn, erryorn, helpyorn, valyorn \- prompts for and validates yes/no .SH SYNOPSIS .LP .nf -\fBckyorn\fR [\fB-Q\fR] [\fB-W\fR \fIwidth\fR] [\fB-d\fR \fIdefault\fR] [\fB-h\fR \fIhelp\fR] [\fB-e\fR \fIerror\fR] +\fBckyorn\fR [\fB-Q\fR] [\fB-W\fR \fIwidth\fR] [\fB-d\fR \fIdefault\fR] [\fB-h\fR \fIhelp\fR] [\fB-e\fR \fIerror\fR] [\fB-p\fR \fIprompt\fR] [\fB-k\fR \fIpid\fR [\fB-s\fR \fIsignal\fR]] .fi @@ -60,80 +60,66 @@ objects. In this instance, the \fBFACE\fR object defines the prompt. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-d\fR\fI default\fR\fR .ad .RS 14n -.rt Defines the default value as \fIdefault\fR. The default is not validated and so does not have to meet any criteria. .RE .sp .ne 2 -.mk .na \fB\fB-e\fR \fIerror\fR\fR .ad .RS 14n -.rt Defines the error message as \fIerror\fR. .RE .sp .ne 2 -.mk .na \fB\fB-h\fR \fIhelp\fR\fR .ad .RS 14n -.rt Defines the help messages as \fIhelp\fR. .RE .sp .ne 2 -.mk .na \fB\fB-k\fR\fI pid\fR\fR .ad .RS 14n -.rt Specifies that process \fBID\fR \fIpid\fR is to be sent a signal if the user chooses to abort. .RE .sp .ne 2 -.mk .na \fB\fB-p\fR\fI prompt\fR\fR .ad .RS 14n -.rt Defines the prompt message as \fIprompt\fR. .RE .sp .ne 2 -.mk .na \fB\fB-Q\fR\fR .ad .RS 14n -.rt Specifies that quit will not be allowed as a valid response. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR \fIsignal\fR\fR .ad .RS 14n -.rt Specifies that the process \fBID\fR \fIpid\fR defined with the \fB-k\fR option is to be sent signal \fIsignal\fR when quit is chosen. If no signal is specified, \fBSIGTERM\fR is used. @@ -141,12 +127,10 @@ specified, \fBSIGTERM\fR is used. .sp .ne 2 -.mk .na \fB\fB-W\fR\fI width\fR\fR .ad .RS 14n -.rt Specifies that prompt, help and error messages will be formatted to a line length of \fIwidth\fR. .RE @@ -157,12 +141,10 @@ length of \fIwidth\fR. The following operand is supported: .sp .ne 2 -.mk .na \fB\fIinput\fR\fR .ad .RS 9n -.rt Input to be verified as \fBy\fR, \fByes\fR, or \fBn\fR, \fBno\fR (in any combination of upper- and lower-case letters). .RE @@ -173,45 +155,37 @@ combination of upper- and lower-case letters). The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt Successful execution. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt \fBEOF\fR on input, or negative width on \fB-W\fR option, or usage error. .RE .sp .ne 2 -.mk .na \fB\fB2\fR\fR .ad .RS 5n -.rt Usage error. .RE .sp .ne 2 -.mk .na \fB\fB3\fR\fR .ad .RS 5n -.rt User termination (quit). .RE diff --git a/usr/src/man/man1/clear.1 b/usr/src/man/man1/clear.1 index 48834bd90b..33f0530bd7 100644 --- a/usr/src/man/man1/clear.1 +++ b/usr/src/man/man1/clear.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 clear 1 "12 Jul 2002" "SunOS 5.11" "User Commands" +.TH CLEAR 1 "Jul 12, 2002" .SH NAME clear \- clear the terminal screen .SH SYNOPSIS @@ -22,12 +22,10 @@ figure out how to clear the screen. .SH OPERANDS .sp .ne 2 -.mk .na \fB\fIterm\fR\fR .ad .RS 8n -.rt Indicates the type of terminal. Normally, this operand is unnecessary because the default is taken from the environment variable \fBTERM\fR. .RE diff --git a/usr/src/man/man1/cmp.1 b/usr/src/man/man1/cmp.1 index c523a48dcd..be3b065dc2 100644 --- a/usr/src/man/man1/cmp.1 +++ b/usr/src/man/man1/cmp.1 @@ -1,13 +1,13 @@ '\" te .\" Copyright 1989 AT&T Copyright (c) 2006, Sun Microsystems, Inc. All Rights Reserved Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 cmp 1 "19 Jul 2006" "SunOS 5.11" "User Commands" +.TH CMP 1 "Jul 19, 2006" .SH NAME cmp \- compare two files .SH SYNOPSIS @@ -32,24 +32,20 @@ respectively, and can be either octal or decimal. A leading 0 denotes octal. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 6n -.rt Write the byte number (decimal) and the differing bytes (octal) for each difference. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 6n -.rt Write nothing for differing files. Return exit status only. .RE @@ -59,24 +55,20 @@ Write nothing for differing files. Return exit status only. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIfile1\fR\fR .ad .RS 9n -.rt A path name of the first file to be compared. If \fIfile1\fR is \fB\(mi\fR, the standard input is used. .RE .sp .ne 2 -.mk .na \fB\fIfile2\fR\fR .ad .RS 9n -.rt A path name of the second file to be compared. If \fIfile2\fR is \fB\(mi\fR, the standard input is used. .RE @@ -123,35 +115,29 @@ that affect the execution of \fBcmp\fR: \fBLANG\fR, \fBLC_ALL\fR, The following error values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt The files are identical. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 6n -.rt The files are different. This includes the case where one file is identical to the first part of the other. .RE .sp .ne 2 -.mk .na \fB\fB>1\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -163,15 +149,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man1/col.1 b/usr/src/man/man1/col.1 index 531b998f17..d76a928e1f 100644 --- a/usr/src/man/man1/col.1 +++ b/usr/src/man/man1/col.1 @@ -1,13 +1,13 @@ '\" te .\" Copyright 1989 AT&T Copyright (c) 1995, Sun Microsystems, Inc. All Rights Reserved Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 col 1 "1 Feb 1995" "SunOS 5.11" "User Commands" +.TH COL 1 "Feb 1, 1995" .SH NAME col \- reverse line-feeds filter .SH SYNOPSIS @@ -52,27 +52,23 @@ means a sequence of two characters, \fBESC\fR followed by the character .sp .TS -tab(); -lw(2.75i) lw(2.75i) -lw(2.75i) lw(2.75i) -. -reverse line-feedESC\(mi7 -reverse half-line-feedESC\(mi8 -forward half-line-feedESC\(mi9 -vertical-tab (VT)013 -start-of-text (SO)016 -end-of-text (SI)017 +l l +l l . +reverse line-feed ESC\(mi7 +reverse half-line-feed ESC\(mi8 +forward half-line-feed ESC\(mi9 +vertical-tab (VT) 013 +start-of-text (SO) 016 +end-of-text (SI) 017 .TE .SH OPTIONS .sp .ne 2 -.mk .na \fB\fB-b\fR\fR .ad .RS 7n -.rt Assume that the output device in use is not capable of backspacing. In this case, if two or more characters are to appear in the same place, only the last one read will be output. @@ -80,12 +76,10 @@ one read will be output. .sp .ne 2 -.mk .na \fB\fB-f\fR \fR .ad .RS 7n -.rt Although \fBcol\fR accepts half-line motions in its input, it normally does not emit them on output. Instead, text that would appear between lines is moved to the next lower full-line boundary. This treatment can be suppressed by the @@ -96,12 +90,10 @@ reverse line motion. .sp .ne 2 -.mk .na \fB\fB-p\fR \fR .ad .RS 7n -.rt Normally, \fBcol\fR will ignore any escape sequences unknown to it that are found in its input; the \fB-p\fR option may be used to cause \fBcol\fR to output these sequences as regular characters, subject to overprinting from @@ -111,12 +103,10 @@ user is fully aware of the textual position of the escape sequences. .sp .ne 2 -.mk .na \fB\fB-x\fR \fR .ad .RS 7n -.rt Prevent \fBcol\fR from converting blank characters to tab characters on output wherever possible. Tab stops are considered to be at each column position \fIn\fR such that \fIn\fR modulo 8 equals 1. @@ -134,23 +124,19 @@ that affect the execution of \fBcol\fR: \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and The following error values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR \fR .ad .RS 7n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR \fR .ad .RS 7n -.rt An error occurred. .RE @@ -162,12 +148,11 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE -CSIenabled +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE +CSI enabled .TE .SH SEE ALSO diff --git a/usr/src/man/man1/comm.1 b/usr/src/man/man1/comm.1 index 7c48ee19ac..8a9a4a4c1f 100644 --- a/usr/src/man/man1/comm.1 +++ b/usr/src/man/man1/comm.1 @@ -2,14 +2,14 @@ .\" Copyright (c) 2004, Sun Microsystems, Inc. All Rights Reserved. .\" Copyright 1989 AT&T .\" Portions Copyright (c) 1992, X/Open Company Limited. All Rights Reserved. -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 comm 1 "3 Mar 2004" "SunOS 5.11" "User Commands" +.TH COMM 1 "Mar 3, 2004" .SH NAME comm \- select or reject lines common to two files .SH SYNOPSIS @@ -35,34 +35,28 @@ original lines. If not, the results are unspecified. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-1\fR\fR .ad .RS 6n -.rt Suppresses the output column of lines unique to \fIfile1\fR. .RE .sp .ne 2 -.mk .na \fB\fB-2\fR\fR .ad .RS 6n -.rt Suppresses the output column of lines unique to \fIfile2\fR. .RE .sp .ne 2 -.mk .na \fB\fB-3\fR\fR .ad .RS 6n -.rt Suppresses the output column of lines duplicated in \fIfile1\fR and \fIfile2\fR. .RE @@ -73,24 +67,20 @@ Suppresses the output column of lines duplicated in \fIfile1\fR and The following operands are supported: .sp .ne 2 -.mk .na \fB\fIfile1\fR\fR .ad .RS 9n -.rt A path name of the first file to be compared. If \fIfile1\fR is \fB\(mi\fR, the standard input is used. .RE .sp .ne 2 -.mk .na \fB\fIfile2\fR\fR .ad .RS 9n -.rt A path name of the second file to be compared. If \fIfile2\fR is \fB\(mi\fR, the standard input is used. .RE @@ -111,7 +101,7 @@ utilities, the command .sp .in +2 .nf -example% \fBcomm -23 file1 file2 | comm -23 - file3\fR +example% \fBcomm -23 file1 file2 | comm -23 - file3\fR .fi .in -2 .sp @@ -158,23 +148,19 @@ that affect the execution of \fBcomm\fR: \fBLANG\fR, \fBLC_ALL\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt All input files were successfully output as specified. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -186,15 +172,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIenabled +CSI enabled _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man1/command.1 b/usr/src/man/man1/command.1 index bf72cdfecc..5f3e7112cd 100644 --- a/usr/src/man/man1/command.1 +++ b/usr/src/man/man1/command.1 @@ -2,14 +2,14 @@ .\" Copyright (c) 1992, X/Open Company Limited All Rights Reserved .\" Portions Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved .\" Portions Copyright (c) 1982-2007 AT&T Knowledge Ventures -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 command 1 "8 Apr 2008" "SunOS 5.11" "User Commands" +.TH COMMAND 1 "Apr 8, 2008" .SH NAME command \- execute a simple command .SH SYNOPSIS @@ -63,24 +63,20 @@ to \fBwhence\fR(1). The following options are supported by \fB/usr/bin/command\fR: .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 6n -.rt Performs the command search using a default value for \fBPATH\fR that is guaranteed to find all of the standard utilities. .RE .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 6n -.rt Writes a string to standard output that indicates the path or command that is be used by the shell, in the current shell execution environment to invoke \fIcommand_name\fR, but does not invoke \fIcommand_name\fR. @@ -117,12 +113,10 @@ not found. .sp .ne 2 -.mk .na \fB\fB-V\fR\fR .ad .RS 6n -.rt Writes a string to standard output that indicates how the name specified in the \fIcommand_name\fR operand is interpreted by the shell, in the current shell execution environment, but does not invoke \fIcommand_name\fR. Although the @@ -176,24 +170,20 @@ Shell reserved words are identified as reserved words. The following options are supported by \fBksh93\fR \fBcommand\fR: .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 6n -.rt Causes a default path to be searched rather than the one defined by the value of \fBPATH\fR. .RE .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 6n -.rt Equivalent to: .sp .in +2 @@ -207,12 +197,10 @@ whence \fIcommand\fR [\fIargument\fR ...] .sp .ne 2 -.mk .na \fB\fB-V\fR\fR .ad .RS 6n -.rt Equivalent to: .sp .in +2 @@ -226,12 +214,10 @@ whence -v \fIcommand\fR [\fIargument\fR ...] .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad .RS 6n -.rt If command fails because there are too many arguments, it is invoked multiple times with a subset of the arguments on each invocation. Arguments that occur prior to the first word that expand to multiple arguments and arguments that @@ -245,23 +231,19 @@ invocation. The exit status is the maximum invocation exit status. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIargument\fR\fR .ad .RS 16n -.rt One of the strings treated as an argument to \fIcommand_name\fR. .RE .sp .ne 2 -.mk .na \fB\fIcommand_name\fR\fR .ad .RS 16n -.rt The name of a utility or a special built-in utility. .RE @@ -332,12 +314,10 @@ that affect the execution of \fBcommand\fR: \fBLANG\fR, \fBLC_ALL\fR, \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and \fBNLSPATH\fR. .sp .ne 2 -.mk .na \fB\fBPATH\fR\fR .ad .RS 8n -.rt Determine the search path used during the command search, except as described under the \fB-p\fR option. .RE @@ -350,23 +330,19 @@ When the \fB-v\fR or \fB-V\fR options are specified, the following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt The \fIcommand_name\fR could not be found or an error occurred. .RE @@ -375,23 +351,19 @@ The \fIcommand_name\fR could not be found or an error occurred. Otherwise, the following exit values are returned: .sp .ne 2 -.mk .na \fB\fB126\fR\fR .ad .RS 7n -.rt The utility specified by \fIcommand_name\fR was found but could not be invoked. .RE .sp .ne 2 -.mk .na \fB\fB127\fR\fR .ad .RS 7n -.rt An error occurred in the \fBcommand\fR utility or the utility specified by \fIcommand_name\fR could not be found. .RE @@ -407,45 +379,37 @@ If \fIcommand\fR is invoked, the exit status of \fBcommand\fR is that of \fIcommand\fR. Otherwise, it is one of the following: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 7n -.rt \fIcommand_name\fR completed successfully. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 7n -.rt \fB-v\fR or \fB-V\fR has been specified and an error occurred. .RE .sp .ne 2 -.mk .na \fB\fB126\fR\fR .ad .RS 7n -.rt \fIcommand_name\fR was found but could not be invoked. .RE .sp .ne 2 -.mk .na \fB\fB127\fR\fR .ad .RS 7n -.rt \fIcommand_name\fR could not be found. .RE @@ -458,15 +422,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .SS "ksh93" @@ -474,13 +437,12 @@ StandardSee \fBstandards\fR(5). .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityUncommitted +Interface Stability Uncommitted .TE .SH SEE ALSO diff --git a/usr/src/man/man1/compress.1 b/usr/src/man/man1/compress.1 index 57046e4136..84e04a611f 100644 --- a/usr/src/man/man1/compress.1 +++ b/usr/src/man/man1/compress.1 @@ -1,15 +1,15 @@ '\" te -.\" Copyright 1989 AT&T +.\" Copyright 1989 AT&T .\" Copyright (c) 2008 Sun Microsystems, Inc. All Rights Reserved .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 compress 1 "13 Mar 2008" "SunOS 5.11" "User Commands" +.TH COMPRESS 1 "Mar 13, 2008" .SH NAME compress, uncompress, zcat \- compress, uncompress files or display expanded files @@ -80,12 +80,10 @@ that have been compressed using \fBcompress\fR. It is the equivalent of The following options are supported: .sp .ne 2 -.mk .na \fB\fB-b\fR \fIbits\fR\fR .ad .RS 11n -.rt Sets the upper limit (in bits) for common substring codes. \fIbits\fR must be between 9 and 16 (16 is the default). Lowering the number of bits result in larger, less compressed files. @@ -93,12 +91,10 @@ larger, less compressed files. .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad .RS 11n -.rt Writes to the standard output; no files are changed and no \fB\&.Z\fR files are created. The behavior of \fBzcat\fR is identical to that of `\fBuncompress\fR \fB-c\fR'. @@ -106,12 +102,10 @@ created. The behavior of \fBzcat\fR is identical to that of `\fBuncompress\fR .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 11n -.rt When compressing, forces compression of \fIfile\fR, even if it does not actually reduce the size of the file, or if the corresponding \fIfile\fR\fB\&.Z\fR file already exists. @@ -128,24 +122,20 @@ standard error and exits with a status greater than \fB0\fR. .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 11n -.rt Verbose. Writes to standard error messages concerning the percentage reduction or expansion of each file. .RE .sp .ne 2 -.mk .na \fB\fB-/\fR\fR .ad .RS 11n -.rt When compressing or decompressing, copies any extended system attributes associated with the source file to the target file and copies any extended system attributes associated with extended attributes of the source file to the @@ -161,12 +151,10 @@ diagnostic is written to \fBstderr\fR, and the final exit status is The following operand is supported: .sp .ne 2 -.mk .na \fB\fIfile\fR\fR .ad .RS 8n -.rt A path name of a file to be compressed by \fBcompress\fR, uncompressed by \fBuncompress\fR, or whose uncompressed form is written to standard out by \fBzcat\fR. If \fIfile\fR is \fB\(mi\fR, or if no \fIfile\fR is specified, the @@ -202,46 +190,38 @@ expression defined for the \fByesexpr\fR. See \fBlocale\fR(5). The following error values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 6n -.rt An error occurred. .RE .sp .ne 2 -.mk .na \fB\fB2\fR\fR .ad .RS 6n -.rt One or more files were not compressed because they would have increased in size (and the \fB-f\fR option was not specified). .RE .sp .ne 2 -.mk .na \fB\fB>2\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -253,17 +233,16 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityCommitted +Interface Stability Committed _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .SH SEE ALSO @@ -275,7 +254,6 @@ StandardSee \fBstandards\fR(5). .SH DIAGNOSTICS .sp .ne 2 -.mk .na \fBUsage: \fBcompress [-fv/] [-b\fR \fIbits\fR] [\fIfile\fR\|.\|.\|. ]\fR .ad @@ -290,7 +268,6 @@ Invalid options were specified on the command line. .sp .ne 2 -.mk .na \fBUsage: \fBuncompress [-fv] [-c | -/] [\fR\fIfile\fR\fB]...\fR\fR .ad @@ -301,7 +278,6 @@ Invalid options were specified on the command line. .sp .ne 2 -.mk .na \fBMissing maxbits\fR .ad @@ -312,7 +288,6 @@ Maxbits must follow \fB-b\fR, or invalid maxbits, not a numeric value. .sp .ne 2 -.mk .na \fB\fIfile\fR: not in compressed format\fR .ad @@ -323,7 +298,6 @@ The file specified to \fBuncompress\fR has not been compressed. .sp .ne 2 -.mk .na \fB\fIfile\fR: compressed with \fIxx\fRbits, can only handle \fIyy\fRbits\fR .ad @@ -336,7 +310,6 @@ than the compress code on this machine. Recompress the file with smaller .sp .ne 2 -.mk .na \fB\fIfile\fR: already has .\|Z suffix -- no change\fR .ad @@ -347,7 +320,6 @@ The file is assumed to be already compressed. Rename the file and try again. .sp .ne 2 -.mk .na \fB\fIfile\fR: already exists; do you wish to overwrite (y or n)?\fR .ad @@ -358,7 +330,6 @@ Respond \fBy\fR if you want the output file to be replaced; \fBn\fR if not. .sp .ne 2 -.mk .na \fBuncompress: corrupt input\fR .ad @@ -370,7 +341,6 @@ is corrupted. .sp .ne 2 -.mk .na \fBCompression:\fIxx.xx\fR\fB%\fR\fR .ad @@ -381,7 +351,6 @@ Percentage of the input saved by compression. (Relevant only for \fB-v\fR.) .sp .ne 2 -.mk .na \fB- - not a regular file: unchanged\fR .ad @@ -393,7 +362,6 @@ unaltered. .sp .ne 2 -.mk .na \fB- - has \fIxx\fR other links: unchanged\fR .ad @@ -405,7 +373,6 @@ information. .sp .ne 2 -.mk .na \fB- - file unchanged\fR .ad @@ -416,7 +383,6 @@ No savings are achieved by compression. The input remains uncompressed. .sp .ne 2 -.mk .na \fB- -filename too long to tack on .Z\fR .ad @@ -427,7 +393,6 @@ The path name is too long to append the \fB\&.Z\fR suffix. .sp .ne 2 -.mk .na \fB- -cannot preserve extended attributes. file unchanged\fR .ad diff --git a/usr/src/man/man1/cp.1 b/usr/src/man/man1/cp.1 index bda0189e11..727b443ac8 100644 --- a/usr/src/man/man1/cp.1 +++ b/usr/src/man/man1/cp.1 @@ -2,14 +2,14 @@ .\" Copyright (c) 1992, X/Open Company Limited All Rights Reserved .\" Copyright 1989 AT&T .\" Portions Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 cp 1 "30 Oct 2007" "SunOS 5.11" "User Commands" +.TH CP 1 "Oct 30, 2007" .SH NAME cp \- copy files .SH SYNOPSIS @@ -91,24 +91,20 @@ The following options are supported for both \fB/usr/bin/cp\fR and \fB/usr/xpg4/bin/cp\fR: .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 6n -.rt Unlink. If a file descriptor for a destination file cannot be obtained, this option attempts to unlink the destination file and proceed. .RE .sp .ne 2 -.mk .na \fB\fB-H\fR\fR .ad .RS 6n -.rt Takes actions based on the type and contents of the file referenced by any symbolic link specified as a \fIsource_file\fR operand. .sp @@ -120,12 +116,10 @@ preserved. .sp .ne 2 -.mk .na \fB\fB-i\fR\fR .ad .RS 6n -.rt Interactive. \fBcp\fR prompts for confirmation whenever the copy would overwrite an existing \fItarget\fR. An affirmative response means that the copy should proceed. Any other answer prevents \fBcp\fR from overwriting @@ -134,12 +128,10 @@ should proceed. Any other answer prevents \fBcp\fR from overwriting .sp .ne 2 -.mk .na \fB\fB-L\fR\fR .ad .RS 6n -.rt Takes actions based on the type and contents of the file referenced by any symbolic link specified as a \fIsource_file\fR operand or any symbolic links encountered during traversal of a file hierarchy. @@ -150,12 +142,10 @@ traversal of a file hierarchy are not preserved. .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 6n -.rt Preserve. The \fBcp\fR utility duplicates not only the contents of \fIsource_file\fR, but also attempts to preserve its ACL, access and modification times, extended attributes, extended system attributes, file mode, @@ -174,12 +164,10 @@ a \fBnon-zero\fR exit status. .sp .ne 2 -.mk .na \fB\fB-P\fR\fR .ad .RS 6n -.rt Takes actions on any symbolic link specified as a \fIsource_file\fR operand or any symbolic link encountered during traversal of a file hierarchy. .sp @@ -189,12 +177,10 @@ hierarchy are preserved. .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 6n -.rt Recursive. \fBcp\fR copies the directory and all its files, including any subdirectories and their files to \fItarget\fR. Unless the \fB-H\fR, \fB-L\fR, or \fB-P\fR option is specified, the \fB-L\fR option is used as the default @@ -203,35 +189,29 @@ mode. .sp .ne 2 -.mk .na \fB\fB-R\fR\fR .ad .RS 6n -.rt Same as \fB-r\fR, except pipes are replicated, not read from. .RE .sp .ne 2 -.mk .na \fB\fB-@\fR\fR .ad .RS 6n -.rt Preserves extended attributes. \fBcp\fR attempts to copy all of the source file's extended attributes along with the file data to the destination file. .RE .sp .ne 2 -.mk .na \fB\fB-/\fR\fR .ad .RS 6n -.rt Preserves extended attributes and extended system attributes. Along with the file's data, the \fBcp\fR utility attempts to copy extended attributes and extended system attributes from each source file, and extended system @@ -291,46 +271,38 @@ preserved. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIsource_file\fR\fR .ad .RS 15n -.rt A pathname of a regular file to be copied. .RE .sp .ne 2 -.mk .na \fB\fIsource_dir\fR\fR .ad .RS 15n -.rt A pathname of a directory to be copied. .RE .sp .ne 2 -.mk .na \fB\fItarget_file\fR\fR .ad .RS 15n -.rt A pathname of an existing or non-existing file, used for the output when a single file is copied. .RE .sp .ne 2 -.mk .na \fB\fItarget\fR\fR .ad .RS 15n -.rt A pathname of a directory to contain the copied files. .RE @@ -433,7 +405,7 @@ $ ls -/c file1 -rw-r--r-- 1 foo staff 0 Oct 29 20:04 file1 {AH-----m--} -$ cp -/ file1 /tmp +$ cp -/ file1 /tmp cp: Failed to copy extended system attributes from file1 to /tmp/file1 @@ -466,23 +438,19 @@ expression defined for the \fByesexpr\fR. See \fBlocale\fR(5). The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt All files were copied successfully. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -495,15 +463,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityCommitted +Interface Stability Committed .TE .SS "/usr/xpg4/bin/cp" @@ -511,15 +478,14 @@ Interface StabilityCommitted .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityCommitted +Interface Stability Committed .TE .SH SEE ALSO diff --git a/usr/src/man/man1/cpio.1 b/usr/src/man/man1/cpio.1 index dbd0bdd191..25506950c1 100644 --- a/usr/src/man/man1/cpio.1 +++ b/usr/src/man/man1/cpio.1 @@ -10,19 +10,19 @@ .\" 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 cpio 1 "3 Aug 2009" "SunOS 5.11" "User Commands" +.TH CPIO 1 "Aug 3, 2009" .SH NAME cpio \- copy file archives in and out .SH SYNOPSIS .LP .nf -\fBcpio\fR \fB-i\fR [\fB-bBcdfkmPrsStuvV6@/\fR] [\fB-C\fR \fIbufsize\fR] [\fB-E\fR \fIfile\fR] +\fBcpio\fR \fB-i\fR [\fB-bBcdfkmPrsStuvV6@/\fR] [\fB-C\fR \fIbufsize\fR] [\fB-E\fR \fIfile\fR] [\fB-H\fR \fIheader\fR] [\fB-I\fR \fI\fR [\fB-M\fR \fImessage\fR]] [\fB-R\fR \fIid\fR] [\fIpattern\fR]... .fi .LP .nf -\fBcpio\fR \fB-o\fR [\fB-aABcLPvV@/\fR] [\fB-C\fR \fIbufsize\fR] [\fB-H\fR \fIheader\fR] +\fBcpio\fR \fB-o\fR [\fB-aABcLPvV@/\fR] [\fB-C\fR \fIbufsize\fR] [\fB-H\fR \fIheader\fR] [\fB-O\fR \fIfile\fR [\fB-M\fR \fImessage\fR]] .fi @@ -107,36 +107,30 @@ proceed while you are changing the floppies. Press RETURN to cause the The following options are supported: .sp .ne 2 -.mk .na \fB\fB-i\fR\fR .ad .RS 6n -.rt (copy in) Reads an archive from the standard input and conditionally extracts the files contained in it and places them into the current directory tree. .RE .sp .ne 2 -.mk .na \fB\fB-o\fR\fR .ad .RS 6n -.rt (copy out) Reads a list of file path names from the standard input and copies those files to the standard output in the form of a \fBcpio\fR archive. .RE .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 6n -.rt (pass) Reads a list of file path names from the standard input and conditionally copies those files into the destination directory tree. .RE @@ -147,12 +141,10 @@ The following options can be appended in any sequence to the \fB-i\fR, \fB-o\fR, or \fB-p\fR options: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 14n -.rt Resets access times of input files after they have been copied, making \fBcpio\fR's access invisible. Access times are not reset for linked files when \fBcpio\fR \fB-pla\fR is specified. @@ -160,12 +152,10 @@ Resets access times of input files after they have been copied, making .sp .ne 2 -.mk .na \fB\fB-A\fR\fR .ad .RS 14n -.rt Appends files to an archive. The \fB-A\fR option requires the \fB-O\fR option. Valid only with archives that are files, or that are on floppy diskettes or hard disk partitions. The effect on files that are linked in the existing @@ -174,24 +164,20 @@ portion of the archive is unpredictable. .sp .ne 2 -.mk .na \fB\fB-b\fR\fR .ad .RS 14n -.rt Reverses the order of the bytes within each word. Use only with the \fB-i\fR option. .RE .sp .ne 2 -.mk .na \fB\fB-B\fR\fR .ad .RS 14n -.rt Blocks input/output 5120 bytes to the record. The default buffer size is 8192 bytes when this and the \fB-C\fR options are not used. \fB-B\fR does not apply to the \fB-p\fR (pass) option. @@ -199,12 +185,10 @@ to the \fB-p\fR (pass) option. .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad .RS 14n -.rt Reads or writes header information in \fBASCII\fR character form for portability. There are no \fBUID\fR or \fBGID\fR restrictions associated with this header format. Use this option between SVR4-based machines, or the @@ -217,12 +201,10 @@ Solaris 2.6 Operating environment or compatible versions, use \fB-H\fR .sp .ne 2 -.mk .na \fB\fB-C\fR \fIbufsize\fR\fR .ad .RS 14n -.rt Blocks input/output \fIbufsize\fR bytes to the record, where \fIbufsize\fR is replaced by a positive integer. The default buffer size is 8192 bytes when this and \fB-B\fR options are not used. \fB-C\fR does not apply to the \fB-p\fR @@ -231,47 +213,39 @@ and \fB-B\fR options are not used. \fB-C\fR does not apply to the \fB-p\fR .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad .RS 14n -.rt Creates directories as needed. .RE .sp .ne 2 -.mk .na \fB\fB-E\fR \fIfile\fR\fR .ad .RS 14n -.rt Specifies an input file (\fIfile\fR) that contains a list of filenames to be extracted from the archive (one filename per line). .RE .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 14n -.rt Copies in all files except those in \fIpattern\fRs. See OPERANDS for a description of \fIpattern\fR. .RE .sp .ne 2 -.mk .na \fB\fB-H\fR \fIheader\fR\fR .ad .RS 14n -.rt Reads or writes header information in \fIheader\fR format. Always use this option or the \fB-c\fR option when the origin and the destination machines are different types. This option is mutually exclusive with options \fB-c\fR and @@ -280,23 +254,19 @@ different types. This option is mutually exclusive with options \fB-c\fR and Valid values for \fIheader\fR are: .sp .ne 2 -.mk .na \fB\fBbar\fR\fR .ad .RS 17n -.rt \fBbar\fR head and format. Used only with the \fB-i\fR option ( read only). .RE .sp .ne 2 -.mk .na \fB\fBcrc\fR | \fBCRC\fR\fR .ad .RS 17n -.rt \fBASCII\fR header with expanded device numbers and an additional per-file checksum. There are no \fBUID\fR or \fBGID\fR restrictions associated with this header format. @@ -304,12 +274,10 @@ header format. .sp .ne 2 -.mk .na \fB\fBodc\fR\fR .ad .RS 17n -.rt \fBASCII\fR header with small device numbers. This is the IEEE/P1003 Data Interchange Standard cpio header and format. It has the widest range of portability of any of the header formats. It is the official format for @@ -321,12 +289,10 @@ header. .sp .ne 2 -.mk .na \fB\fBtar\fR | \fBTAR\fR\fR .ad .RS 17n -.rt \fBtar\fR header and format. This is an older \fBtar\fR header format that allows \fBUID\fRs and \fBGID\fRs up to 2097151 to be stored in the header. It is provided for the reading of legacy archives only, that is, in conjunction @@ -339,12 +305,10 @@ must be read using \fB-H\fR \fBustar\fR. .sp .ne 2 -.mk .na \fB\fBustar\fR | \fBUSTAR\fR\fR .ad .RS 17n -.rt IEEE/P1003 Data Interchange Standard tar header and format. This header format allows \fBUID\fRs and \fBGID\fRs up to 2097151 to be stored in the header. .RE @@ -357,12 +321,10 @@ file (8 Gb \(em 1 byte), the header format can be \fBtar|TAR\fR, .sp .ne 2 -.mk .na \fB\fB-I\fR \fIfile\fR\fR .ad .RS 14n -.rt Reads the contents of \fIfile\fR as an input archive, instead of the standard input. If \fIfile\fR is a character special device, and the current medium has been completely read, replace the medium and press RETURN to continue to the @@ -371,12 +333,10 @@ next medium. This option is used only with the \fB-i\fR option. .sp .ne 2 -.mk .na \fB\fB-k\fR\fR .ad .RS 14n -.rt Attempts to skip corrupted file headers and I/O errors that might be encountered. If you want to copy files from a medium that is corrupted or out of sequence, this option lets you read only those files with good headers. For @@ -388,12 +348,10 @@ smaller archive's trailer is encountered. Use only with the \fB-i\fR option. .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 14n -.rt In pass mode, makes hard links between the source and destination whenever possible. If the \fB-L\fR option is also specified, the hard link is to the file referred to by the symbolic link. Otherwise, the hard link is to the @@ -402,12 +360,10 @@ symbolic link itself. Use only with the \fB-p\fR option. .sp .ne 2 -.mk .na \fB\fB-L\fR\fR .ad .RS 14n -.rt Follows symbolic links. If a symbolic link to a directory is encountered, archives the directory referred to by the link, using the name of the link. Otherwise, archives the file referred to by the link, using the name of the @@ -416,24 +372,20 @@ link. .sp .ne 2 -.mk .na \fB\fB-m\fR\fR .ad .RS 14n -.rt Retains previous file modification time. This option is ineffective on directories that are being copied. .RE .sp .ne 2 -.mk .na \fB\fB-M\fR \fImessage\fR\fR .ad .RS 14n -.rt Defines a \fImessage\fR to use when switching media. When you use the \fB-O\fR or \fB-I\fR options and specify a character special device, you can use this option to define the message that is printed when you reach the end of the @@ -443,12 +395,10 @@ number of the next medium needed to continue. .sp .ne 2 -.mk .na \fB\fB-O\fR \fIfile\fR\fR .ad .RS 14n -.rt Directs the output of \fBcpio\fR to \fIfile\fR, instead of the standard output. If \fIfile\fR is a character special device and the current medium is full, replace the medium and type a carriage return to continue to the next medium. @@ -457,12 +407,10 @@ Use only with the \fB-o\fR option. .sp .ne 2 -.mk .na \fB\fB-P\fR\fR .ad .RS 14n -.rt Preserves \fBACL\fRs. If the option is used for output, existing \fBACL\fRs are written along with other attributes, except for extended attributes, to the standard output. \fBACL\fRs are created as special files with a special file @@ -476,12 +424,10 @@ systems, and hence is not portable. Use \fBASCII\fR headers for portability. .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 14n -.rt Interactively renames files. If the user types a carriage return alone, the file is skipped. If the user types a ``.'', the original pathname is retained. Not available with \fBcpio\fR \fB-p\fR. @@ -489,12 +435,10 @@ Not available with \fBcpio\fR \fB-p\fR. .sp .ne 2 -.mk .na \fB\fB-R\fR \fIid\fR\fR .ad .RS 14n -.rt Reassigns ownership and group information for each file to user ID. (ID must be a valid login ID from the \fBpasswd\fR database.) This option is valid only when id is the invoking user or the super-user. See \fBNOTES\fR. @@ -502,34 +446,28 @@ when id is the invoking user or the super-user. See \fBNOTES\fR. .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 14n -.rt Swaps bytes within each half word. .RE .sp .ne 2 -.mk .na \fB\fB-S\fR\fR .ad .RS 14n -.rt Swaps halfwords within each word. .RE .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad .RS 14n -.rt Prints a table of contents of the input. If any file in the table of contents has extended attributes, these are also listed. No files are created. \fB-t\fR and \fB-V\fR are mutually exclusive. @@ -537,24 +475,20 @@ and \fB-V\fR are mutually exclusive. .sp .ne 2 -.mk .na \fB\fB-u\fR\fR .ad .RS 14n -.rt Copies unconditionally. Normally, an older file is not replaced a newer file with the same name, although an older directory updates a newer directory. .RE .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 14n -.rt Verbose. Prints a list of file and extended attribute names. When used with the \fB-t\fR option, the table of contents looks like the output of an \fBls\fR \fB-l\fR command (see \fBls\fR(1)). @@ -562,36 +496,30 @@ Verbose. Prints a list of file and extended attribute names. When used with the .sp .ne 2 -.mk .na \fB\fB-V\fR\fR .ad .RS 14n -.rt Special verbose. Prints a dot for each file read or written. Useful to assure the user that \fBcpio\fR is working without printing out all file names. .RE .sp .ne 2 -.mk .na \fB\fB-6\fR\fR .ad .RS 14n -.rt Processes a UNIX System Sixth Edition archive format file. Use only with the \fB-i\fR option. This option is mutually exclusive with \fB-c\fR and \fB-H\fR. .RE .sp .ne 2 -.mk .na \fB\fB-@\fR\fR .ad .RS 14n -.rt Includes extended attributes in archive. By default, \fBcpio\fR does not place extended attributes in the archive. With this flag, \fBcpio\fR looks for extended attributes on the files to be placed in the archive and add them, as @@ -605,12 +533,10 @@ explicitly extract attribute records are ignored. .sp .ne 2 -.mk .na \fB\fB-/\fR\fR .ad .RS 14n -.rt Includes extended system attributes in archive. By default, \fBcpio\fR does not place extended system attributes in the archive. With this flag, \fBcpio\fR looks for extended system attributes on the files to be placed in the archive @@ -628,57 +554,47 @@ extract. Attempts to explicitly extract attribute records are ignored. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIdirectory\fR\fR .ad .RS 13n -.rt A path name of an existing directory to be used as the target of \fBcpio\fR \fB-p\fR. .RE .sp .ne 2 -.mk .na \fB\fIpattern\fR\fR .ad .RS 13n -.rt Expressions making use of a pattern-matching notation similar to that used by the shell (see \fBsh\fR(1)) for filename pattern matching, and similar to regular expressions. The following metacharacters are defined: .sp .ne 2 -.mk .na \fB\fB*\fR\fR .ad .RS 9n -.rt Matches any string, including the empty string. .RE .sp .ne 2 -.mk .na \fB\fB?\fR\fR .ad .RS 9n -.rt Matches any single character. .RE .sp .ne 2 -.mk .na \fB\fB[...]\fR\fR .ad .RS 9n -.rt Matches any one of the enclosed characters. A pair of characters separated by `\(mi' matches any symbol between the pair (inclusive), as defined by the system default collating sequence. If the first character following the opening @@ -687,12 +603,10 @@ system default collating sequence. If the first character following the opening .sp .ne 2 -.mk .na \fB\fB!\fR\fR .ad .RS 9n -.rt The ! (exclamation point) means \fInot\fR. For example, the \fB!abc*\fR pattern would exclude all files that begin with \fBabc\fR. .RE @@ -795,12 +709,10 @@ that affect the execution of \fBcpio\fR: \fBLC_COLLATE\fR, \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, \fBLC_TIME\fR, \fBTZ\fR, and \fBNLSPATH\fR. .sp .ne 2 -.mk .na \fB\fBTMPDIR\fR\fR .ad .RS 10n -.rt \fBcpio\fR creates its temporary file in \fB/var/tmp\fR by default. Otherwise, it uses the directory specified by \fBTMPDIR\fR. .RE @@ -811,23 +723,19 @@ it uses the directory specified by \fBTMPDIR\fR. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -839,15 +747,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityCommitted +Interface Stability Committed .TE .SH SEE ALSO @@ -867,16 +774,14 @@ supported archive header type. .sp .TS -tab(); -cw(1.83i) cw(1.83i) cw(1.83i) -lw(1.83i) lw(1.83i) lw(1.83i) -. -Header typeCommand line optionsMaximum path name length -BINARY"\fB-o\fR"256 -POSIX"\fB-oH\fR odc"256 -ASCII"\fB-oc\fR"1023 -CRC"\fB-oH\fR crc"1023 -USTAR"\fB-oH\fR ustar"255 +c c c +l l l . +Header type Command line options Maximum path name length +BINARY "\fB-o\fR" 256 +POSIX "\fB-oH\fR odc" 256 +ASCII "\fB-oc\fR" 1023 +CRC "\fB-oH\fR crc" 1023 +USTAR "\fB-oH\fR ustar" 255 .TE .sp diff --git a/usr/src/man/man1/cputrack.1 b/usr/src/man/man1/cputrack.1 index 5c9d516127..d4c3aebb36 100644 --- a/usr/src/man/man1/cputrack.1 +++ b/usr/src/man/man1/cputrack.1 @@ -3,19 +3,19 @@ .\" 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 cputrack 1 "19 Apr 2004" "SunOS 5.11" "User Commands" +.TH CPUTRACK 1 "Apr 19, 2004" .SH NAME cputrack \- monitor process and LWP behavior using CPU performance counters .SH SYNOPSIS .LP .nf -\fBcputrack\fR \fB-c\fR \fIeventspec\fR [\fB-c\fR \fIeventspec\fR]... [\fB-efntvD\fR] +\fBcputrack\fR \fB-c\fR \fIeventspec\fR [\fB-c\fR \fIeventspec\fR]... [\fB-efntvD\fR] [\fB-N\fR \fIcount\fR] [\fB-o\fR \fIpathname\fR] [\fB-T\fR \fIinterval\fR] \fIcommand\fR [\fIargs\fR] .fi .LP .nf -\fBcputrack\fR \fB-c\fR \fIeventspec\fR [\fB-c\fR \fIeventspec\fR]... \fB-p\fR \fIpid\fR [\fB-efntvD\fR] +\fBcputrack\fR \fB-c\fR \fIeventspec\fR [\fB-c\fR \fIeventspec\fR]... \fB-p\fR \fIpid\fR [\fB-efntvD\fR] [\fB-N\fR \fIcount\fR] [\fB-o\fR \fIpathname\fR] [\fB-T\fR \fIinterval\fR] .fi @@ -48,12 +48,10 @@ executables cannot be tracked. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-c\fR \fIeventspec\fR\fR .ad .RS 16n -.rt Specifies a set of events for the \fBCPU\fR performance counters to monitor. The syntax of these event specifications is: .sp @@ -85,117 +83,97 @@ between the different event settings on each sample. .sp .ne 2 -.mk .na \fB\fB-D\fR\fR .ad .RS 16n -.rt Enables debug mode. .RE .sp .ne 2 -.mk .na \fB\fB-e\fR\fR .ad .RS 16n -.rt Follows all \fBexec\fR(2), or \fBexecve\fR(2) system calls. .RE .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 16n -.rt Follows all children created by \fBfork\fR(2), \fBfork1\fR(2), or \fBvfork\fR(2) system calls. .RE .sp .ne 2 -.mk .na \fB\fB-h\fR\fR .ad .RS 16n -.rt Prints an extended help message on how to use the utility, how to program the processor-dependent counters, and where to look for more detailed information. .RE .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 16n -.rt Omits all header output (useful if \fBcputrack\fR is the beginning of a pipeline). .RE .sp .ne 2 -.mk .na \fB\fB-N\fR \fIcount\fR\fR .ad .RS 16n -.rt Specifies the maximum number of \fBCPU\fR performance counter samples to take before exiting. .RE .sp .ne 2 -.mk .na \fB\fB-o\fR \fIoutfile\fR\fR .ad .RS 16n -.rt Specifies file to be used for the \fBcputrack\fR output. .RE .sp .ne 2 -.mk .na \fB\fB-p\fR \fIpid\fR\fR .ad .RS 16n -.rt Interprets the argument as the process \fBID\fR of an existing process to which process counter context should be attached and monitored. .RE .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad .RS 16n -.rt Prints an additional column of processor cycle counts, if available on the current architecture. .RE .sp .ne 2 -.mk .na \fB\fB-T\fR \fIinterval\fR\fR .ad .RS 16n -.rt Specifies the interval between \fBCPU\fR performance counter samples in seconds. Very small intervals may cause some samples to be skipped. See WARNINGS. @@ -203,12 +181,10 @@ WARNINGS. .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 16n -.rt Enables more verbose output. .RE @@ -293,7 +269,7 @@ command. .in +2 .nf example% \fBcputrack -c pic0=Cycle_cnt,pic1=Instr_cnt sleep 10\fR - + time lwp event pic0 pic1 1.007 1 tick 765308 219233 @@ -303,7 +279,7 @@ example% \fBcputrack -c pic0=Cycle_cnt,pic1=Instr_cnt sleep 10\fR 8.007 1 tick 0 0 10.007 1 tick 0 0 10.017 1 exit 844703 228058 - + .fi .in -2 .sp @@ -322,28 +298,28 @@ where there are no ambiguities. .in +2 .nf example% \fBcputrack -fev -c EC_ref,EC_hit /bin/ulimit -c\fR - + time pid lwp event pic0 pic1 -0.007 101142 1 init_lwp 805286 20023 +0.007 101142 1 init_lwp 805286 20023 0.023 101142 1 fork # 101143 -0.026 101143 1 init_lwp 1015382 24461 -0.029 101143 1 fini_lwp 1025546 25074 -0.029 101143 1 exec 1025546 25074 +0.026 101143 1 init_lwp 1015382 24461 +0.029 101143 1 fini_lwp 1025546 25074 +0.029 101143 1 exec 1025546 25074 0.000 101143 1 exec \e - # '/usr/bin/sh /usr/bin/basename\e + # '/usr/bin/sh /usr/bin/basename\e /bin/ulimit' -0.039 101143 1 init_lwp 1025546 25074 -0.050 101143 1 fini_lwp 1140482 27806 -0.050 101143 1 exec 1140482 27806 +0.039 101143 1 init_lwp 1025546 25074 +0.050 101143 1 fini_lwp 1140482 27806 +0.050 101143 1 exec 1140482 27806 0.000 101143 1 exec # '/usr/bin/expr \e //bin/ulimit : \(.*[^/]\)/*$ : .*/\(..*\) : \(.*\)$ | //bin/ulimi' -0.059 101143 1 init_lwp 1140482 27806 -0.075 101143 1 fini_lwp 1237647 30207 -0.075 101143 1 exit 1237647 30207 +0.059 101143 1 init_lwp 1140482 27806 +0.075 101143 1 fini_lwp 1237647 30207 +0.075 101143 1 exit 1237647 30207 unlimited -0.081 101142 1 fini_lwp 953383 23814 -0.081 101142 1 exit 953383 23814 +0.081 101142 1 fini_lwp 953383 23814 +0.081 101142 1 exit 953383 23814 .fi .in -2 .sp @@ -360,7 +336,7 @@ in the kernel to print the date on a Pentium III machine: .in +2 .nf example% \fBcputrack -c inst_retired,inst_retired,nouser1,sys1 date\fR - + time lwp event pic0 pic1 Fri Aug 20 20:03:08 PDT 1999 @@ -380,7 +356,7 @@ on a Pentium 4 machine: .in +2 .nf example% \fBcputrack -c ITLB_reference,emask=1 date\fR - + time lwp event pic0 Fri Aug 20 20:03:08 PDT 1999 @@ -425,12 +401,11 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE -Interface StabilityEvolving +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE +Interface Stability Evolving .TE .SH SEE ALSO diff --git a/usr/src/man/man1/crle.1 b/usr/src/man/man1/crle.1 index 5fc482b69d..ae99469e5d 100644 --- a/usr/src/man/man1/crle.1 +++ b/usr/src/man/man1/crle.1 @@ -3,14 +3,14 @@ .\" 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 crle 1 "6 Oct 2008" "SunOS 5.11" "User Commands" +.TH CRLE 1 "Oct 6, 2008" .SH NAME crle \- configure runtime linking environment .SH SYNOPSIS .LP .nf -\fBcrle\fR [\fB-64\fR] [\fB-a\fR \fIname\fR] [\fB-A\fR \fIname\fR] [\fB-c\fR \fIconf\fR] [\fB-e\fR \fIenv\fR] [\fB-E\fR \fIenv\fR] - [\fB-f\fR \fIflags\fR] [\fB-i\fR \fIname\fR] [\fB-I\fR \fIname\fR] [\fB-g\fR \fIname\fR] [\fB-G\fR \fIname\fR] +\fBcrle\fR [\fB-64\fR] [\fB-a\fR \fIname\fR] [\fB-A\fR \fIname\fR] [\fB-c\fR \fIconf\fR] [\fB-e\fR \fIenv\fR] [\fB-E\fR \fIenv\fR] + [\fB-f\fR \fIflags\fR] [\fB-i\fR \fIname\fR] [\fB-I\fR \fIname\fR] [\fB-g\fR \fIname\fR] [\fB-G\fR \fIname\fR] [\fB-l\fR \fIdir\fR] [\fB-o\fR \fIdir\fR] [\fB-s\fR \fIdir\fR] [\fB-t\fR [ ELF | AOUT]] [\fB-u\fR] [\fB-v\fR] .fi @@ -62,7 +62,6 @@ experimentation. A configuration file can contain the following information. .sp .ne 2 -.mk .na \fBDefault Search Paths\fR .ad @@ -79,7 +78,6 @@ any system default. See the \fB-l\fR and \fB-u\fR options. .sp .ne 2 -.mk .na \fBTrusted Directories\fR .ad @@ -97,7 +95,6 @@ be augmented with any system defaults. See the \fB-s\fR and \fB-u\fR options. .sp .ne 2 -.mk .na \fBEnvironment Variables\fR .ad @@ -109,7 +106,6 @@ within the configuration file. .sp .ne 2 -.mk .na \fBDirectory Cache\fR .ad @@ -122,7 +118,6 @@ overhead of searching for application dependencies. .sp .ne 2 -.mk .na \fBAlternative Objects\fR .ad @@ -193,7 +188,6 @@ option, or default to \fBRTLD_REL_RELATIVE\fR. The following options are supported. .sp .ne 2 -.mk .na \fB\fB-64\fR\fR .ad @@ -205,7 +199,6 @@ create a 64-bit specific configuration file. .sp .ne 2 -.mk .na \fB\fB-a\fR \fIname\fR\fR .ad @@ -224,7 +217,6 @@ Typically, this option is used with the \fB-o\fR option. .sp .ne 2 -.mk .na \fB\fB-A\fR \fIname\fR\fR .ad @@ -243,7 +235,6 @@ Typically, this option is used with the \fB-o\fR option. .sp .ne 2 -.mk .na \fB\fB-c\fR \fIconf\fR\fR .ad @@ -255,7 +246,6 @@ supplied, the default configuration file is used. .sp .ne 2 -.mk .na \fB\fB-e\fR \fIenv\fR\fR .ad @@ -278,7 +268,6 @@ removed by the process environment at runtime. .sp .ne 2 -.mk .na \fB\fB-E\fR \fIenv\fR\fR .ad @@ -309,7 +298,6 @@ or removed by the process environment at runtime. .sp .ne 2 -.mk .na \fB\fB-f\fR \fIflags\fR\fR .ad @@ -325,7 +313,6 @@ the default flag is \fBRTLD_REL_RELATIVE\fR. .sp .ne 2 -.mk .na \fB\fB-i\fR \fIname\fR\fR .ad @@ -340,7 +327,6 @@ cache as a nonexistent directory. .sp .ne 2 -.mk .na \fB\fB-I\fR \fIname\fR\fR .ad @@ -355,7 +341,6 @@ manner, as the cache that is created is specific to this application. .sp .ne 2 -.mk .na \fB\fB-g\fR \fIname\fR\fR .ad @@ -371,7 +356,6 @@ directory, and its dependencies, are added to the cache. .sp .ne 2 -.mk .na \fB\fB-G\fR \fIname\fR\fR .ad @@ -387,7 +371,6 @@ specific to this application. .sp .ne 2 -.mk .na \fB\fB-l\fR \fIdir\fR\fR .ad @@ -415,7 +398,6 @@ before the new paths specified with the \fB-l\fR option. .sp .ne 2 -.mk .na \fB\fB-o\fR \fIdir\fR\fR .ad @@ -435,7 +417,6 @@ Typically, this option is used with the \fB-a\fR or \fB-A\fR options. .sp .ne 2 -.mk .na \fB\fB-s\fR \fIdir\fR\fR .ad @@ -465,7 +446,6 @@ added before the new directories specified with the \fB-l\fR option. .sp .ne 2 -.mk .na \fB\fB-t\fR \fBELF\fR | \fBAOUT\fR\fR .ad @@ -477,7 +457,6 @@ that follow. The default object type is \fBELF\fR. .sp .ne 2 -.mk .na \fB\fB-u\fR\fR .ad @@ -502,7 +481,6 @@ versions of Solaris. See NOTES. .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad @@ -573,7 +551,7 @@ objects. Configuration file [version 4]: /var/ld/ld.config Platform: 32-bit MSB SPARC Default Library Path (ELF): /lib:/usr/lib:/local/lib - Trusted Directories (ELF): /lib/secure:/usr/lib/secure \e + Trusted Directories (ELF): /lib/secure:/usr/lib/secure \e (system default) Command line: @@ -616,7 +594,7 @@ variable \fBLD_CONFIG\fR used to experiment with these files. .nf # \fBcrle -l /local/lib\fR # \fBdate\fR -ld.so.1: date: fatal: libc.so.1: open failed: \e +ld.so.1: date: fatal: libc.so.1: open failed: \e No such file or directory Killed # \fBLD_NOCONFIG=yes rm /var/ld/ld.config\fR @@ -872,7 +850,6 @@ to the result. .SH FILES .sp .ne 2 -.mk .na \fB\fB/var/ld/ld.config\fR\fR .ad @@ -883,7 +860,6 @@ Default configuration file for 32-bit applications. .sp .ne 2 -.mk .na \fB\fB/var/ld/64/ld.config\fR\fR .ad @@ -894,7 +870,6 @@ Default configuration file for 64-bit applications. .sp .ne 2 -.mk .na \fB\fB/var/tmp\fR\fR .ad @@ -905,7 +880,6 @@ Default location for temporary configuration file. See \fBtempnam\fR(3C). .sp .ne 2 -.mk .na \fB\fB/usr/lib/lddstub\fR\fR .ad @@ -916,7 +890,6 @@ Stub application that is employed to \fBdldump\fR(3C) 32-bit objects. .sp .ne 2 -.mk .na \fB\fB/usr/lib/64/lddstub\fR\fR .ad @@ -927,7 +900,6 @@ Stub application that is employed to \fBdldump\fR(3C) 64-bit objects. .sp .ne 2 -.mk .na \fB\fB/usr/lib/libcrle.so.1\fR\fR .ad @@ -938,7 +910,6 @@ Audit library that is employed to \fBdldump\fR(3C) 32-bit objects. .sp .ne 2 -.mk .na \fB\fB/usr/lib/64/libcrle.so.1\fR\fR .ad @@ -955,7 +926,6 @@ several environment variables affect the runtime linkers behavior in regard to the processing of configuration files that are created by \fBcrle\fR. .sp .ne 2 -.mk .na \fB\fBLD_CONFIG\fR, \fBLD_CONFIG_32\fR and \fBLD_CONFIG_64\fR\fR .ad @@ -966,7 +936,6 @@ Provide an alternative configuration file. .sp .ne 2 -.mk .na \fB\fBLD_NOCONFIG\fR, \fBLD_NOCONFIG_32\fR and \fBLD_NOCONFIG_64\fR\fR .ad @@ -977,7 +946,6 @@ Disable configuration file processing. .sp .ne 2 -.mk .na \fB\fBLD_NODIRCONFIG\fR, \fBLD_NODIRCONFIG_32\fR and \fBLD_NODIRCONFIG_64\fR\fR .ad @@ -988,7 +956,6 @@ Disable directory cache processing from a configuration file. .sp .ne 2 -.mk .na \fB\fBLD_NOENVCONFIG\fR, \fBLD_NOENVCONFIG_32\fR and \fBLD_NOENVCONFIG_64\fR\fR .ad @@ -999,7 +966,6 @@ Disable environment variable processing from a configuration file. .sp .ne 2 -.mk .na \fB\fBLD_NOOBJALTER\fR, \fBLD_NOOBJALTER_32\fR and \fBLD_NOOBJALTER_64\fR\fR .ad @@ -1016,13 +982,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes. .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed .TE .SH SEE ALSO diff --git a/usr/src/man/man1/crontab.1 b/usr/src/man/man1/crontab.1 index 310192421d..c93255f406 100644 --- a/usr/src/man/man1/crontab.1 +++ b/usr/src/man/man1/crontab.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 crontab 1 "6 Apr 2009" "SunOS 5.11" "User Commands" +.TH CRONTAB 1 "Apr 6, 2009" .SH NAME crontab \- user crontab file .SH SYNOPSIS @@ -239,7 +239,6 @@ any generated output or errors are mailed to you. The following variables are supported: .sp .ne 2 -.mk .na \fB\fBHOME\fR\fR .ad @@ -259,7 +258,6 @@ HOME=/var/tmp .sp .ne 2 -.mk .na \fB\fBSHELL\fR\fR .ad @@ -278,7 +276,6 @@ SHELL=/usr/bin/ksh .sp .ne 2 -.mk .na \fB\fBTZ\fR\fR .ad @@ -326,12 +323,10 @@ once, twice, or not at all. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-e\fR\fR .ad .RS 6n -.rt Edits a copy of the current user's \fBcrontab\fR file, or creates an empty file to edit if \fBcrontab\fR does not exist. When editing is complete, the file is installed as the user's \fBcrontab\fR file. @@ -352,12 +347,10 @@ done by root or by a user with the \fBsolaris.jobs.admin\fR authorization. .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 6n -.rt Lists the \fBcrontab\fR file for the invoking user. Only root or a user with the \fBsolaris.jobs.admin\fR authorization can specify a username following the \fB-l\fR option to list the \fBcrontab\fR file of the specified user. @@ -365,12 +358,10 @@ the \fBsolaris.jobs.admin\fR authorization can specify a username following the .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 6n -.rt Removes a user's \fBcrontab\fR from the \fBcrontab\fR directory. Only root or a user with the \fBsolaris.jobs.admin\fR authorization can specify a username following the \fB-r\fR option to remove the \fBcrontab\fR file of the specified @@ -387,7 +378,7 @@ This example cleans up \fBcore\fR files every weekday morning at 3:15 am: .sp .in +2 .nf -\fB15 3 * * 1-5 find $HOME\fR \fB-name\fR\fBcore 2>/dev/null | xargs rm\fR \fB-f\fR +\fB15 3 * * 1-5 find $HOME\fR \fB-name\fR\fBcore 2>/dev/null | xargs rm\fR \fB-f\fR .fi .in -2 .sp @@ -478,12 +469,10 @@ that affect the execution of \fBcrontab\fR: \fBLANG\fR, \fBLC_ALL\fR, .SS "\fB/usr/bin/crontab\fR" .sp .ne 2 -.mk .na \fB\fBEDITOR\fR\fR .ad .RS 10n -.rt Determine the editor to be invoked when the \fB-e\fR option is specified. This is overridden by the \fBVISUAL\fR environmental variable. The default editor is \fBvi\fR(1). @@ -491,24 +480,20 @@ is overridden by the \fBVISUAL\fR environmental variable. The default editor is .sp .ne 2 -.mk .na \fB\fBPATH\fR\fR .ad .RS 10n -.rt The \fBPATH\fR in \fBcrontab\fR's environment specifies the search path used to find the editor. .RE .sp .ne 2 -.mk .na \fB\fBVISUAL\fR\fR .ad .RS 10n -.rt Determine the visual editor to be invoked when the \fB-e\fR option is specified. If \fBVISUAL\fR is not specified, then the environment variable \fBEDITOR\fR is used. If that is not set, the default is \fBvi\fR(1). @@ -517,12 +502,10 @@ specified. If \fBVISUAL\fR is not specified, then the environment variable .SS "\fB/usr/xpg4/bin/crontab\fR" .sp .ne 2 -.mk .na \fB\fBEDITOR\fR\fR .ad .RS 10n -.rt Determine the editor to be invoked when the \fB-e\fR option is specified. The default editor is \fB/usr/xpg4/bin/vi\fR. .RE @@ -530,12 +513,10 @@ default editor is \fB/usr/xpg4/bin/vi\fR. .SS "\fB/usr/xpg6/bin/crontab\fR" .sp .ne 2 -.mk .na \fB\fBEDITOR\fR\fR .ad .RS 10n -.rt Determine the editor to be invoked when the \fB-e\fR option is specified. The default editor is \fB/usr/xpg6/bin/vi\fR. .RE @@ -546,90 +527,74 @@ default editor is \fB/usr/xpg6/bin/vi\fR. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB/etc/cron.d\fR\fR .ad .RS 28n -.rt main cron directory .RE .sp .ne 2 -.mk .na \fB\fB/etc/cron.d/cron.allow\fR\fR .ad .RS 28n -.rt list of allowed users .RE .sp .ne 2 -.mk .na \fB\fB/etc/default/cron\fR\fR .ad .RS 28n -.rt contains cron default settings .RE .sp .ne 2 -.mk .na \fB\fB/etc/cron.d/cron.deny\fR\fR .ad .RS 28n -.rt list of denied users .RE .sp .ne 2 -.mk .na \fB\fB/var/cron/log\fR\fR .ad .RS 28n -.rt accounting information .RE .sp .ne 2 -.mk .na \fB\fB/var/spool/cron/crontabs\fR\fR .ad .RS 28n -.rt spool area for \fBcrontab\fR .RE @@ -642,13 +607,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SS "\fB/usr/xpg4/bin/crontab\fR" @@ -656,13 +620,12 @@ Interface StabilityStandard .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SS "\fB/usr/xpg6/bin/crontab\fR" @@ -670,13 +633,12 @@ Interface StabilityStandard .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man1/crypt.1 b/usr/src/man/man1/crypt.1 index 85efa3f4ae..7621f1f099 100644 --- a/usr/src/man/man1/crypt.1 +++ b/usr/src/man/man1/crypt.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 crypt 1 "8 Mar 2005" "SunOS 5.11" "User Commands" +.TH CRYPT 1 "Mar 8, 2005" .SH NAME crypt \- encode or decode a file .SH SYNOPSIS @@ -25,7 +25,7 @@ with the same key: .in +2 .nf example% \fBcrypt key < clear.file > encrypted.file\fR -example% \fBcrypt key < encrypted.file | pr\fR +example% \fBcrypt key < encrypted.file | pr\fR .fi .in -2 .sp @@ -65,12 +65,10 @@ most vulnerable aspect of \fBcrypt\fR. .SH FILES .sp .ne 2 -.mk .na \fB\fB/dev/tty\fR\fR .ad .RS 12n -.rt for typed key .RE diff --git a/usr/src/man/man1/csh.1 b/usr/src/man/man1/csh.1 index f67546fb2c..3f6a480a05 100644 --- a/usr/src/man/man1/csh.1 +++ b/usr/src/man/man1/csh.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 csh 1 "27 Jul 2007" "SunOS 5.11" "User Commands" +.TH CSH 1 "Jul 27, 2007" .SH NAME csh \- shell command interpreter with a C-like syntax .SH SYNOPSIS @@ -68,12 +68,10 @@ known as a script. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-b\fR\fR .ad .RS 6n -.rt Forced a "break" from option processing. Subsequent command line arguments are not interpreted as C shell options. This allows the passing of options to a script without confusion. The shell does not run set-user-ID or set-group-ID @@ -82,12 +80,10 @@ scripts unless this option is present. .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad .RS 6n -.rt Executes the first \fIargument\fR, which must be present. Remaining arguments are placed in \fBargv\fR, the argument-list variable, and passed directly to \fBcsh\fR. @@ -95,70 +91,58 @@ are placed in \fBargv\fR, the argument-list variable, and passed directly to .sp .ne 2 -.mk .na \fB\fB-e\fR\fR .ad .RS 6n -.rt Exits if a command terminates abnormally or yields a nonzero exit status. .RE .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 6n -.rt Fast start. Reads neither the \fB\&.cshrc\fR file, nor the \fB\&.login\fR file (if a login shell) upon startup. .RE .sp .ne 2 -.mk .na \fB\fB-i\fR\fR .ad .RS 6n -.rt Forced interactive. Prompts for command line input, even if the standard input does not appear to be a terminal (character-special device). .RE .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 6n -.rt Parses (interprets), but does not execute commands. This option can be used to check C shell scripts for syntax errors. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 6n -.rt Takes commands from the standard input. .RE .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad .RS 6n -.rt Reads and executes a single command line. A `\fB\e\fR\&' (backslash) can be used to escape each newline for continuation of the command line onto subsequent input lines. @@ -166,12 +150,10 @@ subsequent input lines. .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 6n -.rt Verbose. Sets the \fBverbose\fR predefined variable. Command input is echoed after history substitution, but before other substitutions and before execution. @@ -179,35 +161,29 @@ execution. .sp .ne 2 -.mk .na \fB\fB-V\fR\fR .ad .RS 6n -.rt Sets \fBverbose\fR before reading \fB\&.cshrc\fR. .RE .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad .RS 6n -.rt Echo. Sets the \fBecho\fR variable. Echoes commands after all substitutions and just before execution. .RE .sp .ne 2 -.mk .na \fB\fB-X\fR\fR .ad .RS 6n -.rt Sets \fBecho\fR before reading \fB\&.cshrc\fR. .RE @@ -316,7 +292,6 @@ gets executed. An event designator is a reference to a command line entry in the history list. .sp .ne 2 -.mk .na \fB\fB!\fR\fR .ad @@ -328,7 +303,6 @@ newline, \fB=\fR or \fB(\fR. .sp .ne 2 -.mk .na \fB\fB!!\fR\fR .ad @@ -340,7 +314,6 @@ previous command. .sp .ne 2 -.mk .na \fB\fB!\fR\fIn\fR\fR .ad @@ -351,7 +324,6 @@ Refer to command line \fIn\fR. .sp .ne 2 -.mk .na \fB\fB!\fR\fB-n\fR\fR .ad @@ -362,7 +334,6 @@ Refer to the current command line minus \fIn\fR. .sp .ne 2 -.mk .na \fB\fB!\fR\fIstr\fR\fR .ad @@ -373,7 +344,6 @@ Refer to the most recent command starting with \fIstr\fR. .sp .ne 2 -.mk .na \fB\fB!?\fR\fIstr\fR\fB?\fR\fR .ad @@ -384,7 +354,6 @@ Refer to the most recent command containing \fIstr\fR. .sp .ne 2 -.mk .na \fB\fB!?\fR\fIstr\fR\fB?\fR \fIadditional\fR\fR .ad @@ -396,7 +365,6 @@ Refer to the most recent command containing \fIstr\fR and append .sp .ne 2 -.mk .na \fB\fB!{\fR\fIcommand\fR\fB}\fR \fIadditional\fR\fR .ad @@ -408,7 +376,6 @@ Refer to the most recent command beginning with \fIcommand\fR and append .sp .ne 2 -.mk .na \fB\fB^\fR\fIprevious_word\fR\fB^\fR\fIreplacement\fR\fB^\fR\fR .ad @@ -448,111 +415,91 @@ word of the previous command, while \fB!!$\fR and \fB!$\fR both refer to the last word in the previous command. Word designators include: .sp .ne 2 -.mk .na \fB\fB#\fR\fR .ad .RS 10n -.rt The entire command line typed so far. .RE .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 10n -.rt The first input word (command). .RE .sp .ne 2 -.mk .na \fB\fIn\fR\fR .ad .RS 10n -.rt The \fIn\fR'th argument. .RE .sp .ne 2 -.mk .na \fB\fB^\fR\fR .ad .RS 10n -.rt The first argument, that is, \fB1\fR. .RE .sp .ne 2 -.mk .na \fB\fB$\fR\fR .ad .RS 10n -.rt The last argument. .RE .sp .ne 2 -.mk .na \fB\fB%\fR\fR .ad .RS 10n -.rt The word matched by the \fB?\fR\fIs\fR search. .RE .sp .ne 2 -.mk .na \fB\fIx\fR\fB\(mi\fR\fIy\fR\fR .ad .RS 10n -.rt A range of words; \fB\(mi\fR\fIy\fR abbreviates \fB0\(mi\fR\fIy\fR. .RE .sp .ne 2 -.mk .na \fB\fB*\fR\fR .ad .RS 10n -.rt All the arguments, or a null value if there is just one word in the event. .RE .sp .ne 2 -.mk .na \fB\fIx\fR\fB*\fR\fR .ad .RS 10n -.rt Abbreviates \fIx\fR\fB\(mi$\fR\fI\&.\fR .RE .sp .ne 2 -.mk .na \fB\fIx\fR\fB\(mi\fR\fR .ad .RS 10n -.rt Like \fIx*\fR but omitting word \fB$\fR. .RE @@ -563,113 +510,93 @@ After the optional word designator, you can add one of the following modifiers, preceded by a \fB:\fR. .sp .ne 2 -.mk .na \fB\fBh\fR\fR .ad .RS 10n -.rt Remove a trailing pathname component, leaving the head. .RE .sp .ne 2 -.mk .na \fB\fBr\fR\fR .ad .RS 10n -.rt Remove a trailing suffix of the form `\fB\&.\fR\fIxxx\fR', leaving the basename. .RE .sp .ne 2 -.mk .na \fB\fBe\fR\fR .ad .RS 10n -.rt Remove all but the suffix, leaving the Extension. .RE .sp .ne 2 -.mk .na \fB\fBs/\fR\fIl\fR\fB/\fR\fIr\fR\fB/\fR\fR .ad .RS 10n -.rt Substitute \fIr\fR for \fIl\fR. .RE .sp .ne 2 -.mk .na \fB\fBt\fR\fR .ad .RS 10n -.rt Remove all leading pathname components, leaving the tail. .RE .sp .ne 2 -.mk .na \fB\fB&\fR\fR .ad .RS 10n -.rt Repeat the previous substitution. .RE .sp .ne 2 -.mk .na \fB\fBg\fR\fR .ad .RS 10n -.rt Apply the change to the first occurrence of a match in each word, by prefixing the above (for example, \fBg&\fR). .RE .sp .ne 2 -.mk .na \fB\fBp\fR\fR .ad .RS 10n -.rt Print the new command but do not execute it. .RE .sp .ne 2 -.mk .na \fB\fBq\fR\fR .ad .RS 10n -.rt Quote the substituted words,escaping further substitutions. .RE .sp .ne 2 -.mk .na \fB\fBx\fR\fR .ad .RS 10n -.rt Like \fBq\fR, but break into words at each space character, tab or newline. .RE @@ -695,12 +622,10 @@ any). .SS "Quick Substitution" .sp .ne 2 -.mk .na \fB\fB^\fR\fIl\fR\fB^\fR\fIr\fR\fB^\fR\fR .ad .RS 9n -.rt This is equivalent to the history substitution: .sp .in +2 @@ -754,23 +679,19 @@ is redirected; this word is variable, command, and filename expanded separately from the rest of the command. .sp .ne 2 -.mk .na \fB\fB<\fR\fR .ad .RS 15n -.rt Redirect the standard input. .RE .sp .ne 2 -.mk .na \fB\fB<\|<\fR\fI\|word\fR\fR .ad .RS 15n -.rt Read the standard input, up to a line that is identical with \fIword\fR, and place the resulting lines in a temporary file. Unless \fIword\fR is escaped or quoted, variable and command substitutions are performed on these lines. Then, @@ -782,12 +703,10 @@ shell. .sp .ne 2 -.mk .na \fB\fB>\fR \fB>!\fR \fB>&\fR \fB>&!\fR\fR .ad .RS 15n -.rt Redirect the standard output to a file. If the file does not exist, it is created. If it does exist, it is overwritten; its previous contents are lost. .sp @@ -799,12 +718,10 @@ the standard error (diagnostic output) to the file. .sp .ne 2 -.mk .na \fB\fB>\|>\fR \fB>\|>&\fR \fB>\|>!\fR \fB>\|>&!\fR\fR .ad .RS 27n -.rt Append the standard output. Like \fB>\fR, but places output at the end of the file rather than overwriting it. If \fBnoclobber\fR is set, it is an error for the file not to exist, unless one of the \fB!\fR forms is used. The \fB&\fR @@ -870,7 +787,6 @@ filename substitutions. Except as noted below, it is an error to refer to a variable that is not set. .sp .ne 2 -.mk .na \fB\fB$\fR\fIvar\fR\fR .ad @@ -879,7 +795,6 @@ Except as noted below, it is an error to refer to a variable that is not set. \fB\fB${\fR\fIvar\fR\fB}\fR\fR .ad .RS 17n -.rt These are replaced by words from the value of \fIvar\fR, each separated by a space character. If \fIvar\fR is an environment variable, its value is returned (but `\fB:\fR' modifiers and the other forms given below are not available). @@ -887,7 +802,6 @@ space character. If \fIvar\fR is an environment variable, its value is returned .sp .ne 2 -.mk .na \fB\fB$\fR\fIvar\fR\fB[\fR\fIindex\fR\fB]\fR\fR .ad @@ -896,7 +810,6 @@ space character. If \fIvar\fR is an environment variable, its value is returned \fB\fB${\fR\fIvar\fR\fB[\fR\fIindex\fR\fB]}\fR\fR .ad .RS 17n -.rt These select only the indicated words from the value of \fIvar\fR. Variable substitution is applied to \fIindex\fR\|, which can consist of (or result in) a either single number, two numbers separated by a `\fB\(mi\fR\&', or an @@ -910,7 +823,6 @@ within range). .sp .ne 2 -.mk .na \fB\fB$#\fR\fIname\fR\fR .ad @@ -919,25 +831,21 @@ within range). \fB\fB${#\fR\fIname\fR\fB}\fR\fR .ad .RS 17n -.rt These give the number of words in the variable. .RE .sp .ne 2 -.mk .na \fB\fB$0\fR\fR .ad .RS 17n -.rt This substitutes the name of the file from which command input is being read except for setuid shell scripts. An error occurs if the name is not known. .RE .sp .ne 2 -.mk .na \fB\fB$\fR\fIn\fR\fR .ad @@ -946,18 +854,15 @@ except for setuid shell scripts. An error occurs if the name is not known. \fB\fB${\fR\fIn\fR\fB}\fR\fR .ad .RS 17n -.rt Equivalent to \fB$argv[\fR\fIn\fR\fB]\fR\fI\&.\fR .RE .sp .ne 2 -.mk .na \fB\fB$*\fR\fR .ad .RS 17n -.rt Equivalent to \fB$argv[*]\fR. .RE @@ -973,7 +878,6 @@ modifier per expansion. The following references can not be modified with \fB:\fR modifiers. .sp .ne 2 -.mk .na \fB\fB$?\fR\fIvar\fR\fR .ad @@ -982,40 +886,33 @@ The following references can not be modified with \fB:\fR modifiers. \fB\fB${?\fR\fIvar\fR\fB}\fR\fR .ad .RS 11n -.rt Substitutes the string 1 if \fIvar\fR is set or 0 if it is not set. .RE .sp .ne 2 -.mk .na \fB\fB$?0\fR\fR .ad .RS 11n -.rt Substitutes 1 if the current input filename is known or 0 if it is not. .RE .sp .ne 2 -.mk .na \fB\fB$$\fR\fR .ad .RS 11n -.rt Substitutes the process number of the (parent) shell. .RE .sp .ne 2 -.mk .na \fB\fB$<\fR\fR .ad .RS 11n -.rt Substitutes a line from the standard input, with no further interpretation thereafter. It can be used to read from the keyboard in a C shell script. .RE @@ -1046,34 +943,28 @@ Unquoted words containing any of the characters \fB*\fR, \fB?\fR, \fB[\fR or an alphabetically sorted list of filenames, as follows: .sp .ne 2 -.mk .na \fB*\fR .ad .RS 24n -.rt Match any (zero or more) characters. .RE .sp .ne 2 -.mk .na \fB?\fR .ad .RS 24n -.rt Match any single character. .RE .sp .ne 2 -.mk .na \fB\fB[\fR.\|.\|.\fB]\fR\fR .ad .RS 24n -.rt Match any single character in the enclosed list(s) or range(s). A list is a string of characters. A range is two characters separated by a dash (\fB\(mi\fR), and includes all the characters in between in the \fBASCII\fR @@ -1082,12 +973,10 @@ collating sequence (see \fBascii\fR(5)). .sp .ne 2 -.mk .na \fB{\fIstr\fR\fB,\fR \fIstr\fR\fB,\fR .\|.\|. \fB}\fR\fR .ad .RS 24n -.rt Expand to each string (or filename-matching pattern) in the comma-separated list. Unlike the pattern-matching expressions above, the expansion of this construct is not sorted. For instance, \fB{b,a}\fR expands to `\fBb\fR' @@ -1097,12 +986,10 @@ and \fB}\fR, along with the string \fB{\|}\fR, are passed undisturbed. .sp .ne 2 -.mk .na \fB~[\fIuser\fR]\fR .ad .RS 24n -.rt Your home directory, as indicated by the value of the variable \fBhome\fR, or that of \fIuser\fR, as indicated by the password entry for \fIuser\fR. .RE @@ -1132,45 +1019,37 @@ a string, which can represent decimal numbers. The following C shell operators are grouped in order of precedence: .sp .ne 2 -.mk .na \fB\fB(\|\fR.\|.\|.\|\fB\|)\fR\fR .ad .RS 19n -.rt grouping .RE .sp .ne 2 -.mk .na \fB>\fB~\fR\fR .ad .RS 19n -.rt one's complement .RE .sp .ne 2 -.mk .na \fB\fB!\fR\fR .ad .RS 19n -.rt logical negation .RE .sp .ne 2 -.mk .na \fB\fB* / %\fR\fR .ad .RS 19n -.rt multiplication, division, remainder. These are right associative, which can lead to unexpected results. Combinations should be grouped explicitly with parentheses. @@ -1178,101 +1057,83 @@ parentheses. .sp .ne 2 -.mk .na \fB\fB+ \(mi\fR\fR .ad .RS 19n -.rt addition, subtraction (also right associative) .RE .sp .ne 2 -.mk .na \fB\fB<< >>\fR\fR .ad .RS 19n -.rt bitwise shift left, bitwise shift right .RE .sp .ne 2 -.mk .na \fB\fB< > <= >=\fR\fR .ad .RS 19n -.rt less than, greater than, less than or equal to, greater than or equal to .RE .sp .ne 2 -.mk .na \fB\fB=\|= != =~ !~\fR\fR .ad .RS 19n -.rt equal to, not equal to, filename-substitution pattern match (described below), filename-substitution pattern mismatch .RE .sp .ne 2 -.mk .na \fB\fB&\fR\fR .ad .RS 19n -.rt bitwise AND .RE .sp .ne 2 -.mk .na \fB\fB^\fR\fR .ad .RS 19n -.rt bitwise XOR (exclusive or) .RE .sp .ne 2 -.mk .na \fB\fB|\fR\fR .ad .RS 19n -.rt bitwise inclusive OR .RE .sp .ne 2 -.mk .na \fB\fB&&\fR\fR .ad .RS 19n -.rt logical AND .RE .sp .ne 2 -.mk .na \fB\fB|\|\||\fR\fR .ad .RS 19n -.rt logical OR .RE @@ -1288,90 +1149,74 @@ statements when pattern-matching between strings is all that is required. Also available are file inquiries: .sp .ne 2 -.mk .na \fB\fB-r\fR\fIfilename\fR\fR .ad .RS 15n -.rt Return true, or 1 if the user has read access. Otherwise it returns false, or 0. .RE .sp .ne 2 -.mk .na \fB\fB-w\fR\fIfilename\fR\fR .ad .RS 15n -.rt True if the user has write access. .RE .sp .ne 2 -.mk .na \fB\fB-x\fR\fIfilename\fR\fR .ad .RS 15n -.rt True if the user has execute permission (or search permission on a directory). .RE .sp .ne 2 -.mk .na \fB\fB-e\fR\fIfilename\fR\fR .ad .RS 15n -.rt True if \fIfilename\fR exists. .RE .sp .ne 2 -.mk .na \fB\fB-o\fR\fIfilename\fR\fR .ad .RS 15n -.rt True if the user owns \fIfilename\fR. .RE .sp .ne 2 -.mk .na \fB\fB-z\fR \fIfilename\fR\fR .ad .RS 15n -.rt True if \fIfilename\fR is of zero length (empty). .RE .sp .ne 2 -.mk .na \fB\fB-f\fR\fIfilename\fR\fR .ad .RS 15n -.rt True if \fIfilename\fR is a plain file. .RE .sp .ne 2 -.mk .na \fB\fB-d\fR\fIfilename\fR\fR .ad .RS 15n -.rt True if \fIfilename\fR is a directory. .RE @@ -1384,12 +1229,10 @@ false. An inquiry as to the success of a command is also available: .sp .ne 2 -.mk .na \fB\fB{\fR \fIcommand\fR\fB}\fR\fR .ad .RS 14n -.rt If \fIcommand\fR runs successfully, the expression evaluates to true, 1. Otherwise, it evaluates to false, 0. \fBNote:\fR Conversely, \fIcommand\fR itself typically returns 0 when it runs successfully, or some other value if it @@ -1510,34 +1353,28 @@ A reference to a job begins with a `\fB%\fR'. By itself, the percent-sign refers to the current job. .sp .ne 2 -.mk .na \fB\fB%\fR \fB%+\fR \fB%%\fR\fR .ad .RS 12n -.rt The current job. .RE .sp .ne 2 -.mk .na \fB\fB%\(mi\fR\fR .ad .RS 12n -.rt The previous job. .RE .sp .ne 2 -.mk .na \fB\fB%\fR\fIj\fR\fR .ad .RS 12n -.rt Refer to job \fIj\fR as in: `\fBkill\fR \fB-9\fR \fB%\fR\fIj\fR'. \fIj\fR can be a job number, or a string that uniquely specifies the command line by which it was started; `\fBfg %vi\fR' might bring a stopped \fBvi\fR job to the @@ -1546,12 +1383,10 @@ foreground, for instance. .sp .ne 2 -.mk .na \fB\fB%?\fR\fIstring\fR\fR .ad .RS 12n -.rt Specify the job for which the command line uniquely contains \fIstring\fR. .RE @@ -1577,23 +1412,19 @@ Built-in commands are executed within the C shell. If a built-in command occurs as any component of a pipeline except the last, it is executed in a subshell. .sp .ne 2 -.mk .na \fB\fB:\fR\fR .ad .RS 26n -.rt Null command. This command is interpreted, but performs no action. .RE .sp .ne 2 -.mk .na \fB\fBalias\fR [ \fIname\fR [ \fIdef\fR ] ]\fR .ad .RS 26n -.rt Assign \fIdef\fR to the alias \fIname\fR. \fIdef\fR is a list of words that can contain escaped history-substitution metasyntax. \fIname\fR is not allowed to be \fBalias\fR or \fBunalias\fR. If \fIdef\fR is omitted, the current @@ -1603,23 +1434,19 @@ definition for the alias \fIname\fR is displayed. If both \fIname\fR and .sp .ne 2 -.mk .na \fB\fBbg\fR [ \fB%\fR\fIjob .\|.\|.\fR ]\fR .ad .RS 26n -.rt Run the current or specified jobs in the background. .RE .sp .ne 2 -.mk .na \fB\fBbreak\fR\fR .ad .RS 26n -.rt Resume execution after the \fBend\fR of the nearest enclosing \fBforeach\fR or \fBwhile\fR loop. The remaining commands on the current line are executed. This allows multilevel breaks to be written as a list of \fBbreak\fR commands, all @@ -1628,29 +1455,24 @@ on one line. .sp .ne 2 -.mk .na \fB\fBbreaksw\fR\fR .ad .RS 26n -.rt Break from a \fBswitch\fR, resuming after the \fBendsw\fR. .RE .sp .ne 2 -.mk .na \fB\fBcase\fR \fIlabel\fR\fB:\fR\fR .ad .RS 26n -.rt A label in a \fBswitch\fR statement. .RE .sp .ne 2 -.mk .na \fB\fBcd\fR [\fIdir\fR ]\fR .ad @@ -1659,7 +1481,6 @@ A label in a \fBswitch\fR statement. \fB\fBchdir\fR [\fIdir\fR ]\fR .ad .RS 26n -.rt Change the shell's working directory to directory \fIdir\fR. If no argument is given, change to the home directory of the user. If \fIdir\fR is a relative pathname not found in the current directory, check for it in those directories @@ -1670,24 +1491,20 @@ that value. .sp .ne 2 -.mk .na \fB\fBcontinue\fR\fR .ad .RS 26n -.rt Continue execution of the next iteration of the nearest enclosing \fBwhile\fR or \fBforeach\fR loop. .RE .sp .ne 2 -.mk .na \fB\fBdefault:\fR\fR .ad .RS 26n -.rt Labels the default case in a \fBswitch\fR statement. The default should come after all \fBcase\fR labels. Any remaining commands on the command line are first executed. @@ -1695,12 +1512,10 @@ first executed. .sp .ne 2 -.mk .na \fB\fBdirs\fR [\fB-l\fR]\fR .ad .RS 26n -.rt Print the directory stack, most recent to the left. The first directory shown is the current directory. With the \fB-l\fR argument, produce an unabbreviated printout; use of the ~ notation is suppressed. @@ -1708,12 +1523,10 @@ printout; use of the ~ notation is suppressed. .sp .ne 2 -.mk .na \fB\fBecho\fR [\fB-n\fR] \fIlist\fR\fR .ad .RS 26n -.rt The words in \fIlist\fR are written to the shell's standard output, separated by space characters. The output is terminated with a newline unless the \fB-n\fR option is used. \fBcsh\fR, by default, invokes its built-in @@ -1724,12 +1537,10 @@ command, regardless of the configuration of your \fBPATH\fR (see .sp .ne 2 -.mk .na \fB\fBeval\fR \fIargument\fR\fB\|.\|.\|.\fR\fR .ad .RS 26n -.rt Reads the arguments as input to the shell and executes the resulting command(s). This is usually used to execute commands generated as the result of command or variable substitution. See \fBtset\fR(1B) for an example of how to @@ -1738,41 +1549,34 @@ use \fBeval\fR. .sp .ne 2 -.mk .na \fB\fBexec\fR \fIcommand\fR\fR .ad .RS 26n -.rt Execute \fIcommand\fR in place of the current shell, which terminates. .RE .sp .ne 2 -.mk .na \fB\fBexit\fR [\fB(\fR\fIexpr\fR\fB)\fR]\fR .ad .RS 26n -.rt The calling shell or shell script exits, either with the value of the status variable or with the value specified by the expression \fIexpr\fR. .RE .sp .ne 2 -.mk .na \fB\fBfg\fR [\fB%\fR\fIjob\fR ]\fR .ad .RS 26n -.rt Bring the current or specified \fIjob\fR into the foreground. .RE .sp .ne 2 -.mk .na \fB\fBforeach\fR \fIvar\fR\fB(\fR\fIwordlist\fR\fB)\fR\fR .ad @@ -1785,7 +1589,6 @@ Bring the current or specified \fIjob\fR into the foreground. \fB\fBend\fR\fR .ad .RS 26n -.rt The variable \fIvar\fR is successively set to each member of \fIwordlist\fR. The sequence of commands between this command and the matching \fBend\fR is executed for each new value of \fIvar\fR. Both \fBforeach\fR and \fBend\fR must @@ -1800,7 +1603,6 @@ statements in the loop are executed. .sp .ne 2 -.mk .na \fB\fBglob\fR \fIwordlist\fR\fR .ad @@ -1813,7 +1615,6 @@ output. .sp .ne 2 -.mk .na \fB\fBgoto\fR\fIlabel\fR\fR .ad @@ -1829,7 +1630,6 @@ corresponding \fBend\fR. .sp .ne 2 -.mk .na \fB\fBhashstat\fR\fR .ad @@ -1845,7 +1645,6 @@ effectiveness of the \fIpath\fR variable, not the \fIcdpath\fR variable. .sp .ne 2 -.mk .na \fB\fBhistory\fR [\fB-hr\fR] [\fIn\fR]\fR .ad @@ -1855,23 +1654,19 @@ Display the history list; if \fIn\fR is given, display only the \fIn\fR most recent events. .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 6n -.rt Reverse the order of printout to be most recent first rather than oldest first. .RE .sp .ne 2 -.mk .na \fB\fB-h\fR\fR .ad .RS 6n -.rt Display the history list without leading numbers. This is used to produce files suitable for sourcing using the \fB-h\fR option to \fIsource\fR. .RE @@ -1880,7 +1675,6 @@ suitable for sourcing using the \fB-h\fR option to \fIsource\fR. .sp .ne 2 -.mk .na \fB\fBif (\fR\fIexpr\fR \fB)\fR\fIcommand\fR\fR .ad @@ -1896,7 +1690,6 @@ list. \fBNote:\fR I/O redirection occurs even if \fIexpr\fR is false, when .sp .ne 2 -.mk .na \fB\fBif (\fR\fBexpr\fR\fB) then\fR\fR .ad @@ -1938,7 +1731,6 @@ an \fBelse\fR. .sp .ne 2 -.mk .na \fB\fBjobs\fR [\fB-l\fR]\fR .ad @@ -1947,12 +1739,10 @@ an \fBelse\fR. List the active jobs under job control. .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 6n -.rt List process \fBID\fRs, in addition to the normal information. .RE @@ -1960,7 +1750,6 @@ List process \fBID\fRs, in addition to the normal information. .sp .ne 2 -.mk .na \fB\fBkill\fR [\fIsig\fR ] [ \fIpid\fR ] [ \fB%\fR\fB\fIjob\fR ] .\|.\|.\fR\fR .ad @@ -1978,12 +1767,10 @@ is \fBTERM\fR (terminate) or \fBHUP\fR (hangup), then the job or process is sent a \fBCONT\fR (continue) signal as well. .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 6n -.rt List the signal names that can be sent. .RE @@ -1991,7 +1778,6 @@ List the signal names that can be sent. .sp .ne 2 -.mk .na \fB\fBlimit\fR [\fB-h\fR] [\fIresource\fR [\fImax-use\fR ] ]\fR .ad @@ -2007,12 +1793,10 @@ report stack size). The values reported are in hexadecimal, but can be translated into decimal numbers using the \fBbc\fR(1) command. .sp .ne 2 -.mk .na \fB\fB-h\fR\fR .ad .RS 6n -.rt Use hard limits instead of the current limits. Hard limits impose a ceiling on the values of the current limits. Only the privileged user can raise the hard limits. @@ -2021,126 +1805,104 @@ limits. \fIresource\fR is one of: .sp .ne 2 -.mk .na \fB\fBcputime\fR\fR .ad .RS 23n -.rt Maximum \fBCPU\fR seconds per process. .RE .sp .ne 2 -.mk .na \fB\fBfilesize\fR\fR .ad .RS 23n -.rt Largest single file allowed. Limited to the size of the filesystem. (See \fBdf\fR(1M)). .RE .sp .ne 2 -.mk .na \fB\fBdatasize\fR (heapsize)\fR .ad .RS 23n -.rt Maximum data size (including stack) for the process. This is the size of your virtual memory See \fBswap\fR(1M). .RE .sp .ne 2 -.mk .na \fB\fBstacksize\fR\fR .ad .RS 23n -.rt Maximum stack size for the process. The default stack size is 2^64 bytes. You can use \fBlimit\fR(1) to change this default within a shell. .RE .sp .ne 2 -.mk .na \fB\fBcoredumpsize\fR\fR .ad .RS 23n -.rt Maximum size of a core dump (file). This limited to the size of the filesystem. .RE .sp .ne 2 -.mk .na \fB\fBdescriptors\fR\fR .ad .RS 23n -.rt Maximum number of file descriptors. Run \fBsysdef()\fR. .RE .sp .ne 2 -.mk .na \fB\fBmemorysize\fR\fR .ad .RS 23n -.rt Maximum size of virtual memory. .RE \fImax-use\fR is a number, with an optional scaling factor, as follows: .sp .ne 2 -.mk .na \fB\fIn\fR\fBh\fR\fR .ad .RS 9n -.rt Hours (for \fBcputime\fR). .RE .sp .ne 2 -.mk .na \fB\fIn\fR\fBk\fR\fR .ad .RS 9n -.rt \fIn\fR kilobytes. This is the default for all but \fBcputime\fR. .RE .sp .ne 2 -.mk .na \fB\fIn\fR\fBm\fR\fR .ad .RS 9n -.rt \fIn\fR megabytes or minutes (for \fBcputime\fR). .RE .sp .ne 2 -.mk .na \fB\fImm\fR\fB:\fR\fIss\fR\fR .ad .RS 9n -.rt Minutes and seconds (for \fBcputime\fR). .RE @@ -2158,7 +1920,6 @@ type the following: .sp .ne 2 -.mk .na \fB\fBlogin\fR [\fIusername\fR\|| \fB-p\fR ]\fR .ad @@ -2169,12 +1930,10 @@ not processed. If \fIusername\fR is omitted, \fBlogin\fR prompts for the name of a user. .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 6n -.rt Preserve the current environment (variables). .RE @@ -2182,7 +1941,6 @@ Preserve the current environment (variables). .sp .ne 2 -.mk .na \fB\fBlogout\fR\fR .ad @@ -2193,7 +1951,6 @@ Terminate a login shell. .sp .ne 2 -.mk .na \fB\fBnice\fR [\fB+\fR\fIn\fR \||\fB-\fR\fIn\fR ] [\fIcommand\fR ]\fR .ad @@ -2210,23 +1967,19 @@ to 4. The range of process priority values is from \(mi20 to 20. Values of boundary, respectively. .sp .ne 2 -.mk .na \fB\fB+\fR\fIn\fR\fR .ad .RS 6n -.rt Increment the process priority value by \fIn\fR. .RE .sp .ne 2 -.mk .na \fB\fB-\fR\fIn\fR\fR .ad .RS 6n -.rt Decrement by \fIn\fR. This argument can be used only by the privileged user. .RE @@ -2234,7 +1987,6 @@ Decrement by \fIn\fR. This argument can be used only by the privileged user. .sp .ne 2 -.mk .na \fB\fBnohup\fR [\fIcommand\fR ]\fR .ad @@ -2249,7 +2001,6 @@ statements apply. All processes detached with \fB&\fR are effectively .sp .ne 2 -.mk .na \fB\fBnotify\fR [\fB%\fR\fIjob\fR] .\|.\|.\fR .ad @@ -2261,7 +2012,6 @@ jobs changes. .sp .ne 2 -.mk .na \fB\fBonintr\fR [\fB\(mi\fR| \fIlabel\fR]\fR .ad @@ -2277,7 +2027,6 @@ received or a child process terminates because it was interrupted. .sp .ne 2 -.mk .na \fB\fBpopd\fR [\fB+\fR\fIn\fR ]\fR .ad @@ -2287,12 +2036,10 @@ Pop the directory stack and \fBcd\fR to the new top directory. The elements of the directory stack are numbered from 0 starting at the top. .sp .ne 2 -.mk .na \fB\fB+\fR\fIn\fR\fR .ad .RS 6n -.rt Discard the \fIn\fR'th entry in the stack. .RE @@ -2300,7 +2047,6 @@ Discard the \fIn\fR'th entry in the stack. .sp .ne 2 -.mk .na \fB\fBpushd\fR [\fB+\fR\fIn\fR |\fIdir\fR]\fR .ad @@ -2310,23 +2056,19 @@ Push a directory onto the directory stack. With no arguments, exchange the top two elements. .sp .ne 2 -.mk .na \fB\fB+\fR\fIn\fR\fR .ad .RS 7n -.rt Rotate the \fIn\fR'th entry to the top of the stack and \fBcd\fR to it. .RE .sp .ne 2 -.mk .na \fB\fIdir\fR\fR .ad .RS 7n -.rt Push the current working directory onto the stack and change to \fIdir\fR. .RE @@ -2334,7 +2076,6 @@ Push the current working directory onto the stack and change to \fIdir\fR. .sp .ne 2 -.mk .na \fB\fBrehash\fR\fR .ad @@ -2348,7 +2089,6 @@ to account for new directories added. .sp .ne 2 -.mk .na \fB\fBrepeat\fR \fIcount command\fR\fR .ad @@ -2360,7 +2100,6 @@ restrictions as with the one-line \fBif\fR statement. .sp .ne 2 -.mk .na \fB\fBset\fR [\fIvar\fR [\fB=\fR \fIvalue\fR ] ]\fR .ad @@ -2377,23 +2116,19 @@ argument alone, \fBset\fR assigns an empty (null) value to the variable assigns \fIvalue\fR to \fIvar\fR, where \fIvalue\fR is one of: .sp .ne 2 -.mk .na \fB\fIword\fR\fR .ad .RS 14n -.rt A single word (or quoted string). .RE .sp .ne 2 -.mk .na \fB\fB(\fR\fIwordlist\fR\fB)\fR\fR .ad .RS 14n -.rt A space-separated list of words enclosed in parentheses. .RE @@ -2404,7 +2139,6 @@ word in a multiword value with \fIword\fR. .sp .ne 2 -.mk .na \fB\fBsetenv\fR [\fIVAR\fR [\fIword\fR ] ]\fR .ad @@ -2436,12 +2170,10 @@ none of the above variables is set in the environment, the "C" (U.S. style) locale determines how \fBcsh\fR behaves. .sp .ne 2 -.mk .na \fB\fBLC_CTYPE\fR\fR .ad .RS 15n -.rt Determines how \fBcsh\fR handles characters. When \fBLC_CTYPE\fR is set to a valid value, \fBcsh\fR can display and handle text and filenames containing valid characters for that locale. @@ -2449,12 +2181,10 @@ valid characters for that locale. .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 @@ -2463,12 +2193,10 @@ default form found in the program itself (in most cases, U.S./English). .sp .ne 2 -.mk .na \fB\fBLC_NUMERIC\fR\fR .ad .RS 15n -.rt Determines the value of the radix character, decimal point, (\fB\&.\fR) in the "C" locale) and thousand separator, empty string (\fB""\fR) in the "C" locale). .RE @@ -2477,7 +2205,6 @@ Determines the value of the radix character, decimal point, (\fB\&.\fR) in the .sp .ne 2 -.mk .na \fB\fBshift\fR [\fIvariable\fR ]\fR .ad @@ -2490,7 +2217,6 @@ to be set or to have a null value. .sp .ne 2 -.mk .na \fB\fBsource\fR [\fB-h\fR] \fIname\fR\fR .ad @@ -2501,12 +2227,10 @@ they are nested too deeply the shell can run out of file descriptors. An error in a sourced file at any level terminates all nested \fBsource\fR commands. .sp .ne 2 -.mk .na \fB\fB-h\fR\fR .ad .RS 6n -.rt Place commands from the file \fIname\fR on the history list without executing them. .RE @@ -2515,7 +2239,6 @@ them. .sp .ne 2 -.mk .na \fB\fBstop\fR \fB%\fR\fIjobid .\|.\|.\fR\fR .ad @@ -2526,7 +2249,6 @@ Stop the current or specified background job. .sp .ne 2 -.mk .na \fB\fBstop\fR \fIpid .\|.\|.\fR\fR .ad @@ -2537,7 +2259,6 @@ Stop the specified process, \fIpid\fR. (see \fBps\fR(1)). .sp .ne 2 -.mk .na \fB\fBsuspend\fR\fR .ad @@ -2549,7 +2270,6 @@ Stop the shell in its tracks, much as if it had been sent a stop signal with .sp .ne 2 -.mk .na \fB\fBswitch (\fR\fIstring\fR\fB)\fR\fR .ad @@ -2601,7 +2321,6 @@ no label matches and there is no default, execution continues after the .sp .ne 2 -.mk .na \fB\fBtime\fR [\fIcommand\fR ]\fR .ad @@ -2615,7 +2334,7 @@ erroneously report the value \fB0\fR for these fields. .sp .in +2 .nf -example %\fBtime ls\fR \fB-R\fR +example %\fBtime ls\fR \fB-R\fR 9.0u 11.0s 3:32 10% 0+0k 0+0io 0pf+0w .fi .in -2 @@ -2627,7 +2346,6 @@ on the \fBtime\fR variable.) .sp .ne 2 -.mk .na \fB\fBumask\fR [\fIvalue\fR ]\fR .ad @@ -2643,7 +2361,6 @@ directory search) but not write permission to the group and others. .sp .ne 2 -.mk .na \fB\fBunalias\fR \fIpattern\fR\fR .ad @@ -2655,7 +2372,6 @@ are removed by `\fBunalias *\fR'. .sp .ne 2 -.mk .na \fB\fBunhash\fR\fR .ad @@ -2666,7 +2382,6 @@ Disable the internal hash tables for the \fIpath\fR and \fIcdpath\fR variables. .sp .ne 2 -.mk .na \fB\fBunlimit\fR [\fB-h\fR] [\fIresource\fR ]\fR .ad @@ -2677,12 +2392,10 @@ all resource limitations are removed. See the description of the \fBlimit\fR command for the list of resource names. .sp .ne 2 -.mk .na \fB\fB-h\fR\fR .ad .RS 6n -.rt Remove corresponding hard limits. Only the privileged user can do this. .RE @@ -2690,7 +2403,6 @@ Remove corresponding hard limits. Only the privileged user can do this. .sp .ne 2 -.mk .na \fB\fBunset\fR \fIpattern\fR\fR .ad @@ -2703,7 +2415,6 @@ effects. .sp .ne 2 -.mk .na \fB\fBunsetenv\fR \fIvariable\fR\fR .ad @@ -2715,7 +2426,6 @@ matching is not performed. .sp .ne 2 -.mk .na \fB\fBwait\fR\fR .ad @@ -2726,7 +2436,6 @@ Wait for background jobs to finish (or for an interrupt) before prompting. .sp .ne 2 -.mk .na \fB\fBwhile (\fR\fIexpr\fR\fB)\fR\fR .ad @@ -2750,7 +2459,6 @@ the \fBend\fR command is entered and then performs the commands in the loop. .sp .ne 2 -.mk .na \fB\fB%\fR [\fIjob\fR ] [\fB&\fR]\fR .ad @@ -2762,7 +2470,6 @@ continue running \fIjob\fR in the background. .sp .ne 2 -.mk .na \fB\fB@\fR [\fIvar\fR \fB=\fR\fIexpr\fR]\fR .ad @@ -2808,12 +2515,10 @@ set from \fBcwd\fR whenever the latter changes. The following shell variables have predefined meanings: .sp .ne 2 -.mk .na \fB\fBargv\fR\fR .ad .RS 13n -.rt Argument list. Contains the list of command line arguments supplied to the current invocation of the shell. This variable determines the value of the positional parameters \fB$1\fR, \fB$2\fR, and so on. @@ -2821,12 +2526,10 @@ positional parameters \fB$1\fR, \fB$2\fR, and so on. .sp .ne 2 -.mk .na \fB\fBcdpath\fR\fR .ad .RS 13n -.rt Contains a list of directories to be searched by the \fBcd\fR, \fBchdir\fR, and \fBpopd\fR commands, if the directory argument each accepts is not a subdirectory of the current directory. @@ -2834,68 +2537,56 @@ subdirectory of the current directory. .sp .ne 2 -.mk .na \fB\fBcwd\fR\fR .ad .RS 13n -.rt The full pathname of the current directory. .RE .sp .ne 2 -.mk .na \fB\fBecho\fR\fR .ad .RS 13n -.rt Echo commands (after substitutions) just before execution. .RE .sp .ne 2 -.mk .na \fB\fBfignore\fR\fR .ad .RS 13n -.rt A list of filename suffixes to ignore when attempting filename completion. Typically the single word `\fB\&.o\fR'. .RE .sp .ne 2 -.mk .na \fB\fBfilec\fR\fR .ad .RS 13n -.rt Enable filename completion, in which case the Control-d character \fBEOT\fR and the \fBESC\fR character have special significance when typed in at the end of a terminal input line: .sp .ne 2 -.mk .na \fB\fBEOT\fR\fR .ad .RS 7n -.rt Print a list of all filenames that start with the preceding string. .RE .sp .ne 2 -.mk .na \fB\fBESC\fR\fR .ad .RS 7n -.rt Replace the preceding string with the longest unambiguous extension. .RE @@ -2903,24 +2594,20 @@ Replace the preceding string with the longest unambiguous extension. .sp .ne 2 -.mk .na \fB\fBhardpaths\fR\fR .ad .RS 13n -.rt If set, pathnames in the directory stack are resolved to contain no symbolic-link components. .RE .sp .ne 2 -.mk .na \fB\fBhistchars\fR\fR .ad .RS 13n -.rt A two-character string. The first character replaces \fB!\fR as the history-substitution character. The second replaces the carat (\fB^\fR) for quick substitutions. @@ -2928,12 +2615,10 @@ quick substitutions. .sp .ne 2 -.mk .na \fB\fBhistory\fR\fR .ad .RS 13n -.rt The number of lines saved in the history list. A very large number can use up all of the C shell's memory. If not set, the C shell saves only the most recent command. @@ -2941,36 +2626,30 @@ command. .sp .ne 2 -.mk .na \fB\fBhome\fR\fR .ad .RS 13n -.rt The user's home directory. The filename expansion of ~ refers to the value of this variable. .RE .sp .ne 2 -.mk .na \fB\fBignoreeof\fR\fR .ad .RS 13n -.rt If set, the shell ignores \fBEOF\fR from terminals. This protects against accidentally killing a C shell by typing a Control-d. .RE .sp .ne 2 -.mk .na \fB\fBmail\fR\fR .ad .RS 13n -.rt A list of files where the C shell checks for mail. If the first word of the value is a number, it specifies a mail checking interval in seconds (default 5 minutes). @@ -2978,24 +2657,20 @@ minutes). .sp .ne 2 -.mk .na \fB\fBnobeep\fR\fR .ad .RS 13n -.rt Suppress the bell during command completion when asking the C shell to extend an ambiguous filename. .RE .sp .ne 2 -.mk .na \fB\fBnoclobber\fR\fR .ad .RS 13n -.rt Restrict output redirection so that existing files are not destroyed by accident. \fB>\fR redirections can only be made to new files. \fB>>\fR redirections can only be made to existing files. @@ -3003,48 +2678,40 @@ redirections can only be made to existing files. .sp .ne 2 -.mk .na \fB\fBnoglob\fR\fR .ad .RS 13n -.rt Inhibit filename substitution. This is most useful in shell scripts once filenames (if any) are obtained and no further expansion is desired. .RE .sp .ne 2 -.mk .na \fB\fBnonomatch\fR\fR .ad .RS 13n -.rt Return the filename substitution pattern, rather than an error, if the pattern is not matched. Malformed patterns still result in errors. .RE .sp .ne 2 -.mk .na \fB\fBnotify\fR\fR .ad .RS 13n -.rt If set, the shell notifies you immediately as jobs are completed, rather than waiting until just before issuing a prompt. .RE .sp .ne 2 -.mk .na \fB\fBpath\fR\fR .ad .RS 13n -.rt The list of directories in which to search for commands. \fBpath\fR is initialized from the environment variable \fBPATH\fR, which the C shell updates whenever \fBpath\fR changes. A null word ('') specifies the current directory. @@ -3059,12 +2726,10 @@ table. .sp .ne 2 -.mk .na \fB\fBprompt\fR\fR .ad .RS 13n -.rt The string an interactive C shell prompts with. Noninteractive shells leave the \fBprompt\fR variable unset. Aliases and other commands in the \fB\&.cshrc\fR file that are only useful interactively, can be placed after the following @@ -3076,34 +2741,28 @@ mortals, or \fIhostname\fR\fB#\fR for the privileged user. The setting of \fB$prompt\fR has three meanings: .sp .ne 2 -.mk .na \fB\fB$prompt\fR not set\fR .ad .RS 25n -.rt non-interactive shell, test \fB$?prompt\fR. .RE .sp .ne 2 -.mk .na \fB\fB$prompt\fR set but \fB== ""\fR\fR .ad .RS 25n -.rt \fB\&.cshrc\fR called by the \fBwhich\fR(1) command. .RE .sp .ne 2 -.mk .na \fB\fB$prompt\fR set and \fB!= ""\fR\fR .ad .RS 25n -.rt normal interactive shell. .RE @@ -3111,12 +2770,10 @@ normal interactive shell. .sp .ne 2 -.mk .na \fB\fBsavehist\fR\fR .ad .RS 13n -.rt The number of lines from the history list that are saved in ~/.history when the user logs out. Large values for \fBsavehist\fR slow down the C shell during startup. @@ -3124,12 +2781,10 @@ startup. .sp .ne 2 -.mk .na \fB\fBshell\fR\fR .ad .RS 13n -.rt The file in which the C shell resides. This is used in forking shells to interpret files that have execute bits set, but that are not executable by the system. @@ -3137,12 +2792,10 @@ system. .sp .ne 2 -.mk .na \fB\fBstatus\fR\fR .ad .RS 13n -.rt The status returned by the most recent command. If that command terminated abnormally, 0200 is added to the status. Built-in commands that fail return exit status 1; all other built-in commands set status to 0. @@ -3150,12 +2803,10 @@ exit status 1; all other built-in commands set status to 0. .sp .ne 2 -.mk .na \fB\fBtime\fR\fR .ad .RS 13n -.rt Control automatic timing of commands. Can be supplied with one or two values. The first is the reporting threshold in \fBCPU\fR seconds. The second is a string of tags and text indicating which resources to report on. A tag is a @@ -3163,135 +2814,111 @@ percent sign (\fB%\fR) followed by a single upper-case letter (unrecognized tags print as text): .sp .ne 2 -.mk .na \fB\fB%D\fR\fR .ad .RS 6n -.rt Average amount of unshared data space used in Kilobytes. .RE .sp .ne 2 -.mk .na \fB\fB%E\fR\fR .ad .RS 6n -.rt Elapsed (wallclock) time for the command. .RE .sp .ne 2 -.mk .na \fB\fB%F\fR\fR .ad .RS 6n -.rt Page faults. .RE .sp .ne 2 -.mk .na \fB\fB%I\fR\fR .ad .RS 6n -.rt Number of block input operations. .RE .sp .ne 2 -.mk .na \fB\fB%K\fR\fR .ad .RS 6n -.rt Average amount of unshared stack space used in Kilobytes. .RE .sp .ne 2 -.mk .na \fB\fB%M\fR\fR .ad .RS 6n -.rt Maximum real memory used during execution of the process. .RE .sp .ne 2 -.mk .na \fB\fB%O\fR\fR .ad .RS 6n -.rt Number of block output operations. .RE .sp .ne 2 -.mk .na \fB\fB%P\fR\fR .ad .RS 6n -.rt Total CPU time \(em U (user) plus S (system) \(em as a percentage of E (elapsed) time. .RE .sp .ne 2 -.mk .na \fB\fB%S\fR\fR .ad .RS 6n -.rt Number of seconds of CPU time consumed by the kernel on behalf of the user's process. .RE .sp .ne 2 -.mk .na \fB\fB%U\fR\fR .ad .RS 6n -.rt Number of seconds of \fBCPU\fR time devoted to the user's process. .RE .sp .ne 2 -.mk .na \fB\fB%W\fR\fR .ad .RS 6n -.rt Number of swaps. .RE .sp .ne 2 -.mk .na \fB\fB%X\fR\fR .ad .RS 6n -.rt Average amount of shared memory used in Kilobytes. .RE @@ -3302,12 +2929,10 @@ in that order. .sp .ne 2 -.mk .na \fB\fBverbose\fR\fR .ad .RS 13n -.rt Display each command after history substitution takes place. .RE @@ -3319,78 +2944,64 @@ encountering files greater than or equal to 2 Gbyte (2^31 bytes). .SH FILES .sp .ne 2 -.mk .na \fB\fB~/.cshrc\fR\fR .ad .RS 15n -.rt Read at beginning of execution by each shell. .RE .sp .ne 2 -.mk .na \fB\fB~/.login\fR\fR .ad .RS 15n -.rt Read by login shells after \fB\&.cshrc\fR at login. .RE .sp .ne 2 -.mk .na \fB\fB~/.logout\fR\fR .ad .RS 15n -.rt Read by login shells at logout. .RE .sp .ne 2 -.mk .na \fB\fB~/.history\fR\fR .ad .RS 15n -.rt Saved history for use at next login. .RE .sp .ne 2 -.mk .na \fB\fB/usr/bin/sh\fR\fR .ad .RS 15n -.rt The Bourne shell, for shell scripts not starting with a `\fB#\fR'. .RE .sp .ne 2 -.mk .na \fB\fB/tmp/sh*\fR\fR .ad .RS 15n -.rt Temporary file for `\fB<<\fR\&'. .RE .sp .ne 2 -.mk .na \fB\fB/etc/passwd\fR\fR .ad .RS 15n -.rt Source of home directories for `~\fIname\fR'. .RE @@ -3402,13 +3013,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled .TE .SH SEE ALSO @@ -3423,12 +3033,10 @@ CSIEnabled .SH DIAGNOSTICS .sp .ne 2 -.mk .na \fB\fBYou have stopped jobs.\fR\fR .ad .RS 26n -.rt You attempted to exit the C shell with stopped jobs under job control. An immediate second attempt to exit succeeds, terminating the stopped jobs. .RE diff --git a/usr/src/man/man1/csplit.1 b/usr/src/man/man1/csplit.1 index 1d384168d0..d4d312deac 100644 --- a/usr/src/man/man1/csplit.1 +++ b/usr/src/man/man1/csplit.1 @@ -2,14 +2,14 @@ .\" Copyright 1989 AT&T .\" Copyright (c) 1992, X/Open Company Limited All Rights Reserved .\" Portions Copyright (c) 2003, Sun Microsystems, Inc. All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 csplit 1 "4 Dec 2003" "SunOS 5.11" "User Commands" +.TH CSPLIT 1 "Dec 4, 2003" .SH NAME csplit \- split files based on context .SH SYNOPSIS @@ -30,12 +30,10 @@ operands, and writes the sizes of the files. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-f\fR\fI prefix\fR\fR .ad .RS 13n -.rt Names the created files \fIprefix\fR\fB00\fR, \fIprefix\fR\fB01\fR, ..., \fIprefix\fR\fIn\fR. The default is \fBxx00\fR ... \fBxx\fR\fIn\fR. If the \fIprefix\fR argument would create a file name exceeding \fB14\fR bytes, an @@ -45,36 +43,30 @@ no files are created. .sp .ne 2 -.mk .na \fB\fB-k\fR\fR .ad .RS 13n -.rt Leaves previously created files intact. By default, \fBcsplit\fR removes created files if an error occurs. .RE .sp .ne 2 -.mk .na \fB\fB-n\fR\fI number\fR\fR .ad .RS 13n -.rt Uses \fInumber\fR decimal digits to form filenames for the file pieces. The default is \fB2\fR. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 13n -.rt Suppresses the output of file size messages. .RE @@ -84,12 +76,10 @@ Suppresses the output of file size messages. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIfile\fR\fR .ad .RS 8n -.rt The path name of a text file to be split. If \fIfile\fR is \fB-\fR, the standard input will be used. .RE @@ -99,12 +89,10 @@ standard input will be used. The operands \fIarg1\fR ... \fIargn\fR can be a combination of the following: .sp .ne 2 -.mk .na \fB/\fIrexp\fR/[\fIoffset\fR]\fR .ad .RS 18n -.rt Create a file using the content of the lines from the current line up to, but not including, the line that results from the evaluation of the regular expression with \fIoffset\fR, if any, applied. The regular expression @@ -123,24 +111,20 @@ of \fIrexp\fR always is applied from the current line to the end of the file. .sp .ne 2 -.mk .na \fB%\fIrexp\fR%[\fIoffset\fR]\fR .ad .RS 18n -.rt This operand is the same as /\fIrexp\fR/[\fIoffset\fR], except that no file will be created for the selected section of the input file. .RE .sp .ne 2 -.mk .na \fB\fIline_no\fR\fR .ad .RS 18n -.rt Create a file from the current line up to (but not including) the line number \fIline_no\fR. Lines in the file will be numbered starting at one. The current line becomes \fIline_no\fR. @@ -148,12 +132,10 @@ line becomes \fIline_no\fR. .sp .ne 2 -.mk .na \fB{\fInum\fR}\fR .ad .RS 18n -.rt Repeat operand. This operand can follow any of the operands described previously. If it follows a \fIrexp\fR type operand, that operand will be applied \fInum\fR more times. If it follows a \fIline_no\fR operand, the file @@ -245,23 +227,19 @@ that affect the execution of \fBcsplit\fR: \fBLANG\fR, \fBLC_ALL\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -273,15 +251,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO @@ -295,12 +272,10 @@ Interface StabilityStandard The diagnostic messages are self-explanatory, except for the following: .sp .ne 2 -.mk .na \fB\fIarg\fR \(mi out of range\fR .ad .RS 25n -.rt The given argument did not reference a line between the current position and the end of the file. .RE diff --git a/usr/src/man/man1/ctags.1 b/usr/src/man/man1/ctags.1 index 842465fd3a..cbcd35fe5b 100644 --- a/usr/src/man/man1/ctags.1 +++ b/usr/src/man/man1/ctags.1 @@ -1,13 +1,13 @@ '\" te .\" Copyright 1989 AT&T Copyright (c) 1980 Regents of the University of California. Copyright (c) 2001, Sun Microsystems, Inc. All Rights Reserved Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 ctags 1 "18 Mar 1997" "SunOS 5.11" "User Commands" +.TH CTAGS 1 "Mar 18, 1997" .SH NAME ctags \- create a tags file for use with ex and vi .SH SYNOPSIS @@ -61,69 +61,57 @@ The precedence of the options that pertain to printing is \fB-x\fR, \fB-v\fR, then the remaining options. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 15n -.rt Appends output to an existing \fBtags\fR file. .RE .sp .ne 2 -.mk .na \fB\fB-B\fR\fR .ad .RS 15n -.rt Uses backward searching patterns (\fB?\fR.\|.\|.\|\fB?\fR). .RE .sp .ne 2 -.mk .na \fB\fB-f\fR \fItagsfile\fR\fR .ad .RS 15n -.rt Places the tag descriptions in a file called \fItagsfile\fR instead of \fBtags\fR. .RE .sp .ne 2 -.mk .na \fB\fB-F\fR\fR .ad .RS 15n -.rt Uses forward searching patterns (\fB/\fR.\|.\|.\|\fB/\fR) (default). .RE .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad .RS 15n -.rt Creates tags for typedefs. \fB/usr/xpg4/bin/ctags\fR creates tags for typedefs by default. .RE .sp .ne 2 -.mk .na \fB\fB-u\fR\fR .ad .RS 15n -.rt Updates the specified files in tags, that is, all references to them are deleted, and the new values are appended to the file. Beware: this option is implemented in a way that is rather slow; it is usually faster to simply @@ -132,12 +120,10 @@ rebuild the \fBtags\fR file. .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 15n -.rt Produces on the standard output an index listing the function name, file name, and page number (assuming 64 line pages). Since the output will be sorted into lexicographic order, it may be desired to run the output through \fBsort\fR @@ -146,23 +132,19 @@ lexicographic order, it may be desired to run the output through \fBsort\fR .sp .ne 2 -.mk .na \fB\fB-w\fR\fR .ad .RS 15n -.rt Suppresses warning diagnostics. .RE .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad .RS 15n -.rt Produces a list of object names, the line number and file name on which each is defined, as well as the text of that line and prints this on the standard output. This is a simple index which can be printed out as an off-line readable @@ -175,36 +157,30 @@ function index. The following \fIfile\fR operands are supported: .sp .ne 2 -.mk .na \fB\fIfile\fR\fB\&.c\fR\fR .ad .RS 12n -.rt Files with basenames ending with the \fB\&.c\fR suffix are treated as C-language source code. .RE .sp .ne 2 -.mk .na \fB\fIfile\fR\fB\&.h\fR\fR .ad .RS 12n -.rt Files with basenames ending with the \fB\&.h\fR suffix are treated as C-language source code. .RE .sp .ne 2 -.mk .na \fB\fIfile\fR\fB\&.f\fR\fR .ad .RS 12n -.rt Files with basenames ending with the \fB\&.f\fR suffix are treated as FORTRAN-language source code. .RE @@ -265,53 +241,45 @@ that affect the execution of \fBctags\fR: \fBLANG\fR, \fBLC_ALL\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fBtags\fR\fR .ad .RS 8n -.rt output tags file .RE .SH ATTRIBUTES .sp -.LP .SS "/usr/xpg4/bin/ctags" .sp .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man1/ctrun.1 b/usr/src/man/man1/ctrun.1 index 63e75aad93..e6840ec89f 100644 --- a/usr/src/man/man1/ctrun.1 +++ b/usr/src/man/man1/ctrun.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 ctrun 1 "25 Feb 2008" "SunOS 5.11" "User Commands" +.TH CTRUN 1 "Feb 25, 2008" .SH NAME ctrun \- execute command in a process contract .SH SYNOPSIS @@ -28,18 +28,15 @@ For additional information about process contracts, see \fBcontract\fR(4) and The following options are supported: .sp .ne 2 -.mk .na \fB\fB-A\fR \fIfmri aux\fR\fR .ad .RS 26n -.rt Sets the process contract creator's auxiliary field. .RE .sp .ne 2 -.mk .na \fB\fB-i\fR \fIevent\fR,[\fIevent\fR ...]\fR .ad @@ -48,18 +45,15 @@ Sets the process contract creator's auxiliary field. \fB\fB-f\fR \fIevent\fR,[\fIevent\fR ...]\fR .ad .RS 26n -.rt Sets the informative and fatal events, respectively. .sp The following are valid \fIevent\fRs: .sp .ne 2 -.mk .na \fB\fBcore\fR\fR .ad .RS 10n -.rt A member process dumped core. .sp \fBcore\fR events are informative by default. @@ -67,45 +61,37 @@ A member process dumped core. .sp .ne 2 -.mk .na \fB\fBempty\fR\fR .ad .RS 10n -.rt The last member of the process contract exited. .RE .sp .ne 2 -.mk .na \fB\fBexit\fR\fR .ad .RS 10n -.rt A member process exited. .RE .sp .ne 2 -.mk .na \fB\fBfork\fR\fR .ad .RS 10n -.rt A process was added to the process contract. .RE .sp .ne 2 -.mk .na \fB\fBhwerr\fR\fR .ad .RS 10n -.rt A member process encountered a hardware error. .sp \fBhwerr\fR events are fatal by default. @@ -113,12 +99,10 @@ A member process encountered a hardware error. .sp .ne 2 -.mk .na \fB\fBsignal\fR\fR .ad .RS 10n -.rt A member process received a fatal signal from a process in a different process contract. .RE @@ -132,12 +116,10 @@ lifetime of \fBcontract\fR is specified. See \fB-l\fR. .sp .ne 2 -.mk .na \fB\fB-F\fR \fIfmri\fR\fR .ad .RS 26n -.rt Sets the process contract service \fBFMRI\fR field. To set this field the caller is required to have the \fB{PRIV_CONTRACT_IDENTITY}\fR in its effective set. @@ -145,44 +127,36 @@ set. .sp .ne 2 -.mk .na \fB\fB-l\fR \fIlifetime\fR\fR .ad .RS 26n -.rt The following valid \fIlifetime\fR values are supported: .sp .ne 2 -.mk .na \fB\fBchild\fR\fR .ad .RS 12n -.rt \fBctrun\fR exits when the command exits, regardless of whether the contract is empty. .RE .sp .ne 2 -.mk .na \fB\fBcontract\fR\fR .ad .RS 12n -.rt \fBctrun\fR exits only when the contract exits. This is the default. .RE .sp .ne 2 -.mk .na \fB\fBnone\fR\fR .ad .RS 12n -.rt \fBctrun\fR exits immediately, orphaning the contract. .RE @@ -190,21 +164,17 @@ empty. .sp .ne 2 -.mk .na \fB\fB-o\fR \fIoption\fR,[\fIoption\fR ...]\fR .ad .RS 26n -.rt The following \fIoption\fRs are supported: .sp .ne 2 -.mk .na \fB\fBnoorphan\fR\fR .ad .RS 12n -.rt Kills all processes in the contract if the holder (\fBctrun\fR) exits. .sp This option is invalid when a lifetime of \fBnone\fR is specified. @@ -212,24 +182,20 @@ This option is invalid when a lifetime of \fBnone\fR is specified. .sp .ne 2 -.mk .na \fB\fBpgrponly\fR\fR .ad .RS 12n -.rt If a fatal error occurs, kills at most the process group of which the errant process is a member. .RE .sp .ne 2 -.mk .na \fB\fBregent\fR\fR .ad .RS 12n -.rt The contract inherits inheritable contracts when abandoned by member processes. .RE @@ -237,12 +203,10 @@ The contract inherits inheritable contracts when abandoned by member processes. .sp .ne 2 -.mk .na \fB\fB-r\fR \fIcount\fR\fR .ad .RS 26n -.rt If the contract encounters a fault, this option attempts to restart the command \fIcount\fR times. If \fIcount\fR is \fB0\fR, the attempt to restart continues indefinitely. By default, \fBctrun\fR does not attempt to restart the command. @@ -253,12 +217,10 @@ if the \fBpgrponly\fR option is used. .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad .RS 26n -.rt If the contract created by \fBctrun\fR inherited subcontracts from its member processes, attempts to transfer them to the new contract when restarting. .sp @@ -267,23 +229,19 @@ This option is invalid unless \fB-r\fR is also specified. .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 26n -.rt Displays contract events and \fBctrun\fR actions as they occur. .RE .sp .ne 2 -.mk .na \fB\fB-V\fR\fR .ad .RS 26n -.rt Displays verbose contract events, as are displayed by the \fB-v\fR option of \fBctwatch\fR. Implies \fB-v\fR. .RE @@ -294,23 +252,19 @@ Displays verbose contract events, as are displayed by the \fB-v\fR option of The following operands are supported: .sp .ne 2 -.mk .na \fB\fIargument\fR\fR .ad .RS 12n -.rt One of the strings treated as an argument to \fIcommand\fR. .RE .sp .ne 2 -.mk .na \fB\fIcommand\fR\fR .ad .RS 12n -.rt The command to be passed to \fBexecvp\fR(2). See \fBexec\fR(2). .RE @@ -365,69 +319,57 @@ exit status of \fBctrun\fR is the exit status of \fIcommand\fR. Otherwise, \fBctrun\fR exits with one of the following values: .sp .ne 2 -.mk .na \fB\fB123\fR\fR .ad .RS 7n -.rt The child process exited abnormally. .RE .sp .ne 2 -.mk .na \fB\fB124\fR\fR .ad .RS 7n -.rt \fBctrun\fR encountered an internal error. .RE .sp .ne 2 -.mk .na \fB\fB125\fR\fR .ad .RS 7n -.rt Invalid arguments were provided to \fBctrun\fR. .RE .sp .ne 2 -.mk .na \fB\fB126\fR\fR .ad .RS 7n -.rt \fIcommand\fR was found but could not be invoked. .RE .sp .ne 2 -.mk .na \fB\fB127\fR\fR .ad .RS 7n -.rt \fIcommand\fR could not be found. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB/system/contract/process/*\fR\fR .ad .RS 30n -.rt - + .RE .SH ATTRIBUTES @@ -438,13 +380,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilitySee below. +Interface Stability See below. .TE .sp diff --git a/usr/src/man/man1/ctstat.1 b/usr/src/man/man1/ctstat.1 index 471208074d..eac5c7d6df 100644 --- a/usr/src/man/man1/ctstat.1 +++ b/usr/src/man/man1/ctstat.1 @@ -3,13 +3,13 @@ .\" 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 ctstat 1 "16 Jun 2009" "SunOS 5.11" "User Commands" +.TH CTSTAT 1 "Jun 16, 2009" .SH NAME ctstat \- display active system contracts .SH SYNOPSIS .LP .nf -\fB/usr/bin/ctstat\fR [\fB-a\fR] [\fB-i\fR \fIcontractid...\fR] [\fB-t\fR \fItype...\fR] [\fB-v\fR] +\fB/usr/bin/ctstat\fR [\fB-a\fR] [\fB-i\fR \fIcontractid...\fR] [\fB-t\fR \fItype...\fR] [\fB-v\fR] [\fB-T\fR u | d ] [\fIinterval\fR [\fIcount\fR]] .fi @@ -28,7 +28,6 @@ statistics on all contracts in the system. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad @@ -40,7 +39,6 @@ which are in the owned, inherited, or orphan states are displayed. .sp .ne 2 -.mk .na \fB\fB-i\fR \fIcontractid\fR...\fR .ad @@ -55,7 +53,6 @@ commas, or enclosed in quotes and separated by commas or spaces. .sp .ne 2 -.mk .na \fB\fB-T\fR \fBu\fR | \fBd\fR\fR .ad @@ -70,7 +67,6 @@ time. See \fBtime\fR(2). Specify \fBd\fR for standard date format. See .sp .ne 2 -.mk .na \fB\fB-t\fR \fItype\fR...\fR .ad @@ -84,7 +80,6 @@ commas, or enclosed in quotes and separated by commas or spaces. The following types are supported: .sp .ne 2 -.mk .na \fB\fBprocess\fR\fR .ad @@ -97,7 +92,6 @@ Process contracts .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad @@ -112,7 +106,6 @@ Verbose output. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIinterval\fR\fR .ad @@ -123,7 +116,6 @@ Report once each \fIinterval\fR seconds. .sp .ne 2 -.mk .na \fB\fIcount\fR\fR .ad @@ -139,7 +131,6 @@ The following list defines the column headings and the meanings of a \fBctstat\fR report: .sp .ne 2 -.mk .na \fBCTID\fR .ad @@ -150,7 +141,6 @@ The contract \fBID\fR of the contract. .sp .ne 2 -.mk .na \fBZONEID\fR .ad @@ -161,7 +151,6 @@ The zone ID of the contract's creator. .sp .ne 2 -.mk .na \fBTYPE\fR .ad @@ -172,7 +161,6 @@ The contract type. .sp .ne 2 -.mk .na \fBSTATE\fR .ad @@ -181,7 +169,6 @@ The contract type. The state of the contract: .sp .ne 2 -.mk .na \fBowned\fR .ad @@ -192,7 +179,6 @@ Contract is owned by a process. .sp .ne 2 -.mk .na \fBinherited\fR .ad @@ -204,7 +190,6 @@ the owner's process contract. .sp .ne 2 -.mk .na \fBorphan\fR .ad @@ -218,7 +203,6 @@ owner. .sp .ne 2 -.mk .na \fBdead\fR .ad @@ -233,7 +217,6 @@ events) have been released. .sp .ne 2 -.mk .na \fBHOLDER\fR .ad @@ -246,7 +229,6 @@ regent process contract. .sp .ne 2 -.mk .na \fBEVENTS\fR .ad @@ -257,7 +239,6 @@ The number of unacknowledged critical events pending. .sp .ne 2 -.mk .na \fBQTIME\fR .ad @@ -268,7 +249,6 @@ The time until quantum ends, or \fB-\fR if no negotiation is in progress. .sp .ne 2 -.mk .na \fBNTIME\fR .ad @@ -343,7 +323,6 @@ CTID TYPE STATE HOLDER EVENTS QTIME NTIME The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad @@ -354,7 +333,6 @@ Successful completion. .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad @@ -365,7 +343,6 @@ An error occurred. .sp .ne 2 -.mk .na \fB\fB2\fR\fR .ad @@ -386,13 +363,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilitySee below. +Interface Stability See below. .TE .sp diff --git a/usr/src/man/man1/ctwatch.1 b/usr/src/man/man1/ctwatch.1 index bd1b4c68e9..77ad32ebc1 100644 --- a/usr/src/man/man1/ctwatch.1 +++ b/usr/src/man/man1/ctwatch.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 ctwatch 1 "14 Jul 2004" "SunOS 5.11" "User Commands" +.TH CTWATCH 1 "Jul 14, 2004" .SH NAME ctwatch \- watch events in a contract or group of contracts .SH SYNOPSIS @@ -24,12 +24,10 @@ contracts. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 6n -.rt Report events starting at the front of the event queue. Normally, \fBctwatch\fR reports only events which occur after it has been invoked. With the \fB-f\fR option, any events that still exist in the contracts' event queues when @@ -39,12 +37,10 @@ reported. .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 6n -.rt Reliably watches all messages. Normally, the system may drop informative events and acknowledged critical events at any time, so \fBctwatch\fR isn't guaranteed to see them all. This option may only be used if the \fBctwatch\fR is invoked @@ -53,12 +49,10 @@ with the \fB{PRIV_CONTRACT_EVENT}\fR privilege asserted in its effective set. .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 6n -.rt Request verbose event descriptions. .RE @@ -68,21 +62,17 @@ Request verbose event descriptions. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIcontract-type\fR\fR .ad .RS 17n -.rt Valid contract types are: .sp .ne 2 -.mk .na \fBprocess\fR .ad .RS 11n -.rt Process contracts. .RE @@ -90,12 +80,10 @@ Process contracts. .sp .ne 2 -.mk .na \fB\fIcontract-id\fR\fR .ad .RS 17n -.rt A valid contract id. .RE @@ -106,68 +94,56 @@ The following list defines the column headings and the meanings of a \fBctwatch\fR report: .sp .ne 2 -.mk .na \fBCTID\fR .ad .RS 11n -.rt The contract \fBID\fR generating the event. .RE .sp .ne 2 -.mk .na \fBEVID\fR .ad .RS 11n -.rt The event \fBID\fR. .RE .sp .ne 2 -.mk .na \fBCRIT\fR .ad .RS 11n -.rt Whether the event is informative, critical, or initiates an exit negotiation. Values are \fBinfo\fR, \fBcrit\fR, or \fBneg\fR, respectively. .RE .sp .ne 2 -.mk .na \fBACK\fR .ad .RS 11n -.rt The event has been acknowledged. Values are \fByes\fR or "\fBno\fR". .RE .sp .ne 2 -.mk .na \fBCTTYPE\fR .ad .RS 11n -.rt The contract type. .RE .sp .ne 2 -.mk .na \fBSUMMARY\fR .ad .RS 11n -.rt A type-specific summary of the event. .RE @@ -195,34 +171,28 @@ CTID EVID CRIT ACK CTTYPE SUMMARY The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt An error occurred. .RE .sp .ne 2 -.mk .na \fB\fB2\fR\fR .ad .RS 5n -.rt Invalid arguments. .RE @@ -238,13 +208,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilitySee below. +Interface Stability See below. .TE .sp diff --git a/usr/src/man/man1/cut.1 b/usr/src/man/man1/cut.1 index 185e9a37cc..b024031dda 100644 --- a/usr/src/man/man1/cut.1 +++ b/usr/src/man/man1/cut.1 @@ -2,14 +2,14 @@ .\" Copyright 1989 AT&T .\" Copyright (c) 1999, Sun Microsystems, Inc. All Rights Reserved .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 cut 1 "29 Apr 1999" "SunOS 5.11" "User Commands" +.TH CUT 1 "Apr 29, 1999" .SH NAME cut \- cut out selected fields of each line of a file .SH SYNOPSIS @@ -51,12 +51,10 @@ reorder columns in a table, use \fBcut\fR and \fBpaste\fR. The following options are supported: .sp .ne 2 -.mk .na \fB\fIlist\fR \fR .ad .RS 13n -.rt A comma-separated or blank-character-separated list of integer field numbers (in increasing order), with optional \fB\(mi\fR to indicate ranges (for instance, \fB1,4,7\fR; \fB1\(mi3,8\fR; \fB\(mi5,10\fR (short for @@ -65,12 +63,10 @@ instance, \fB1,4,7\fR; \fB1\(mi3,8\fR; \fB\(mi5,10\fR (short for .sp .ne 2 -.mk .na \fB\fB\fR\fB-b\fR \fIlist\fR \fR .ad .RS 13n -.rt The \fIlist\fR following \fB-b\fR specifies byte positions (for instance, \fB-b1\fR\fB-72\fR would pass the first 72 bytes of each line). When \fB-b\fR and \fB-n\fR are used together, \fIlist\fR is adjusted so that no multi-byte @@ -79,24 +75,20 @@ character is split. .sp .ne 2 -.mk .na \fB\fB\fR\fB-c\fR \fIlist\fR \fR .ad .RS 13n -.rt The \fIlist\fR following \fB-c\fR specifies character positions (for instance, \fB-c1\fR\fB-72\fR would pass the first 72 characters of each line). .RE .sp .ne 2 -.mk .na \fB\fB\fR\fB-d\fR \fIdelim\fR \fR .ad .RS 13n -.rt The character following \fB-d\fR is the field delimiter (\fB-f\fR option only). Default is \fItab\fR. Space or other characters with special meaning to the shell must be quoted. \fIdelim\fR can be a multi-byte character. @@ -104,12 +96,10 @@ shell must be quoted. \fIdelim\fR can be a multi-byte character. .sp .ne 2 -.mk .na \fB\fB\fR\fB-f\fR \fIlist\fR \fR .ad .RS 13n -.rt The \fIlist\fR following \fB-f\fR is a list of fields assumed to be separated in the file by a delimiter character (see \fB-d\fR ); for instance, \fB-f1\fR\fB,7\fR copies the first and seventh field only. Lines with no field @@ -119,24 +109,20 @@ delimiters will be passed through intact (useful for table subheadings), unless .sp .ne 2 -.mk .na \fB\fB-n\fR \fR .ad .RS 13n -.rt Do not split characters. When \fB-b\fR \fIlist\fR and \fB-n\fR are used together, \fIlist\fR is adjusted so that no multi-byte character is split. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR \fR .ad .RS 13n -.rt Suppresses lines with no delimiter characters in case of \fB-f\fR option. Unless specified, lines with no delimiters will be passed through untouched. .RE @@ -147,12 +133,10 @@ Unless specified, lines with no delimiters will be passed through untouched. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIfile\fR \fR .ad .RS 9n -.rt A path name of an input file. If no \fIfile\fR operands are specified, or if a \fIfile\fR operand is \fB\(mi\fR, the standard input will be used. .RE @@ -203,23 +187,19 @@ that affect the execution of \fBcut\fR: \fBLANG\fR, \fBLC_ALL\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR \fR .ad .RS 7n -.rt All input files were output successfully. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR \fR .ad .RS 7n -.rt An error occurred. .RE @@ -231,15 +211,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO @@ -250,7 +229,6 @@ Interface StabilityStandard .SH DIAGNOSTICS .sp .ne 2 -.mk .na \fB\fBcut: \fR\fB-n\fR\fB may only be used with \fR\fB-b\fR \fR .ad @@ -261,7 +239,6 @@ Interface StabilityStandard .sp .ne 2 -.mk .na \fB\fBcut: \fR\fB-d\fR\fB may only be used with \fR\fB-f\fR \fR .ad @@ -272,7 +249,6 @@ Interface StabilityStandard .sp .ne 2 -.mk .na \fB\fBcut: \fR\fB-s\fR\fB may only be used with \fR\fB-f\fR \fR .ad @@ -283,7 +259,6 @@ Interface StabilityStandard .sp .ne 2 -.mk .na \fB\fBcut: cannot open \fR\fI<file>\fR \fR .ad @@ -295,7 +270,6 @@ present, processing continues. .sp .ne 2 -.mk .na \fB\fBcut: no delimiter specified\fR \fR .ad @@ -306,7 +280,6 @@ Missing \fIdelim\fR on \fB-d\fR option. .sp .ne 2 -.mk .na \fB\fBcut: invalid delimiter\fR \fR .ad @@ -317,7 +290,6 @@ Missing \fIdelim\fR on \fB-d\fR option. .sp .ne 2 -.mk .na \fB\fBcut: no \fIlist\fR\fR\fB specified\fR \fR .ad @@ -328,7 +300,6 @@ Missing \fIlist\fR on \fB-b\fR, \fB-c\fR, or \fB-f\fR option. .sp .ne 2 -.mk .na \fB\fBcut: invalid range specifier\fR \fR .ad @@ -339,7 +310,6 @@ Missing \fIlist\fR on \fB-b\fR, \fB-c\fR, or \fB-f\fR option. .sp .ne 2 -.mk .na \fB\fBcut: too many ranges specified\fR \fR .ad @@ -350,7 +320,6 @@ Missing \fIlist\fR on \fB-b\fR, \fB-c\fR, or \fB-f\fR option. .sp .ne 2 -.mk .na \fB\fBcut: range must be increasing\fR \fR .ad @@ -361,7 +330,6 @@ Missing \fIlist\fR on \fB-b\fR, \fB-c\fR, or \fB-f\fR option. .sp .ne 2 -.mk .na \fB\fBcut: invalid character in range\fR \fR .ad @@ -372,7 +340,6 @@ Missing \fIlist\fR on \fB-b\fR, \fB-c\fR, or \fB-f\fR option. .sp .ne 2 -.mk .na \fB\fBcut: internal error processing input\fR \fR .ad @@ -383,7 +350,6 @@ Missing \fIlist\fR on \fB-b\fR, \fB-c\fR, or \fB-f\fR option. .sp .ne 2 -.mk .na \fB\fBcut: invalid multibyte character\fR \fR .ad @@ -394,7 +360,6 @@ Missing \fIlist\fR on \fB-b\fR, \fB-c\fR, or \fB-f\fR option. .sp .ne 2 -.mk .na \fB\fBcut: unable to allocate enough memory\fR \fR .ad diff --git a/usr/src/man/man1/date.1 b/usr/src/man/man1/date.1 index 7911b374c8..08c3b0b878 100644 --- a/usr/src/man/man1/date.1 +++ b/usr/src/man/man1/date.1 @@ -3,14 +3,14 @@ .\" Copyright (c) 2004, Sun Microsystems, Inc. All Rights Reserved .\" Copyright 1989 AT&T .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 date 1 "1 May 2011" "SunOS 5.11" "User Commands" +.TH DATE 1 "May 1, 2011" .SH NAME date \- write the date and time .SH SYNOPSIS @@ -84,12 +84,10 @@ Fri Dec 23 10:10:42 EST 1988 The following options are supported: .sp .ne 2 -.mk .na \fB\fB-a\fR [\|\fB-\fR\|]\|\fIsss.fff\fR \fR .ad .RS 24n -.rt Slowly adjust the time by \fIsss\fR.\fIfff\fR seconds (\fIfff\fR represents fractions of a second). This adjustment can be positive or negative. The system's clock is sped up or slowed down until it has drifted by the number of @@ -98,24 +96,20 @@ seconds specified. Only the super-user may adjust the time. .sp .ne 2 -.mk .na \fB\fB-u\fR \fR .ad .RS 24n -.rt Display (or set) the date in Greenwich Mean Time (GMT\(emuniversal time), bypassing the normal conversion to (or from) local time. .RE .sp .ne 2 -.mk .na \fB-R\fR .ad .RS 24n -.rt Change the default format to the format used for mail message headers (similar to RFC 822 format). The default format becomes .sp @@ -132,12 +126,10 @@ Change the default format to the format used for mail message headers The following operands are supported: .sp .ne 2 -.mk .na \fB\fB+\fR\fIformat\fR \fR .ad .RS 12n -.rt If the argument begins with \fB+\fR, the output of \fBdate\fR is the result of passing \fIformat\fR and the current time to \fBstrftime()\fR. \fBdate\fR uses the conversion specifications listed on the \fBstrftime\fR(3C) manual page, @@ -145,24 +137,20 @@ with the conversion specification for \fB%C\fR determined by whether \fB/usr/bin/date\fR or \fB/usr/xpg4/bin/date\fR is used: .sp .ne 2 -.mk .na \fB\fB/usr/bin/date\fR \fR .ad .RS 23n -.rt Locale's date and time representation. This is the default output for \fBdate\fR. .RE .sp .ne 2 -.mk .na \fB\fB/usr/xpg4/bin/date\fR \fR .ad .RS 23n -.rt Century (a year divided by 100 and truncated to an integer) as a decimal number [00-99]. .RE @@ -173,67 +161,55 @@ must be quoted; see the EXAMPLES section. .sp .ne 2 -.mk .na \fB\fImm\fR \fR .ad .RS 12n -.rt Month number .RE .sp .ne 2 -.mk .na \fB\fIdd\fR \fR .ad .RS 12n -.rt Day number in the month .RE .sp .ne 2 -.mk .na \fB\fIHH\fR \fR .ad .RS 12n -.rt Hour number (24 hour system) .RE .sp .ne 2 -.mk .na \fB\fIMM\fR \fR .ad .RS 12n -.rt Minute number .RE .sp .ne 2 -.mk .na \fB\fISS\fR \fR .ad .RS 12n -.rt Second number .RE .sp .ne 2 -.mk .na \fB\fIcc\fR \fR .ad .RS 12n -.rt Century (a year divided by 100 and truncated to an integer) as a decimal number [00-99]. For example, \fIcc\fR is \fB19\fR for the year 1988 and \fB20\fR for the year 2007. @@ -241,12 +217,10 @@ the year 2007. .sp .ne 2 -.mk .na \fB\fIyy\fR \fR .ad .RS 12n -.rt Last two digits of the year number. If century (\fIcc\fR) is not specified, then values in the range \fB69-99\fR shall refer to years 1969 to 1999 inclusive, and values in the range \fB00-68\fR shall refer to years 2000 to @@ -351,12 +325,10 @@ that affect the execution of \fBdate\fR: \fBLANG\fR, \fBLC_ALL\fR, \fBLC_CTYPE\fR, \fBLC_TIME\fR, \fBLC_MESSAGES\fR, and \fBNLSPATH\fR. .sp .ne 2 -.mk .na \fB\fBTZ\fR \fR .ad .RS 7n -.rt Determine the timezone in which the time and date are written, unless the \fB-u\fR option is specified. If the \fBTZ\fR variable is not set and the \fB-u\fR is not specified, the system default timezone is used. @@ -368,23 +340,19 @@ Determine the timezone in which the time and date are written, unless the The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR \fR .ad .RS 7n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR \fR .ad .RS 7n -.rt An error occurred. .RE @@ -397,13 +365,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIenabled +CSI enabled .TE .SS "/usr/xpg4/bin/date" @@ -411,15 +378,14 @@ CSIenabled .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIenabled +CSI enabled _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO @@ -429,23 +395,19 @@ Interface StabilityStandard .SH DIAGNOSTICS .sp .ne 2 -.mk .na \fB\fBno permission\fR \fR .ad .RS 19n -.rt You are not the super-user and you tried to change the date. .RE .sp .ne 2 -.mk .na \fB\fBbad conversion\fR \fR .ad .RS 19n -.rt The date set is syntactically incorrect. .RE diff --git a/usr/src/man/man1/dc.1 b/usr/src/man/man1/dc.1 index d01fa47833..f395d7e8a0 100644 --- a/usr/src/man/man1/dc.1 +++ b/usr/src/man/man1/dc.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 dc 1 "29 Aug 2003" "SunOS 5.11" "User Commands" +.TH DC 1 "Aug 29, 2003" .SH NAME dc \- desk calculator .SH SYNOPSIS @@ -38,12 +38,10 @@ The following constructions are recognized under both \fB/usr/bin/dc\fR and \fB/usr/xpg6/bin/dc\fR: .sp .ne 2 -.mk .na \fB\fInumber\fR\fR .ad .RS 15n -.rt The value of the number is pushed on the stack. A number is an unbroken string of the digits 0\(mi9. It may be preceded by an underscore (\fB_\fR) to input a negative number. Numbers may contain decimal points. @@ -51,12 +49,10 @@ negative number. Numbers may contain decimal points. .sp .ne 2 -.mk .na \fB\fBs\fR\fIx\fR\fR .ad .RS 15n -.rt The top of the stack is popped and stored into a register named \fIx\fR, where \fIx\fR may be any character. If the \fBs\fR is capitalized, \fIx\fR is treated as a stack and the value is pushed on it. @@ -64,12 +60,10 @@ treated as a stack and the value is pushed on it. .sp .ne 2 -.mk .na \fB\fBl\fR\fIx\fR\fR .ad .RS 15n -.rt The value in register \fIx\fR is pushed on the stack. The register \fIx\fR is not altered. All registers start with zero value. If the \fBl\fR is capitalized, register \fIx\fR is treated as a stack and its top value is popped @@ -78,125 +72,103 @@ onto the main stack. .sp .ne 2 -.mk .na \fB\fBd\fR\fR .ad .RS 15n -.rt The top value on the stack is duplicated. .RE .sp .ne 2 -.mk .na \fB\fBp\fR\fR .ad .RS 15n -.rt The top value on the stack is printed. The top value remains unchanged. .RE .sp .ne 2 -.mk .na \fB\fBP\fR\fR .ad .RS 15n -.rt Interprets the top of the stack as an ASCII string, removes it, and prints it. .RE .sp .ne 2 -.mk .na \fB\fBf\fR\fR .ad .RS 15n -.rt All values on the stack are printed. .RE .sp .ne 2 -.mk .na \fB\fBq\fR\fR .ad .RS 15n -.rt Exits the program. If executing a string, the recursion level is popped by two. .RE .sp .ne 2 -.mk .na \fB\fBQ\fR\fR .ad .RS 15n -.rt Exits the program. The top value on the stack is popped and the string execution level is popped by that value. .RE .sp .ne 2 -.mk .na \fB\fBx\fR\fR .ad .RS 15n -.rt Treats the top element of the stack as a character string and executes it as a string of \fBdc\fR commands. .RE .sp .ne 2 -.mk .na \fB\fBX\fR\fR .ad .RS 15n -.rt Replaces the number on the top of the stack with its scale factor. .RE .sp .ne 2 -.mk .na \fB\fB[ ... ]\fR\fR .ad .RS 15n -.rt Puts the bracketed ASCII string onto the top of the stack. .RE .sp .ne 2 -.mk .na \fB\fB<\fR\fIx \fR \fB>\fR\fIx \fR \fB=\fR\fIx \fR\fR .ad .RS 15n -.rt The top two elements of the stack are popped and compared. Register \fIx\fR is evaluated if they obey the stated relation. .RE .sp .ne 2 -.mk .na \fB\fBv\fR\fR .ad .RS 15n -.rt Replaces the top element on the stack by its square root. Any existing fractional part of the argument is taken into account, but otherwise the scale factor is ignored. @@ -204,80 +176,66 @@ factor is ignored. .sp .ne 2 -.mk .na \fB\fB!\fR\fR .ad .RS 15n -.rt Interprets the rest of the line as a shell command. .RE .sp .ne 2 -.mk .na \fB\fBc\fR\fR .ad .RS 15n -.rt All values on the stack are popped. .RE .sp .ne 2 -.mk .na \fB\fBi\fR\fR .ad .RS 15n -.rt The top value on the stack is popped and used as the number radix for further input. .RE .sp .ne 2 -.mk .na \fB\fBI\fR\fR .ad .RS 15n -.rt Pushes the input base on the top of the stack. .RE .sp .ne 2 -.mk .na \fB\fBo\fR\fR .ad .RS 15n -.rt The top value on the stack is popped and used as the number radix for further output. .RE .sp .ne 2 -.mk .na \fB\fBO\fR\fR .ad .RS 15n -.rt Pushes the output base on the top of the stack. .RE .sp .ne 2 -.mk .na \fB\fBk\fR\fR .ad .RS 15n -.rt The top of the stack is popped, and that value is used as a non-negative scale factor: the appropriate number of places are printed on output, and maintained during multiplication, division, and exponentiation. The interaction of scale @@ -287,68 +245,56 @@ together. .sp .ne 2 -.mk .na \fB\fBK\fR\fR .ad .RS 15n -.rt Pushes the current scale factor on the top of the stack. .RE .sp .ne 2 -.mk .na \fB\fBz\fR\fR .ad .RS 15n -.rt The stack level is pushed onto the stack. .RE .sp .ne 2 -.mk .na \fB\fBZ\fR\fR .ad .RS 15n -.rt Replaces the number on the top of the stack with its length. .RE .sp .ne 2 -.mk .na \fB\fB?\fR\fR .ad .RS 15n -.rt A line of input is taken from the input source (usually the terminal) and executed. .RE .sp .ne 2 -.mk .na \fB\fBY\fR\fR .ad .RS 15n -.rt Displays \fBdc\fR debugging information. .RE .sp .ne 2 -.mk .na \fB\fB; :\fR\fR .ad .RS 15n -.rt Used by \fBbc\fR(1) for array operations. .RE @@ -359,12 +305,10 @@ The following construction is recognized under \fB/usr/bin/dc\fR, using the scale of whatever the result is. .sp .ne 2 -.mk .na \fB\fB+ \(mi / * % ^\fR\fR .ad .RS 18n -.rt The top two values on the stack are added (\fB+\fR), subtracted (\fB\(mi\fR), multiplied (\fB*\fR), divided (\fB/\fR), remaindered (\fB%\fR), or exponentiated (\fB^\fR). The two entries are popped off the stack; the result @@ -379,12 +323,10 @@ The following construction is recognized under \fB/usr/xpg6/bin/dc\fR. The results of division are forced to be a scale of 20. .sp .ne 2 -.mk .na \fB\fB+ \(mi / * % ^\fR\fR .ad .RS 18n -.rt The top two values on the stack are added (\fB+\fR), subtracted (\fB\(mi\fR), multiplied (\fB*\fR), divided (\fB/\fR), remaindered (\fB%\fR), or exponentiated (\fB^\fR). The two entries are popped off the stack. The result @@ -418,188 +360,154 @@ lyx .SH DIAGNOSTICS .sp .ne 2 -.mk .na \fB\fIx\fR \fBis unimplemented\fR\fR .ad .RS 29n -.rt \fIx\fR is an octal number. .RE .sp .ne 2 -.mk .na \fB\fBout of space\fR\fR .ad .RS 29n -.rt The free list is exhausted (too many digits). .RE .sp .ne 2 -.mk .na \fB\fBout of stack space\fR\fR .ad .RS 29n -.rt Too many pushes onto the stack (stack overflow). .RE .sp .ne 2 -.mk .na \fB\fBempty stack\fR\fR .ad .RS 29n -.rt Too many pops from the stack (stack underflow). .RE .sp .ne 2 -.mk .na \fB\fBnesting depth\fR\fR .ad .RS 29n -.rt Too many levels of nested execution. .RE .sp .ne 2 -.mk .na \fB\fBdivide by 0\fR\fR .ad .RS 29n -.rt Division by zero. .RE .sp .ne 2 -.mk .na \fB\fBsqrt of neg number\fR\fR .ad .RS 29n -.rt Square root of a negative number is not defined (no imaginary numbers). .RE .sp .ne 2 -.mk .na \fB\fBexp not an integer\fR\fR .ad .RS 29n -.rt \fBdc\fR only processes integer exponentiation. .RE .sp .ne 2 -.mk .na \fB\fBexp too big\fR\fR .ad .RS 29n -.rt The largest exponent allowed is 999. .RE .sp .ne 2 -.mk .na \fB\fBinput base is too large\fR\fR .ad .RS 29n -.rt The input base x: 2<= x <= 16. .RE .sp .ne 2 -.mk .na \fB\fBinput base is too small\fR\fR .ad .RS 29n -.rt The input base x: 2<= x <= 16. .RE .sp .ne 2 -.mk .na \fB\fBoutput base is too large\fR\fR .ad .RS 29n -.rt The output base must be no larger than \fBBC_BASE_MAX\fR. .RE .sp .ne 2 -.mk .na \fB\fBinvalid scale factor\fR\fR .ad .RS 29n -.rt Scale factor cannot be less than 1. .RE .sp .ne 2 -.mk .na \fB\fBscale factor is too large\fR\fR .ad .RS 29n -.rt A scale factor cannot be larger than \fBBC_SCALE_MAX\fR. .RE .sp .ne 2 -.mk .na \fB\fBsymbol table overflow\fR\fR .ad .RS 29n -.rt Too many variables have been specified. .RE .sp .ne 2 -.mk .na \fB\fBinvalid index\fR\fR .ad .RS 29n -.rt Index cannot be less than 1. .RE .sp .ne 2 -.mk .na \fB\fBindex is too large\fR\fR .ad .RS 29n -.rt An index cannot be larger than \fBBC_DIM_MAX\fR. .RE diff --git a/usr/src/man/man1/deallocate.1 b/usr/src/man/man1/deallocate.1 index 69bcda472e..ae3a6ab4c6 100644 --- a/usr/src/man/man1/deallocate.1 +++ b/usr/src/man/man1/deallocate.1 @@ -3,19 +3,19 @@ .\" 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 deallocate 1 "30 Apr 2008" "SunOS 5.11" "User Commands" +.TH DEALLOCATE 1 "Apr 30, 2008" .SH NAME deallocate \- device deallocation .SH SYNOPSIS .LP .nf -\fBdeallocate\fR [\fB-s\fR] [\fB-w\fR] [\fB-F\fR] [\fB-z\fR \fIzonename\fR] +\fBdeallocate\fR [\fB-s\fR] [\fB-w\fR] [\fB-F\fR] [\fB-z\fR \fIzonename\fR] [\fB-c\fR \fIdev-class\fR | \fB-g\fR \fIdev-type\fR | \fIdevice\fR] .fi .LP .nf -\fBdeallocate\fR [\fB-s\fR] [\fB-w\fR] [\fB-F\fR] [\fB-z\fR \fIzonename\fR] \fB-I\fR +\fBdeallocate\fR [\fB-s\fR] [\fB-w\fR] [\fB-F\fR] [\fB-z\fR \fIzonename\fR] \fB-I\fR .fi .SH DESCRIPTION @@ -35,23 +35,19 @@ user. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-c\fR \fIdev-class\fR\fR .ad .RS 16n -.rt Deallocates all devices of the specified device class. .RE .sp .ne 2 -.mk .na \fB\fB-F\fR \fIdevice\fR\fR .ad .RS 16n -.rt Forces deallocation of the device associated with the file specified by \fIdevice\fR. Only a user with the \fBsolaris.device.revoke\fR authorization is permitted to use this option. @@ -59,12 +55,10 @@ permitted to use this option. .sp .ne 2 -.mk .na \fB\fB-I\fR\fR .ad .RS 16n -.rt Forces deallocation of all allocatable devices. Only a user with the \fBsolaris.device.revoke\fR authorization is permitted to use this option. This option should only be used at system initialization. @@ -72,12 +66,10 @@ option should only be used at system initialization. .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 16n -.rt Silent. Suppresses any diagnostic output. .RE @@ -87,23 +79,19 @@ The following options are supported when the system is configured with Trusted Extensions: .sp .ne 2 -.mk .na \fB\fB-g\fR \fIdev-type\fR\fR .ad .RS 15n -.rt Deallocates a device of device type matching \fIdev-type\fR. .RE .sp .ne 2 -.mk .na \fB\fB-w\fR\fR .ad .RS 15n -.rt Runs the device cleaning program in a windowing environment. If a windowing version of the program exists, it is used. Otherwise, the standard version is run in a terminal window. @@ -111,12 +99,10 @@ run in a terminal window. .sp .ne 2 -.mk .na \fB\fB-z\fR \fIzonename\fR\fR .ad .RS 15n -.rt Deallocates device from the zone specified by \fIzonename\fR. .RE @@ -126,12 +112,10 @@ Deallocates device from the zone specified by \fIzonename\fR. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIdevice\fR\fR .ad .RS 10n -.rt Deallocates the specified \fIdevice\fR. .RE @@ -141,34 +125,28 @@ Deallocates the specified \fIdevice\fR. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 15n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB20\fR\fR .ad .RS 15n -.rt No entry for the specified device. .RE .sp .ne 2 -.mk .na \fB\fIother value\fR\fR .ad .RS 15n -.rt An error occurred. .RE @@ -193,13 +171,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilitySee below. +Interface Stability See below. .TE .sp diff --git a/usr/src/man/man1/deroff.1 b/usr/src/man/man1/deroff.1 index a74022ad4b..74f061b343 100644 --- a/usr/src/man/man1/deroff.1 +++ b/usr/src/man/man1/deroff.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 deroff 1 "14 Sep 1992" "SunOS 5.11" "User Commands" +.TH DEROFF 1 "Sep 14, 1992" .SH NAME deroff \- remove nroff/troff, tbl, and eqn constructs .SH SYNOPSIS @@ -29,12 +29,10 @@ standard input. .SH OPTIONS .sp .ne 2 -.mk .na \fB\fB-m\fR\fR .ad .RS 6n -.rt The \fB-m\fR option may be followed by an \fBm\fR, \fBs\fR, or \fBl\fR. The \fB-mm\fR option causes the macros to be interpreted so that only running text is output (that is, no text from macro lines.) The \fB-ml\fR option forces the @@ -44,12 +42,10 @@ macros. .sp .ne 2 -.mk .na \fB\fB-w\fR\fR .ad .RS 6n -.rt If the \fB-w\fR option is given, the output is a word list, one ``word'' per line, with all other characters deleted. Otherwise, the output follows the original, with the deletions mentioned above. In text, a ``word'' is any string @@ -63,12 +59,10 @@ ampersands are removed from ``words.'' .sp .ne 2 -.mk .na \fB\fB-i\fR\fR .ad .RS 6n -.rt The \fB-i\fR option causes \fBderoff\fR to ignore \fB\&.so\fR and \fB\&.nx\fR commands. .RE diff --git a/usr/src/man/man1/dhcpinfo.1 b/usr/src/man/man1/dhcpinfo.1 index 7d5c0b9756..24b8918a8b 100644 --- a/usr/src/man/man1/dhcpinfo.1 +++ b/usr/src/man/man1/dhcpinfo.1 @@ -1,10 +1,10 @@ '\" te -.\" Copyright (c) 1992-1996 Competitive Automation, Inc. +.\" Copyright (c) 1992-1996 Competitive Automation, Inc. .\" Copyright (c) 2009, 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 dhcpinfo 1 "15 May 2009" "SunOS 5.11" "User Commands" +.TH DHCPINFO 1 "May 15, 2009" .SH NAME dhcpinfo \- display values of parameters received through DHCP .SH SYNOPSIS @@ -57,29 +57,27 @@ their formats are listed below: .sp .TS -tab(); -cw(1.4i) cw(2.1i) cw(2i) -lw(1.4i) lw(2.1i) lw(2i) -. -Data TypeFormat\fBdhcp_inittab\fR(4) type -Unsigned NumberOne or more decimal digitsT{ +c c c +l l l . +Data Type Format \fBdhcp_inittab\fR(4) type +Unsigned Number One or more decimal digits T{ \fBUNUMBER8\fR, \fBUNUMBER16\fR, \fBUNUMBER32\fR, \fBUNUMBER64\fR T} -Signed NumberT{ +Signed Number T{ One or more decimal digits, optionally preceded by a minus sign -T}T{ +T} T{ \fBSNUMBER8\fR, \fBSNUMBER16\fR, \fBSNUMBER32\fR, \fBSNUMBER64\fR T} -\fBIP\fR AddressDotted-decimal notation\fBIP\fR -IPv6 AddressColon-separated notation\fBIPv6\fR -OctetT{ +\fBIP\fR Address Dotted-decimal notation \fBIP\fR +IPv6 Address Colon-separated notation \fBIPv6\fR +Octet T{ The string \fB0x\fR followed by a two-digit hexadecimal value -T}\fBOCTET\fR -StringZero or more \fBASCII\fR characters\fBASCII\fR -DUIDDHCP Unique Identifier text\fBDUID\fR -Domain NameT{ +T} \fBOCTET\fR +String Zero or more \fBASCII\fR characters \fBASCII\fR +DUID DHCP Unique Identifier text \fBDUID\fR +Domain Name T{ Standard dot-separated domain name, RFC 1035 format -T}\fBDOMAIN\fR +T} \fBDOMAIN\fR .TE .SH OPTIONS @@ -88,24 +86,20 @@ T}\fBDOMAIN\fR The following options are supported: .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad .RS 16n -.rt Displays the output in a canonical format. This format is identical to the \fBOCTET\fR format with a granularity of \fB1\fR. .RE .sp .ne 2 -.mk .na \fB\fB-i\fR \fIinterface\fR\fR .ad .RS 16n -.rt Specifies the interface to retrieve values for \fBDHCP\fR parameters from. If this option is not specified, the primary interface is used. .sp @@ -126,23 +120,19 @@ interface, not one of the logical interfaces created by \fBdhcpagent\fR. .sp .ne 2 -.mk .na \fB\fB-n\fR \fIlimit\fR\fR .ad .RS 16n -.rt Limits the list of values displayed to \fIlimit\fR lines. .RE .sp .ne 2 -.mk .na \fB\fB-v\fR\fB4 | 6\fR\fR .ad .RS 16n -.rt Specifies the DHCP version to query. Use \fB-v4\fRfor DHCPv4 and \fB-v6\fR for DHCPv6. .RE @@ -153,12 +143,10 @@ DHCPv6. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIcode\fR\fR .ad .RS 14n -.rt Numeric code for the requested \fBDHCP\fR parameter, as defined by the \fBDHCP\fR specification. Vendor options are specified by adding \fB256\fR to the actual vendor code for DHCPv4, and \fB65536\fR for DHCPv6. @@ -166,12 +154,10 @@ the actual vendor code for DHCPv4, and \fB65536\fR for DHCPv6. .sp .ne 2 -.mk .na \fB\fIidentifier\fR\fR .ad .RS 14n -.rt Mnemonic symbol for the requested \fBDHCP\fR parameter, as listed in \fBdhcp_inittab\fR(4). .RE @@ -182,23 +168,19 @@ Mnemonic symbol for the requested \fBDHCP\fR parameter, as listed in The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt Successful operation. .RE .sp .ne 2 -.mk .na \fB\fB2\fR\fR .ad .RS 5n -.rt The operation was not successful. The \fBDHCP\fR client daemon might not be running, the interface might have failed to configure, or no satisfactory \fBDHCP\fR responses were received. @@ -206,34 +188,28 @@ running, the interface might have failed to configure, or no satisfactory .sp .ne 2 -.mk .na \fB\fB3\fR\fR .ad .RS 5n -.rt Bad arguments. .RE .sp .ne 2 -.mk .na \fB\fB4\fR\fR .ad .RS 5n -.rt The operation timed out. .RE .sp .ne 2 -.mk .na \fB\fB6\fR\fR .ad .RS 5n -.rt System error (should never occur). .RE @@ -245,13 +221,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed .TE .SH SEE ALSO diff --git a/usr/src/man/man1/diff.1 b/usr/src/man/man1/diff.1 index f4e522c0b1..ea4ee76950 100644 --- a/usr/src/man/man1/diff.1 +++ b/usr/src/man/man1/diff.1 @@ -1,13 +1,13 @@ '\" te .\" Copyright 1989 AT&T Copyright (c) 2004, Sun Microsystems, Inc. All Rights Reserved Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 diff 1 "22 Sep 2004" "SunOS 5.11" "User Commands" +.TH DIFF 1 "Sep 22, 2004" .SH NAME diff \- compare two files .SH SYNOPSIS @@ -28,7 +28,7 @@ diff \- compare two files .LP .nf -\fBdiff\fR [\fB-bitw\fR] [\fB-c\fR | \fB-e\fR | \fB-f\fR | \fB-h\fR | \fB-n\fR | \fB-u\fR] [\fB-l\fR] [\fB-r\fR] [\fB-s\fR] +\fBdiff\fR [\fB-bitw\fR] [\fB-c\fR | \fB-e\fR | \fB-f\fR | \fB-h\fR | \fB-n\fR | \fB-u\fR] [\fB-l\fR] [\fB-r\fR] [\fB-s\fR] [\fB-S\fR \fIname\fR] \fIdirectory1\fR \fIdirectory2\fR .fi @@ -72,36 +72,30 @@ second file flagged by `\|\fB>\fR\|'. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-b\fR \fR .ad .RS 7n -.rt Ignores trailing blanks (spaces and tabs) and treats other strings of blanks as equivalent. .RE .sp .ne 2 -.mk .na \fB\fB-i\fR \fR .ad .RS 7n -.rt Ignores the case of letters. For example, `\fBA\fR' will compare equal to `\fBa\fR'. .RE .sp .ne 2 -.mk .na \fB\fB-t\fR \fR .ad .RS 7n -.rt Expands TAB characters in output lines. Normal or \fB-c\fR output adds character(s) to the front of each line that may adversely affect the indentation of the original source lines and make the output lines difficult to @@ -110,12 +104,10 @@ interpret. This option will preserve the original source's indentation. .sp .ne 2 -.mk .na \fB\fB-w\fR \fR .ad .RS 7n -.rt Ignores all blanks (SPACE and TAB characters) and treats all other strings of blanks as equivalent. For example, `\fBif ( a =\|= b )\fR' will compare equal to `\fBif(a=\|=b)\fR'. @@ -126,12 +118,10 @@ to `\fBif(a=\|=b)\fR'. The following options are mutually exclusive: .sp .ne 2 -.mk .na \fB\fB-c\fR \fR .ad .RS 14n -.rt Produces a listing of differences with three lines of context. With this option, output format is modified slightly. That is, output begins with identification of the files involved and their creation dates, then each change @@ -143,24 +133,20 @@ files with '\|!\|'. .sp .ne 2 -.mk .na \fB\fB-C\fR \fInumber\fR \fR .ad .RS 14n -.rt Produces a listing of differences identical to that produced by \fB-c\fR with \fInumber\fR lines of context. .RE .sp .ne 2 -.mk .na \fB\fB-D\fR \fIstring\fR \fR .ad .RS 14n -.rt Creates a merged version of \fIfile1\fR and \fIfile2\fR with C preprocessor controls included so that a compilation of the result without defining \fIstring\fR is equivalent to compiling \fIfile1\fR, while defining @@ -169,12 +155,10 @@ controls included so that a compilation of the result without defining .sp .ne 2 -.mk .na \fB\fB-e\fR \fR .ad .RS 14n -.rt Produces a script of only \fBa\fR, \fBc\fR, and \fBd\fR commands for the editor \fBed\fR, which will recreate \fIfile2\fR from \fIfile1\fR. In connection with the \fB-e\fR option, the following shell program may help maintain multiple @@ -193,23 +177,19 @@ hand. A ``latest version'' appears on the standard output. .sp .ne 2 -.mk .na \fB\fB-f\fR \fR .ad .RS 13n -.rt Produces a similar script, not useful with \fBed\fR, in the opposite order. .RE .sp .ne 2 -.mk .na \fB\fB-h\fR \fR .ad .RS 13n -.rt Does a fast, half-hearted job. It works only when changed stretches are short and well separated, but does work on files of unlimited length. Options \fB-c\fR, \fB-C\fR, \fB-D\fR, \fB-e\fR, \fB-f\fR, and \fB-n\fR are unavailable @@ -218,24 +198,20 @@ with \fB-h\fR. \fBdiff\fR does not descend into directories with this option. .sp .ne 2 -.mk .na \fB\fB-n\fR \fR .ad .RS 13n -.rt Produces a script similar to \fB-e\fR, but in the opposite order and with a count of changed lines on each insert or delete command. .RE .sp .ne 2 -.mk .na \fB\fB-u\fR\fR .ad .RS 13n -.rt Produces a listing of differences with three lines of context. The output is similar to that of the \fB-c\fR option, except that the context is "unified". Removed and changed lines in \fIfile1\fR are marked by a '\fB-\fR' while lines @@ -257,12 +233,10 @@ Each change is separated by a line of the form .sp .ne 2 -.mk .na \fB\fB-U\fR \fInumber\fR\fR .ad .RS 13n -.rt Produces a listing of differences identical to that produced by \fB-u\fR with \fInumber\fR lines of context. .RE @@ -272,12 +246,10 @@ Produces a listing of differences identical to that produced by \fB-u\fR with The following options are used for comparing directories: .sp .ne 2 -.mk .na \fB\fB-l\fR \fR .ad .RS 12n -.rt Produces output in long format. Before the \fBdiff\fR, each text file is piped through \fBpr\fR(1) to paginate it. Other differences are remembered and summarized after all text file differences are reported. @@ -285,35 +257,29 @@ summarized after all text file differences are reported. .sp .ne 2 -.mk .na \fB\fB-r\fR \fR .ad .RS 12n -.rt Applies \fBdiff\fR recursively to common subdirectories encountered. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR \fR .ad .RS 12n -.rt Reports files that are identical. These identical files would not otherwise be mentioned. .RE .sp .ne 2 -.mk .na \fB\fB-S\fR \fIname\fR \fR .ad .RS 12n -.rt Starts a directory \fBdiff\fR in the middle, beginning with the file \fIname\fR. .RE @@ -324,7 +290,6 @@ Starts a directory \fBdiff\fR in the middle, beginning with the file The following operands are supported: .sp .ne 2 -.mk .na \fB\fIfile1\fR \fR .ad @@ -333,14 +298,12 @@ The following operands are supported: \fB\fIfile2\fR\fR .ad .RS 15n -.rt A path name of a file or directory to be compared. If either \fIfile1\fR or \fIfile2\fR is \fB\(mi\fR, the standard input will be used in its place. .RE .sp .ne 2 -.mk .na \fB\fIdirectory1\fR \fR .ad @@ -349,7 +312,6 @@ A path name of a file or directory to be compared. If either \fIfile1\fR or \fB\fIdirectory2\fR\fR .ad .RS 15n -.rt A path name of a directory to be compared. .RE @@ -403,12 +365,10 @@ that affect the execution of \fBdiff\fR: \fBLANG\fR, \fBLC_ALL\fR, \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, \fBLC_TIME\fR, and \fBNLSPATH\fR. .sp .ne 2 -.mk .na \fB\fBTZ\fR \fR .ad .RS 7n -.rt Determines the locale for affecting the timezone used for calculating file timestamps written with the \fB-C\fR and \fB-c\fR options. .RE @@ -419,57 +379,47 @@ timestamps written with the \fB-C\fR and \fB-c\fR options. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR \fR .ad .RS 7n -.rt No differences were found. .RE .sp .ne 2 -.mk .na \fB\fB1\fR \fR .ad .RS 7n -.rt Differences were found. .RE .sp .ne 2 -.mk .na \fB\fB>1\fR \fR .ad .RS 7n -.rt An error occurred. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB/tmp/d?????\fR \fR .ad .RS 19n -.rt temporary file used for comparison .RE .sp .ne 2 -.mk .na \fB\fB/usr/lib/diffh\fR \fR .ad .RS 19n -.rt executable file for \fB-h\fR option .RE @@ -481,15 +431,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man1/diff3.1 b/usr/src/man/man1/diff3.1 index 27988ae4bb..001761ac6b 100644 --- a/usr/src/man/man1/diff3.1 +++ b/usr/src/man/man1/diff3.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 diff3 1 "7 Nov 2005" "SunOS 5.11" "User Commands" +.TH DIFF3 1 "Nov 7, 2005" .SH NAME diff3 \- 3-way differential file comparison .SH SYNOPSIS @@ -19,45 +19,37 @@ diff3 \- 3-way differential file comparison of text flagged with the following codes: .sp .ne 2 -.mk .na \fB\fB====\fR\fR .ad .RS 9n -.rt all three files differ .RE .sp .ne 2 -.mk .na \fB\fB====1\fR\fR .ad .RS 9n -.rt \fIfilename1\fRis different .RE .sp .ne 2 -.mk .na \fB\fB====2\fR\fR .ad .RS 9n -.rt \fIfilename2\fRis different .RE .sp .ne 2 -.mk .na \fB\fB====3\fR\fR .ad .RS 9n -.rt \fIfilename3\fRis different .RE @@ -67,24 +59,20 @@ The type of change suffered in converting a given range of a given file to some other is indicated in one of the following ways: .sp .ne 2 -.mk .na \fB\fIf\fR\fB : \fR\fIn1\fR\fB a\fR\fR .ad .RS 17n -.rt Text is to be appended after line number \fIn1\fR in file \fIf\fR, where \fIf\fR = 1, 2, or 3. .RE .sp .ne 2 -.mk .na \fB\fIf\fR\fB : \fR\fIn1\fR\fB , \fR\fIn2\fR\fB c\fR\fR .ad .RS 17n -.rt Text is to be changed in the range line \fIn1\fR to line \fIn2\fR. If \fIn1\fR = \fIn\fR2, the range can be abbreviated to \fIn1\fR. .RE @@ -111,12 +99,10 @@ The following command applies the resulting script to \fIfilename1\fR. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-e\fR \fR .ad .RS 7n -.rt Produce a script for the \fBed\fR(1) editor that incorporates into \fIfilename1\fR all changes between \fIfilename2\fR and \fIfilename3\fR (that is, the changes that normally would be flagged \fB====\fR and \fB====3\fR). @@ -126,12 +112,10 @@ Text lines that consist of a single dot (\fB\&.\fR defeat the \fB-e\fR option. .sp .ne 2 -.mk .na \fB\fB-E\fR \fR .ad .RS 7n -.rt Produce a script that incorporates all changes between \fIfilename2\fR and \fIfilename3\fR, but treat overlapping changes (that is, changes that would be flagged with \fB====\fR in the normal listing) differently. The overlapping @@ -141,35 +125,29 @@ lines from both files are inserted by the edit script, bracketed by .sp .ne 2 -.mk .na \fB\fB-x\fR \fR .ad .RS 7n -.rt Produce a script to incorporate only changes flagged \fB====\fR. .RE .sp .ne 2 -.mk .na \fB\fB-X\fR \fR .ad .RS 7n -.rt Produce a script that incorporates only changes flagged \fB====\fR, but treat these changes in the manner of the \fB-E\fR option. .RE .sp .ne 2 -.mk .na \fB\fB-3\fR \fR .ad .RS 7n -.rt Produce a script to incorporate only changes flagged \fB====3\fR. .RE @@ -181,23 +159,19 @@ encountering files greater than or equal to 2 Gbyte ( 2^31 bytes). .SH FILES .sp .ne 2 -.mk .na \fB\fB/tmp/d3*\fR \fR .ad .RS 23n -.rt .RE .sp .ne 2 -.mk .na \fB\fB/usr/lib/diff3prog\fR \fR .ad .RS 23n -.rt .RE @@ -207,34 +181,28 @@ encountering files greater than or equal to 2 Gbyte ( 2^31 bytes). The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR \fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 6n -.rt An error occurred. A difference was found or there was a fatal error. .RE .sp .ne 2 -.mk .na \fB\fB>1\fR\fR .ad .RS 6n -.rt A fatal error occurred. .RE @@ -250,13 +218,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled .TE .SH SEE ALSO diff --git a/usr/src/man/man1/diffmk.1 b/usr/src/man/man1/diffmk.1 index cda7ddf2c8..2aef743146 100644 --- a/usr/src/man/man1/diffmk.1 +++ b/usr/src/man/man1/diffmk.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 diffmk 1 "14 Sep 1992" "SunOS 5.11" "User Commands" +.TH DIFFMK 1 "Sep 14, 1992" .SH NAME diffmk \- mark differences between versions of a troff input file .SH SYNOPSIS diff --git a/usr/src/man/man1/digest.1 b/usr/src/man/man1/digest.1 index 5d1eaf1f62..cacf5e296a 100644 --- a/usr/src/man/man1/digest.1 +++ b/usr/src/man/man1/digest.1 @@ -1,9 +1,9 @@ '\" te -.\" Copyright 2006, Sun Microsystems, Inc. All Rights Reserved +.\" Copyright 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 digest 1 "21 May 2009" "SunOS 5.11" "User Commands" +.TH DIGEST 1 "May 21, 2009" .SH NAME digest \- calculate a message digest .SH SYNOPSIS @@ -24,36 +24,30 @@ line of output is the digest of a single file. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-a\fR \fIalgorithm\fR\fR .ad .RS 16n -.rt Specifies the name of the algorithm to use during the encryption or decryption process. See USAGE, \fBAlgorithms\fR, for details. .RE .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 16n -.rt Displays list of algorithms available on the system. This list can change depending on the configuration of the cryptographic framework. .RE .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 16n -.rt Verbose output. Includes the algorithm name and filename in the output. .RE @@ -155,23 +149,19 @@ sha512 The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -183,13 +173,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed .TE .SH SEE ALSO diff --git a/usr/src/man/man1/dircmp.1 b/usr/src/man/man1/dircmp.1 index c9f7fa917f..d4bc165d88 100644 --- a/usr/src/man/man1/dircmp.1 +++ b/usr/src/man/man1/dircmp.1 @@ -2,14 +2,14 @@ .\" Copyright (c) 1996, Sun Microsystems, Inc. All Rights Reserved. .\" Copyright 1989 AT&T .\" Portions Copyright (c) 1992, X/Open Company Limited. All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 dircmp 1 "1 Feb 1995" "SunOS 5.11" "User Commands" +.TH DIRCMP 1 "Feb 1, 1995" .SH NAME dircmp \- directory comparison .SH SYNOPSIS @@ -32,12 +32,10 @@ common to both directories have the same contents. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad .RS 8n -.rt Compares the contents of files with the same name in both directories and output a list telling what must be changed in the two files to bring them into agreement. The list format is described in \fBdiff\fR(1). @@ -45,23 +43,19 @@ agreement. The list format is described in \fBdiff\fR(1). .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 8n -.rt Suppresses messages about identical files. .RE .sp .ne 2 -.mk .na \fB\fB-w\fR \fIn\fR\fR .ad .RS 8n -.rt Changes the width of the output line to \fIn\fR characters. The default width is \fB72\fR. .RE @@ -72,7 +66,6 @@ is \fB72\fR. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIdir1\fR\fR .ad @@ -81,7 +74,6 @@ The following operands are supported: \fB\fIdir2\fR\fR .ad .RS 8n -.rt A path name of a directory to be compared. .RE @@ -102,23 +94,19 @@ that affect the execution of \fBdircmp\fR: \fBLC_COLLATE\fR, \fBLC_CTYPE\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. (Differences in directory contents are not considered errors.) .RE diff --git a/usr/src/man/man1/dis.1 b/usr/src/man/man1/dis.1 index 026828eaf8..9580ec78a2 100644 --- a/usr/src/man/man1/dis.1 +++ b/usr/src/man/man1/dis.1 @@ -10,13 +10,13 @@ .\" 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 dis 1 "24 Aug 2009" "SunOS 5.11" "User Commands" +.TH DIS 1 "Aug 24, 2009" .SH NAME dis \- object code disassembler .SH SYNOPSIS .LP .nf -\fBdis\fR [\fB-onqCLV\fR] [\fB-d\fR \fIsec\fR] [\fB-D\fR \fIsec\fR] [\fB-F\fR \fIfunction\fR] +\fBdis\fR [\fB-onqCLV\fR] [\fB-d\fR \fIsec\fR] [\fB-D\fR \fIsec\fR] [\fB-F\fR \fIfunction\fR] [\fB-l\fR \fIstring\fR] [\fB-t\fR \fIsec\fR] \fIfile\fR... .fi @@ -36,47 +36,39 @@ Options are interpreted by the disassembler and can be specified in any order. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-C\fR\fR .ad .RS 15n -.rt Displays demangled C++ symbol names in the disassembly. .RE .sp .ne 2 -.mk .na \fB\fB-d\fR \fIsec\fR\fR .ad .RS 15n -.rt Disassembles the named section as data, printing the offset of the data from the beginning of the section. .RE .sp .ne 2 -.mk .na \fB\fB-D\fR \fIsec\fR\fR .ad .RS 15n -.rt Disassembles the named section as data, printing the actual address of the data. .RE .sp .ne 2 -.mk .na \fB\fB-F\fR \fIfunction\fR\fR .ad .RS 15n -.rt Disassembles only the named function in each object file specified on the command line. The \fB-F\fR option can be specified multiple times on the command line. @@ -84,12 +76,10 @@ command line. .sp .ne 2 -.mk .na \fB\fB-l\fR \fIstring\fR\fR .ad .RS 15n -.rt Disassembles the archive file specified by \fIstring\fR. For example, one would issue the command \fBdis\fR \fB-l\fR \fBx\fR \fB-l\fR \fBz\fR to disassemble \fBlibx.a\fR and \fBlibz.a\fR, which are assumed to be in \fBLIBDIR\fR. @@ -99,12 +89,10 @@ This option is obsolete and might be removed in a future release of Solaris. .sp .ne 2 -.mk .na \fB\fB-L\fR\fR .ad .RS 15n -.rt Invokes a lookup of C-language source labels in the symbol table for subsequent writing to standard output. .sp @@ -113,57 +101,47 @@ This option is obsolete and might be removed in a future release of Solaris. .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 15n -.rt Displays all addresses numerically. Addresses are displayed using symbolic names by default. .RE .sp .ne 2 -.mk .na \fB\fB-o\fR\fR .ad .RS 15n -.rt Prints numbers in octal. The default is hexadecimal. .RE .sp .ne 2 -.mk .na \fB\fB-q\fR\fR .ad .RS 15n -.rt Quiet mode. Does not print any headers or function entry labels. .RE .sp .ne 2 -.mk .na \fB\fB-t\fR \fIsec\fR\fR .ad .RS 15n -.rt Disassembles the named section as text. .RE .sp .ne 2 -.mk .na \fB\fB-V\fR\fR .ad .RS 15n -.rt Prints, on standard error, the version number of the disassembler being executed. .sp @@ -187,12 +165,10 @@ compiled with additional debugging information. The following operand is supported: .sp .ne 2 -.mk .na \fB\fIfile\fR\fR .ad .RS 8n -.rt A path name of an object file or an archive (see \fBar\fR(1)) of object files. .RE @@ -204,12 +180,10 @@ that affect the execution of \fBdis\fR: \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and \fBNLSPATH\fR. .sp .ne 2 -.mk .na \fB\fBLIBDIR\fR\fR .ad .RS 10n -.rt If this environment variable contains a value, use this as the path to search for the library. If the variable contains a null value, or is not set, it defaults to searching for the library under \fB/usr/lib\fR. @@ -221,35 +195,29 @@ defaults to searching for the library under \fB/usr/lib\fR. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB/usr/lib\fR\fR .ad .RS 12n -.rt default \fBLIBDIR\fR .RE @@ -261,13 +229,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilitySee below. +Interface Stability See below. .TE .sp diff --git a/usr/src/man/man1/disown.1 b/usr/src/man/man1/disown.1 index 74610fd19f..e4e59cbdcc 100644 --- a/usr/src/man/man1/disown.1 +++ b/usr/src/man/man1/disown.1 @@ -2,7 +2,7 @@ .\" Copyright (c) 1982-2007 AT&T Knowledge Ventures .\" To view license terms, see http://www.opensource.org/licenses/cpl1.0.txt .\" Portions Copyright (c) 2007, Sun Microsystems, Inc. -.TH disown 1 "18 Apr 2007" "SunOS 5.11" "User Commands" +.TH DISOWN 1 "Apr 18, 2007" .SH NAME disown \- ksh93 built-in function to disassociate a job with the current shell .SH SYNOPSIS @@ -27,89 +27,73 @@ recently started or stopped background job. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIjob\fR\fR .ad .RS 7n -.rt Specifies the job or jobs on which disown operates. .sp Specify \fIjob\fR as one of the following: .sp .ne 2 -.mk .na \fB\fInumber\fR\fR .ad .RS 12n -.rt Refers to a process ID. .RE .sp .ne 2 -.mk .na \fB\fB-\fR\fInumber\fR\fR .ad .RS 12n -.rt Refers to a process group ID. .RE .sp .ne 2 -.mk .na \fB\fB%\fR\fInumber\fR\fR .ad .RS 12n -.rt Refers to a job number. .RE .sp .ne 2 -.mk .na \fB\fB%\fR\fIstring\fR\fR .ad .RS 12n -.rt Refers to a job whose name begins with \fIstring\fR. .RE .sp .ne 2 -.mk .na \fB\fB%?\fR\fIstring\fR\fR .ad .RS 12n -.rt Refers to a job whose name contains \fIstring\fR. .RE .sp .ne 2 -.mk .na \fB\fB%+\fR or \fB%%\fR\fR .ad .RS 12n -.rt Refers to the current job. .RE .sp .ne 2 -.mk .na \fB\fB%-\fR\fR .ad .RS 12n -.rt Refers to the previous job. .RE @@ -118,23 +102,19 @@ Refers to the previous job. .SH EXIT STATUS .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt One or more specified jobs does not exist. .RE @@ -165,13 +145,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityUncommitted +Interface Stability Uncommitted .TE .SH SEE ALSO diff --git a/usr/src/man/man1/dispgid.1 b/usr/src/man/man1/dispgid.1 index aa481201ad..0fc506d9ff 100644 --- a/usr/src/man/man1/dispgid.1 +++ b/usr/src/man/man1/dispgid.1 @@ -3,13 +3,13 @@ .\" 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 dispgid 1 "14 Sep 1992" "SunOS 5.11" "User Commands" +.TH DISPGID 1 "Sep 14, 1992" .SH NAME dispgid \- displays a list of all valid group names .SH SYNOPSIS .LP .nf -\fBdispgid\fR +\fBdispgid\fR .fi .SH DESCRIPTION @@ -23,23 +23,19 @@ line). The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt Successful execution. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt Cannot read the group file. .RE diff --git a/usr/src/man/man1/dispuid.1 b/usr/src/man/man1/dispuid.1 index 7156cdc51f..df10df4455 100644 --- a/usr/src/man/man1/dispuid.1 +++ b/usr/src/man/man1/dispuid.1 @@ -3,13 +3,13 @@ .\" 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 dispuid 1 "14 Sep 1992" "SunOS 5.11" "User Commands" +.TH DISPUID 1 "Sep 14, 1992" .SH NAME dispuid \- displays a list of all valid user names .SH SYNOPSIS .LP .nf -\fBdispuid\fR +\fBdispuid\fR .fi .SH DESCRIPTION @@ -23,23 +23,19 @@ name). The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt Successful execution. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt Cannot read the password file. .RE diff --git a/usr/src/man/man1/dos2unix.1 b/usr/src/man/man1/dos2unix.1 index c4332f9dd4..0fe479ad55 100644 --- a/usr/src/man/man1/dos2unix.1 +++ b/usr/src/man/man1/dos2unix.1 @@ -3,13 +3,13 @@ .\" 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 dos2unix 1 "14 Sep 2000" "SunOS 5.11" "User Commands" +.TH DOS2UNIX 1 "Sep 14, 2000" .SH NAME dos2unix \- convert text file from DOS format to ISO format .SH SYNOPSIS .LP .nf -\fBdos2unix\fR [\fB-ascii\fR] [\fB-iso\fR] [\fB-7\fR] +\fBdos2unix\fR [\fB-ascii\fR] [\fB-iso\fR] [\fB-7\fR] [\fB-437\fR | \fB-850\fR | \fB-860\fR | \fB-863\fR | \fB-865\fR] \fIoriginalfile\fR \fIconvertedfile\fR .fi @@ -33,36 +33,30 @@ rewrite the original file after converting it. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-ascii\fR\fR .ad .RS 10n -.rt Removes extra carriage returns and converts end of file characters in \fBDOS\fR format text files to conform to SunOS requirements. .RE .sp .ne 2 -.mk .na \fB\fB-iso\fR\fR .ad .RS 10n -.rt This is the default. It converts characters in the \fBDOS\fR extended character set to the corresponding \fBISO\fR standard characters. .RE .sp .ne 2 -.mk .na \fB\fB-7\fR\fR .ad .RS 10n -.rt Converts 8 bit \fBDOS\fR graphics characters to 7 bit space characters so that SunOS can read the file. .RE @@ -74,56 +68,46 @@ determine which code page to use. Otherwise, the default is US. The user may override the code page with one of the following options: .sp .ne 2 -.mk .na \fB\fB-437\fR\fR .ad .RS 8n -.rt Use US code page .RE .sp .ne 2 -.mk .na \fB\fB-850\fR\fR .ad .RS 8n -.rt Use multilingual code page .RE .sp .ne 2 -.mk .na \fB\fB-860\fR\fR .ad .RS 8n -.rt Use Portuguese code page .RE .sp .ne 2 -.mk .na \fB\fB-863\fR\fR .ad .RS 8n -.rt Use French Canadian code page .RE .sp .ne 2 -.mk .na \fB\fB-865\fR\fR .ad .RS 8n -.rt Use Danish code page .RE @@ -133,24 +117,20 @@ Use Danish code page The following operands are required: .sp .ne 2 -.mk .na \fB\fIoriginalfile\fR \fR .ad .RS 18n -.rt The original file in \fBDOS\fR format that is being converted to \fBISO\fR format. .RE .sp .ne 2 -.mk .na \fB\fIconvertedfile\fR \fR .ad .RS 18n -.rt The new file in \fBISO\fR format that has been converted from the original \fBDOS\fR file format. .RE @@ -162,7 +142,6 @@ The new file in \fBISO\fR format that has been converted from the original .SH DIAGNOSTICS .sp .ne 2 -.mk .na \fB\fBFile \fIfilename\fR not found, or no read permission\fR\fR .ad @@ -174,7 +153,6 @@ permission. Check with the SunOS command, \fBls\fR \fB-l\fR (see \fBls\fR(1)). .sp .ne 2 -.mk .na \fB\fBBad output filename \fIfilename\fR, or no write permission\fR\fR .ad @@ -187,7 +165,6 @@ the drive or diskette is not write-protected. .sp .ne 2 -.mk .na \fB\fBError while writing to temporary file\fR\fR .ad @@ -202,7 +179,6 @@ occurs, the original file remains intact. .sp .ne 2 -.mk .na \fB\fBTranslated temporary file name =\fR \fIfilename\fR.\fR .ad diff --git a/usr/src/man/man1/download.1 b/usr/src/man/man1/download.1 index acf68584cd..f7ae7da5a7 100644 --- a/usr/src/man/man1/download.1 +++ b/usr/src/man/man1/download.1 @@ -3,19 +3,19 @@ .\" 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 "9 Sep 1996" "SunOS 5.11" "User Commands" +.TH DOWNLOAD 1 "Sep 9, 1996" .SH NAME download \- host resident PostScript font downloader .SH SYNOPSIS .LP .nf -\fBdownload\fR [\fB-f\fR] [\fB-p\fR \fIprinter\fR] [\fB-m\fR \fIname\fR] [\fB-H\fR \fIdirectory\fR] +\fBdownload\fR [\fB-f\fR] [\fB-p\fR \fIprinter\fR] [\fB-m\fR \fIname\fR] [\fB-H\fR \fIdirectory\fR] [\fIfile\fR]... .fi .LP .nf -\fB/usr/lib/lp/postscript/download\fR +\fB/usr/lib/lp/postscript/download\fR .fi .SH DESCRIPTION @@ -48,12 +48,10 @@ ignored if the map table can not be read. .SH OPTIONS .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 16n -.rt Force a complete scan of each input \fBfile\fR. In the absence of an explicit comment pointing \fBdownload\fR to the end of the file, the default scan stops immediately after the PostScript header comments. @@ -61,24 +59,20 @@ immediately after the PostScript header comments. .sp .ne 2 -.mk .na \fB\fB-p\fR\fI printer\fR\fR .ad .RS 16n -.rt Check the list of printer-resident fonts in \fB/etc/lp/printers/\fR\fIprinter\fR\fB/residentfonts\fR before downloading. .RE .sp .ne 2 -.mk .na \fB\fB-m\fR\fI name\fR\fR .ad .RS 16n -.rt 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 appended to the pathname of the host font directory. @@ -86,12 +80,10 @@ appended to the pathname of the host font directory. .sp .ne 2 -.mk .na \fB\fB-H\fR\fI directory\fR\fR .ad .RS 16n -.rt Use \fIdir\fR as the host font directory. The default is \fB/usr/lib/lp/postscript\fR. .RE @@ -139,23 +131,19 @@ map table, you could download fonts by issuing the following command: 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 diff --git a/usr/src/man/man1/dpost.1 b/usr/src/man/man1/dpost.1 index f3325cb478..104eb59e43 100644 --- a/usr/src/man/man1/dpost.1 +++ b/usr/src/man/man1/dpost.1 @@ -3,20 +3,20 @@ .\" 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 "9 Sep 1996" "SunOS 5.11" "User Commands" +.TH DPOST 1 "Sep 9, 1996" .SH NAME dpost \- troff postprocessor for PostScript printers .SH SYNOPSIS .LP .nf -\fBdpost\fR [\fB-c\fR \fInum\fR] [\fB-e\fR \fInum\fR] [\fB-m\fR \fInum\fR] [\fB-n\fR \fInum\fR] [\fB-o\fR \fIlist\fR] - [\fB-w\fR \fInum\fR] [\fB-x\fR \fInum\fR] [\fB-y\fR \fInum\fR] [\fB-F\fR \fIdir\fR] [\fB-H\fR \fIdir\fR] +\fBdpost\fR [\fB-c\fR \fInum\fR] [\fB-e\fR \fInum\fR] [\fB-m\fR \fInum\fR] [\fB-n\fR \fInum\fR] [\fB-o\fR \fIlist\fR] + [\fB-w\fR \fInum\fR] [\fB-x\fR \fInum\fR] [\fB-y\fR \fInum\fR] [\fB-F\fR \fIdir\fR] [\fB-H\fR \fIdir\fR] [\fB-L\fR \fIfile\fR] [\fB-O\fR] [\fB-T\fR \fIname\fR] [\fIfile\fR]... .fi .LP .nf -\fB/usr/lib/lp/postscript/dpost\fR +\fB/usr/lib/lp/postscript/dpost\fR .fi .SH DESCRIPTION @@ -45,23 +45,19 @@ responsible for setting up an appropriate user coordinate system. .SH OPTIONS .sp .ne 2 -.mk .na \fB\fB-c\fR\fI num\fR\fR .ad .RS 11n -.rt Print \fInum\fR copies of each page. By default only one copy is printed. .RE .sp .ne 2 -.mk .na \fB\fB-e\fR\fI num\fR\fR .ad .RS 11n -.rt Sets the text encoding level to \fInum\fR. The recognized choices are 0, 1, and 2. The size of the output file and print time should decrease as \fInum\fR increases. Level 2 encoding will typically be about 20 percent faster than @@ -71,12 +67,10 @@ previous versions of \fBdpost\fR. .sp .ne 2 -.mk .na \fB\fB-m\fR\fI num\fR\fR .ad .RS 11n -.rt 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. @@ -84,24 +78,20 @@ default magnification is \fB1.0\fR. .sp .ne 2 -.mk .na \fB\fB-n\fR\fI num\fR\fR .ad .RS 11n -.rt 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. .RE .sp .ne 2 -.mk .na \fB\fB-o\fR\fI list\fR\fR .ad .RS 11n -.rt Print those pages for which numbers are given in the comma-separated \fIlist\fR. The list contains single numbers \fIN\fR and ranges \fIN1\fR\fB\(mi\fR\fIN2.\fR A missing \fIN1\fR means the lowest numbered page, @@ -116,24 +106,20 @@ appear on one physical sheet of paper. .sp .ne 2 -.mk .na \fB\fB-p\fR\fI mode\fR\fR .ad .RS 11n -.rt Print \fIfiles\fR in either portrait or landscape \fImode\fR. Only the first character of \fImode\fR is significant. The default \fImode\fR is portrait. .RE .sp .ne 2 -.mk .na \fB\fB-w\fR\fI num\fR\fR .ad .RS 11n -.rt 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. @@ -141,12 +127,10 @@ is set to \fB0.3\fR points. .sp .ne 2 -.mk .na \fB\fB-x\fR\fI num\fR\fR .ad .RS 11n -.rt 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 @@ -155,24 +139,20 @@ moves everything right. The default offset is \fB0\fR inches. .sp .ne 2 -.mk .na \fB\fB-y\fR\fI num\fR\fR .ad .RS 11n -.rt 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. .RE .sp .ne 2 -.mk .na \fB\fB-F\fR\fI dir\fR\fR .ad .RS 11n -.rt Use \fIdir\fR as the font directory. The default \fIdir\fR is \fB/usr/lib/font\fR, and \fBdpost\fR reads binary font files from directory \fB/usr/lib/font/devpost\fR. @@ -180,12 +160,10 @@ Use \fIdir\fR as the font directory. The default \fIdir\fR is .sp .ne 2 -.mk .na \fB\fB-H\fR\fI dir\fR\fR .ad .RS 11n -.rt Use \fIdir\fR as the host resident font directory. Files in this directory should be complete PostScript font descriptions, and must be assigned a name that corresponds to the appropriate two-character \fBtroff\fR font name. Each @@ -195,36 +173,30 @@ each job. There is no default directory. .sp .ne 2 -.mk .na \fB\fB-L\fR\fI file\fR\fR .ad .RS 11n -.rt Use \fBfile\fR as the PostScript prologue which, by default, is \fB/usr/lib/lp/postscript/dpost.ps\fR. .RE .sp .ne 2 -.mk .na \fB\fB-O\fR\fR .ad .RS 11n -.rt Disables PostScript picture inclusion. A recommended option when \fBdpost\fR is run by a spooler in a networked environment. .RE .sp .ne 2 -.mk .na \fB\fB-T\fR\fI name\fR\fR .ad .RS 11n -.rt Use font files for device \fIname\fR as the best description of available PostScript fonts. By default, \fIname\fR is set to \fBpost\fR and \fBdpost\fR reads binary files from \fB/usr/lib/font/devpost\fR. @@ -269,30 +241,25 @@ should give the best results. 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/usr/lib/font/devpost/*.out\fR\fR .ad @@ -303,7 +270,6 @@ An error occurred. .sp .ne 2 -.mk .na \fB\fB/usr/lib/font/devpost/charlib/*\fR\fR .ad @@ -314,7 +280,6 @@ An error occurred. .sp .ne 2 -.mk .na \fB\fB/usr/lib/lp/postscript/color.ps\fR\fR .ad @@ -325,7 +290,6 @@ An error occurred. .sp .ne 2 -.mk .na \fB\fB/usr/lib/lp/postscript/draw.ps\fR\fR .ad @@ -336,7 +300,6 @@ An error occurred. .sp .ne 2 -.mk .na \fB\fB/usr/lib/lp/postscript/forms.ps\fR\fR .ad @@ -347,7 +310,6 @@ An error occurred. .sp .ne 2 -.mk .na \fB\fB/usr/lib/lp/postscript/ps.requests\fR\fR .ad @@ -358,7 +320,6 @@ An error occurred. .sp .ne 2 -.mk .na \fB\fB/usr/lib/macros/pictures\fR\fR .ad @@ -369,7 +330,6 @@ An error occurred. .sp .ne 2 -.mk .na \fB\fB/usr/lib/macros/color\fR\fR .ad diff --git a/usr/src/man/man1/du.1 b/usr/src/man/man1/du.1 index 80f8ccf148..05820b1bb6 100644 --- a/usr/src/man/man1/du.1 +++ b/usr/src/man/man1/du.1 @@ -1,26 +1,26 @@ '\" te .\" Copyright (c) 1992, X/Open Company Limited. All Rights Reserved. .\" Portions Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved. -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 1 "6 Feb 2007" "SunOS 5.11" "User Commands" +.TH DU 1 "Feb 6, 2007" .SH NAME du \- summarize disk usage .SH SYNOPSIS .LP .nf -\fB/usr/bin/du\fR [\fB-dorx\fR] [\fB-a\fR | \fB-s\fR] [\fB-h\fR | \fB-k\fR | \fB-m\fR] [\fB-H\fR | \fB-L\fR] +\fB/usr/bin/du\fR [\fB-dorx\fR] [\fB-a\fR | \fB-s\fR] [\fB-h\fR | \fB-k\fR | \fB-m\fR] [\fB-H\fR | \fB-L\fR] [\fIfile\fR ...] .fi .LP .nf -\fB/usr/xpg4/bin/du\fR [\fB-dorx\fR] [\fB-a\fR | \fB-s\fR] [\fB-h\fR | \fB-k\fR | \fB-m\fR] [\fB-H\fR | \fB-L\fR] +\fB/usr/xpg4/bin/du\fR [\fB-dorx\fR] [\fB-a\fR | \fB-s\fR] [\fB-h\fR | \fB-k\fR | \fB-m\fR] [\fB-H\fR | \fB-L\fR] [\fIfile\fR ...] .fi @@ -52,12 +52,10 @@ The following options are supported for \fB/usr/bin/du\fR and \fB/usr/xpg4/bin/du\fR: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 6n -.rt In addition to the default output, report the size of each file not of type directory in the file hierarchy rooted in the specified file. Regardless of the presence of the \fB-a\fR option, non-directories given as \fIfile\fR operands @@ -66,24 +64,20 @@ will always be listed. .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad .RS 6n -.rt Do not cross filesystem boundaries. For example, the command, \fBdu -d /\fR reports usage only on the root partition. .RE .sp .ne 2 -.mk .na \fB\fB-h\fR\fR .ad .RS 6n -.rt All sizes are scaled to a human readable format, for example, \fB14K\fR, \fB234M\fR, \fB2.7G\fR, or \fB3.0T\fR. Scaling is done by repetitively dividing by \fB1024\fR. @@ -91,12 +85,10 @@ by \fB1024\fR. .sp .ne 2 -.mk .na \fB\fB-H\fR\fR .ad .RS 6n -.rt If a symbolic link to a directory is specified on the command line, process the symbolic link by using the directory which the symbolic link references, rather than the link itself. @@ -104,48 +96,40 @@ than the link itself. .sp .ne 2 -.mk .na \fB\fB-k\fR\fR .ad .RS 6n -.rt Write 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 Process symbolic links by using the file or directory which the symbolic link references, rather than the link itself. .RE .sp .ne 2 -.mk .na \fB\fB-m\fR\fR .ad .RS 6n -.rt Write the files sizes in units of megabytes, rather than the default 512-byte units. .RE .sp .ne 2 -.mk .na \fB\fB-o\fR\fR .ad .RS 6n -.rt Do 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 @@ -154,12 +138,10 @@ does nothing if \fB-s\fR is used. .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 6n -.rt Generate diagnostic messages about unreadable directories and files whose status cannot be obtained. /usr/bin/du is silent if these conditions arise and \fB-r\fR is not specified. \fB/usr/xpg4/bin/du\fR acts as though \fB-r\fR is @@ -168,24 +150,20 @@ always specified. .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 6n -.rt Instead of the default output, report only the total sum for each of the specified files. .RE .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad .RS 6n -.rt When evaluating file sizes, evaluate only those files that have the same device as the file specified by the file operand. .RE @@ -206,12 +184,10 @@ option specified determines the output format. The following operand is supported: .sp .ne 2 -.mk .na \fB\fIfile\fR\fR .ad .RS 8n -.rt The path name of a file whose size is to be written. If no \fIfile\fR is specified, the current directory is used. .RE @@ -238,23 +214,19 @@ that affect the execution of \fBdu\fR: \fBLANG\fR, \fBLC_ALL\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fI\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -267,15 +239,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityStable +Interface Stability Stable .TE .SS "/usr/xpg4/bin/du" @@ -283,15 +254,14 @@ Interface StabilityStable .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man1/dump.1 b/usr/src/man/man1/dump.1 index 0b7bb18627..50540b462d 100644 --- a/usr/src/man/man1/dump.1 +++ b/usr/src/man/man1/dump.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 dump 1 "6 Sep 2002" "SunOS 5.11" "User Commands" +.TH DUMP 1 "Sep 6, 2002" .SH NAME dump \- dump selected parts of an object file .SH SYNOPSIS @@ -43,129 +43,106 @@ This utility will accept both object files and archives of object files. It processes each file argument according to one or more of the following options: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 20n -.rt Dumps the archive header of each member of an archive. .RE .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad .RS 20n -.rt Dumps the string table(s). .RE .sp .ne 2 -.mk .na \fB\fB-C\fR\fR .ad .RS 20n -.rt Dumps decoded C++ symbol table names. .RE .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 20n -.rt Dumps each file header. .RE .sp .ne 2 -.mk .na \fB\fB-g\fR\fR .ad .RS 20n -.rt Dumps the global symbols in the symbol table of an archive. .RE .sp .ne 2 -.mk .na \fB\fB-h\fR\fR .ad .RS 20n -.rt Dumps the section headers. .RE .sp .ne 2 -.mk .na \fB\fB-L\fR\fR .ad .RS 20n -.rt Dumps dynamic linking information and static shared library information, if available. .RE .sp .ne 2 -.mk .na \fB\fB-o\fR\fR .ad .RS 20n -.rt Dumps each program execution header. .RE .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 20n -.rt Dumps relocation information. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 20n -.rt Dumps section contents in hexadecimal. .RE .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad .RS 20n -.rt Dumps symbol table entries. .RE .sp .ne 2 -.mk .na \fB\fB-T\fR \fIindex\fR\fR .ad @@ -174,19 +151,16 @@ Dumps symbol table entries. \fB\fB-T\fR \fIindex1\fR,\fIindex2\fR\fR .ad .RS 20n -.rt Dumps only the indexed symbol table entry defined by \fIindex\fR or a range of entries defined by \fIindex1\fR\fB,\fR\fIindex2\fR. .RE .sp .ne 2 -.mk .na \fB\fB-V\fR\fR .ad .RS 20n -.rt Prints version information. .RE @@ -196,7 +170,6 @@ The following modifiers are used in conjunction with the options listed above to modify their capabilities. .sp .ne 2 -.mk .na \fB\fB-d\fR \fInumber\fR\fR .ad @@ -205,7 +178,6 @@ to modify their capabilities. \fB\fB-d\fR \fInumber1\fR,\fInumber2\fR\fR .ad .RS 22n -.rt Dumps the section number indicated by \fInumber\fR or the range of sections starting at \fInumber1\fR and ending at \fInumber2\fR. This modifier can be used with \fB-h\fR, \fB-s\fR, and \fB-r\fR. When \fB-d\fR is used with \fB-h\fR @@ -223,12 +195,10 @@ output. .sp .ne 2 -.mk .na \fB\fB\fR\fB-n\fR\fB \fR\fIname\fR\fR .ad .RS 22n -.rt Dumps information pertaining only to the named entity. This modifier can be used with \fB-h\fR, \fB-s\fR, \fB-r\fR, and \fB-t\fR. When \fB-n\fR is used with \fB-h\fR or \fB-s\fR, the argument will be treated as the name of a @@ -241,110 +211,90 @@ dump the section header information for the \fB\&.text\fR section. .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 22n -.rt Suppresses printing of the headings. .RE .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 22n -.rt Dumps information in symbolic representation rather than numeric. This modifier can be used with .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 6n -.rt (date, user id, group id) .RE .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 6n -.rt (class, data, type, machine, version, flags) .RE .sp .ne 2 -.mk .na \fB\fB-h\fR\fR .ad .RS 6n -.rt (type, flags) .RE .sp .ne 2 -.mk .na \fB\fB-L\fR\fR .ad .RS 6n -.rt (value) .RE .sp .ne 2 -.mk .na \fB\fB-o\fR\fR .ad .RS 6n -.rt (type, flags) .RE .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 6n -.rt (name, type) .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 6n -.rt (interpret section contents wherever possible) .RE .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad .RS 6n -.rt (type, bind) .RE diff --git a/usr/src/man/man1/dumpcs.1 b/usr/src/man/man1/dumpcs.1 index abd053d38e..ae5f6242b2 100644 --- a/usr/src/man/man1/dumpcs.1 +++ b/usr/src/man/man1/dumpcs.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 dumpcs 1 "20 Dec 1996" "SunOS 5.11" "User Commands" +.TH DUMPCS 1 "Dec 20, 1996" .SH NAME dumpcs \- show codeset table for the current locale .SH SYNOPSIS @@ -29,68 +29,56 @@ enough \fBASCII\fR space character(s) to fill that codeset's column width. .SH OPTIONS .sp .ne 2 -.mk .na \fB\fB-0\fR \fR .ad .RS 7n -.rt Show \fBASCII\fR (or \fBEUC\fR primary) codeset. .RE .sp .ne 2 -.mk .na \fB\fB-1\fR \fR .ad .RS 7n -.rt Show \fBEUC\fR codeset 1, if used for the current locale. .RE .sp .ne 2 -.mk .na \fB\fB-2\fR \fR .ad .RS 7n -.rt Show \fBEUC\fR codeset 2, if used for the current locale. .RE .sp .ne 2 -.mk .na \fB\fB-3\fR \fR .ad .RS 7n -.rt Show \fBEUC\fR codeset 3, if used for the current locale. .RE .sp .ne 2 -.mk .na \fB\fB-v\fR \fR .ad .RS 7n -.rt "Verbose". Normally, ranges of non-printable characters are collapsed into a single line. This option produces one line for each non-printable character. .RE .sp .ne 2 -.mk .na \fB\fB-w\fR \fR .ad .RS 7n -.rt Replace code values with corresponding wide character values (process codes). .RE diff --git a/usr/src/man/man1/echo.1 b/usr/src/man/man1/echo.1 index d882199654..30d7c5319d 100644 --- a/usr/src/man/man1/echo.1 +++ b/usr/src/man/man1/echo.1 @@ -3,14 +3,14 @@ .\" Copyright (c) 2008, Sun Microsystems, Inc. All Rights Reserved .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved .\" Portions Copyright (c) 1982-2007 AT&T Knowledge Ventures -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 1 "8 Apr 2008" "SunOS 5.11" "User Commands" +.TH ECHO 1 "Apr 8, 2008" .SH NAME echo \- echo arguments .SH SYNOPSIS @@ -52,123 +52,101 @@ match \fB/usr/ucb/echo\fR. The following operand is supported: .sp .ne 2 -.mk .na \fB\fIstring\fR\fR .ad .RS 10n -.rt A string to be written to standard output. If any operand is "\fB-n\fR", it is treated as a string, not an option. The following character sequences is recognized within any of the arguments: .sp .ne 2 -.mk .na \fB\fB\ea\fR\fR .ad .RS 8n -.rt Alert character. .RE .sp .ne 2 -.mk .na \fB\fB\eb\fR\fR .ad .RS 8n -.rt Backspace. .RE .sp .ne 2 -.mk .na \fB\fB\ec\fR\fR .ad .RS 8n -.rt Print line without new-line. All characters following the \fB\ec\fR in the argument are ignored. .RE .sp .ne 2 -.mk .na \fB\fB\ef\fR\fR .ad .RS 8n -.rt Form-feed. .RE .sp .ne 2 -.mk .na \fB\fB\en\fR\fR .ad .RS 8n -.rt New-line. .RE .sp .ne 2 -.mk .na \fB\fB\er\fR\fR .ad .RS 8n -.rt Carriage return. .RE .sp .ne 2 -.mk .na \fB\fB\et\fR\fR .ad .RS 8n -.rt Tab. .RE .sp .ne 2 -.mk .na \fB\fB\ev\fR\fR .ad .RS 8n -.rt Vertical tab. .RE .sp .ne 2 -.mk .na \fB\fB\e\e\fR\fR .ad .RS 8n -.rt Backslash. .RE .sp .ne 2 -.mk .na \fB\fB\e0\fR\fIn\fR\fR .ad .RS 8n -.rt Where \fIn\fR is the 8-bit character whose \fBASCII\fR code is the 1-, 2- or 3-digit octal number representing that character. .RE @@ -318,12 +296,10 @@ that affect the execution of \fBecho\fR: \fBLANG\fR, \fBLC_ALL\fR, \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and \fBNLSPATH\fR. .sp .ne 2 -.mk .na \fB\fBSYSV3\fR\fR .ad .RS 9n -.rt This environment variable is used to provide compatibility with INTERACTIVE UNIX System and SCO UNIX installation scripts. It is intended for compatibility only and should not be used in new scripts. This variable is applicable only @@ -336,23 +312,19 @@ for Solaris x86 platforms, not Solaris SPARC systems. The following error values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -364,17 +336,16 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityCommitted +Interface Stability Committed _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .SH SEE ALSO diff --git a/usr/src/man/man1/ed.1 b/usr/src/man/man1/ed.1 index cb22999587..922aaa12bf 100644 --- a/usr/src/man/man1/ed.1 +++ b/usr/src/man/man1/ed.1 @@ -1,13 +1,13 @@ '\" te .\" Copyright 1989 AT&T Copyright (c) 2003, Sun Microsystems, Inc. Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 ed 1 "10 Dec 2003" "SunOS 5.11" "User Commands" +.TH ED 1 "Dec 10, 2003" .SH NAME ed, red \- text editor .SH SYNOPSIS @@ -125,23 +125,22 @@ follows: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -SpecifiedResulting +box; +c | c +l | l . +Specified Resulting _ -,1 , $ +, 1 , $ _ -, addr1 , addr +, addr 1 , addr _ -addr ,addr , addr +addr , addr , addr _ -;1 ; $ +; 1 ; $ _ -; addr1 ; addr +; addr 1 ; addr _ -addr ;addr ; addr +addr ; addr ; addr .TE .sp @@ -197,7 +196,6 @@ numbered or written, respectively, as discussed below under the \fBl\fR, \fBn\fR, and \fBp\fR commands. .sp .ne 2 -.mk .na \fB\fB(.)a\fR\fR .ad @@ -210,7 +208,6 @@ numbered or written, respectively, as discussed below under the \fBl\fR, \fB\fB\&.\fR\fR .ad .RS 11n -.rt The \fBa\fRppend command accepts zero or more lines of text and appends it after the addressed line in the buffer. The current line (\fB\&.\fR) is left at the last inserted line, or, if there were none, at the addressed line. Address @@ -221,7 +218,6 @@ entered from a terminal is 256 per line (including the new-line character). .sp .ne 2 -.mk .na \fB\fB(.,.)c\fR\fR .ad @@ -234,7 +230,6 @@ entered from a terminal is 256 per line (including the new-line character). \fB\fB\&.\fR\fR .ad .RS 11n -.rt The \fBc\fRhange command deletes the addressed lines from the buffer, then accepts zero or more lines of text that replaces these lines in the buffer. The current line (\fB\&.\fR) is left at the last line input, or, if there were @@ -244,23 +239,19 @@ address of the new last line. If no lines remain in the buffer, the current line number will be set to 0. .sp .ne 2 -.mk .na \fB\fB/usr/xpg4/bin/ed\fR\fR .ad .RS 20n -.rt Address 0 is not legal for this command. .RE .sp .ne 2 -.mk .na \fB\fB/usr/xpg6/bin/ed\fR\fR .ad .RS 20n -.rt Address 0 is valid for this command. It is interpreted as if the address 1 were specified. .RE @@ -269,12 +260,10 @@ specified. .sp .ne 2 -.mk .na \fB\fBC\fR\fR .ad .RS 11n -.rt Same as the \fBX\fR command, described later, except that \fBed\fR assumes all text read in for the \fBe\fR and \fBr\fR commands is encrypted unless a null key is typed in. @@ -282,12 +271,10 @@ key is typed in. .sp .ne 2 -.mk .na \fB\fB(.,.)d\fR\fR .ad .RS 11n -.rt The \fBd\fRelete command deletes the addressed lines from the buffer. The line after the last line deleted becomes the current line. If the lines deleted were originally at the end of the buffer, the new last line becomes the current @@ -297,12 +284,10 @@ line. If no lines remain in the buffer, the current line number will be set to .sp .ne 2 -.mk .na \fB\fBe\fR \fIfile\fR\fR .ad .RS 11n -.rt The \fBe\fRdit command deletes the entire contents of the buffer and then reads the contents of \fIfile\fR into the buffer. The current line (\fB\&.\fR) is set to the last line of the buffer. If \fIfile\fR is not given, the currently @@ -324,12 +309,10 @@ previously. .sp .ne 2 -.mk .na \fB\fBE\fR \fIfile\fR\fR .ad .RS 11n -.rt The \fBE\fRdit command is like \fBe\fR, except that the editor does not check to see if any changes have been made to the buffer since the last \fBw\fR command. @@ -337,12 +320,10 @@ command. .sp .ne 2 -.mk .na \fB\fBf\fR \fIfile\fR\fR .ad .RS 11n -.rt If \fIfile\fR is given, the \fBf\fR command changes the currently remembered path name to \fIfile\fR. Whether the name is changed or not, the \fBf\fR command then writes the (possibly new) currently remembered path name to the @@ -355,12 +336,10 @@ The current line number is unchanged. .sp .ne 2 -.mk .na \fB\fB(1,$)g/\fR\fIRE\fR\fB/\fR\fIcommand list\fR\fR .ad .RS 26n -.rt In the \fBg\fRlobal command, the first step is to mark every line that matches the given \fIRE\fR. Then, for every such line, the given \fIcommand list\fR is executed with the current line (\fB\&.\fR) initially set to that line. When the @@ -382,12 +361,10 @@ if it is preceded by a backslash. .sp .ne 2 -.mk .na \fB\fB(1,$)G/\fR\fIRE\fR\fB/\fR\fR .ad .RS 26n -.rt In the interactive \fBG\fRlobal command, the first step is to mark every line that matches the given \fIRE\fR. Then, for every such line, that line is written to standard output, the current line (\fB\&.\fR) is changed to that @@ -411,24 +388,20 @@ used as a literal character if it is preceded by a backslash. .sp .ne 2 -.mk .na \fB\fBh\fR\fR .ad .RS 26n -.rt The \fBhelp\fR command gives a short error message that explains the reason for the most recent \fB?\fR diagnostic. The current line number is unchanged. .RE .sp .ne 2 -.mk .na \fB\fBH\fR\fR .ad .RS 26n -.rt The \fBHelp\fR command causes \fBed\fR to enter a mode in which error messages are written for all subsequent \fB?\fR diagnostics. It also explains the previous \fB?\fR if there was one. The \fBH\fR command alternately turns this @@ -437,7 +410,6 @@ mode on and off; it is initially off. The current line number is unchanged. .sp .ne 2 -.mk .na \fB\fB(.,.)i\fR\fR .ad @@ -450,7 +422,6 @@ mode on and off; it is initially off. The current line number is unchanged. \fB\fB\&.\fR\fR .ad .RS 26n -.rt The \fBinsert\fR command accepts zero or more lines of text and inserts it before the addressed line in the buffer. The current line (\fB\&.\fR) is left at the last inserted line, or, if there were none, at the addressed line. This @@ -459,23 +430,19 @@ text. The maximum number of characters that may be entered from a terminal is 256 per line (including the new-line character). .sp .ne 2 -.mk .na \fB\fB/usr/xpg4/bin/ed\fR\fR .ad .RS 20n -.rt Address 0 is not legal for this command. .RE .sp .ne 2 -.mk .na \fB\fB/usr/xpg6/bin/ed\fR\fR .ad .RS 20n -.rt Address 0 is valid for this command. It is interpreted as if the address 1 were specified. .RE @@ -484,12 +451,10 @@ specified. .sp .ne 2 -.mk .na \fB\fB(.,.+1)j\fR\fR .ad .RS 26n -.rt The \fBj\fRoin command joins contiguous lines by removing the appropriate new-line characters. If exactly one address is given, this command does nothing. If lines are joined, the current line number is set to the address of @@ -498,12 +463,10 @@ the joined line. Otherwise, the current line number is unchanged. .sp .ne 2 -.mk .na \fB\fB(.)k\fR\fIx\fR\fR .ad .RS 26n -.rt The mar\fBk\fR command marks the addressed line with name \fIx\fR, which must be an ASCII lower-case letter (\fBa\fR\fB-\fR\fBz\fR). The address \fI a\'x\fR then addresses this line. The current line (\fB\&.\fR) is unchanged. @@ -511,12 +474,10 @@ then addresses this line. The current line (\fB\&.\fR) is unchanged. .sp .ne 2 -.mk .na \fB\fB(.,.)l\fR\fR .ad .RS 26n -.rt The \fBl\fR command writes to standard output the addressed lines in a visually unambiguous form. The characters ( \fB\e\e\fR, \fB\ea\fR, \fB\eb\fR, \fB\ef\fR, \fB\er\fR, \fB\et\fR, \fB\ev\fR) are written as the corresponding escape @@ -538,12 +499,10 @@ the last line written. .sp .ne 2 -.mk .na \fB\fB(.,.)m\fR\fIa\fR\fR .ad .RS 26n -.rt The \fBm\fRove command repositions the addressed line(s) after the line addressed by \fIa\fR. Address 0 is legal for \fIa\fR and causes the addressed line(s) to be moved to the beginning of the file. It is an error if address @@ -553,12 +512,10 @@ left at the last line moved. .sp .ne 2 -.mk .na \fB\fB(.,.)n\fR\fR .ad .RS 26n -.rt The \fBn\fRumber command writes the addressed lines, preceding each line by its line number and a tab character. The current line (\fB\&.\fR) is left at the last line written. The \fBn\fR command may be appended to any command other @@ -567,12 +524,10 @@ than \fBe\fR, \fBE\fR, \fBf\fR, \fBq\fR, \fBQ\fR, \fBr\fR, \fBw\fR, or \fB!\fR. .sp .ne 2 -.mk .na \fB\fB(.,.)p\fR\fR .ad .RS 26n -.rt The \fBp\fRrint command writes the addressed lines to standard output. The current line (\fB\&.\fR) is left at the last line written. The \fBp\fR command may be appended to any command other than \fBe\fR, \fBE\fR, \fBf\fR, \fBq\fR, @@ -582,12 +537,10 @@ current line and writes the new current line. .sp .ne 2 -.mk .na \fB\fBP\fR\fR .ad .RS 26n -.rt The \fBP\fR command causes \fBed\fR to prompt with an asterisk (\fB*\fR) (or \fIstring\fR, if \fB-p\fR is specified) for all subsequent commands. The \fBP\fR command alternatively turns this mode on and off; it is initially on if @@ -596,12 +549,10 @@ the \fB-p\fR option is specified, otherwise off. The current line is unchanged. .sp .ne 2 -.mk .na \fB\fBq\fR\fR .ad .RS 26n -.rt The \fBq\fRuit command causes \fBed\fR to exit. If the buffer has changed since the last time the entire buffer was written, the user is warned. See DIAGNOSTICS. @@ -609,24 +560,20 @@ DIAGNOSTICS. .sp .ne 2 -.mk .na \fB\fBQ\fR\fR .ad .RS 26n -.rt The editor exits without checking if changes have been made in the buffer since the last \fBw\fR command. .RE .sp .ne 2 -.mk .na \fB\fB($)r\fR \fIfile\fR\fR .ad .RS 26n -.rt The \fBr\fRead command reads the contents of \fIfile\fR into the buffer. If \fIfile\fR is not given, the currently remembered file name, if any, is used (see the \fBe\fR and \fBf\fR commands). The currently remembered file name is @@ -652,7 +599,6 @@ current directory to the end of the file being edited. Such a shell command is .sp .ne 2 -.mk .na \fB\fB(.,.)s/\fR\fIRE\fR\fB/\fR\fIreplacement\fR\fB/\fR\fR .ad @@ -725,24 +671,20 @@ if the replacement string is identical to the string that it replaces. The substitute command supports the following indicators: .sp .ne 2 -.mk .na \fB\fIcount\fR\fR .ad .RS 9n -.rt Substitute for the \fIcount\fRth occurrence only of the \fIRE\fR found on each addressed line. \fIcount\fR must be between \fB1\fR-\fB2047\fR. .RE .sp .ne 2 -.mk .na \fB\fBg\fR\fR .ad .RS 9n -.rt Globally substitute for all non-overlapping instances of the \fIRE\fR rather than just the first one. If both \fBg\fR and \fIcount\fR are specified, the results are unspecified. @@ -750,36 +692,30 @@ results are unspecified. .sp .ne 2 -.mk .na \fB\fBl\fR\fR .ad .RS 9n -.rt Write to standard output the final line in which a substitution was made. The line is written in the format specified for the \fBl\fR command. .RE .sp .ne 2 -.mk .na \fB\fBn\fR\fR .ad .RS 9n -.rt Write to standard output the final line in which a substitution was made. The line is written in the format specified for the \fBn\fR command. .RE .sp .ne 2 -.mk .na \fB\fBp\fR\fR .ad .RS 9n -.rt Write to standard output the final line in which a substitution was made. The line will be written in the format specified for the \fBp\fR command. .RE @@ -788,7 +724,6 @@ line will be written in the format specified for the \fBp\fR command. .sp .ne 2 -.mk .na \fB\fB(.,.)t\fR\fIa\fR\fR .ad @@ -801,7 +736,6 @@ current line (\fB\&.\fR) is left at the last line copied. .sp .ne 2 -.mk .na \fB\fBu\fR\fR .ad @@ -820,7 +754,6 @@ started. .sp .ne 2 -.mk .na \fB\fB(1,$)v/\fR\fIRE\fR\fB/\fR\fIcommand list\fR\fR .ad @@ -832,7 +765,6 @@ marked during the first step are those that do \fBnot\fR match the \fIRE\fR. .sp .ne 2 -.mk .na \fB\fB(1,$)V/\fR\fIRE\fR\fB/\fR\fR .ad @@ -845,7 +777,6 @@ match the \fIRE\fR. .sp .ne 2 -.mk .na \fB\fB(1,$)w\fR \fIfile\fR\fR .ad @@ -878,12 +809,10 @@ command that wrote the entire buffer''. .sp .ne 2 -.mk .na \fB\fB(1,$)W\fR \fIfile\fR\fR .ad .RS 19n -.rt This command is the same as the \fBw\fRrite command above, except that it appends the addressed lines to the end of \fIfile\fR if it exists. If \fIfile\fR does not exist, it is created as described above for the \fBw\fR @@ -892,12 +821,10 @@ command. .sp .ne 2 -.mk .na \fB\fBX\fR\fR .ad .RS 19n -.rt An educated guess is made to determine whether text read for the \fBe\fR and \fBr\fR commands is encrypted. A null key turns off encryption. Subsequent \fBe\fR, \fBr\fR, and \fBw\fR commands will use this key to encrypt or decrypt @@ -907,12 +834,10 @@ option of \fBed\fR. .sp .ne 2 -.mk .na \fB\fB($)=\fR\fR .ad .RS 19n -.rt The line number of the addressed line is written to standard output in the following format: .sp @@ -928,12 +853,10 @@ The current line number is unchanged by this command. .sp .ne 2 -.mk .na \fB\fB!\fR\fIshell command\fR\fR .ad .RS 19n -.rt The remainder of the line after the \fB!\fR is sent to the UNIX system shell (see \fBsh\fR(1)) to be interpreted as a command. Within the text of that command, the unescaped character \fB%\fR is replaced with the remembered file @@ -951,12 +874,10 @@ The current line number is unchanged. .sp .ne 2 -.mk .na \fB\fB(.+1)\fR<new-line>\fR .ad .RS 19n -.rt An address alone on a line causes the addressed line to be written. A new-line alone is equivalent to \fB\&.+1p\fR. It is useful for stepping forward through the buffer. The current line number will be set to the address of the written @@ -973,24 +894,20 @@ The \fBed\fR utility takes the standard action for all signals with the following exceptions: .sp .ne 2 -.mk .na \fB\fBSIGINT\fR\fR .ad .RS 10n -.rt The \fBed\fR utility interrupts its current activity, writes the string "\fB?\en\fR" to standard output, and returns to command mode. .RE .sp .ne 2 -.mk .na \fB\fBSIGHUP\fR\fR .ad .RS 10n -.rt If the buffer is not empty and has changed since the last write, the \fBed\fR utility attempts to write a copy of the buffer in a file. First, the file named \fBed.hup\fR in the current directory is used. If that fails, the file named @@ -1020,34 +937,28 @@ may be omitted, in which case the addressed line is written. The following pairs of commands are equivalent: .sp .ne 2 -.mk .na \fB\fBs/s1/s2\fR\fR .ad .RS 11n -.rt \fBs/s1/s2/p\fR .RE .sp .ne 2 -.mk .na \fB\fBg/s1\fR\fR .ad .RS 11n -.rt \fBg/s1/p\fR .RE .sp .ne 2 -.mk .na \fB\fB?s1\fR\fR .ad .RS 11n -.rt \fB?s1?\fR .RE @@ -1065,12 +976,10 @@ current line number unchanged. .SH OPTIONS .sp .ne 2 -.mk .na \fB\fB-C\fR\fR .ad .RS 13n -.rt Encryption option. The same as the \fB-x\fR option, except that \fBed\fR simulates a \fBC\fR command. The \fBC\fR command is like the \fBX\fR command, except that all text read in is assumed to have been encrypted. @@ -1078,24 +987,20 @@ except that all text read in is assumed to have been encrypted. .sp .ne 2 -.mk .na \fB\fB\fR\fB-p\fR\fIstring\fR \fR .ad .RS 13n -.rt Allows the user to specify a prompt string. By default, there is no prompt string. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR | \fB-;\fR\fR .ad .RS 13n -.rt Suppresses the writing of character counts by \fBe\fR, \fBr\fR, and \fBw\fR commands, of diagnostics from \fBe\fR and \fBq\fR commands, and of the \fB!\fR prompt after a \fB!\fR\fIshell command\fR. @@ -1103,12 +1008,10 @@ prompt after a \fB!\fR\fIshell command\fR. .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad .RS 13n -.rt Encryption option. When \fB-x\fR is used, \fBed\fR simulates an \fBX\fR command and prompts the user for a key. The \fBX\fR command makes an educated guess to determine whether text read in is encrypted or not. The temporary buffer file @@ -1122,12 +1025,10 @@ is encrypted also, using a transformed version of the key typed in for the The following operand is supported: .sp .ne 2 -.mk .na \fB\fIfile\fR\fR .ad .RS 8n -.rt If \fIfile\fR is specified, \fBed\fR simulates an \fBe\fR command on the file named by the path name \fIfile\fR before accepting commands from the standard input. @@ -1151,59 +1052,49 @@ that affect the execution of \fBed\fR: \fBHOME\fR, \fBLANG\fR, \fBLC_ALL\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion without any file or command errors. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB$TMPDIR\fR\fR .ad .RS 12n -.rt If this environment variable is not \fINULL\fR, its value is used in place of \fB/var/tmp\fR as the directory name for the temporary work file. .RE .sp .ne 2 -.mk .na \fB\fB/var/tmp\fR\fR .ad .RS 12n -.rt If \fB/var/tmp\fR exists, it is used as the directory name for the temporary work file. .RE .sp .ne 2 -.mk .na \fB\fB/tmp\fR\fR .ad .RS 12n -.rt If the environment variable \fBTMPDIR\fR does not exist or is \fINULL,\fR and if \fB/var/tmp\fR does not exist, then \fB/tmp\fR is used as the directory name for the temporary work file. @@ -1211,12 +1102,10 @@ for the temporary work file. .sp .ne 2 -.mk .na \fB\fBed.hup\fR\fR .ad .RS 12n -.rt Work is saved here if the terminal is hung up. .RE @@ -1229,13 +1118,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled .TE .SS "/usr/xpg4/bin/ed" @@ -1243,15 +1131,14 @@ CSIEnabled .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityStandard +Interface Stability Standard .TE .SS "/usr/xpg6/bin/ed" @@ -1259,15 +1146,14 @@ Interface StabilityStandard .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO @@ -1280,23 +1166,19 @@ Interface StabilityStandard .SH DIAGNOSTICS .sp .ne 2 -.mk .na \fB\fB?\fR\fR .ad .RS 9n -.rt for command errors. .RE .sp .ne 2 -.mk .na \fB\fB?\fR\fIfile\fR\fR .ad .RS 9n -.rt for an inaccessible file. Use the \fBh\fRelp and \fBH\fRelp commands for detailed explanations. .RE diff --git a/usr/src/man/man1/egrep.1 b/usr/src/man/man1/egrep.1 index 3bc038fa91..ce82db2372 100644 --- a/usr/src/man/man1/egrep.1 +++ b/usr/src/man/man1/egrep.1 @@ -1,15 +1,15 @@ '\" te -.\" Copyright 1989 AT&T -.\" Copyright (c) 2006, Sun Microsystems, Inc. All Rights Reserved +.\" Copyright 1989 AT&T +.\" Copyright (c) 2006, Sun Microsystems, Inc. All Rights Reserved .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 egrep 1 "24 Mar 2006" "SunOS 5.11" "User Commands" +.TH EGREP 1 "Mar 24, 2006" .SH NAME egrep \- search a file for a pattern using full regular expressions .SH SYNOPSIS @@ -30,13 +30,13 @@ egrep \- search a file for a pattern using full regular expressions .LP .nf -\fB/usr/xpg4/bin/egrep\fR [\fB-bchilnqsvx\fR] \fB-e\fR \fIpattern_list\fR [\fB-f\fR \fIfile\fR] +\fB/usr/xpg4/bin/egrep\fR [\fB-bchilnqsvx\fR] \fB-e\fR \fIpattern_list\fR [\fB-f\fR \fIfile\fR] [\fIfile...\fR] .fi .LP .nf -\fB/usr/xpg4/bin/egrep\fR [\fB-bchilnqsvx\fR] [\fB-e\fR \fIpattern_list\fR] \fB-f\fR \fIfile\fR +\fB/usr/xpg4/bin/egrep\fR [\fB-bchilnqsvx\fR] [\fB-e\fR \fIpattern_list\fR] \fB-f\fR \fIfile\fR [\fIfile...\fR] .fi @@ -112,115 +112,95 @@ The following options are supported for both \fB/usr/bin/egrep\fR and \fB/usr/xpg4/bin/egrep\fR: .sp .ne 2 -.mk .na \fB\fB-b\fR\fR .ad .RS 19n -.rt Precede each line by the block number on which it was found. This can be useful in locating block numbers by context (first block is 0). .RE .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad .RS 19n -.rt Print only a count of the lines that contain the pattern. .RE .sp .ne 2 -.mk .na \fB\fB-e\fR \fIpattern_list\fR\fR .ad .RS 19n -.rt Search for a \fIpattern_list\fR (\fIfull regular expression\fR that begins with a \fB\(mi\fR). .RE .sp .ne 2 -.mk .na \fB\fB-f\fR \fIfile\fR\fR .ad .RS 19n -.rt Take the list of \fIfull\fR \fIregular\fR \fIexpressions\fR from \fIfile\fR. .RE .sp .ne 2 -.mk .na \fB\fB-h\fR\fR .ad .RS 19n -.rt Suppress printing of filenames when searching multiple files. .RE .sp .ne 2 -.mk .na \fB\fB-i\fR\fR .ad .RS 19n -.rt Ignore upper/lower case distinction during comparisons. .RE .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 19n -.rt Print the names of files with matching lines once, separated by NEWLINEs. Does not repeat the names of files when the pattern is found more than once. .RE .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 19n -.rt Precede each line by its line number in the file (first line is 1). .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 19n -.rt Work silently, that is, display nothing except error messages. This is useful for checking the error status. .RE .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 19n -.rt Print all lines except those that contain the pattern. .RE @@ -230,24 +210,20 @@ Print all lines except those that contain the pattern. The following options are supported for \fB/usr/xpg4/bin/egrep\fR only: .sp .ne 2 -.mk .na \fB\fB-q\fR\fR .ad .RS 6n -.rt Quiet. Does not write anything to the standard output, regardless of matching lines. Exits with zero status if an input line is selected. .RE .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad .RS 6n -.rt Consider only input lines that use all characters in the line to match an entire fixed string or regular expression to be matching lines. .RE @@ -258,12 +234,10 @@ entire fixed string or regular expression to be matching lines. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIfile\fR\fR .ad .RS 8n -.rt A path name of a file to be searched for the patterns. If no \fIfile\fR operands are specified, the standard input is used. .RE @@ -271,24 +245,20 @@ operands are specified, the standard input is used. .SS "/usr/bin/egrep" .sp .ne 2 -.mk .na \fB\fIpattern\fR\fR .ad .RS 11n -.rt Specify a pattern to be used during the search for input. .RE .SS "/usr/xpg4/bin/egrep" .sp .ne 2 -.mk .na \fB\fIpattern\fR\fR .ad .RS 11n -.rt Specify one or more patterns to be used during the search for input. This operand is treated as if it were specified as \fB-e\fR\fIpattern_list.\fR. .RE @@ -310,34 +280,28 @@ that affect the execution of \fBegrep\fR: \fBLC_COLLATE\fR, \fBLC_CTYPE\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt If any matches are found. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt If no matches are found. .RE .sp .ne 2 -.mk .na \fB\fB2\fR\fR .ad .RS 5n -.rt For syntax errors or inaccessible files (even if matches were found). .RE @@ -350,13 +314,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSINot Enabled +CSI Not Enabled .TE .SS "/usr/xpg4/bin/egrep" @@ -364,13 +327,12 @@ CSINot Enabled .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled .TE .SH SEE ALSO diff --git a/usr/src/man/man1/eject.1 b/usr/src/man/man1/eject.1 index 877c7c0e64..142322011f 100644 --- a/usr/src/man/man1/eject.1 +++ b/usr/src/man/man1/eject.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 eject 1 "8 Sep 2009" "SunOS 5.11" "User Commands" +.TH EJECT 1 "Sep 8, 2009" .SH NAME eject \- eject media such as CD-ROM and floppy from drive .SH SYNOPSIS @@ -52,56 +52,46 @@ drives have this capability. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad .RS 6n -.rt Display the name of the default device to be ejected. .RE .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 6n -.rt Force the device to eject even if it is busy. .RE .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 6n -.rt Display paths and nicknames of ejectable devices. .RE .sp .ne 2 -.mk .na \fB\fB-q\fR\fR .ad .RS 6n -.rt Query to see if the media is present. .RE .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad .RS 6n -.rt Issues the drive a CD-ROM tray close command. .sp Not all devices support this command. @@ -113,24 +103,20 @@ Not all devices support this command. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIdevice\fR\fR .ad .RS 12n -.rt Specifies which device to \fBeject\fR, by the name it appears in the directory \fB/dev\fR. .RE .sp .ne 2 -.mk .na \fB\fInickname\fR\fR .ad .RS 12n -.rt Specifies which device to \fBeject\fR, by its nickname as known to this command. .sp @@ -173,81 +159,67 @@ example> \fBeject floppy0\fR The following exit codes are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt The operation was successful or, with the \fB-q\fR option, the media \fIis\fR in the drive. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt The operation was unsuccessful or, with the \fB-q\fR option, the media is \fInot\fR in the drive. .RE .sp .ne 2 -.mk .na \fB\fB2\fR\fR .ad .RS 5n -.rt Invalid options were specified. .RE .sp .ne 2 -.mk .na \fB\fB3\fR\fR .ad .RS 5n -.rt An \fBioctl()\fR request failed. .RE .sp .ne 2 -.mk .na \fB\fB4\fR\fR .ad .RS 5n -.rt Manually ejectable media is now okay to remove. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB/dev/diskette0\fR\fR .ad .RS 18n -.rt default diskette file .RE .sp .ne 2 -.mk .na \fB\fB/dev/sr0\fR\fR .ad .RS 18n -.rt default \fBCD-ROM\fR file (deprecated) .RE diff --git a/usr/src/man/man1/elfdump.1 b/usr/src/man/man1/elfdump.1 index 3c6d773acf..c27e7aef0b 100644 --- a/usr/src/man/man1/elfdump.1 +++ b/usr/src/man/man1/elfdump.1 @@ -11,7 +11,7 @@ .\" 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 elfdump 1 "3 Apr 2009" "SunOS 5.11" "User Commands" +.TH ELFDUMP 1 "Apr 3, 2009" .SH NAME elfdump \- dumps selected parts of an object file .SH SYNOPSIS @@ -50,7 +50,7 @@ Category Option ELF Section Type Dynamic -d SHT_DYNAMIC Global Offset Table (GOT) -G Special. See below. Group -g SHT_GROUP -Hardware/Software +Hardware/Software Capabilities -H SHT_SUNW_cap Hash Table -h SHT_HASH Interpreter -i Special, see below. @@ -98,112 +98,92 @@ and Libraries Guide\fR. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad .RS 18n -.rt Dumps section header information. .RE .sp .ne 2 -.mk .na \fB\fB-C\fR\fR .ad .RS 18n -.rt Demangles C++ symbol names. .RE .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad .RS 18n -.rt Dumps the contents of the \fB\&.dynamic\fR section. .RE .sp .ne 2 -.mk .na \fB\fB-e\fR\fR .ad .RS 18n -.rt Dumps the \fBELF\fR header. .RE .sp .ne 2 -.mk .na \fB\fB-g\fR\fR .ad .RS 18n -.rt Dumps the contents of the \fB\&.group\fR section. .RE .sp .ne 2 -.mk .na \fB\fB-G\fR\fR .ad .RS 18n -.rt Dumps the contents of the \fB\&.got\fR section. .RE .sp .ne 2 -.mk .na \fB\fB-h\fR\fR .ad .RS 18n -.rt Dumps the contents of the \fB\&.hash\fR section. .RE .sp .ne 2 -.mk .na \fB\fB-H\fR\fR .ad .RS 18n -.rt Dumps the contents of the \fB\&.SUNW_cap\fR hardware and software capabilities section. .RE .sp .ne 2 -.mk .na \fB\fB-i\fR\fR .ad .RS 18n -.rt Dumps the contents of the \fB\&.interp\fR section. .RE .sp .ne 2 -.mk .na \fB\fB-I\fR \fIindex-expr\fR\fR .ad .RS 18n -.rt Qualifies the sections or program headers to examine with a specific index or index range. For example, the third section header in a file can be displayed using: @@ -245,45 +225,37 @@ See Matching Options for additional information about the matching options .sp .ne 2 -.mk .na \fB\fB-k\fR\fR .ad .RS 18n -.rt Calculates the \fBELF\fR checksum. See \fBgelf_checksum\fR(3ELF). .RE .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 18n -.rt Displays long section names without truncation. .RE .sp .ne 2 -.mk .na \fB\fB-m\fR\fR .ad .RS 18n -.rt Dumps the contents of the \fB\&.SUNW_move\fR section. .RE .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 18n -.rt Dumps the contents of \fB\&.note\fR sections. By default, \fBelfdump\fR displays this data without interpretation in hexadecimal form. Core files are an exception. A subset of the core file notes described in \fBcore\fR(4) are @@ -295,12 +267,10 @@ and NT_ZONENAME. .sp .ne 2 -.mk .na \fB\fB-N\fR \fIname\fR\fR .ad .RS 18n -.rt Qualifies the sections or program headers to examine with a specific name. For example, in a file that contains more than one symbol table, the \fB\&.dynsym\fR symbol table can be displayed by itself using: @@ -330,12 +300,10 @@ See Matching Options for additional information about the matching options .sp .ne 2 -.mk .na \fB\fB-O\fR \fIosabi\fR\fR .ad .RS 18n -.rt Specifies the Operating System ABI to apply when interpreting the object. \fIosabi\fR can be the name or value of any of the \fBELFOSABI_\fR constants found in \fB/usr/include/sys/elf.h\fR. For convenience, the \fBELFOSABI_\fR @@ -355,12 +323,10 @@ object that specifies the generic ELF ABI is assumed to conform to the .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 18n -.rt Dumps the program headers. Individual program headers can be specified using the matching options (\fB-I\fR, \fB-N\fR, \fB-T\fR). See Matching Options for additional information. @@ -371,12 +337,10 @@ options can be used in a given \fBelfdump\fR invocation .sp .ne 2 -.mk .na \fB\fB-P\fR\fR .ad .RS 18n -.rt Generate and use alternative section header information based on the information from the program headers, ignoring any section header information contained in the file. If the file has no section headers a warning message is @@ -390,23 +354,19 @@ headers allows files with altered section headers to be examined. .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 18n -.rt Dumps the contents of the \fB\&.rel\fR[\fBa\fR] relocation sections. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 18n -.rt Dumps the contents of the \fB\&.SUNW_ldynsym\fR, \fB\&.dynsym\fR, and \fB\&.symtab\fR symbol table sections. For archives, the archive symbol table is also dumped. Individual sections can be specified with the matching options @@ -425,12 +385,10 @@ See Matching Options for additional information about the matching options .sp .ne 2 -.mk .na \fB\fB-S\fR\fR .ad .RS 18n -.rt Dumps the contents of the \fB\&.SUNW_ldynsym\fR and \fB\&.dynsym\fR symbol table sections sorted in the order given by the \fB\&.SUNW_dynsymsort\fR and \fB\&.SUNW_dyntlssort\fR symbol sort sections. Thread Local Storage (TLS) @@ -440,12 +398,10 @@ not referenced by the sort sections are not displayed. .sp .ne 2 -.mk .na \fB\fB-T\fR \fItype\fR\fR .ad .RS 18n -.rt Qualifies the sections or program headers to examine with a specific type. For example, in a file that contains more than one symbol table, the \fB\&.dynsym\fR symbol table can be displayed by itself using: @@ -498,35 +454,29 @@ See Matching Options for additional information about the matching options .sp .ne 2 -.mk .na \fB\fB-u\fR\fR .ad .RS 18n -.rt Dumps the contents of sections used for stack frame unwinding and exception processing. .RE .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 18n -.rt Dumps the contents of the \fB\&.SUNW\fR\fI_version\fR version sections. .RE .sp .ne 2 -.mk .na \fB\fB-w\fR \fIfile\fR\fR .ad .RS 18n -.rt Writes the contents of sections which are specified with the matching options (\fB-I\fR, \fB-N\fR, \fB-T\fR) to the named file. For example, extracting the \fB\&.text\fR section of a file can be carried out with: @@ -547,12 +497,10 @@ options can be used in a given \fBelfdump\fR invocation .sp .ne 2 -.mk .na \fB\fB-y\fR\fR .ad .RS 18n -.rt Dumps the contents of the \fB\&.SUNW_syminfo\fR section. .RE @@ -562,12 +510,10 @@ Dumps the contents of the \fB\&.SUNW_syminfo\fR section. The following operand is supported: .sp .ne 2 -.mk .na \fB\fIfilename\fR\fR .ad .RS 12n -.rt The name of the specified object file. .RE @@ -618,12 +564,10 @@ specifying each item. .SH FILES .sp .ne 2 -.mk .na \fB\fBliblddbg.so\fR\fR .ad .RS 15n -.rt linker debugging library .RE @@ -635,13 +579,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed .TE .SH SEE ALSO diff --git a/usr/src/man/man1/elfedit.1 b/usr/src/man/man1/elfedit.1 index 2fb4add659..a8e9712218 100644 --- a/usr/src/man/man1/elfedit.1 +++ b/usr/src/man/man1/elfedit.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 elfedit 1 "28 Jan 2008" "SunOS 5.11" "User Commands" +.TH ELFEDIT 1 "Jan 28, 2008" .SH NAME elfedit \- examine or edit ELF files .SH SYNOPSIS @@ -69,12 +69,10 @@ The interpretation of the characters in an \fBelfedit\fR token depends on the style of quoting used: .sp .ne 2 -.mk .na \fBUnquoted\fR .ad .RS 17n -.rt Outside of single (') or double (") quotes, backslash (\) acts as an escape character. When a backslash character is seen, \fBelfedit\fR ignores it, and treats the character following it literally (even if the following character is @@ -86,12 +84,10 @@ literal character. .sp .ne 2 -.mk .na \fBSingle Quotes\fR .ad .RS 17n -.rt Within single quotes ('), white space characters do not delimit tokens, and are interpreted as literal characters within the token. Double quote (") and backslash (\) characters are interpreted as literal characters, and have no @@ -100,134 +96,110 @@ special meaning. .sp .ne 2 -.mk .na \fBDouble Quotes\fR .ad .RS 17n -.rt Within double quotes ("), white space characters do not delimit tokens. Single quote characters are interpreted literally and do not have a quoting function. Backslash (\) is an escape character which operates similarly to the way it is used in the C programming language within a string literal: .sp .ne 2 -.mk .na \fB\a\fR .ad .RS 8n -.rt alert (bell) .RE .sp .ne 2 -.mk .na -\fB\b\fR +\fB\\b\fR .ad .RS 8n -.rt backspace .RE .sp .ne 2 -.mk .na \fB\f\fR .ad .RS 8n -.rt form feed .RE .sp .ne 2 -.mk .na \fB\n\fR .ad .RS 8n -.rt newline .RE .sp .ne 2 -.mk .na \fB\r\fR .ad .RS 8n -.rt return .RE .sp .ne 2 -.mk .na \fB\t\fR .ad .RS 8n -.rt horizontal tab .RE .sp .ne 2 -.mk .na -\fB\v\fR +\fB\\v\fR .ad .RS 8n -.rt vertical tab .RE .sp .ne 2 -.mk .na \fB\\\fR .ad .RS 8n -.rt backslash .RE .sp .ne 2 -.mk .na \fB\'\fR .ad .RS 8n -.rt single quote .RE .sp .ne 2 -.mk .na \fB\"\fR .ad .RS 8n -.rt double quote .RE .sp .ne 2 -.mk .na -\fB\ooo\fR +\fB\\ooo\fR .ad .RS 8n -.rt An octal constant, where ooo is one to three octal digits (0...7) .RE @@ -250,100 +222,82 @@ form. \fBelfedit\fR is delivered with the following standard modules: .sp .ne 2 -.mk .na \fB\fBcap\fR\fR .ad .RS 11n -.rt Capabilities Section .RE .sp .ne 2 -.mk .na \fB\fBdyn\fR\fR .ad .RS 11n -.rt Dynamic Section .RE .sp .ne 2 -.mk .na \fB\fBehdr\fR\fR .ad .RS 11n -.rt ELF Header .RE .sp .ne 2 -.mk .na \fB\fBphdr\fR\fR .ad .RS 11n -.rt Program Header Array .RE .sp .ne 2 -.mk .na \fB\fBshdr\fR\fR .ad .RS 11n -.rt Section Header Array .RE .sp .ne 2 -.mk .na \fB\fBstr\fR\fR .ad .RS 11n -.rt String Table Section .RE .sp .ne 2 -.mk .na \fB\fBsym\fR\fR .ad .RS 11n -.rt Symbol Table Section .RE .sp .ne 2 -.mk .na \fB\fBsyminfo\fR\fR .ad .RS 11n -.rt \fBSyminfo\fR Section .RE .sp .ne 2 -.mk .na \fB\fBsys\fR\fR .ad .RS 11n -.rt Core built in \fBelfedit\fR commands .RE @@ -455,48 +409,40 @@ addition to normal characters, the path can also contain any of the following tokens: .sp .ne 2 -.mk .na \fB\fB%i\fR\fR .ad .RS 6n -.rt Expands to the current instruction set architecture (ISA) name (\fBsparc\fR, \fBsparcv9\fR, \fBi386\fR, \fBamd64\fR). .RE .sp .ne 2 -.mk .na \fB\fB%I\fR\fR .ad .RS 6n -.rt Expands to the 64-bit ISA. This is the same thing as \fB%i\fR for 64-bit versions of \fBelfedit\fR, but expands to the empty string for 32-bit versions. .RE .sp .ne 2 -.mk .na \fB\fB%o\fR\fR .ad .RS 6n -.rt Expands to the old value of the path being modified. This is useful for appending or prepending directories to the default path. .RE .sp .ne 2 -.mk .na \fB\fB%r\fR\fR .ad .RS 6n -.rt Root of file system tree holding the \fBelfedit\fR program, assuming that \fBelfedit\fR is installed as \fBusr/bin/elfedi\fRt within the tree. On a standard system, this is simply the standard system root directory (\fB/\fR). @@ -507,12 +453,10 @@ modules are used. .sp .ne 2 -.mk .na \fB\fB%%\fR\fR .ad .RS 6n -.rt Expands to a single \fB%\fR character .RE @@ -532,34 +476,28 @@ The default module search path for \fBelfedit\fR is: Expanding the tokens, this is: .sp .ne 2 -.mk .na \fB\fB/usr/lib/elfedit\fR\fR .ad .RS 28n -.rt 32-bit \fBelfedit\fR .RE .sp .ne 2 -.mk .na \fB\fB/usr/lib/elfedit/sparcv9\fR\fR .ad .RS 28n -.rt 64-bit \fBelfedit\fR (\fBsparc\fR) .RE .sp .ne 2 -.mk .na \fB\fB/usr/lib/elfedit/amd64\fR\fR .ad .RS 28n -.rt 64-bit \fBelfedit\fR (\fBx86\fR) .RE @@ -574,12 +512,10 @@ specify both, the \fB-L\fR option supersedes the environment variable. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 29n -.rt Enable \fBautoprint\fR mode. When \fBautoprint\fR is enabled, \fBelfedit\fR prints the modified values that result when the ELF file is modified. This output is shown in the current output style, which can be changed using the @@ -601,12 +537,10 @@ interactive session, use the \fBelfedit\fR command: .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad .RS 29n -.rt If set, this option causes \fBelfedit\fR to issue informational messages describing its internal operations and details of the ELF object being processed. This can be useful when a deep understanding of the operation being @@ -615,12 +549,10 @@ carried out is desired. .sp .ne 2 -.mk .na \fB\fB-e\fR \fIcmd\fR\fR .ad .RS 29n -.rt Specifies an edit command. Multiple \fB-e\fR options can be specified. If edit commands are present on the command line, \fBelfedit\fR operates in batch mode. After opening the file, \fBelfedit\fR executes each command in the order given, @@ -630,60 +562,50 @@ useful for performing simple operations from shell scripts and makefiles. .sp .ne 2 -.mk .na \fB\fB-L\fR \fIpath\fR\fR .ad .RS 29n -.rt Sets default path for locating \fBelfedit\fR modules. Modules are described in \fBModule Search Path\fR section of this manual page.. .RE .sp .ne 2 -.mk .na \fB\fB-o\fR \fBdefault\fR | \fBsimple\fR | \fBnum\fR\fR .ad .RS 29n -.rt The style used to display ELF data. This option establishes the current style for the session. It can be changed from within the \fBelfedit\fR session by using the set (\fBsys:set\fR) command, or by providing \fB-o\fR options to the individual commands executed within the session. .sp .ne 2 -.mk .na \fB\fBdefault\fR\fR .ad .RS 11n -.rt The default style is to display output in a format intended for human viewing. This style is similar to that used by the \fBelfdump\fR utility. .RE .sp .ne 2 -.mk .na \fB\fBnum\fR\fR .ad .RS 11n -.rt Integer values are always shown in integer form. Strings are shown as the integer offset into the containing string table. .RE .sp .ne 2 -.mk .na \fB\fBsimple\fR\fR .ad .RS 11n -.rt When displaying strings from within the ELF file, only the string is displayed. Integer values are displayed as symbolic constants if possible, and in integer form otherwise. No titles, headers, or other supplemental output is shown. @@ -693,12 +615,10 @@ form otherwise. No titles, headers, or other supplemental output is shown. .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 29n -.rt Read-only mode. The input file is opened for read-only access, and the results of the edit session are not saved. \fBelfedit\fR does not allow the \fIoutfile\fR argument when \fB-r\fR is specified. Read-only mode is highly @@ -713,12 +633,10 @@ examination of files for which the user does not have write permission. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIinfile\fR\fR .ad .RS 11n -.rt Input file containing an ELF object to process. .sp This can be an executable (\fBET_EXEC\fR), shared object (\fBET_DYN\fR), or @@ -744,12 +662,10 @@ can be useful for examining an existing file that you do not wish to modify. .sp .ne 2 -.mk .na \fB\fIoutfile\fR\fR .ad .RS 11n -.rt Output file. If both \fIinfile\fR and \fIoutfile\fR are present, \fIinfile\fR is opened for read-only access, and the modified object contents are written to \fIoutfile\fR. @@ -791,34 +707,28 @@ their work and exit when running in this mode. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt A fatal error occurred. .RE .sp .ne 2 -.mk .na \fB\fB2\fR\fR .ad .RS 5n -.rt Invalid command line options were specified. .RE @@ -958,36 +868,30 @@ STT_FUNC .SH ENVIRONMENT VARIABLES .sp .ne 2 -.mk .na \fB\fBELFEDIT_PATH\fR\fR .ad .RS 16n -.rt Alters the default module search path. Module search paths are discussed in the \fBModule Search Path\fR section of this manual page. .RE .sp .ne 2 -.mk .na \fB\fBLD_NOEXEC_64\fR\fR .ad .RS 16n -.rt Suppresses the automatic execution of the 64-bit \fBelfedit\fR. By default, the 64-bit version of \fBelfedit\fR runs if the system is 64-bit capable. .RE .sp .ne 2 -.mk .na \fB\fBPAGER\fR\fR .ad .RS 16n -.rt Interactively delivers output from \fBelfedit\fR to the screen. If not set, \fBmore\fR is used. See \fBmore\fR(1). .RE @@ -995,24 +899,20 @@ Interactively delivers output from \fBelfedit\fR to the screen. If not set, .SH FILES .sp .ne 2 -.mk .na \fB\fB/usr/lib/elfedit\fR\fR .ad .RS 20n -.rt Default directory for \fBelfedit\fR modules that are loaded on demand to supply editing commands. .RE .sp .ne 2 -.mk .na \fB\fB~/.teclarc\fR\fR .ad .RS 20n -.rt Personal \fBtecla\fR customization file for command line editing. See \fBtecla\fR(5). .RE @@ -1025,13 +925,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed .TE .SH SEE ALSO diff --git a/usr/src/man/man1/elfsign.1 b/usr/src/man/man1/elfsign.1 index 7a07a4764a..827601489a 100644 --- a/usr/src/man/man1/elfsign.1 +++ b/usr/src/man/man1/elfsign.1 @@ -1,10 +1,10 @@ '\" te -.\" Copyright 2009, Sun Microsystems, Inc. All Rights Reserved +.\" Copyright 2009, 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 elfsign 1 "7 Jul 2008" "SunOS 5.11" "User Commands" +.TH ELFSIGN 1 "Jul 7, 2008" .SH NAME elfsign \- sign binaries .SH SYNOPSIS @@ -22,13 +22,13 @@ elfsign \- sign binaries .LP .nf -\fB/usr/bin/elfsign\fR verify [\fB-c\fR \fIcertificate_file\fR] +\fB/usr/bin/elfsign\fR verify [\fB-c\fR \fIcertificate_file\fR] [\fB-v\fR] \fB-e\fR \fIelf_object\fR [file]... .fi .LP .nf -\fB/usr/bin/elfsign\fR request \fB-r\fR \fIcertificate_request_file\fR +\fB/usr/bin/elfsign\fR request \fB-r\fR \fIcertificate_request_file\fR {\fB-k\fR \fIprivate_key\fR | \fB-T\fR \fItoken_label\fR} .fi @@ -45,12 +45,10 @@ elfsign \- sign binaries .SH DESCRIPTION .sp .ne 2 -.mk .na \fB\fBlist\fR\fR .ad .RS 11n -.rt Lists on standard output information from a single certificate file or signed elf object. The selected field appears on a single line. If the field specified does not apply to the named file, the command terminates with no standard @@ -60,12 +58,10 @@ other commands. .sp .ne 2 -.mk .na \fB\fBrequest\fR\fR .ad .RS 11n -.rt Generates a private key and a PKCS#10 certificate request. The PKCS#10 certificate request for use with the Solaris Cryptographic Framework. If the private key is to be created in a token device, elfsign prompts for the PIN @@ -80,23 +76,19 @@ Framework. .sp .ne 2 -.mk .na \fB\fBsign\fR\fR .ad .RS 11n -.rt Signs the elf object, using the given private key and certificate file. .RE .sp .ne 2 -.mk .na \fB\fBverify\fR\fR .ad .RS 11n -.rt Verifies an existing signed object. Uses the certificate given or searches for an appropriate certificate in \fB/etc/crypto/certs\fR if \fB-c\fR is not given. .RE @@ -107,7 +99,6 @@ an appropriate certificate in \fB/etc/crypto/certs\fR if \fB-c\fR is not given. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad @@ -123,7 +114,6 @@ certificate. .sp .ne 2 -.mk .na \fB\fB-c\fR \fIcertificate_file\fR\fR .ad @@ -134,7 +124,6 @@ Specifies the path to an X.509 certificate in PEM/PKCS#7 or ASN.1 BER format. .sp .ne 2 -.mk .na \fB\fB-e\fR \fIelf_object\fR\fR .ad @@ -148,7 +137,6 @@ multiple objects. .sp .ne 2 -.mk .na \fB\fB-F\fR \fIformat\fR\fR .ad @@ -158,24 +146,20 @@ For the \fBsign\fR subcommand, specifies the format of the signature. The valid format options are .sp .ne 2 -.mk .na \fB\fBrsa_md5_sha1\fR\fR .ad .RS 16n -.rt Default format Solaris 10 and updates, The \fBrsa_md5_sha1\fR format is Obsolete. .RE .sp .ne 2 -.mk .na \fB\fBrsa_sha1\fR\fR .ad .RS 16n -.rt Default format for this release. .RE @@ -186,7 +170,6 @@ cryptographically secure, nor is it used as part of verification. .sp .ne 2 -.mk .na \fB\fB-f\fR \fIfield\fR\fR .ad @@ -198,57 +181,47 @@ output. The valid field specifiers for a certifiicate file are: .sp .ne 2 -.mk .na \fBsubject\fR .ad .RS 11n -.rt Subject DN (Distinguished Name) .RE .sp .ne 2 -.mk .na \fBissuer\fR .ad .RS 11n -.rt Issuer DN .RE The valid field specifiers for an elf object are: .sp .ne 2 -.mk .na \fBformat\fR .ad .RS 10n -.rt Format of the signature .RE .sp .ne 2 -.mk .na \fBsigner\fR .ad .RS 10n -.rt Subject DN of the certificate used to sign the object .RE .sp .ne 2 -.mk .na \fBtime\fR .ad .RS 10n -.rt Time the signature was applied, in the locale's default format .RE @@ -256,7 +229,6 @@ Time the signature was applied, in the locale's default format .sp .ne 2 -.mk .na \fB\fB-k\fR \fIprivate_key\fR\fR .ad @@ -272,7 +244,6 @@ It is an error to specify both the \fB-k\fR and \fB-T\fR options. .sp .ne 2 -.mk .na \fB\fB-P\fR \fIpin_file\fR\fR .ad @@ -286,7 +257,6 @@ It is an error to specify the \fB-P\fR option without the \fB-T\fR option. .sp .ne 2 -.mk .na \fB\fB-r\fR \fIcertificate_request_file\fR\fR .ad @@ -297,7 +267,6 @@ Specifies the path to the certificate request file, which is in PKCS#10 format. .sp .ne 2 -.mk .na \fB\fB-T\fR \fItoken_label\fR\fR .ad @@ -311,7 +280,6 @@ It is an error to specify both the \fB-T\fR and \fB-k\fR options. .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad @@ -328,12 +296,10 @@ is not stable parseable output. The following operand is supported: .sp .ne 2 -.mk .na \fB\fIfile\fR\fR .ad .RS 8n -.rt One or more elf objects to be signed or verified. At least one elf object must be specified either via the -e option or after all other options. .RE @@ -366,7 +332,7 @@ elfsign: verification of lib/libmylib.so.1 passed .in +2 .nf example$ elfsign request -k mykey -r req.pkcs10 -Enter Company Name / Stock Symbol or some other globally +Enter Company Name / Stock Symbol or some other globally unique identifier. This will be the prefix of the Certificate DN: SUNW @@ -379,20 +345,20 @@ The terms "retail" and "non-retail" refer to export classifications for products manufactured in the USA. These terms define the portion of the world where the product may be shipped.) Roughly speaking, "retail" is worldwide (minus certain excluded nations) and "non-retail" is domestic -only (plus some highly favored nations). -If your provider is subject to USA export control, then you +only (plus some highly favored nations). +If your provider is subject to USA export control, then you must obtain an export approval (classification) from the government of the USA before exporting your provider. -It is critical that you specify the obtained (or expected, when -used during development) classification to the following questions +It is critical that you specify the obtained (or expected, when +used during development) classification to the following questions so that your provider will be appropriately signed. -Do you have retail export approval for use without restrictions +Do you have retail export approval for use without restrictions based on the caller (for example, IPsec)? [Yes/No] \fBNo\fR If you have non-retail export approval for unrestricted use of your -provider by callers, are you also planning to receive retail -approval by restricting which export sensitive callers +provider by callers, are you also planning to receive retail +approval by restricting which export sensitive callers (for example, IPsec) may use your provider? [Yes/No] \fBNo\fR [...] @@ -422,34 +388,30 @@ The following exit values are returned: .sp .TS -tab(); -cw(1i) cw(3i) cw(1.5i) -lw(1i) lw(3i) lw(1.5i) -. -VALUEMEANINGSUB-COMMAND -\fB0\fROperation successfulsign/verify/request -\fB1\fRInvalid arguments -\fB2\fRFailed to verify ELF object verify -3Unable to open ELF objectsign/verify -4Unable to load or invalid certificatesign/verify -5T{ +c c c +l l l . +VALUE MEANING SUB-COMMAND +\fB0\fR Operation successful sign/verify/request +\fB1\fR Invalid arguments +\fB2\fR Failed to verify ELF object verify +3 Unable to open ELF object sign/verify +4 Unable to load or invalid certificate sign/verify +5 T{ Unable to load private key, private key is invalid, or token label is invalid -T}sign -6Failed to add signaturesign -7T{ +T} sign +6 Failed to add signature sign +7 T{ Attempt to verify unsigned object or object not an ELF file -T}verify +T} verify .TE .SH FILES .sp .ne 2 -.mk .na \fB\fB/etc/crypto/certs\fR\fR .ad .RS 21n -.rt Directory searched for the \fBverify\fR subcommand if the \fB-c\fR flag is not used .RE @@ -462,13 +424,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilitySee below. +Interface Stability See below. .TE .sp diff --git a/usr/src/man/man1/elfwrap.1 b/usr/src/man/man1/elfwrap.1 index 4e2b75d33a..76218bb55f 100644 --- a/usr/src/man/man1/elfwrap.1 +++ b/usr/src/man/man1/elfwrap.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 elfwrap 1 "17 March 2008" "SunOS 5.11" "User Commands" +.TH ELFWRAP 1 "Mar 17, 2008" .SH NAME elfwrap \- wrap data in an \fBELF\fR file .SH SYNOPSIS @@ -48,7 +48,6 @@ The \fBbasename\fR(1) of each data file is used to create various pieces of relocatable object. .sp .ne 2 -.mk .na \fBAn \fBELF\fR section named \fB\&.isv-data\fR\fR .ad @@ -59,7 +58,6 @@ This section contains the entire contents of the input data file. .sp .ne 2 -.mk .na \fBAn \fBELF\fR symbol named \fBisv-data_start\fR\fR .ad @@ -70,7 +68,6 @@ This symbol reflects the starting address of the \fB\&.isv-data\fR section. .sp .ne 2 -.mk .na \fBAn \fBELF\fR symbol named \fBisv-data_end\fR\fR .ad @@ -86,7 +83,6 @@ This symbol reflects the address of the first location after the The following options are supported: .sp .ne 2 -.mk .na \fB\fB-64\fR\fR .ad @@ -97,7 +93,6 @@ Create a 64-bit \fBELF\fR relocatable object. .sp .ne 2 -.mk .na \fB\fB-o\fR \fIrelobj-file\fR\fR .ad @@ -108,7 +103,6 @@ Produce a relocatable object that is named \fIrelobj-file\fR. .sp .ne 2 -.mk .na \fB\fB-z\fR target=\fBsparc\fR | \fBx86\fR\fR .ad @@ -132,8 +126,8 @@ The following example encapsulates the system \fBpasswd\fR file and the system .nf example% \fBelfwrap -o passgroup.o /etc/passwd /etc/group\fR example% \fBelfdump -s passgroup.o | egrep "passwd|group"\fR - [2] 0x00000000 0x00000000 SECT LOCL D 0 .passwd - [3] 0x00000000 0x00000000 SECT LOCL D 0 .group + [2] 0x00000000 0x00000000 SECT LOCL D 0 .passwd + [3] 0x00000000 0x00000000 SECT LOCL D 0 .group [7] 0x00000000 0x000002f0 OBJT GLOB D 0 .passwd passwd_start [8] 0x000002f0 0x00000000 OBJT GLOB D 0 .passwd passwd_end [9] 0x00000000 0x00000121 OBJT GLOB D 0 .group group_start @@ -181,12 +175,10 @@ nobody4:x:65534:65534:SunOS 4.x NFS Anonymous Access User:/: .SH FILES .sp .ne 2 -.mk .na \fB\fBa.wrap.o\fR\fR .ad .RS 12n -.rt The default relocatable object file created. .RE @@ -198,13 +190,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed .TE .SH SEE ALSO diff --git a/usr/src/man/man1/enable.1 b/usr/src/man/man1/enable.1 index 276d9d4a82..987ed71789 100644 --- a/usr/src/man/man1/enable.1 +++ b/usr/src/man/man1/enable.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 enable 1 "5 Jun 2006" "SunOS 5.11" "User Commands" +.TH ENABLE 1 "Jun 5, 2006" .SH NAME enable, disable \- enable/disable LP printers .SH SYNOPSIS @@ -44,12 +44,10 @@ client systems when IPP is being used to communicate between client and server. The following options are supported for use with \fBdisable\fR: .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad .RS 15n -.rt Cancels any requests that are currently printing on \fIprinter\fR. This option cannot be used with the \fB-W\fR option. If the printer is remote, the \fB-c\fR option is silently ignored. @@ -57,12 +55,10 @@ option is silently ignored. .sp .ne 2 -.mk .na \fB\fB-W\fR\fR .ad .RS 15n -.rt Waits until the request currently being printed is finished before disabling \fIprinter\fR. This option cannot be used with the \fB-c\fR option. If the printer is remote, the \fB-W\fR option is silently ignored. @@ -70,12 +66,10 @@ printer is remote, the \fB-W\fR option is silently ignored. .sp .ne 2 -.mk .na \fB\fB-r\fR [\fIreason\fR]\fR .ad .RS 15n -.rt Assigns a \fIreason\fR for the disabling of the printer(s). This \fIreason\fR applies to all printers specified. This \fIreason\fR is reported by \fBlpstat\fR \fB-p\fR. Enclose \fIreason\fR in quotes if it contains blanks. @@ -89,12 +83,10 @@ The default reason is \fBunknown reason\fR for the existing printer, and The following operand is supported for both \fBenable\fR and \fBdisable\fR: .sp .ne 2 -.mk .na \fB\fIprinter\fR\fR .ad .RS 11n -.rt The name of the printer to be enabled or disabled. Specify \fIprinter\fR using atomic or URI-style (\fIscheme\fR\fB://\fR\fIendpoint\fR) names. See \fBprinters.conf\fR(4) regarding the naming conventions for destinations. @@ -106,79 +98,65 @@ atomic or URI-style (\fIscheme\fR\fB://\fR\fIendpoint\fR) names. See 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 \fBNIS\fR version of \fB/etc/printers.conf\fR .RE .sp .ne 2 -.mk .na \fB\fBprinters.org_dir\fR\fR .ad .RS 24n -.rt \fBNIS+\fR version of \fB/etc/printers.conf\fR .RE @@ -190,15 +168,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityObsolete +Interface Stability Obsolete _ -CSIEnabled +CSI Enabled .TE .SH SEE ALSO diff --git a/usr/src/man/man1/encrypt.1 b/usr/src/man/man1/encrypt.1 index 4e1373f027..69a8eef726 100644 --- a/usr/src/man/man1/encrypt.1 +++ b/usr/src/man/man1/encrypt.1 @@ -1,9 +1,9 @@ '\" te -.\" Copyright 2008, Sun Microsystems, Inc. All Rights Reserved +.\" Copyright 2008, 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 encrypt 1 "17 Dec 2008" "SunOS 5.11" "User Commands" +.TH ENCRYPT 1 "Dec 17, 2008" .SH NAME encrypt, decrypt \- encrypt or decrypt files .SH SYNOPSIS @@ -14,7 +14,7 @@ encrypt, decrypt \- encrypt or decrypt files .LP .nf -\fB/usr/bin/encrypt\fR \fB-a\fR \fIalgorithm\fR [\fB-v\fR] +\fB/usr/bin/encrypt\fR \fB-a\fR \fIalgorithm\fR [\fB-v\fR] [\fB-k\fR \fIkey_file\fR | \fB-K\fR \fIkey_label\fR [\fB-T\fR \fItoken_spec\fR]] [\fB-i\fR \fIinput_file\fR] [\fB-o\fR \fIoutput_file\fR] .fi @@ -26,7 +26,7 @@ encrypt, decrypt \- encrypt or decrypt files .LP .nf -\fB/usr/bin/decrypt\fR \fB-a\fR \fIalgorithm\fR [\fB-v\fR] +\fB/usr/bin/decrypt\fR \fB-a\fR \fIalgorithm\fR [\fB-v\fR] [\fB-k\fR \fIkey_file\fR | \fB-K\fR \fIkey_label\fR [\fB-T\fR \fItoken_spec\fR]] [\fB-i\fR \fIinput_file\fR] [\fB-o\fR \fIoutput_file\fR] .fi @@ -84,35 +84,29 @@ Cipher text data. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-a\fR \fIalgorithm\fR\fR .ad .RS 18n -.rt Specify the name of the algorithm to use during the encryption or decryption process. See USAGE, \fBAlgorithms\fR for details. .RE .sp .ne 2 -.mk .na \fB\fB-i\fR \fIinput_file\fR\fR .ad .RS 18n -.rt Specify the input file. Default is stdin if \fIinput_file\fR is not specified. .RE .sp .ne 2 -.mk .na \fB\fB-k\fR \fIkey_file\fR\fR .ad .RS 18n -.rt Specify the file containing the key value for the encryption algorithm. Each algorithm has specific key material requirements, as stated in the PKCS#11 specification. If \fB-k\fR is not specified, \fBencrypt\fR prompts for key @@ -126,23 +120,19 @@ For information on generating a key file, see the \fBgenkey\fR subcommand in .sp .ne 2 -.mk .na \fB\fB-K\fR \fIkey_label\fR\fR .ad .RS 18n -.rt Specify the label of a symmetric token key in a PKCS#11 token. .RE .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 18n -.rt Display the list of algorithms available on the system. This list can change depending on the configuration of the cryptographic framework. The keysizes are displayed in bits. @@ -150,12 +140,10 @@ displayed in bits. .sp .ne 2 -.mk .na \fB\fB-o\fR \fIoutput_file\fR\fR .ad .RS 18n -.rt Specify output file. Default is stdout if \fIoutput_file\fR is not specified. If stdout is used without redirecting to a file, the terminal window can appear to hang because the raw encrypted or decrypted data has disrupted the terminal @@ -164,12 +152,10 @@ emulation, much like viewing a binary file can do at times. .sp .ne 2 -.mk .na \fB\fB-T\fR \fItoken_spec\fR\fR .ad .RS 18n -.rt Specify a PKCS#11 token other than the default soft token object store when the \fB-K\fR is specified. .sp @@ -194,12 +180,10 @@ token label and the manufacturer. .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 18n -.rt Display verbose information. See \fBVerbose\fR. .RE @@ -354,23 +338,19 @@ example$ encrypt -a des -K mydeskey \e The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -382,13 +362,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed .TE .SH SEE ALSO diff --git a/usr/src/man/man1/enhance.1 b/usr/src/man/man1/enhance.1 index b3ca67cda6..8a18e37304 100644 --- a/usr/src/man/man1/enhance.1 +++ b/usr/src/man/man1/enhance.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 enhance 1 "18 May 2004" "SunOS 5.11" "User Commands" +.TH ENHANCE 1 "May 18, 2004" .SH NAME enhance \- enhanced command-line editing facilities .SH SYNOPSIS @@ -57,23 +57,19 @@ be displayed on the next line. .SH FILES .sp .ne 2 -.mk .na \fB\fB/usr/lib/libtecla.so\fR\fR .ad .RS 24n -.rt \fBtecla\fR library .RE .sp .ne 2 -.mk .na \fB\fB~/.teclarc\fR\fR .ad .RS 24n -.rt \fBtecla\fR personal customization file. .RE @@ -85,13 +81,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityEvolving +Interface Stability Evolving .TE .SH SEE ALSO diff --git a/usr/src/man/man1/env.1 b/usr/src/man/man1/env.1 index 6294786a5e..3c8612c0a8 100644 --- a/usr/src/man/man1/env.1 +++ b/usr/src/man/man1/env.1 @@ -1,13 +1,13 @@ '\" te .\" Copyright 1989 AT&T Copyright (c) 1992, X/Open Company Limited All Rights Reserved Portions Copyright (c) 2002, Sun Microsystems, Inc. All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 env 1 "2 Jan 2002" "SunOS 5.11" "User Commands" +.TH ENV 1 "Jan 2, 2002" .SH NAME env \- set environment for command invocation .SH SYNOPSIS @@ -18,7 +18,7 @@ env \- set environment for command invocation .LP .nf -\fB/usr/xpg4/bin/env\fR [\fB-i\fR | \fB-\fR] [\fIname=value\fR]... +\fB/usr/xpg4/bin/env\fR [\fB-i\fR | \fB-\fR] [\fIname=value\fR]... [\fIutility\fR [\fIarg\fR... ]] .fi @@ -43,12 +43,10 @@ If \fBenv\fR executes commands with arguments, it uses the default shell The following options are supported: .sp .ne 2 -.mk .na \fB\fB-i\fR | \fB\(mi\fR \fR .ad .RS 14n -.rt Ignores the environment that would otherwise be inherited from the current shell. Restricts the environment for \fIutility\fR to that specified by the arguments. @@ -60,12 +58,10 @@ arguments. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIname\fR\fB=\fR\fIvalue\fR \fR .ad .RS 15n -.rt Arguments of the form \fIname\fR\fB=\fR\fIvalue\fR modify the execution environment, and are placed into the inherited environment before \fIutility\fR is invoked. @@ -73,24 +69,20 @@ is invoked. .sp .ne 2 -.mk .na \fB\fIutility\fR \fR .ad .RS 15n -.rt The name of the utility to be invoked. If \fIutility\fR names any of the special shell built-in utilities, the results are undefined. .RE .sp .ne 2 -.mk .na \fB\fIarg\fR \fR .ad .RS 15n -.rt A string to pass as an argument for the invoked utility. .RE @@ -123,12 +115,10 @@ that affect the execution of \fBenv\fR: \fBLANG\fR, \fBLC_ALL\fR, \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and \fBNLSPATH\fR. .sp .ne 2 -.mk .na \fB\fBPATH\fR\fR .ad .RS 8n -.rt Determine the location of the \fIutility\fR. If \fBPATH\fR is specified as a \fIname\fR=\fIvalue\fR operand to \fBenv\fR, the value given shall be used in the search for \fIutility\fR. @@ -142,45 +132,37 @@ If \fIutility\fR is invoked, the exit status of \fBenv\fR is the exit status of exit values: .sp .ne 2 -.mk .na \fB\fB0\fR \fR .ad .RS 10n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB1-125\fR \fR .ad .RS 10n -.rt An error occurred. .RE .sp .ne 2 -.mk .na \fB\fB126\fR \fR .ad .RS 10n -.rt \fIutility\fR was found but could not be invoked. .RE .sp .ne 2 -.mk .na \fB\fB127\fR \fR .ad .RS 10n -.rt \fIutility\fR could not be found. .RE @@ -193,13 +175,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIenabled +CSI enabled .TE .SS "/usr/xpg4/bin" @@ -207,15 +188,14 @@ CSIenabled .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIenabled +CSI enabled _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man1/eqn.1 b/usr/src/man/man1/eqn.1 index 36c85cd6b4..695f44d8e0 100644 --- a/usr/src/man/man1/eqn.1 +++ b/usr/src/man/man1/eqn.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 eqn 1 "12 Jul 2002" "SunOS 5.11" "User Commands" +.TH EQN 1 "Jul 12, 2002" .SH NAME eqn, neqn, checkeq \- typeset mathematics test .SH SYNOPSIS @@ -58,12 +58,10 @@ treated as \fBeqn\fR input. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-d\fR\fIxy\fR \fR .ad .RS 9n -.rt Sets equation delimiters set to characters \fIx\fR and \fIy\fR with the command-line argument. The more common way to do this is with \fBdelim\fR\fI xy\fR between \fB\&.EQ\fR and \fB\&.EN\fR. The left and right delimiters may be @@ -74,12 +72,10 @@ text. All text that is neither between delimiters nor between \fB\&.EQ\fR and .sp .ne 2 -.mk .na \fB\fB-f\fR\fIn\fR \fR .ad .RS 9n -.rt Changes font to \fIn\fR globally in the document. The font can also be changed globally in the body of the document by using the \fBgfont\fR\fI n\fR directive, where \fIn\fR is the font specification. @@ -87,12 +83,10 @@ directive, where \fIn\fR is the font specification. .sp .ne 2 -.mk .na \fB\fB-p\fR\fIn\fR \fR .ad .RS 9n -.rt Reduces subscripts and superscripts by \fIn\fR point sizes from the previous size. In the absence of the \fB-p\fR option, subscripts and superscripts are reduced by 3 point sizes from the previous size. @@ -100,12 +94,10 @@ reduced by 3 point sizes from the previous size. .sp .ne 2 -.mk .na \fB\fB-s\fR\fIn\fR \fR .ad .RS 9n -.rt Changes point size to \fIn\fR globally in the document. The point size can also be changed globally in the body of the document by using the \fBgsize\fR\fI n\fR directive, where \fIn\fR is the point size. @@ -117,12 +109,10 @@ n\fR directive, where \fIn\fR is the point size. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIfile\fR \fR .ad .RS 9n -.rt The nroff or troff file processed by \fBeqn\fR or \fBneqn\fR. .RE @@ -142,7 +132,6 @@ tilde (\fB~\fR) represents a full SPACE in the output; a circumflex (\fB^\fR) half as much. .sp .ne 2 -.mk .na \fBSubscripts and superscripts:\fR .ad @@ -151,12 +140,10 @@ half as much. These are produced with the keywords \fBsub\fR and \fBsup\fR. .sp .ne 2 -.mk .na \fB\fBx sub i\fR\fR .ad .RS 29n -.rt makes .EQ delim $$ @@ -167,12 +154,10 @@ $x sub i$ .sp .ne 2 -.mk .na \fB\fBa sub i sup 2\fR \fR .ad .RS 29n -.rt produces .EQ delim $$ @@ -183,12 +168,10 @@ $a sub i sup 2$ .sp .ne 2 -.mk .na \fB\fBe sup {x sup 2 + y sup 2}\fR\fR .ad .RS 29n -.rt gives e^(x^2+y^2) .sp .RE @@ -197,7 +180,6 @@ gives e^(x^2+y^2) .sp .ne 2 -.mk .na \fBFractions:\fR .ad @@ -206,12 +188,10 @@ gives e^(x^2+y^2) Fractions are made with \fBover\fR. .sp .ne 2 -.mk .na \fB\fBa over b\fR \fR .ad .RS 13n -.rt yields .EQ delim $$ @@ -224,7 +204,6 @@ $a over b$ .sp .ne 2 -.mk .na \fBSquare Roots:\fR .ad @@ -233,7 +212,6 @@ $a over b$ These are made with \fBsqrt\fR .sp .ne 2 -.mk .na \fB\fB1 over sqrt {ax sup 2 +bx+c}\fR \fR .ad @@ -251,7 +229,6 @@ $1 over sqrt {ax sup 2 +bx+c}$ .sp .ne 2 -.mk .na \fBLimits:\fR .ad @@ -261,7 +238,6 @@ The keywords \fBfrom\fR and \fBto\fR introduce lower and upper limits on arbitrary things: .sp .ne 2 -.mk .na \fB\fBlim from {n\(-> inf } sum from 0 to n x sub i\fR\fR .ad @@ -279,7 +255,6 @@ $lim from {n\(-> inf } sum from 0 to n x sub i$ .sp .ne 2 -.mk .na \fBBrackets and Braces:\fR .ad @@ -289,7 +264,6 @@ Left and right brackets, braces, and the like, of the right height are made with \fBleft\fR and \fBright\fR. .sp .ne 2 -.mk .na \fB\fBleft [ x sup 2 + y sup 2 over alpha right ] ~=~1\fR \fR .ad @@ -311,7 +285,6 @@ floor, and \fB""\fR for nothing at all (useful for a right-side-only bracket). .sp .ne 2 -.mk .na \fBVertical piles:\fR .ad @@ -321,12 +294,10 @@ Vertical piles of things are made with \fBpile\fR, \fBlpile\fR, \fBcpile\fR, and \fBrpile\fR. .sp .ne 2 -.mk .na \fB\fBpile {a above b above c}\fR\fR .ad .RS 28n -.rt produces .EQ delim $$ @@ -343,7 +314,6 @@ spacing, and \fBrpile\fR right justifies. .sp .ne 2 -.mk .na \fBMatrices:\fR .ad @@ -352,7 +322,6 @@ spacing, and \fBrpile\fR right justifies. Matrices are made with \fBmatrix\fR. .sp .ne 2 -.mk .na \fB\fBmatrix { lcol { x sub i above y sub 2 } ccol { 1 above 2 } }\fR \fR .ad @@ -372,7 +341,6 @@ In addition, there is \fBrcol\fR for a right-justified column. .sp .ne 2 -.mk .na \fBDiacritical marks:\fR .ad @@ -382,12 +350,10 @@ Diacritical marks are made with \fBdot\fR, \fBdotdot\fR, \fBhat\fR, \fBtilde\fR, \fBbar\fR, \fBvec\fR, \fBdyad\fR, and \fBunder\fR. .sp .ne 2 -.mk .na \fB\fBx dot = f(t) bar\fR\fR .ad .RS 28n -.rt is .EQ delim $$ @@ -398,12 +364,10 @@ $x dot = f(t) bar$ .sp .ne 2 -.mk .na \fB\fBy dotdot bar ~=~ n under\fR\fR .ad .RS 28n -.rt is .EQ delim $$ @@ -414,12 +378,10 @@ $y dotdot bar ~=~ n under$ .sp .ne 2 -.mk .na \fB\fBx vec ~=~ y dyad\fR \fR .ad .RS 28n -.rt is .EQ delim $$ @@ -432,7 +394,6 @@ $x vec ~=~ y dyad$ .sp .ne 2 -.mk .na \fBSizes and Fonts:\fR .ad @@ -447,7 +408,6 @@ Sizes and font can be changed with \fBsize\fR \fIn\fR or \fBsize\fR .sp .ne 2 -.mk .na \fBSuccessive display arguments:\fR .ad @@ -460,7 +420,6 @@ that is to line up vertically in subsequent equations. .sp .ne 2 -.mk .na \fBShorthands:\fR .ad @@ -470,7 +429,6 @@ Shorthands may be defined or existing keywords redefined with \fBdefine\fR\fI:\fR .sp .ne 2 -.mk .na \fB\fBdefine\fR\fI thing \fR\fB%\fR\fI replacement \fR\fB%\fR \fR .ad @@ -485,7 +443,6 @@ character that does not occur in \fIreplacement\fR. .sp .ne 2 -.mk .na \fBKeywords and Shorthands:\fR .ad @@ -497,7 +454,6 @@ Keywords like \fBsum\fR \fBint\fR \fBinf\fR and shorthands like \fB>=\fR .sp .ne 2 -.mk .na \fBGreek letters:\fR .ad @@ -509,7 +465,6 @@ Greek letters are spelled out in the desired case, as in \fBalpha\fR or .sp .ne 2 -.mk .na \fBMathematical words:\fR .ad diff --git a/usr/src/man/man1/exec.1 b/usr/src/man/man1/exec.1 index 58fb7fc7f0..7276e8a975 100644 --- a/usr/src/man/man1/exec.1 +++ b/usr/src/man/man1/exec.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 exec 1 "8 Apr 2008" "SunOS 5.11" "User Commands" +.TH EXEC 1 "Apr 8, 2008" .SH NAME exec, eval, source \- shell built-in functions to execute other commands .SH SYNOPSIS @@ -87,12 +87,10 @@ descriptors. An error in a sourced file at any level terminates all nested \fBsource\fR commands. .sp .ne 2 -.mk .na \fB\fB-h\fR\fR .ad .RS 6n -.rt Place commands from the file \fIname\fR on the history list without executing them. .RE @@ -216,23 +214,19 @@ field splitting and file name generation are not performed. The following options are supported by \fBksh93 exec\fR: .sp .ne 2 -.mk .na \fB\fB-a\fR \fIname\fR\fR .ad .RS 11n -.rt \fBargv[0]\fR is set to \fIname\fR for command. .RE .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad .RS 11n -.rt Clear all environment variables before executions except variable assignments that are part of the current \fBexec\fR command. .RE @@ -244,45 +238,37 @@ that are part of the current \fBexec\fR command. The following exit values are returned by \fBexec\fR: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 9n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB1-125\fR\fR .ad .RS 9n -.rt A redirection error occurred. .RE .sp .ne 2 -.mk .na \fB\fB127\fR\fR .ad .RS 9n -.rt \fIcommand\fR was not found. .RE .sp .ne 2 -.mk .na \fB\fB126\fR\fR .ad .RS 9n -.rt \fIcommand\fR was found, but it is not an executable utility. .RE @@ -293,23 +279,19 @@ The following exit values are returned by \fBexec\fR. If \fIcommand\fR is specified, \fBexec\fR does not return. .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. All I/O redirections were successful. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -328,11 +310,10 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE .TE .SH SEE ALSO diff --git a/usr/src/man/man1/exit.1 b/usr/src/man/man1/exit.1 index eec29753be..8732bfe2f2 100644 --- a/usr/src/man/man1/exit.1 +++ b/usr/src/man/man1/exit.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 exit 1 "2 Nov 2007" "SunOS 5.11" "User Commands" +.TH EXIT 1 "Nov 2, 2007" .SH NAME exit, return, goto \- shell built-in functions to enable the execution of the shell to advance beyond its sequence of steps @@ -202,11 +202,10 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE .TE .SH SEE ALSO diff --git a/usr/src/man/man1/expand.1 b/usr/src/man/man1/expand.1 index 59ae4a438e..3a6c4e38d6 100644 --- a/usr/src/man/man1/expand.1 +++ b/usr/src/man/man1/expand.1 @@ -1,13 +1,13 @@ '\" te .\" Copyright (c) 1992, X/Open Company Limited All Rights Reserved Portions Copyright (c) 1995, Sun Microsystems, Inc. All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 expand 1 "1 Feb 1995" "SunOS 5.11" "User Commands" +.TH EXPAND 1 "Feb 1, 1995" .SH NAME expand, unexpand \- expand TAB characters to SPACE characters, and vice versa .SH SYNOPSIS @@ -47,12 +47,10 @@ overridden by the \fB-a\fR option (see the OPTIONS section below). The following options are supported for \fBexpand\fR: .sp .ne 2 -.mk .na \fB\fB-t\fR \fItablist\fR \fR .ad .RS 26n -.rt Specifies the tab stops. The argument \fItablist\fR must consist of a single positive decimal integer or multiple positive decimal integers, separated by blank characters or commas, in ascending order. If a single number is given, @@ -72,24 +70,20 @@ character is replaced by a single space character in the output. .sp .ne 2 -.mk .na \fB\fB-\fR\fItabstop\fR \fR .ad .RS 26n -.rt Specifies as a single argument, sets TAB characters \fItabstop\fR SPACE characters apart instead of the default \fB8\fR. .RE .sp .ne 2 -.mk .na \fB\fB-\fR\fItab1\fR\fI,\|tab2,...,tabn\fR \fR .ad .RS 26n -.rt Sets TAB characters at the columns specified by \fB-\fR\fItab1,tab2,...,\|tabn\fR .RE @@ -99,24 +93,20 @@ Sets TAB characters at the columns specified by The following options are supported for \fBunexpand\fR: .sp .ne 2 -.mk .na \fB\fB-a\fR \fR .ad .RS 15n -.rt Inserts TAB characters when replacing a run of two or more SPACE characters would produce a smaller output file. .RE .sp .ne 2 -.mk .na \fB\fB-t\fR \fItablist\fR \fR .ad .RS 15n -.rt Specifies the tab stops. The option-argument \fItablist\fR must be a single argument consisting of a single positive decimal integer or multiple positive decimal integers, separated by blank characters or commas, in ascending order. @@ -144,12 +134,10 @@ characters. The following ooperand is supported for \fBexpand\fR and \fBunexpand\fR: .sp .ne 2 -.mk .na \fB\fB\fIfile\fR\fR \fR .ad .RS 9n -.rt The path name of a text file to be used as input. .RE @@ -165,23 +153,19 @@ that affect the execution of \fBexpand\fR and \fBunexpand\fR: \fBLANG\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR \fR .ad .RS 7n -.rt Successful completion .RE .sp .ne 2 -.mk .na \fB\fB>0\fR \fR .ad .RS 7n -.rt An error occurred. .RE @@ -193,15 +177,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIenabled +CSI enabled _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man1/expr.1 b/usr/src/man/man1/expr.1 index 8943b918d7..a7d598c5ba 100644 --- a/usr/src/man/man1/expr.1 +++ b/usr/src/man/man1/expr.1 @@ -2,14 +2,14 @@ .\" Copyright 1989 AT&T .\" Copyright (c) 2003, Sun Microsystems, Inc. All Rights Reserved .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 1 "29 Aug 2003" "SunOS 5.11" "User Commands" +.TH EXPR 1 "Aug 29, 2003" .SH NAME expr \- evaluate arguments as an expression .SH SYNOPSIS @@ -56,7 +56,6 @@ precedence, with equal precedence operators grouped within \fB{\|}\fR symbols. All of the operators are left-associative. .sp .ne 2 -.mk .na \fB\fIexpr\fR \fB\e|\fR \fIexpr\fR\fR .ad @@ -69,7 +68,6 @@ not \fINULL\fR; otherwise, \fB0\fR. .sp .ne 2 -.mk .na \fB\fIexpr\fR \fB\e&\fR \fIexpr\fR\fR .ad @@ -81,7 +79,6 @@ otherwise returns \fB0\fR. .sp .ne 2 -.mk .na \fB\fIexpr\fR{ \fB=\fR, \fB\e>\fR, \fB\e>=\fR, \fB\e<\fR, \fB\e<=\fR, \fB!=\fR} \fIexpr\fR\fR @@ -97,7 +94,6 @@ specified relationship is \fBTRUE\fR, \fB0\fR if the relationship is .sp .ne 2 -.mk .na \fB\fIexpr \fR{ \fB+\fR, \fB\(mi \fR} \fIexpr\fR\fR .ad @@ -108,7 +104,6 @@ Addition or subtraction of integer-valued arguments. .sp .ne 2 -.mk .na \fB\fIexpr \fR{ \fB\e*\fR, \fB/\fR, \fB%\fR} \fIexpr\fR\fR .ad @@ -119,7 +114,6 @@ Multiplication, division, or remainder of the integer-valued arguments. .sp .ne 2 -.mk .na \fB\fIexpr\fR \fB:\fR \fIexpr\fR\fR .ad @@ -139,7 +133,6 @@ corresponding to \e1. .sp .ne 2 -.mk .na \fB\fIinteger\fR \fR .ad @@ -150,7 +143,6 @@ An argument consisting only of an (optional) unary minus followed by digits. .sp .ne 2 -.mk .na \fB\fIstring\fR \fR .ad @@ -168,7 +160,6 @@ System only and are not intended to be used by non- INTERACTIVE UNIX System scripts: .sp .ne 2 -.mk .na \fB\fBindex\fR \fIstring character-list\fR\fR .ad @@ -180,7 +171,6 @@ matches a byte in \fIstring\fR. .sp .ne 2 -.mk .na \fB\fBlength\fR \fIstring\fR\fR .ad @@ -191,7 +181,6 @@ Return the length (that is, the number of bytes) of \fIstring\fR. .sp .ne 2 -.mk .na \fB\fBsubstr\fR \fIstring integer-1 integer-2\fR\fR .ad @@ -288,45 +277,37 @@ As a side effect of expression evaluation, \fBexpr\fR returns the following exit values: .sp .ne 2 -.mk .na \fB\fB0\fR \fR .ad .RS 7n -.rt If the expression is neither \fINULL\fR nor \fB0\fR. .RE .sp .ne 2 -.mk .na \fB\fB1\fR \fR .ad .RS 7n -.rt If the expression is either \fINULL\fR or \fB0\fR. .RE .sp .ne 2 -.mk .na \fB\fB2\fR \fR .ad .RS 7n -.rt For invalid expressions. .RE .sp .ne 2 -.mk .na \fB\fB>2\fR \fR .ad .RS 7n -.rt An error occurred. .RE @@ -338,15 +319,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIenabled +CSI enabled _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO @@ -357,23 +337,19 @@ Interface StabilityStandard .SH DIAGNOSTICS .sp .ne 2 -.mk .na \fB\fBsyntax error\fR\fR .ad .RS 24n -.rt Operator and operand errors. .RE .sp .ne 2 -.mk .na \fB\fBnon-numeric argument\fR\fR .ad .RS 24n -.rt Arithmetic is attempted on such a string. .RE diff --git a/usr/src/man/man1/exstr.1 b/usr/src/man/man1/exstr.1 index 7b223c94f1..be476f0aef 100644 --- a/usr/src/man/man1/exstr.1 +++ b/usr/src/man/man1/exstr.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 exstr 1 "5 Jul 1990" "SunOS 5.11" "User Commands" +.TH EXSTR 1 "Jul 5, 1990" .SH NAME exstr \- extract strings from source files .SH SYNOPSIS @@ -70,18 +70,15 @@ the message retrieval function. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-e\fR \fR .ad .RS 7n -.rt Extract a list of strings from the named C-language source files, with positional information. This list is produced on standard output in the following format: .sp .ne 2 -.mk .na \fB\fIfile:line:position:msgfile:msgnum:string\fR \fR .ad @@ -92,7 +89,6 @@ following format: .sp .ne 2 -.mk .na \fB\fIfile\fR \fR .ad @@ -103,7 +99,6 @@ the name of a C-language source file .sp .ne 2 -.mk .na \fB\fIline\fR \fR .ad @@ -114,7 +109,6 @@ line number in the file .sp .ne 2 -.mk .na \fB\fIposition\fR \fR .ad @@ -125,7 +119,6 @@ character position in the line .sp .ne 2 -.mk .na \fB\fImsgfile\fR \fR .ad @@ -136,7 +129,6 @@ null .sp .ne 2 -.mk .na \fB\fImsgnum\fR \fR .ad @@ -147,7 +139,6 @@ null .sp .ne 2 -.mk .na \fB\fIstring\fR \fR .ad @@ -160,12 +151,10 @@ Normally you would redirect this output into a file. Then you would edit this file to add the values you want to use for \fImsgfile\fR and \fImsgnum\fR: .sp .ne 2 -.mk .na \fB\fImsgfile\fR \fR .ad .RS 12n -.rt the file that contains the text strings that will replace \fIstring\fR. A file with this name must be created and installed in the appropriate place by the \fBmkmsgs\fR(1) utility. @@ -173,12 +162,10 @@ with this name must be created and installed in the appropriate place by the .sp .ne 2 -.mk .na \fB\fImsgnum\fR \fR .ad .RS 12n -.rt the sequence number of the string in \fImsgfile\fR. .RE @@ -188,24 +175,20 @@ The next step is to use \fBexstr\fR \fB-r\fR to replace \fIstring\fRs in .sp .ne 2 -.mk .na \fB\fB-r\fR \fR .ad .RS 7n -.rt Replace strings in a C-language source file with function calls to the message retrieval function \fBgettxt\fR(). .RE .sp .ne 2 -.mk .na \fB\fB-d\fR \fR .ad .RS 7n -.rt This option is used together with the \fB-r\fR option. If the message retrieval fails when \fBgettxt\fR() is invoked at run-time, then the extracted string is printed. You would use the capability provided by \fBexstr\fR on an application @@ -381,7 +364,6 @@ main() .SH FILES .sp .ne 2 -.mk .na \fB\fB/usr/lib/locale/\fR\fIlocale\fR\fB/LC_MESSAGES/* \fR\fR .ad diff --git a/usr/src/man/man1/factor.1 b/usr/src/man/man1/factor.1 index 5d758e67d0..f8460fc40b 100644 --- a/usr/src/man/man1/factor.1 +++ b/usr/src/man/man1/factor.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 factor 1 "31 Jan 1996" "SunOS 5.11" "User Commands" +.TH FACTOR 1 "Jan 31, 1996" .SH NAME factor \- obtain the prime factors of a number .SH SYNOPSIS @@ -38,35 +38,29 @@ is prime or the square of a prime. .SH OPERANDS .sp .ne 2 -.mk .na \fB\fIinteger\fR\fR .ad .RS 11n -.rt Any positive integer less than or equal to 10^14. .RE .SH EXIT STATUS .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt An error occurred. .RE diff --git a/usr/src/man/man1/fdformat.1 b/usr/src/man/man1/fdformat.1 index 2cf2115889..8a13bc7eb3 100644 --- a/usr/src/man/man1/fdformat.1 +++ b/usr/src/man/man1/fdformat.1 @@ -3,13 +3,13 @@ .\" 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 fdformat 1 "28 Feb 2007" "SunOS 5.11" "User Commands" +.TH FDFORMAT 1 "Feb 28, 2007" .SH NAME fdformat \- format floppy diskette or PCMCIA memory card .SH SYNOPSIS .LP .nf -\fBfdformat\fR [\fB-dDeEfHlLmMUqvx\fR] [\fB-b\fR \fIlabel\fR] [\fB-B\fR \fIfilename\fR] +\fBfdformat\fR [\fB-dDeEfHlLmMUqvx\fR] [\fB-b\fR \fIlabel\fR] [\fB-B\fR \fIfilename\fR] [\fB-t\fR \fIdostype\fR] [\fIdevname\fR] .fi @@ -80,24 +80,20 @@ block \fB0\fR. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-b\fR \fIlabel\fR\fR .ad .RS 15n -.rt Labels the media with volume label. A SunOS volume label is restricted to 8 characters. A \fBDOS\fR volume label is restricted to 11 upper-case characters. .RE .sp .ne 2 -.mk .na \fB\fB-B\fR \fIfilename\fR\fR .ad .RS 15n -.rt Installs special boot loader in filename on an \fBMS-DOS\fR diskette. This option is only meaningful when the \fB-d\fR option (or \fB-t\fR \fBdos\fR) is also specified. @@ -105,12 +101,10 @@ also specified. .sp .ne 2 -.mk .na \fB\fB-D\fR\fR .ad .RS 15n -.rt Formats a \fB720KB\fR (3.5 inch) or \fB360KB\fR (5.25 inch) double-density diskette (same as the \fB-l\fR or \fB-L\fR options). This is the default for double-density type drives. It is needed if the drive is a high- or @@ -119,47 +113,39 @@ extended-density type. .sp .ne 2 -.mk .na \fB\fB-e\fR\fR .ad .RS 15n -.rt Ejects the diskette when done. This feature is not available on all systems. .RE .sp .ne 2 -.mk .na \fB\fB-E\fR\fR .ad .RS 15n -.rt Formats a \fB2.88MB\fR (3.5 inch) extended-density diskette. This is the default for extended-density type drives. .RE .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 15n -.rt Forces formatting, that is, this option does not ask for confirmation before starting format. .RE .sp .ne 2 -.mk .na \fB\fB-H\fR\fR .ad .RS 15n -.rt Formats a \fB1.44MB\fR (3.5 inch) or \fB1.2MB\fR (5.25 inch) high-density diskette. This is the default for high-density type drives; it is needed if the drive is the extended-density type. @@ -167,12 +153,10 @@ drive is the extended-density type. .sp .ne 2 -.mk .na \fB\fB-M\fR\fR .ad .RS 15n -.rt Writes a \fB1.2MB\fR (3.5 inch) medium-density format on a high-density diskette (use only with the -t nec option). This is the same as using \fB-m\fR. .sp @@ -181,35 +165,29 @@ This feature is not available on all systems. .sp .ne 2 -.mk .na \fB\fB-q\fR\fR .ad .RS 15n -.rt Quiet; does not print status messages. .RE .sp .ne 2 -.mk .na \fB\fB-t\fR \fBdos\fR\fR .ad .RS 15n -.rt Installs an \fBMS-DOS\fR file system and boot sector formatting. This is equivalent to the \fBDOS\fR format command or the \fB-d\fR option. .RE .sp .ne 2 -.mk .na \fB\fB-t\fR \fBnec\fR\fR .ad .RS 15n -.rt Installs an \fBNEC-DOS\fR file system and boot sector on the disk after formatting. This should be used only with the \fB-M\fR option. This feature is not available on all systems. @@ -217,35 +195,29 @@ not available on all systems. .sp .ne 2 -.mk .na \fB\fB-U\fR\fR .ad .RS 15n -.rt Performs \fBumount\fR on any file systems and then formats. See \fBmount\fR(1M). .RE .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 15n -.rt Verifies each block of the diskette after the format. .RE .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad .RS 15n -.rt Skips the format and only writes a SunOS label or an \fBMS-DOS\fR file system. .RE @@ -255,12 +227,10 @@ Skips the format and only writes a SunOS label or an \fBMS-DOS\fR file system. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIdevname\fR\fR .ad .RS 11n -.rt Replaces \fIdevname\fR with \fBrdiskette0\fR (systems without volume management) or \fBfloppy0\fR (systems with volume management) to use the first drive or rdiskette1 (systems without volume management) or \fBfloppy1\fR @@ -275,28 +245,24 @@ If devname is omitted, the default diskette drive, if one exists, will be used. \fIN\fR represents a decimal number and can be specified as follows: .sp .ne 2 -.mk .na \fBc\fIN\fR\fR .ad .RS 6n -.rt Controller \fIN\fR .RE .sp .ne 2 -.mk .na \fBt\fIN\fR\fR .ad .RS 6n -.rt Technology type \fIN\fR: .sp .in +2 .nf - + 0x1 ROM 0x2 OTPROM 0x3 EPROM @@ -312,23 +278,19 @@ Technology type \fIN\fR: .sp .ne 2 -.mk .na \fBd\fIN\fR\fR .ad .RS 6n -.rt Technology region in type \fIN\fR. .RE .sp .ne 2 -.mk .na \fBs\fIN\fR\fR .ad .RS 6n -.rt Slice \fIN\fR. .RE @@ -336,24 +298,20 @@ The following options are provided for compatibility with previous versions of \fBfdformat\fR. Their use is discouraged. .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad .RS 6n -.rt Formats an \fBMS-DOS\fR floppy diskette or \fBPCMCIA\fR memory card (same as \fB-t\fR \fBdos\fR). This is equivalent to the \fBMS-DOS FORMAT\fR command. .RE .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 6n -.rt Formats a \fB720KB\fR (3.5 inch) or \fB360KB\fR (5.25 inch) double-density diskette (same as \fB-D\fR or \fB-L\fR). This is the default for double-density type drives; it is needed if the drive is the high- or extended-density type. @@ -361,12 +319,10 @@ type drives; it is needed if the drive is the high- or extended-density type. .sp .ne 2 -.mk .na \fB\fB-L\fR\fR .ad .RS 6n -.rt Formats a \fB720KB\fR (3.5 inch) or \fB360KB\fR (5.25 inch) double-density diskette (same as \fB-l\fR or \fB-D\fR). This is the default for double-density type drives. @@ -374,12 +330,10 @@ type drives. .sp .ne 2 -.mk .na \fB\fB-m\fR\fR .ad .RS 6n -.rt Writes a \fB1.2 MB\fR (3.5 inch) medium- density format on a high-density diskette (use only with the \fB-t\fR \fBnec\fR option). This is the same as using \fB-M\fR. This feature is not available on all systems. @@ -390,106 +344,88 @@ using \fB-M\fR. This feature is not available on all systems. .SH FILES .sp .ne 2 -.mk .na \fB/dev/diskette0\fR .ad .RS 24n -.rt Directory providing block device access for the media in floppy drive \fB0\fR. .RE .sp .ne 2 -.mk .na \fB/dev/diskette0\fR .ad .RS 24n -.rt Directory providing character device access for the media in floppy drive \fB0\fR. .RE .sp .ne 2 -.mk .na \fB/dev/aliases/floppy0\fR .ad .RS 24n -.rt Symbolic link to the character device for the media in floppy drive \fB0\fR. .RE .sp .ne 2 -.mk .na \fB/dev/rdiskette\fR .ad .RS 24n -.rt Directory providing character device access for the media in the primary floppy drive, usually drive \fB0\fR. .RE .sp .ne 2 -.mk .na \fB/dev/dsk/c\fIN\fRt\fIN\fRd\fIN\fRs\fIN\fR\fR .ad .RS 24n -.rt Directory providing block device access for the \fBPCMCIA\fR memory card. See OPERANDS for a description of \fIN\fR. .RE .sp .ne 2 -.mk .na \fB/dev/rdsk/c\fIN\fRt\fIN\fRd\fIN\fRs\fIN\fR\fR .ad .RS 24n -.rt Directory providing character device access for the \fBPCMCIA\fR memory card. See OPERANDS for a description of \fIN\fR. .RE .sp .ne 2 -.mk .na \fB/dev/aliases/pcmem\fIS\fR\fR .ad .RS 24n -.rt Symbolic link to the character device for the \fBPCMCIA\fR memory card in socket \fIS\fR where \fIS\fR represents a \fBPCMCIA\fR socket number. .RE .sp .ne 2 -.mk .na \fB/dev/rdsk/c\fIN\fRt\fIN\fRd\fIN\fRs\fIN\fR\fR .ad .RS 24n -.rt Directory providing character device access for the \fBPCMCIA\fR memory card. See OPERANDS for a description of \fIN\fR. .RE .sp .ne 2 -.mk .na \fB/dev/dsk/c\fIN\fRt\fIN\fRd\fIN\fRs\fIN\fR\fR .ad .RS 24n -.rt Directory providing block device access for the \fBPCMCIA\fR memory card. See OPERANDS for a description of \fIN\fR. .RE @@ -520,8 +456,8 @@ following message: .sp .in +2 .nf -Non-System disk or disk error. -Replace and strike any key when ready +Non-System disk or disk error. +Replace and strike any key when ready .fi .in -2 .sp diff --git a/usr/src/man/man1/fgrep.1 b/usr/src/man/man1/fgrep.1 index fd428f4dda..a4018c567b 100644 --- a/usr/src/man/man1/fgrep.1 +++ b/usr/src/man/man1/fgrep.1 @@ -2,14 +2,14 @@ .\" Copyright 1989 AT&T .\" Copyright (c) 2006, Sun Microsystems, Inc. All Rights Reserved .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 fgrep 1 "24 Mar 2006" "SunOS 5.11" "User Commands" +.TH FGREP 1 "Mar 24, 2006" .SH NAME fgrep \- search a file for a fixed-character string .SH SYNOPSIS @@ -30,13 +30,13 @@ fgrep \- search a file for a fixed-character string .LP .nf -\fB/usr/xpg4/bin/fgrep\fR [\fB-bchilnqsvx\fR] \fB-e\fR \fIpattern_list\fR [\fB-f\fR \fIfile\fR] +\fB/usr/xpg4/bin/fgrep\fR [\fB-bchilnqsvx\fR] \fB-e\fR \fIpattern_list\fR [\fB-f\fR \fIfile\fR] [\fIfile...\fR] .fi .LP .nf -\fB/usr/xpg4/bin/fgrep\fR [\fB-bchilnqsvx\fR] [\fB-e\fR \fIpattern_list\fR] \fB-f\fR \fIfile\fR +\fB/usr/xpg4/bin/fgrep\fR [\fB-bchilnqsvx\fR] [\fB-e\fR \fIpattern_list\fR] \fB-f\fR \fIfile\fR [\fIfile...\fR] .fi @@ -72,126 +72,104 @@ The following options are supported for both \fB/usr/bin/fgrep\fR and \fB/usr/xpg4/bin/fgrep\fR: .sp .ne 2 -.mk .na \fB\fB-b\fR\fR .ad .RS 19n -.rt Precedes each line by the block number on which the line was found. This can be useful in locating block numbers by context. The first block is 0. .RE .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad .RS 19n -.rt Prints only a count of the lines that contain the pattern. .RE .sp .ne 2 -.mk .na \fB\fB-e\fR \fIpattern_list\fR\fR .ad .RS 19n -.rt Searches for a \fIstring\fR in \fIpattern-list\fR. This is useful when the \fIstring\fR begins with a \fB\(mi\fR\&. .RE .sp .ne 2 -.mk .na \fB\fB-f\fR \fIpattern-file\fR\fR .ad .RS 19n -.rt Takes the list of patterns from \fIpattern-file\fR. .RE .sp .ne 2 -.mk .na \fB\fB-h\fR\fR .ad .RS 19n -.rt Suppresses printing of files when searching multiple files. .RE .sp .ne 2 -.mk .na \fB\fB-i\fR\fR .ad .RS 19n -.rt Ignores upper/lower case distinction during comparisons. .RE .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 19n -.rt Prints the names of files with matching lines once, separated by new-lines. Does not repeat the names of files when the pattern is found more than once. .RE .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 19n -.rt Precedes each line by its line number in the file. The first line is 1. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 19n -.rt Works silently, that is, displays nothing except error messages. This is useful for checking the error status. .RE .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 19n -.rt Prints all lines except those that contain the pattern. .RE .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad .RS 19n -.rt Prints only lines that are matched entirely. .RE @@ -201,12 +179,10 @@ Prints only lines that are matched entirely. The following options are supported for \fB/usr/xpg4/bin/fgrep\fR only: .sp .ne 2 -.mk .na \fB\fB-q\fR\fR .ad .RS 6n -.rt Quiet. Does not write anything to the standard output, regardless of matching lines. Exits with zero status if an input line is selected. .RE @@ -217,12 +193,10 @@ lines. Exits with zero status if an input line is selected. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIfile\fR\fR .ad .RS 8n -.rt Specifies a path name of a file to be searched for the patterns. If no \fIfile\fR operands are specified, the standard input will be used. .RE @@ -230,24 +204,20 @@ Specifies a path name of a file to be searched for the patterns. If no .SS "/usr/bin/fgrep" .sp .ne 2 -.mk .na \fB\fIpattern\fR\fR .ad .RS 11n -.rt Specifies a pattern to be used during the search for input. .RE .SS "/usr/xpg4/bin/fgrep" .sp .ne 2 -.mk .na \fB\fIpattern\fR\fR .ad .RS 11n -.rt Specifies one or more patterns to be used during the search for input. This operand is treated as if it were specified as \fB-e\fR \fIpattern_list\fR. .RE @@ -269,34 +239,28 @@ that affect the execution of \fBfgrep\fR: \fBLC_COLLATE\fR, \fBLC_CTYPE\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt If any matches are found .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt If no matches are found .RE .sp .ne 2 -.mk .na \fB\fB2\fR\fR .ad .RS 5n -.rt For syntax errors or inaccessible files, even if matches were found. .RE @@ -309,13 +273,12 @@ For syntax errors or inaccessible files, even if matches were found. See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled .TE .SH SEE ALSO diff --git a/usr/src/man/man1/file.1 b/usr/src/man/man1/file.1 index 6e445f1bf7..870fc05fe6 100644 --- a/usr/src/man/man1/file.1 +++ b/usr/src/man/man1/file.1 @@ -1,13 +1,13 @@ '\" te .\" Copyright 1989 AT&T Copyright (c) 1992, X/Open Company Limited All Rights Reserved Portions Copyright (c) 2006, Sun Microsystems, Inc. All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 1 "15 May 2006" "SunOS 5.11" "User Commands" +.TH FILE 1 "May 15, 2006" .SH NAME file \- determine file type .SH SYNOPSIS @@ -105,47 +105,39 @@ be determined. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad .RS 12n -.rt Checks the magic file for format errors. For reasons of efficiency, this validation is normally not carried out. .RE .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad .RS 12n -.rt Applies any position-sensitive and context-sensitive default system tests to the file. .RE .sp .ne 2 -.mk .na \fB\fB-f\fR \fIffile\fR\fR .ad .RS 12n -.rt \fIffile\fR contains a list of the files to be examined. .RE .sp .ne 2 -.mk .na \fB\fB-h\fR\fR .ad .RS 12n -.rt When a symbolic link is encountered, this option identifies the file as a symbolic link. If \fB-h\fR is not specified and \fIfile\fR is a symbolic link that refers to a non-existent file, the \fBfile\fR utility identifies the file @@ -154,43 +146,35 @@ as a symbolic link, as if \fB-h\fR had been specified. .sp .ne 2 -.mk .na \fB\fB-i\fR\fR .ad .RS 12n -.rt If a file is a regular file, this option does not attempt to classify the type of file further, but identifies the file as a "regular file". .RE .sp .ne 2 -.mk .na \fB\fB-m\fR \fImfile\fR\fR .ad .RS 12n -.rt .sp .ne 2 -.mk .na \fB\fB/usr/bin/file\fR\fR .ad .RS 22n -.rt Uses \fImfile\fR as an alternate magic file, instead of \fB/etc/magic\fR. .RE .sp .ne 2 -.mk .na \fB\fB/usr/xpg4/bin/file\fR\fR .ad .RS 22n -.rt Specifies the name of a file containing position-sensitive tests that are applied to a file in order to classify it (see \fBmagic\fR(4)). If the \fB-m\fR option is specified without specifying the \fB-d\fR option or the \fB-M\fR @@ -202,12 +186,10 @@ position-sensitive tests specified by the \fB-m\fR option. .sp .ne 2 -.mk .na \fB\fB-M\fR \fIMfile\fR\fR .ad .RS 12n -.rt Specifies the name of a file containing position-sensitive tests that are applied to a file in order to classify it (see \fBmagic\fR(4)). No position-sensitive default system tests nor context-sensitive default system @@ -226,12 +208,10 @@ options is applied in the order specified by the appearance of these options. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIfile\fR\fR .ad .RS 8n -.rt A path name of a file to be tested. .RE @@ -268,35 +248,29 @@ that affect the execution of \fBfile\fR: \fBLANG\fR, \fBLC_ALL\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB/etc/magic\fR\fR .ad .RS 14n -.rt \fBfile\fR's magic number file .RE @@ -308,15 +282,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man1/filebench.1 b/usr/src/man/man1/filebench.1 index 8a9e793729..3d15c9b743 100644 --- a/usr/src/man/man1/filebench.1 +++ b/usr/src/man/man1/filebench.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 filebench 1 "9 Oct 2007" "SunOS 5.11" "User Commands" +.TH FILEBENCH 1 "Oct 9, 2007" .SH NAME filebench \- framework of workloads to measure and compare filesystem performance @@ -32,12 +32,10 @@ http://www.opensolaris.org The following options are supported: .sp .ne 2 -.mk .na \fB\fB-c\fR \fIstats_dir...\fR\fR .ad .RS 19n -.rt Generates a HTML file (\fBindex.html\fR) that is a comparison of the specified directories. \fIstats_dir\fR specifies the directory or directories in which the results are stored. @@ -49,12 +47,10 @@ the results are stored. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIprofile\fR\fR .ad .RS 11n -.rt Specifies the name of the configuration file ending in \fB\&.prof\fR. The configuration file specifies: .RS +4 @@ -89,34 +85,28 @@ the directory path in which to store the results. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt An error occurred. .RE .sp .ne 2 -.mk .na \fB\fB2\fR\fR .ad .RS 5n -.rt Invalid command line options were specified. .RE @@ -171,13 +161,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityUncommitted +Interface Stability Uncommitted .TE .SH SEE ALSO diff --git a/usr/src/man/man1/filesync.1 b/usr/src/man/man1/filesync.1 index 98b034d447..b671a5b557 100644 --- a/usr/src/man/man1/filesync.1 +++ b/usr/src/man/man1/filesync.1 @@ -3,13 +3,13 @@ .\" 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 filesync 1 "6 Nov 2000" "SunOS 5.11" "User Commands" +.TH FILESYNC 1 "Nov 6, 2000" .SH NAME filesync \- synchronize ordinary, directory or special files .SH SYNOPSIS .LP .nf -\fBfilesync\fR [\fB-aehmnqvy\fR] [\fB-o\fR src | dst] +\fBfilesync\fR [\fB-aehmnqvy\fR] [\fB-o\fR src | dst] [\fB-f\fR src | dst | old | new] [\fB-r\fR \fIdirectory\fR]... .fi @@ -203,12 +203,10 @@ baseline files from being copied. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 28n -.rt Force the checking of Access Control Lists (\fBACL\fRs ) and attempt to make them agree for all new and changed files. If it is not possible to set the \fBACL\fR for a particular file, \fBfilesync\fR stops \fBACL\fR synchronization @@ -221,12 +219,10 @@ attempting to do so will result in numerous error messages. .sp .ne 2 -.mk .na \fB\fB-d\fR\fI dest-dir\fR\fR .ad .RS 28n -.rt Specify the directory on the destination system into which \fIfilename\fR is to be copied. Use with the \fB-s\fR\fI source-dir\fR option and the \fIfilename\fR operand. See \fB-s\fR and \fBOPERANDS\fR. @@ -234,12 +230,10 @@ operand. See \fB-s\fR and \fBOPERANDS\fR. .sp .ne 2 -.mk .na \fB\fB-e\fR\fR .ad .RS 28n -.rt Flag all differences. It may not be possible to resolve all conflicts involving modes and ownership (unless \fBfilesync\fR is being run with root privileges). If you cannot change the ownership or protections on a file, \fBfilesync\fR @@ -250,12 +244,10 @@ differences. .sp .ne 2 -.mk .na \fB\fB\fR\fB-f\fR\fB src\fR | \fBdst\fR | \fBold\fR | \fBnew\fR\fR .ad .RS 28n -.rt The \fB-f\fR option tells \fBfilesync\fR how to resolve conflicting changes. If a file has been changed on both systems, and an \fB-f\fR option has been specified, \fBfilesync\fR will retain the changes made on the favored system @@ -274,12 +266,10 @@ if they both specify the same preference (\fBsrc \fRand\fB dst\fR). If .sp .ne 2 -.mk .na \fB\fB-h\fR\fR .ad .RS 28n -.rt Halt on error. Normally, if \fBfilesync\fR encounters a read or write error while copying files, it notes the error and the program continues, in an attempt to reconcile other files. If the \fB-h\fR option is specified, @@ -289,12 +279,10 @@ not try to process any more files. .sp .ne 2 -.mk .na \fB\fB-m\fR\fR .ad .RS 28n -.rt Ensure that both copies of the file have the same modification time. The modification time for newly copied files is set to the time of reconciliation by default. File changes are ordered by increasing modification times so that @@ -313,12 +301,10 @@ time prior to a \fB\&.o\fR file that was built from a prior version of the .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 28n -.rt Do not really make the changes. If the \fB-n\fR option is specified, \fBfilesync\fR determines what changes have been made to files, and what reconciliations are required and displays this information on the standard @@ -334,12 +320,10 @@ description. .sp .ne 2 -.mk .na \fB\fB\fR\fB-o\fR\fB src | dst\fR\fR .ad .RS 28n -.rt The \fB-o\fR option forces a one-way reconciliation, favoring either the source system (\fBsrc\fR) or destination system (\fBdst\fR). .sp @@ -366,12 +350,10 @@ they both specify the same preference (\fBsrc\fR or \fBdst\fR). If \fB-o\fR and .sp .ne 2 -.mk .na \fB\fB-q\fR\fR .ad .RS 28n -.rt Suppress the standard \fBfilesync\fR messages that describe each reconciliation action as it is performed. .sp @@ -382,24 +364,20 @@ form of a UNIX shell command (for example, \fBmv\fR, \fBln\fR, \fBcp\fR, .sp .ne 2 -.mk .na \fB\fB-r\fR\fI directory\fR\fR .ad .RS 28n -.rt Limit the reconciliation to \fIdirectory\fR. Specify multiple directories with multiple \fB-r\fR specifications. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fI source-dir\fR\fR .ad .RS 28n -.rt Specify the directory on the source system from which the \fIfilename\fR to be copied is located. Use with the \fB-d\fR\fI dest-dir\fR option and the \fIfilename\fR operand. See the \fB-d\fR option description and @@ -408,24 +386,20 @@ copied is located. Use with the \fB-d\fR\fI dest-dir\fR option and the .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 28n -.rt Display additional information about each file comparison as it is made on the standard output. .RE .sp .ne 2 -.mk .na \fB\fB-y\fR\fR .ad .RS 28n -.rt Bypass safety check prompts. Nomadic machines occasionally move between domains, and many of the files on which \fBfilesync\fR operates are expected to be accessed by NFS. There is a danger that someday \fBfilesync\fR will be @@ -445,12 +419,10 @@ confirm these prompts. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIfilename\fR\fR .ad .RS 12n -.rt The name of the ordinary file, directory, symbolic link, or special file in the specified source directory (\fIsource-dir\fR) to be synchronized. Specify multiple files by separating each filename by spaces. Use the \fIfilename\fR @@ -511,12 +483,10 @@ switches). .SH ENVIRONMENT VARIABLES .sp .ne 2 -.mk .na \fB\fBFILESYNC\fR\fR .ad .RS 15n -.rt Specifies the default location of the \fBfilesync\fR packing rules and baseline files. The default value for this variable is \fB$HOME\fR. The suffixes \fB\&.packingrules\fR and \fB\&.filesync-base\fR will be appended to form the @@ -525,12 +495,10 @@ names of the packing rules and baseline files. .sp .ne 2 -.mk .na \fB\fBLC_MESSAGES\fR\fR .ad .RS 15n -.rt Determines how diagnostic and informative messages are presented. In the "C" locale, the messages are presented in the default form found in the program itself (in most cases, U.S. English). @@ -545,124 +513,102 @@ However, if either the \fB-n\fR option was specified or any errors occurred, the exit status will be the logical OR of the following: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 7n -.rt No conflicts, all files up to date. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 7n -.rt Some resolvable conflicts. .RE .sp .ne 2 -.mk .na \fB\fB2\fR\fR .ad .RS 7n -.rt Some conflicts requiring manual resolution. .RE .sp .ne 2 -.mk .na \fB\fB4\fR\fR .ad .RS 7n -.rt Some specified files did not exist. .RE .sp .ne 2 -.mk .na \fB\fB8\fR\fR .ad .RS 7n -.rt Insufficient permission for some files. .RE .sp .ne 2 -.mk .na \fB\fB16\fR\fR .ad .RS 7n -.rt Errors accessing packing rules or baseline file. .RE .sp .ne 2 -.mk .na \fB\fB32\fR\fR .ad .RS 7n -.rt Invalid arguments. .RE .sp .ne 2 -.mk .na \fB\fB64\fR\fR .ad .RS 7n -.rt Unable to access either or both of the specified \fBsrc\fR or \fBdst\fR directories. .RE .sp .ne 2 -.mk .na \fB\fB128\fR\fR .ad .RS 7n -.rt Miscellaneous other failures. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB$HOME/.packingrules\fR\fR .ad .RS 24n -.rt list of files to be kept synchronized .RE .sp .ne 2 -.mk .na \fB\fB$HOME/.filesync-base\fR\fR .ad .RS 24n -.rt baseline summary file .RE diff --git a/usr/src/man/man1/find.1 b/usr/src/man/man1/find.1 index 29185df519..ef993a3bbd 100644 --- a/usr/src/man/man1/find.1 +++ b/usr/src/man/man1/find.1 @@ -6,7 +6,7 @@ .\" .\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for .\" permission to reproduce portions of its copyrighted documentation. -.\" Original documentation from The Open Group can be obtained online at +.\" Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, .\" have given us permission to reprint portions of their documentation. @@ -33,7 +33,7 @@ .\" 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 find 1 "5 Sep 2011" "SunOS 5.11" "User Commands" +.TH FIND 1 "Sep 5, 2011" .SH NAME find \- find files .SH SYNOPSIS @@ -68,24 +68,20 @@ directory that is an ancestor of the last file encountered. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-E\fR\fR .ad .RS 6n -.rt Interpret regular expressions followed by \fB-regex\fR and \fB-iregex\fR primaries as extended regular expressions. .RE .sp .ne 2 -.mk .na \fB\fB-H\fR\fR .ad .RS 6n -.rt Causes the file information and file type evaluated for each symbolic link encountered on the command line to be those of the file referenced by the link, and not the link itself. If the referenced file does not exist, the file @@ -95,12 +91,10 @@ links not on the command line is that of the link itself. .sp .ne 2 -.mk .na \fB\fB-L\fR\fR .ad .RS 6n -.rt Causes the file information and file type evaluated for each symbolic link to be those of the file referenced by the link, and not the link itself. See \fBNOTES\fR. @@ -117,23 +111,19 @@ behavior of the utility. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIpath\fR\fR .ad .RS 14n -.rt A pathname of a starting point in the directory hierarchy. .RE .sp .ne 2 -.mk .na \fB\fIexpression\fR\fR .ad .RS 14n -.rt The first argument that starts with a \fB\(mi\fR, or is a \fB!\fR or a \fB(\fR, and all subsequent arguments are interpreted as an \fIexpression\fR made up of the following primaries and operators. In the descriptions, wherever \fIn\fR is @@ -141,34 +131,28 @@ used as a primary argument, it is interpreted as a decimal integer optionally preceded by a plus (\fB+\fR) or minus (\fB\(mi\fR) sign, as follows: .sp .ne 2 -.mk .na \fB+\fIn\fR\fR .ad .RS 6n -.rt more than \fIn\fR .RE .sp .ne 2 -.mk .na \fB\fIn\fR\fR .ad .RS 6n -.rt exactly \fIn\fR .RE .sp .ne 2 -.mk .na \fB-\fIn\fR\fR .ad .RS 6n -.rt less than \fIn\fR .RE @@ -180,80 +164,66 @@ less than \fIn\fR Valid expressions are: .sp .ne 2 -.mk .na \fB\fB-acl\fR\fR .ad .RS 17n -.rt True if the file have additional ACLs defined. .RE .sp .ne 2 -.mk .na \fB\fB-amin\fR \fIn\fR\fR .ad .RS 17n -.rt File was last accessed \fIn\fR minutes ago. .RE .sp .ne 2 -.mk .na \fB\fB-atime\fR \fIn\fR\fR .ad .RS 17n -.rt True if the file was accessed \fIn\fR days ago. The access time of directories in \fIpath\fR is changed by \fBfind\fR itself. .RE .sp .ne 2 -.mk .na \fB\fB-cmin\fR \fIn\fR\fR .ad .RS 17n -.rt File's status was last changed \fIn\fR minutes ago. .RE .sp .ne 2 -.mk .na \fB\fB-cpio\fR \fIdevice\fR\fR .ad .RS 17n -.rt Always true. Writes the current file on \fIdevice\fR in \fBcpio\fR format (5120-byte records). .RE .sp .ne 2 -.mk .na \fB\fB-ctime\fR \fIn\fR\fR .ad .RS 17n -.rt True if the file's status was changed \fIn\fR days ago. .RE .sp .ne 2 -.mk .na \fB\fB-depth\fR\fR .ad .RS 17n -.rt Always true. Causes descent of the directory hierarchy to be done so that all entries in a directory are acted on before the directory itself. This can be useful when \fBfind\fR is used with \fBcpio\fR(1) to transfer files that are @@ -262,12 +232,10 @@ contained in directories without write permission. .sp .ne 2 -.mk .na \fB\fB-exec\fR \fIcommand\fR\fR .ad .RS 17n -.rt True if the executed command returns a zero value as exit status. The end of command must be punctuated by an escaped semicolon (\fB;\fR). A command argument \fB{}\fR is replaced by the current pathname. If the last argument to @@ -279,12 +247,10 @@ status, find returns a non-zero exit status. .sp .ne 2 -.mk .na \fB\fB-follow\fR\fR .ad .RS 17n -.rt Always true and always evaluated no matter where it appears in \fIexpression\fR. The behavior is unspecified if \fB-follow\fR is used when the \fBfind\fR command is invoked with either the \fB-H\fR or the \fB-L\fR option. @@ -297,35 +263,29 @@ This expression should not be used with the find-type \fBl\fR expression. See .sp .ne 2 -.mk .na \fB\fB-fstype\fR \fItype\fR\fR .ad .RS 17n -.rt True if the filesystem to which the file belongs is of type \fItype\fR. .RE .sp .ne 2 -.mk .na \fB\fB-group\fR \fIgname\fR\fR .ad .RS 17n -.rt True if the file belongs to the group \fIgname\fR. If \fIgname\fR is numeric and there's no such group name, it is taken as a group \fBID\fR. .RE .sp .ne 2 -.mk .na \fB\fB-groupacl\fR \fIgname\fR\fR .ad .RS 17n -.rt True if the file's ACL contains an entry for the group \fIgname\fR. If \fIgname\fR is numeric and there's no such group name, it is taken as a group \fBID\fR. @@ -333,56 +293,46 @@ as a group \fBID\fR. .sp .ne 2 -.mk .na \fB\fB-iname\fR \fIpattern\fR\fR .ad .RS 17n -.rt Like \fB-name\fR, but the match is case insensitive. .RE .sp .ne 2 -.mk .na \fB\fB-inum\fR \fIn\fR\fR .ad .RS 17n -.rt True if the file has inode number \fIn\fR. .RE .sp .ne 2 -.mk .na \fB\fB-iregex\fR \fIpattern\fR\fR .ad .RS 17n -.rt Like \fB-regex\fR, but the match is case insensitive. .RE .sp .ne 2 -.mk .na \fB\fB-links\fR \fIn\fR\fR .ad .RS 17n -.rt True if the file has \fIn\fR links. .RE .sp .ne 2 -.mk .na \fB\fB-local\fR\fR .ad .RS 17n -.rt True if the file system type is not a remote file system type as defined in the \fB/etc/dfs/fstypes\fR file. \fBnfs\fR is used as the default remote filesystem type if the \fB/etc/dfs/fstypes\fR file is not present. The \fB-local\fR option @@ -392,12 +342,10 @@ example of how to search for local files without descending. .sp .ne 2 -.mk .na \fB\fB-ls\fR\fR .ad .RS 17n -.rt Always true. Prints current pathname together with its associated statistics. These include (respectively): .RS +4 @@ -460,12 +408,10 @@ Formatting is done internally, without executing the \fBls\fR program. .sp .ne 2 -.mk .na \fB\fB-maxdepth\fR \fIn\fR\fR .ad .RS 17n -.rt Always true; descend at most \fIn\fR directory levels below the command line arguments. If any \fB-maxdepth\fR primary is specified, it applies to the entire expression even if it would not normally be @@ -475,12 +421,10 @@ the command line arguments. .sp .ne 2 -.mk .na \fB\fB-mindepth\fR \fIn\fR\fR .ad .RS 17n -.rt Always true; do not apply any tests or actions at levels less than \fIn\fR. If any \fB-mindepth\fR primary is specified, it applies to the entire expression even if it would not normally be evaluated. @@ -489,46 +433,38 @@ entire expression even if it would not normally be evaluated. .sp .ne 2 -.mk .na \fB\fB-mmin\fR \fIn\fR\fR .ad .RS 17n -.rt File's data was last modified \fIn\fR minutes ago. .RE .sp .ne 2 -.mk .na \fB\fB-mount\fR\fR .ad .RS 17n -.rt Always true. Restricts the search to the file system containing the directory specified. Does not list mount points to other file systems. .RE .sp .ne 2 -.mk .na \fB\fB-mtime\fR \fIn\fR\fR .ad .RS 17n -.rt True if the file's data was modified \fIn\fR days ago. .RE .sp .ne 2 -.mk .na \fB\fB-name\fR \fIpattern\fR\fR .ad .RS 17n -.rt True if \fIpattern\fR matches the basename of the current file name. Normal shell file name generation characters (see \fBsh\fR(1)) can be used. A backslash (\fB\|\e\|\fR) is used as an escape character within the pattern. The @@ -543,104 +479,86 @@ names beginning with '\fB\&.\fR'. .sp .ne 2 -.mk .na \fB\fB-ncpio\fR \fIdevice\fR\fR .ad .RS 17n -.rt Always true. Writes the current file on \fIdevice\fR in \fBcpio\fR \fB-c\fR format (5120 byte records). .RE .sp .ne 2 -.mk .na \fB\fB-newer\fR \fIfile\fR\fR .ad .RS 17n -.rt True if the current file has been modified more recently than the argument \fIfile\fR. .RE .sp .ne 2 -.mk .na \fB\fB-nogroup\fR\fR .ad .RS 17n -.rt True if the file belongs to non-existing group. .RE .sp .ne 2 -.mk .na \fB\fB-nouser\fR\fR .ad .RS 17n -.rt True if the file belongs to non-existing user. .RE .sp .ne 2 -.mk .na \fB\fB-ok\fR \fIcommand\fR\fR .ad .RS 17n -.rt Like \fB-exec\fR, except that the generated command line is printed with a question mark first, and is executed only if the response is affirmative. .RE .sp .ne 2 -.mk .na \fB\fB-perm\fR [\fB-\fR]\fImode\fR\fR .ad .RS 17n -.rt The \fImode\fR argument is used to represent file mode bits. It is identical in format to the symbolic mode operand, \fIsymbolic_mode_list\fR, described in \fBchmod\fR(1), and is interpreted as follows. To start, a template is assumed with all file mode bits cleared. An \fIop\fR symbol of: .sp .ne 2 -.mk .na \fB\fB+\fR\fR .ad .RS 8n -.rt Set the appropriate mode bits in the template .RE .sp .ne 2 -.mk .na \fB\fB\(mi\fR\fR .ad .RS 8n -.rt Clear the appropriate bits .RE .sp .ne 2 -.mk .na \fB\fB=\fR\fR .ad .RS 8n -.rt Set the appropriate mode bits, without regard to the contents of the file mode creation mask of the process .RE @@ -660,12 +578,10 @@ permission bits. .sp .ne 2 -.mk .na \fB\fB-perm\fR [\fB-\fR]\fIonum\fR\fR .ad .RS 17n -.rt True if the file permission flags exactly match the octal number \fIonum\fR (see \fBchmod\fR(1)). If \fIonum\fR is prefixed by a minus sign (\fB\(mi\fR), only the bits that are set in \fIonum\fR are compared with the file permission @@ -674,35 +590,29 @@ flags, and the expression evaluates true if they match. .sp .ne 2 -.mk .na \fB\fB-print\fR\fR .ad .RS 17n -.rt Always true. Causes the current pathname to be printed. .RE .sp .ne 2 -.mk .na \fB\fB-print0\fR\fR .ad .RS 17n -.rt Always true. Causes the current pathname to be printed, terminated by an ASCII NUL character (character code 0) instead of a newline. .RE .sp .ne 2 -.mk .na \fB\fB-prune\fR\fR .ad .RS 17n -.rt Always yields true. Does not examine any directories or files in the directory structure below the \fIpattern\fR just matched. (See EXAMPLES). If \fB-depth\fR is specified, \fB-prune\fR has no effect. @@ -710,36 +620,30 @@ is specified, \fB-prune\fR has no effect. .sp .ne 2 -.mk .na \fB\fB-regex\fR \fIpattern\fR\fB .ad .RS 17n -.rt True if the full path of the file matches \fIpattern\fR using regular expressions. .RE .sp .ne 2 -.mk .na \fB\fB-size\fR \fIn\fR[\fBc\fR]\fR .ad .RS 17n -.rt True if the file is \fIn\fR blocks long (512 bytes per block). If \fIn\fR is followed by a \fBc\fR, the size is in bytes. .RE .sp .ne 2 -.mk .na \fB\fB-type\fR \fIc\fR\fR .ad .RS 17n -.rt True if the type of the file is \fIc\fR, where \fIc\fR is \fBb\fR, \fBc\fR, \fBd\fR, \fBD\fR, \fBf\fR, \fBl\fR, \fBp\fR, or \fBs\fR for block special file, character special file, directory, door, plain file, symbolic link, fifo (named @@ -748,24 +652,20 @@ pipe), or socket, respectively. .sp .ne 2 -.mk .na \fB\fB-user\fR \fIuname\fR\fR .ad .RS 17n -.rt True if the file belongs to the user \fIuname\fR. If \fIuname\fR is numeric and there's no such user name, it is taken as a user \fBID\fR. .RE .sp .ne 2 -.mk .na \fB\fB-useracl\fR \fIuname\fR\fR .ad .RS 17n -.rt True if the file's ACL contains an entry for the user \fIuname\fR. If \fIuname\fR is numeric and there's no such user name, it is taken as a user \fBID\fR. @@ -773,23 +673,19 @@ taken as a user \fBID\fR. .sp .ne 2 -.mk .na \fB\fB-xdev\fR\fR .ad .RS 17n -.rt Same as the \fB-mount\fR primary. .RE .sp .ne 2 -.mk .na \fB\fB-xattr\fR\fR .ad .RS 17n -.rt True if the file has extended attributes. .RE @@ -800,7 +696,6 @@ The primaries can be combined using the following operators (in order of decreasing precedence): .sp .ne 2 -.mk .na \fB1)\fB(\fR\fIexpression\fR\fB)\fR\fR .ad @@ -812,7 +707,6 @@ shell and must be escaped). .sp .ne 2 -.mk .na \fB2)\fB!\fR\fIexpression\fR\fR .ad @@ -823,7 +717,6 @@ The negation of a primary (\fB!\fR is the unary \fInot\fR operator). .sp .ne 2 -.mk .na \fB3) \fIexpression\fR\fB[\fR\fB-a\fR\fB]\fR \fIexpression\fR\fR .ad @@ -835,7 +728,6 @@ juxtaposition of two primaries). .sp .ne 2 -.mk .na \fB4) \fIexpression\fR\fB\fR\fB-o\fR\fIexpression\fR\fR .ad @@ -900,7 +792,7 @@ or \fB*.o\fR that have not been accessed for a week: .in +2 .nf example% \fBfind $HOME \e( -name a.out -o -name '*.o' \e) \e - -atime +7 -exec rm {} \e;\fR + -atime +7 -exec rm {} \e;\fR .fi .in -2 .sp @@ -1047,12 +939,10 @@ that affect the execution of \fBfind\fR: \fBLANG\fR, \fBLC_ALL\fR, \fBLC_COLLATE\fR, \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and \fBNLSPATH\fR. .sp .ne 2 -.mk .na \fB\fBPATH\fR\fR .ad .RS 8n -.rt Determine the location of the \fIutility_name\fR for the \fB-exec\fR and \fB-ok\fR primaries. .RE @@ -1073,57 +963,47 @@ expression defined for the \fByesexpr\fR. See \fBlocale\fR(5). The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt All \fIpath\fR operands were traversed successfully. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB/etc/passwd\fR\fR .ad .RS 20n -.rt Password file .RE .sp .ne 2 -.mk .na \fB\fB/etc/group\fR\fR .ad .RS 20n -.rt Group file .RE .sp .ne 2 -.mk .na \fB\fB/etc/dfs/fstypes\fR\fR .ad .RS 20n -.rt File that registers distributed file system packages .RE @@ -1135,17 +1015,16 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityCommitted +Interface Stability Committed _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .SH SEE ALSO @@ -1162,24 +1041,20 @@ The following options are obsolete and will not be supported in future releases: .sp .ne 2 -.mk .na \fB\fB-cpio\fR \fIdevice\fR\fR .ad .RS 17n -.rt Always true. Writes the current file on \fIdevice\fR in \fBcpio\fR format (5120-byte records). .RE .sp .ne 2 -.mk .na \fB\fB-ncpio\fR \fIdevice\fR\fR .ad .RS 17n -.rt Always true. Writes the current file on \fIdevice\fR in \fBcpio\fR \fB-c\fR format (5120-byte records). .RE diff --git a/usr/src/man/man1/finger.1 b/usr/src/man/man1/finger.1 index 9af0320f24..44830a0d89 100644 --- a/usr/src/man/man1/finger.1 +++ b/usr/src/man/man1/finger.1 @@ -2,7 +2,7 @@ .\" Copyright 1989 AT&T .\" 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) 2000, Sun Microsystems, Inc. All Rights Reserved. -.TH finger 1 "6 Nov 2000" "SunOS 5.11" "User Commands" +.TH FINGER 1 "Nov 6, 2000" .SH NAME finger \- display information about local and remote users .SH SYNOPSIS @@ -13,7 +13,7 @@ finger \- display information about local and remote users .LP .nf -\fBfinger\fR [\fB-l\fR] +\fBfinger\fR [\fB-l\fR] [\fIusername@hostname\fR 1 [\fI@hostname\fR 2 \fI\&..\fR \fI\&.@hostname\fR n]...] .fi @@ -141,182 +141,150 @@ The following options are supported, except that the \fIusername@hostname\fR form supports only the \fB-l\fR option: .sp .ne 2 -.mk .na \fB\fB-b\fR \fR .ad .RS 7n -.rt Suppresses printing the user's home directory and shell in a long format printout. .RE .sp .ne 2 -.mk .na \fB\fB-f\fR \fR .ad .RS 7n -.rt Suppresses printing the header that is normally printed in a non-long format printout. .RE .sp .ne 2 -.mk .na \fB\fB-h\fR \fR .ad .RS 7n -.rt Suppresses printing of the \fB\&.project\fR file in a long format printout. .RE .sp .ne 2 -.mk .na \fB\fB-i\fR \fR .ad .RS 7n -.rt Forces "idle" output format, which is similar to short format except that only the login name, terminal, login time, and idle time are printed. .RE .sp .ne 2 -.mk .na \fB\fB-l\fR \fR .ad .RS 7n -.rt Forces long output format. .RE .sp .ne 2 -.mk .na \fB\fB-m\fR \fR .ad .RS 7n -.rt Matches arguments only on user name (not first or last name). .RE .sp .ne 2 -.mk .na \fB\fB-p\fR \fR .ad .RS 7n -.rt Suppresses printing of the \fB\&.plan\fR file in a long format printout. .RE .sp .ne 2 -.mk .na \fB\fB-q\fR \fR .ad .RS 7n -.rt Forces quick output format, which is similar to short format except that only the login name, terminal, and login time are printed. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR \fR .ad .RS 7n -.rt Forces short output format. .RE .sp .ne 2 -.mk .na \fB\fB-w\fR \fR .ad .RS 7n -.rt Suppresses printing the full name in a short format printout. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB$HOME/.plan \fR \fR .ad .RS 24n -.rt user's plan .RE .sp .ne 2 -.mk .na \fB\fB$HOME/.project\fR \fR .ad .RS 24n -.rt user's projects .RE .sp .ne 2 -.mk .na \fB\fB/etc/default/finger\fR \fR .ad .RS 24n -.rt \fBfinger\fR options file .RE .sp .ne 2 -.mk .na \fB\fB/etc/passwd\fR\fR .ad .RS 24n -.rt password file .RE .sp .ne 2 -.mk .na \fB\fB/var/adm/lastlog\fR \fR .ad .RS 24n -.rt time of last login .RE .sp .ne 2 -.mk .na \fB\fB/var/adm/utmpx\fR \fR .ad .RS 24n -.rt accounting .RE diff --git a/usr/src/man/man1/fmt.1 b/usr/src/man/man1/fmt.1 index 824b8cfe96..1cd01eebf4 100644 --- a/usr/src/man/man1/fmt.1 +++ b/usr/src/man/man1/fmt.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 fmt 1 "9 May 1997" "SunOS 5.11" "User Commands" +.TH FMT 1 "May 9, 1997" .SH NAME fmt \- simple text formatters .SH SYNOPSIS @@ -44,12 +44,10 @@ reformats the text between the cursor location and the end of the paragraph. .SH OPTIONS .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad .RS 21n -.rt Crown margin mode. Preserve the indentation of the first two lines within a paragraph, and align the left margin of each subsequent line with that of the second line. This is useful for tagged paragraphs. @@ -57,12 +55,10 @@ second line. This is useful for tagged paragraphs. .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 21n -.rt Split lines only. Do not join short lines to form longer ones. This prevents sample lines of code, and other such formatted text, from being unduly combined. @@ -70,24 +66,20 @@ combined. .sp .ne 2 -.mk .na \fB\fB-w\fR\fI width\fR | \fB-\fR\fIwidth\fR\fR .ad .RS 21n -.rt Fill output lines to up to \fIwidth\fR columns. .RE .SH OPERANDS .sp .ne 2 -.mk .na \fB\fIinputfile\fR\fR .ad .RS 13n -.rt Input file. .RE diff --git a/usr/src/man/man1/fmtmsg.1 b/usr/src/man/man1/fmtmsg.1 index 119c293e1e..4dc5a9f1a7 100644 --- a/usr/src/man/man1/fmtmsg.1 +++ b/usr/src/man/man1/fmtmsg.1 @@ -4,13 +4,13 @@ .\" 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 fmtmsg 1 "20 Jul 1994" "SunOS 5.11" "User Commands" +.TH FMTMSG 1 "Jul 20, 1994" .SH NAME fmtmsg \- display a message on stderr or system console .SH SYNOPSIS .LP .nf -\fBfmtmsg\fR [\fB-c\fR \fIclass\fR] [\fB-u\fR \fIsubclass\fR] [\fB-l\fR \fIlabel\fR] [\fB-s\fR \fIseverity\fR] +\fBfmtmsg\fR [\fB-c\fR \fIclass\fR] [\fB-u\fR \fIsubclass\fR] [\fB-l\fR \fIlabel\fR] [\fB-s\fR \fIseverity\fR] [\fB-t\fR \fItag\fR] [\fB-a\fR \fIaction\fR] \fItext\fR .fi @@ -33,43 +33,35 @@ display of the formatted message. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-c\fR \fIclass\fR \fR .ad .RS 16n -.rt Describes the source of the message. Valid keywords are: .sp .ne 2 -.mk .na \fB\fBhard\fR \fR .ad .RS 9n -.rt The source of the condition is hardware. .RE .sp .ne 2 -.mk .na \fB\fBsoft\fR \fR .ad .RS 9n -.rt The source of the condition is software. .RE .sp .ne 2 -.mk .na \fB\fBfirm\fR \fR .ad .RS 9n -.rt The source of the condition is firmware. .RE @@ -77,93 +69,77 @@ The source of the condition is firmware. .sp .ne 2 -.mk .na \fB\fB-u\fR \fIsubclass\fR \fR .ad .RS 16n -.rt A list of keywords (separated by commas) that further defines the message and directs the display of the message. Valid keywords are: .sp .ne 2 -.mk .na \fB\fBappl\fR \fR .ad .RS 12n -.rt The condition originated in an application. This keyword should not be used in combination with either \fButil\fR or \fBopsys\fR. .RE .sp .ne 2 -.mk .na \fB\fButil\fR \fR .ad .RS 12n -.rt The condition originated in a utility. This keyword should not be used in combination with either \fBappl\fR or \fBopsys\fR. .RE .sp .ne 2 -.mk .na \fB\fBopsys\fR \fR .ad .RS 12n -.rt The message originated in the kernel. This keyword should not be used in combination with either \fBappl\fR or \fButil\fR. .RE .sp .ne 2 -.mk .na \fB\fBrecov\fR \fR .ad .RS 12n -.rt The application will recover from the condition. This keyword should not be used in combination with \fBnrecov\fR. .RE .sp .ne 2 -.mk .na \fB\fBnrecov\fR \fR .ad .RS 12n -.rt The application will not recover from the condition. This keyword should not be used in combination with \fBrecov\fR. .RE .sp .ne 2 -.mk .na \fB\fBprint\fR \fR .ad .RS 12n -.rt Print the message to the standard error stream \fBstderr\fR. .RE .sp .ne 2 -.mk .na \fB\fBconsole\fR \fR .ad .RS 12n -.rt Write the message to the system console. \fBprint\fR, \fBconsole\fR, or both may be used. .RE @@ -172,67 +148,55 @@ may be used. .sp .ne 2 -.mk .na \fB\fB-l\fR \fIlabel\fR \fR .ad .RS 16n -.rt Identifies the source of the message. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR \fIseverity\fR \fR .ad .RS 16n -.rt Indicates the seriousness of the error. The keywords and definitions of the standard levels of \fIseverity\fR are: .sp .ne 2 -.mk .na \fB\fBhalt\fR \fR .ad .RS 9n -.rt The application has encountered a severe fault and is halting. .RE .sp .ne 2 -.mk .na \fB\fBerror\fR\fR .ad .RS 9n -.rt The application has detected a fault. .RE .sp .ne 2 -.mk .na \fB\fBwarn\fR\fR .ad .RS 9n -.rt The application has detected a condition that is out of the ordinary and might be a problem. .RE .sp .ne 2 -.mk .na \fB\fBinfo\fR \fR .ad .RS 9n -.rt The application is providing information about a condition that is not in error. .RE @@ -241,23 +205,19 @@ error. .sp .ne 2 -.mk .na \fB\fB-t\fR \fItag\fR \fR .ad .RS 16n -.rt The string containing an identifier for the message. .RE .sp .ne 2 -.mk .na \fB\fB-a\fR \fIaction\fR \fR .ad .RS 16n -.rt A text string describing the first step in the error recovery process. This string must be written so that the entire \fIaction\fR argument is interpreted as a single argument. \fBfmtmsg\fR precedes each action string with the \fBTO @@ -266,12 +226,10 @@ FIX:\fR prefix. .sp .ne 2 -.mk .na \fB\fItext\fR \fR .ad .RS 16n -.rt A text string describing the condition. Must be written so that the entire \fItext\fR argument is interpreted as a single argument. .RE @@ -300,7 +258,7 @@ produces: .sp .in +2 .nf -UX:cat: ERROR: invalid syntax +UX:cat: ERROR: invalid syntax TO FIX: refer to manual UX:cat:138 .fi .in -2 @@ -327,7 +285,7 @@ and Example 1 is used, \fBfmtmsg\fR produces: .sp .in +2 .nf -ERROR: invalid syntax +ERROR: invalid syntax TO FIX: refer to manual .fi .in -2 @@ -423,56 +381,46 @@ for use by \fBfmtmsg\fR. The standard severity levels shown below cannot be modified. Additional severity levels can be defined, redefined, and removed. .sp .ne 2 -.mk .na \fB\fB0\fR \fR .ad .RS 6n -.rt (no severity is used) .RE .sp .ne 2 -.mk .na \fB\fB1\fR \fR .ad .RS 6n -.rt \fBHALT\fR .RE .sp .ne 2 -.mk .na \fB\fB2\fR \fR .ad .RS 6n -.rt \fBERROR\fR .RE .sp .ne 2 -.mk .na \fB\fB3\fR \fR .ad .RS 6n -.rt \fBWARNING\fR .RE .sp .ne 2 -.mk .na \fB\fB4\fR \fR .ad .RS 6n -.rt \fBINFO\fR .RE @@ -521,59 +469,49 @@ that \fIdescription\fR in the colon separated list is ignored. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR \fR .ad .RS 7n -.rt All the requested functions were executed successfully. .RE .sp .ne 2 -.mk .na \fB\fB1\fR \fR .ad .RS 7n -.rt The command contains a syntax error, an invalid option, or an invalid argument to an option. .RE .sp .ne 2 -.mk .na \fB\fB2\fR \fR .ad .RS 7n -.rt The function executed with partial success, however the message was not displayed on \fBstderr\fR. .RE .sp .ne 2 -.mk .na \fB\fB4\fR \fR .ad .RS 7n -.rt The function executed with partial success; however, the message was not displayed on the system console. .RE .sp .ne 2 -.mk .na \fB\fB32\fR \fR .ad .RS 7n -.rt No requested functions were executed successfully. .RE diff --git a/usr/src/man/man1/fold.1 b/usr/src/man/man1/fold.1 index 78ee6b5654..6b5301b895 100644 --- a/usr/src/man/man1/fold.1 +++ b/usr/src/man/man1/fold.1 @@ -1,13 +1,13 @@ '\" te .\" Copyright 1989 AT&T Copyright (c) 1995, Sun Microsystems, Inc. All Rights Reserved Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 fold 1 "1 Feb 1995" "SunOS 5.11" "User Commands" +.TH FOLD 1 "Feb 1, 1995" .SH NAME fold \- filter for folding lines .SH SYNOPSIS @@ -34,12 +34,10 @@ input, and the \fB-b\fR option is not specified, they will be treated specially: .sp .ne 2 -.mk .na \fBBACKSPACE \fR .ad .RS 20n -.rt The current count of line width will be decremented by one, although the count never will become negative. \fBfold\fR will not insert a NEWLINE character immediately before or after any BACKSPACE character. @@ -47,12 +45,10 @@ immediately before or after any BACKSPACE character. .sp .ne 2 -.mk .na \fBCARRIAGE-RETURN \fR .ad .RS 20n -.rt The current count of line width will be set to \fB0\fR. \fBfold\fR will not insert a NEWLINE character immediately before or after any CARRIAGE-RETURN character. @@ -60,12 +56,10 @@ character. .sp .ne 2 -.mk .na \fBTAB \fR .ad .RS 20n -.rt Each TAB character encountered will advance the column position pointer to the next tab stop. Tab stops will be at each column position \fIn\fR such that \fIn\fR modulo 8 equals 1. @@ -77,23 +71,19 @@ next tab stop. Tab stops will be at each column position \fIn\fR such that The following options are supported: .sp .ne 2 -.mk .na \fB\fB-b\fR \fR .ad .RS 20n -.rt Counts \fIwidth\fR in bytes rather than column positions. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR \fR .ad .RS 20n -.rt If a segment of a line contains a blank character within the first \fIwidth\fR column positions (or bytes), breaks the line after the last such blank character meeting the width constraints. If there is no blank character meeting @@ -103,12 +93,10 @@ segment of the input line. .sp .ne 2 -.mk .na \fB\fB-w\fR \fIwidth\fR\fB|\fR\fB-\fR\fIwidth\fR \fR .ad .RS 20n -.rt Specifies the maximum line length, in column positions (or bytes if \fB-b\fR is specified). If \fIwidth\fR is not a positive decimal number, an error is returned. The default value is 80. @@ -120,12 +108,10 @@ returned. The default value is 80. The following operand is supported: .sp .ne 2 -.mk .na \fB\fB\fIfile\fR\fR \fR .ad .RS 9n -.rt A path name of a text file to be folded. If no \fIfile\fR operands are specified, the standard input will be used. .RE @@ -159,23 +145,19 @@ that affect the execution of \fBfold\fR: \fBLANG\fR, \fBLC_ALL\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR \fR .ad .RS 7n -.rt All input files were processed successfully. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR \fR .ad .RS 7n -.rt An error occurred. .RE @@ -187,15 +169,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIenabled +CSI enabled _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man1/ftp.1 b/usr/src/man/man1/ftp.1 index 519a4b2bfd..0fe300d072 100644 --- a/usr/src/man/man1/ftp.1 +++ b/usr/src/man/man1/ftp.1 @@ -4,13 +4,13 @@ .\" 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 ftp 1 "6 Jun 2006" "SunOS 5.11" "User Commands" +.TH FTP 1 "Jun 6, 2006" .SH NAME ftp \- file transfer program .SH SYNOPSIS .LP .nf -\fBftp\fR [\fB-adfginpstvx\fR] [\fB-m\fR \fIGSS Mech\fR] [\fB-T\fR \fItimeout\fR] +\fBftp\fR [\fB-adfginpstvx\fR] [\fB-m\fR \fIGSS Mech\fR] [\fB-T\fR \fItimeout\fR] [\fIhostname\fR [\fIport\fR]] .fi @@ -35,68 +35,56 @@ The following options can be specified at the command line, or to the command interpreter: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 14n -.rt Uses \fBGSSAPI\fR authentication \fBonly\fR. If the authentication fails, this option closes the connection. .RE .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad .RS 14n -.rt Enables debugging. .RE .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 14n -.rt Forwards local security credentials to the remote server. .RE .sp .ne 2 -.mk .na \fB\fB-g\fR\fR .ad .RS 14n -.rt Disables filename "globbing". .RE .sp .ne 2 -.mk .na \fB\fB-i\fR\fR .ad .RS 14n -.rt Turns off interactive prompting during multiple file transfers. .RE .sp .ne 2 -.mk .na \fB\fB-m\fR\fR .ad .RS 14n -.rt Specifies the \fBGSS\fR-\fBAPI\fR mechanism to use. The default is to use the kerberos_v5 mechanism. Supported alternatives are defined in \fB/etc/gss/mech\fR (see \fBmech\fR(4)). @@ -104,12 +92,10 @@ kerberos_v5 mechanism. Supported alternatives are defined in .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 14n -.rt Does not attempt "auto-login" upon initial connection. If auto-login is not disabled, \fBftp\fR checks the \fB\&.netrc\fR file in the user's home directory for an entry describing an account on the remote machine. If no entry exists, @@ -120,24 +106,20 @@ a password and an account with which to login. .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 14n -.rt Enables passive mode for data transfers. This command is useful when connecting to a remote host from behind a connection filtering firewall. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 14n -.rt Skips the \fBSYST\fR command that is sent by default to all remote servers upon connection. The system command is what enables the automatic use of binary mode rather than the protocol default ascii mode. @@ -148,23 +130,19 @@ provided to allow inter-operability with these servers. .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad .RS 14n -.rt Enables packet tracing (unimplemented). .RE .sp .ne 2 -.mk .na \fB\fB-T\fR \fItimeout\fR\fR .ad .RS 14n -.rt Enables global connection timer, specified in seconds (decimal). There is a timer for the control connection that is reset when anything is sent to the server and disabled while the client is prompting for user input. Another @@ -173,12 +151,10 @@ independent timer is used to monitor incoming or outgoing data connections. .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 14n -.rt Shows all responses from the remote server, as well as report on data transfer statistics. This is turned on by default if \fBftp\fR is running interactively with its input coming from the user's terminal. @@ -186,12 +162,10 @@ with its input coming from the user's terminal. .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad .RS 14n -.rt Attempts to use \fBGSSAPI\fR for authentication and encryption. Data and Command channel protection is set to "\fBprivate\fR". .RE @@ -201,7 +175,6 @@ Command channel protection is set to "\fBprivate\fR". The following commands can be specified to the command interpreter: .sp .ne 2 -.mk .na \fB\fB!\fR\fR .ad @@ -213,7 +186,6 @@ If no \fIcommand\fR is given, invokes an interactive shell. .sp .ne 2 -.mk .na \fB\fB$\fR \fImacro-name\fR [ \fIargs\fR ]\fR .ad @@ -225,7 +197,6 @@ command. Arguments are passed to the macro unglobbed. .sp .ne 2 -.mk .na \fB\fBaccount\fR [ \fIpasswd\fR ]\fR .ad @@ -239,7 +210,6 @@ mode. .sp .ne 2 -.mk .na \fB\fBappend\fR \fIlocal-file\fR [ \fIremote-file\fR ]\fR .ad @@ -253,7 +223,6 @@ for "representation type", "file structure", and "transfer mode". .sp .ne 2 -.mk .na \fB\fBascii\fR\fR .ad @@ -265,7 +234,6 @@ type. .sp .ne 2 -.mk .na \fB\fBbell\fR\fR .ad @@ -276,7 +244,6 @@ Sounds a bell after each file transfer command is completed. .sp .ne 2 -.mk .na \fB\fBbinary\fR\fR .ad @@ -287,7 +254,6 @@ Sets the "representation type" to "image". .sp .ne 2 -.mk .na \fB\fBbye\fR\fR .ad @@ -299,7 +265,6 @@ Terminates the \fBFTP\fR session with the remote server and exit \fBftp\fR. An .sp .ne 2 -.mk .na \fB\fBcase\fR\fR .ad @@ -313,7 +278,6 @@ lower case. .sp .ne 2 -.mk .na \fB\fBcd\fR \fIremote-directory\fR\fR .ad @@ -324,7 +288,6 @@ Changes the working directory on the remote machine to \fIremote-directory\fR. .sp .ne 2 -.mk .na \fB\fBcdup\fR\fR .ad @@ -336,7 +299,6 @@ remote machine working directory. .sp .ne 2 -.mk .na \fB\fBclear\fR\fR .ad @@ -348,7 +310,6 @@ command succeeded, then this is the default protection level. .sp .ne 2 -.mk .na \fB\fBclose\fR\fR .ad @@ -360,7 +321,6 @@ command interpreter. Any defined macros are erased. .sp .ne 2 -.mk .na \fB\fBcr\fR\fR .ad @@ -378,7 +338,6 @@ from a record delimiter only when \fBcr\fR is off. .sp .ne 2 -.mk .na \fB\fBdelete\fR \fIremote-file\fR\fR .ad @@ -389,7 +348,6 @@ Deletes the file \fIremote-file\fR on the remote machine. .sp .ne 2 -.mk .na \fB\fBdebug\fR\fR .ad @@ -401,7 +359,6 @@ sent to the remote machine, preceded by the string \fB->\fR\&. .sp .ne 2 -.mk .na \fB\fBdir\fR [ \fIremote-directory\fR [ \fIlocal-file\fR ]]\fR .ad @@ -416,7 +373,6 @@ on the remote machine is used. If no local file is specified, or .sp .ne 2 -.mk .na \fB\fBdisconnect\fR\fR .ad @@ -427,7 +383,6 @@ A synonym for \fBclose\fR. .sp .ne 2 -.mk .na \fB\fBform\fR [ \fIformat-name\fR ]\fR .ad @@ -440,7 +395,6 @@ corresponds to the default "non-print" subtype. .sp .ne 2 -.mk .na \fB\fBget\fR \fIremote-file\fR [ \fIlocal-file\fR ]\fR .ad @@ -455,7 +409,6 @@ structure", and "transfer mode" are used while transferring the file. .sp .ne 2 -.mk .na \fB\fBglob\fR\fR .ad @@ -480,7 +433,6 @@ of files. You can do this by transferring a \fBtar\fR(1) archive of the subtree .sp .ne 2 -.mk .na \fB\fBhash\fR\fR .ad @@ -492,7 +444,6 @@ of a data block is 8192 bytes. .sp .ne 2 -.mk .na \fB\fBhelp\fR [ \fIcommand\fR ]\fR .ad @@ -504,7 +455,6 @@ argument is given, \fBftp\fR prints a list of the known commands. .sp .ne 2 -.mk .na \fB\fBlcd\fR [ \fIdirectory\fR ]\fR .ad @@ -516,7 +466,6 @@ specified, the user's home directory is used. .sp .ne 2 -.mk .na \fB\fBls\fR [ \fB-al\fR | \fIremote-directory\fR [ \fIlocal-file\fR ]]\fR .ad @@ -545,7 +494,6 @@ is sent to the terminal. .sp .ne 2 -.mk .na \fB\fBmacdef\fR \fImacro-name\fR\fR .ad @@ -569,7 +517,6 @@ on. A \fB\e\fR followed by any character is replaced by that character. Use the .sp .ne 2 -.mk .na \fB\fBmdelete\fR \fIremote-files\fR\fR .ad @@ -580,7 +527,6 @@ Deletes the \fIremote-files\fR on the remote machine. .sp .ne 2 -.mk .na \fB\fBmdir\fR \fIremote-files local-file\fR\fR .ad @@ -593,7 +539,6 @@ indeed the target local file for receiving \fBmdir\fR output. .sp .ne 2 -.mk .na \fB\fBmget\fR \fIremote-files\fR\fR .ad @@ -609,7 +554,6 @@ local directories can be created with \fB! mkdir\fR \fIdirectory\fR. .sp .ne 2 -.mk .na \fB\fBmkdir\fR \fIdirectory-name\fR\fR .ad @@ -620,7 +564,6 @@ Makes a directory on the remote machine. .sp .ne 2 -.mk .na \fB\fBmls\fR \fIremote-files local-file\fR\fR .ad @@ -633,7 +576,6 @@ indeed the target local file for receiving \fBmls\fR output. .sp .ne 2 -.mk .na \fB\fBmode\fR [ \fImode-name\fR ]\fR .ad @@ -646,7 +588,6 @@ implementation only supports \fBstream\fR, and requires that it be specified. .sp .ne 2 -.mk .na \fB\fBmput\fR \fIlocal-files\fR\fR .ad @@ -660,7 +601,6 @@ filename expansion. Resulting file names are processed according to .sp .ne 2 -.mk .na \fB\fBnlist\fR [ \fB-al\fR | \fIremote-directory\fR [ \fIlocal-file\fR ]]\fR .ad @@ -679,7 +619,6 @@ long format the same way it does when used with the \fBls\fR command. .sp .ne 2 -.mk .na \fB\fBnmap\fR [ \fIinpattern outpattern\fR ]\fR .ad @@ -724,7 +663,6 @@ of the \fB$\fR, \fB[\fR, \fB]\fR, and \fB,\fR, characters. .sp .ne 2 -.mk .na \fB\fBntrans\fR [ \fIinchars\fR [ \fIoutchars\fR ] ]\fR .ad @@ -752,7 +690,6 @@ alphabet. .sp .ne 2 -.mk .na \fB\fBopen\fR \fIhost\fR [ \fIport\fR ]\fR .ad @@ -767,7 +704,6 @@ the \fBFTP\fR server. .sp .ne 2 -.mk .na \fB\fBpassive\fR\fR .ad @@ -786,7 +722,6 @@ be used in place of \fBPASV\fR and \fBEPRT\fR in place of \fBPORT\fR. .sp .ne 2 -.mk .na \fB\fBprivate\fR\fR .ad @@ -799,7 +734,6 @@ If no \fBADAT\fR command succeeded, then the only possible level is "clear". .sp .ne 2 -.mk .na \fB\fBprompt\fR\fR .ad @@ -813,7 +747,6 @@ default, prompting is turned on. If prompting is turned off, any \fBmget\fR or .sp .ne 2 -.mk .na \fB\fBprotect\fR \fIprotection-level\fR\fR .ad @@ -831,7 +764,6 @@ is specified, the current level is printed. The default protection level is .sp .ne 2 -.mk .na \fB\fBproxy\fR \fIftp-command\fR\fR .ad @@ -858,7 +790,6 @@ server on the secondary control connection. .sp .ne 2 -.mk .na \fB\fBput\fR \fIlocal-file\fR [ \fIremote-file\fR ]\fR .ad @@ -873,7 +804,6 @@ uses the current settings for "representation type", "file structure", and .sp .ne 2 -.mk .na \fB\fBpwd\fR\fR .ad @@ -884,7 +814,6 @@ Prints the name of the current working directory on the remote machine. .sp .ne 2 -.mk .na \fB\fBquit\fR\fR .ad @@ -895,7 +824,6 @@ A synonym for \fBbye\fR. .sp .ne 2 -.mk .na \fB\fBquote\fR \fIarg1 arg2\fR ...\fR .ad @@ -911,7 +839,6 @@ FTP protocol. .sp .ne 2 -.mk .na \fB\fBrecv\fR \fIremote-file\fR [ \fIlocal-file\fR ]\fR .ad @@ -922,7 +849,6 @@ FTP protocol. .sp .ne 2 -.mk .na \fB\fBreget\fR \fIremote-file\fR [ \fIlocal-file\fR ]\fR .ad @@ -937,7 +863,6 @@ transferring large files over networks that are prone to dropping connections. .sp .ne 2 -.mk .na \fB\fBremotehelp\fR [ \fIcommand-name\fR ]\fR .ad @@ -949,7 +874,6 @@ specified it is supplied to the server as well. .sp .ne 2 -.mk .na \fB\fBrename\fR \fIfrom to\fR\fR .ad @@ -960,7 +884,6 @@ Renames the file \fIfrom\fR on the remote machine to have the name \fIto\fR. .sp .ne 2 -.mk .na \fB\fBreset\fR\fR .ad @@ -973,7 +896,6 @@ violation of the \fBFTP\fR protocol by the remote server. .sp .ne 2 -.mk .na \fB\fBrestart\fR [ \fImarker\fR ]\fR .ad @@ -988,7 +910,6 @@ marker. If no argument is specified, the current restart status is displayed. .sp .ne 2 -.mk .na \fB\fBrmdir\fR \fIdirectory-name\fR\fR .ad @@ -999,7 +920,6 @@ Deletes a directory on the remote machine. .sp .ne 2 -.mk .na \fB\fBrunique\fR\fR .ad @@ -1017,7 +937,6 @@ command. The default value is off. .sp .ne 2 -.mk .na \fB\fBsafe\fR\fR .ad @@ -1030,7 +949,6 @@ succeeded, then the only possible level is "\fBclear\fR". .sp .ne 2 -.mk .na \fB\fBsend\fR \fIlocal-file\fR [ \fIremote-file\fR ]\fR .ad @@ -1041,7 +959,6 @@ A synonym for \fBput\fR. .sp .ne 2 -.mk .na \fB\fBsendport\fR\fR .ad @@ -1059,7 +976,6 @@ incorrectly indicate they have been accepted. .sp .ne 2 -.mk .na \fB\fBsite\fR \fIarg1\fR [ \fIarg2\fR ] ...\fR .ad @@ -1071,7 +987,6 @@ Sends the arguments specified, verbatim, to the remote \fBFTP\fR server as a .sp .ne 2 -.mk .na \fB\fBstatus\fR\fR .ad @@ -1082,7 +997,6 @@ Show the current status of \fBftp\fR. .sp .ne 2 -.mk .na \fB\fBstruct\fR [ \fIstruct-name\fR ]\fR .ad @@ -1095,7 +1009,6 @@ implementation only supports \fBfile\fR, and requires that it be specified. .sp .ne 2 -.mk .na \fB\fBsunique\fR\fR .ad @@ -1108,7 +1021,6 @@ The remote server reports the unique name. Default value is off. .sp .ne 2 -.mk .na \fB\fBtcpwindow\fR [ \fIsize\fR ]\fR .ad @@ -1121,7 +1033,6 @@ connections. If no argument is specified, the current setting is displayed. .sp .ne 2 -.mk .na \fB\fBtenex\fR\fR .ad @@ -1132,7 +1043,6 @@ Sets the "representation type" to that needed to talk to \fBTENEX\fR machines. .sp .ne 2 -.mk .na \fB\fBtrace\fR\fR .ad @@ -1143,7 +1053,6 @@ Toggles packet tracing (unimplemented). .sp .ne 2 -.mk .na \fB\fBtype\fR [ \fItype-name\fR ]\fR .ad @@ -1158,7 +1067,6 @@ printed. The default type is "network \fBASCII\fR". .sp .ne 2 -.mk .na \fB\fBuser\fR \fIuser-name\fR [ \fIpassword\fR [ \fIaccount\fR ]]\fR .ad @@ -1176,7 +1084,6 @@ automatically on initial connection to the \fBFTP\fR server. .sp .ne 2 -.mk .na \fB\fBverbose\fR\fR .ad @@ -1191,7 +1098,6 @@ from a terminal, and off otherwise. .sp .ne 2 -.mk .na \fB\fB?\fR [ \fIcommand\fR ]\fR .ad @@ -1233,24 +1139,20 @@ Local files specified as arguments to \fBftp\fR commands are processed according to the following rules. .sp .ne 2 -.mk .na \fB1)\fR .ad .RS 6n -.rt If the file name \fB\(mi\fR is specified, the standard input (for reading) or standard output (for writing) is used. .RE .sp .ne 2 -.mk .na \fB2)\fR .ad .RS 6n -.rt If the first character of the file name is \fB|\fR, the remainder of the argument is interpreted as a shell command. \fBftp\fR then forks a shell, using \fBpopen\fR(3C) with the argument supplied, and reads (writes) from the @@ -1262,12 +1164,10 @@ SPACE characters, the argument must be quoted; for example \fB"| ls .sp .ne 2 -.mk .na \fB3)\fR .ad .RS 6n -.rt Failing the above checks, if globbing is enabled, local file names are expanded according to the rules used in the \fBsh\fR(1); see the \fBglob\fR command. If the \fBftp\fR command expects a single local file (for example, \fBput\fR), @@ -1276,12 +1176,10 @@ only the first filename generated by the globbing operation is used. .sp .ne 2 -.mk .na \fB4)\fR .ad .RS 6n -.rt For \fBmget\fR commands and \fBget\fR commands with unspecified local file names, the local filename is the remote filename, which can be altered by a \fBcase\fR, \fBntrans\fR, or \fBnmap\fR setting. The resulting filename can @@ -1290,12 +1188,10 @@ then be altered if \fBrunique\fR is on. .sp .ne 2 -.mk .na \fB5)\fR .ad .RS 6n -.rt For \fBmput\fR commands and \fBput\fR commands with unspecified remote file names, the remote filename is the local filename, which can be altered by a \fBntrans\fR or \fBnmap\fR setting. The resulting filename can then be altered @@ -1349,13 +1245,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIenabled +CSI enabled .TE .SH SEE ALSO diff --git a/usr/src/man/man1/ftpcount.1 b/usr/src/man/man1/ftpcount.1 index ea27f879ad..5a2d561e80 100644 --- a/usr/src/man/man1/ftpcount.1 +++ b/usr/src/man/man1/ftpcount.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 ftpcount 1 "25 Apr 2003" "SunOS 5.11" "User Commands" +.TH FTPCOUNT 1 "Apr 25, 2003" .SH NAME ftpcount \- show current number of users in each FTP Server class .SH SYNOPSIS @@ -24,24 +24,20 @@ file. The \fBftpcount\fR command supports the following options: .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 6n -.rt Display the user counts for FTP Server classes defined in virtual host \fBftpaccess\fR(4) files. .RE .sp .ne 2 -.mk .na \fB\fB-V\fR\fR .ad .RS 6n -.rt Display program copyright and version information, then terminate. .RE @@ -51,23 +47,19 @@ Display program copyright and version information, then terminate. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR \fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB>\fB0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -89,13 +81,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man1/ftpwho.1 b/usr/src/man/man1/ftpwho.1 index 7ae2c3915e..d5cf9004fd 100644 --- a/usr/src/man/man1/ftpwho.1 +++ b/usr/src/man/man1/ftpwho.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 ftpwho 1 "25 Apr 2003" "SunOS 5.11" "User Commands" +.TH FTPWHO 1 "Apr 25, 2003" .SH NAME ftpwho \- show current process information for each FTP Server user .SH SYNOPSIS @@ -24,24 +24,20 @@ information displayed by the \fBftpcount\fR(1) command. The \fBftpwho\fR command supports the following options: .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 6n -.rt Display the current process information and user counts for FTP Server classes defined in virtual host \fBftpaccess\fR(4) files. .RE .sp .ne 2 -.mk .na \fB\fB-V\fR\fR .ad .RS 6n -.rt Display the program copyright and version information, then terminate. .RE @@ -51,23 +47,19 @@ Display the program copyright and version information, then terminate. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR \fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB>\fB0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -89,13 +81,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityExternal +Interface Stability External .TE .SH SEE ALSO diff --git a/usr/src/man/man1/gcore.1 b/usr/src/man/man1/gcore.1 index 14b46767d3..e199c9d2ac 100644 --- a/usr/src/man/man1/gcore.1 +++ b/usr/src/man/man1/gcore.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 gcore 1 "19 Jun 2006" "SunOS 5.11" "User Commands" +.TH GCORE 1 "Jun 19, 2006" .SH NAME gcore \- get core images of running processes .SH SYNOPSIS @@ -24,12 +24,10 @@ is \fIprocess-id\fR is \fBcore.\fR\fIprocess-id\fR. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-c\fR \fIcontent\fR\fR .ad .RS 15n -.rt Produces core image files with the specified content. The content description uses the same tokens as in \fBcoreadm\fR(1M). The \fB-c\fR option does not apply to cores produced due to the \fB-p\fR or \fB-g\fR flags. @@ -37,23 +35,19 @@ apply to cores produced due to the \fB-p\fR or \fB-g\fR flags. .sp .ne 2 -.mk .na \fB\fB-F\fR\fR .ad .RS 15n -.rt Force. Grabs the target process even if another process has control. .RE .sp .ne 2 -.mk .na \fB\fB-g\fR\fR .ad .RS 15n -.rt Produces core image files in the global core file repository with the global content as configured by \fBcoreadm\fR(1M). The command fails if the user does not have permissions to the global core file repository. @@ -61,12 +55,10 @@ not have permissions to the global core file repository. .sp .ne 2 -.mk .na \fB\fB\fR\fB-o\fR \fIfilename\fR\fR .ad .RS 15n -.rt Substitutes \fIfilename\fR in place of \fBcore\fR as the first part of the name of the core image files. \fIfilename\fR can contain the same tokens to be expanded as the paths in \fBcoreadm\fR(1M). @@ -74,12 +66,10 @@ expanded as the paths in \fBcoreadm\fR(1M). .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 15n -.rt Produces a core image file in the process-specific location with the process-specific content for each process as configured by \fBcoreadm\fR(1M). The command fails if the user does not have permissions to the per-process core @@ -92,12 +82,10 @@ file repository. The following operand is supported: .sp .ne 2 -.mk .na \fB\fIprocess-id\fR\fR .ad .RS 14n -.rt process \fBID\fR .RE @@ -115,35 +103,29 @@ at the moment of application of the \fBproc\fR tool in question. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 12n -.rt On success. .RE .sp .ne 2 -.mk .na \fBnon-zero\fR .ad .RS 12n -.rt On failure, such as non-existent process \fBID\fR. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB\fR\fBcore.\fR\fB\fIprocess-id\fR\fR\fR .ad .RS 19n -.rt core images .RE @@ -155,13 +137,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilitySee below. +Interface Stability See below. .TE .sp diff --git a/usr/src/man/man1/gencat.1 b/usr/src/man/man1/gencat.1 index 6ebe2f7ce7..398f27eeb7 100644 --- a/usr/src/man/man1/gencat.1 +++ b/usr/src/man/man1/gencat.1 @@ -1,13 +1,13 @@ '\" te .\" Copyright 1989 AT&T Copyright (c) 1995, Sun Microsystems, Inc. All Rights Reserved Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 gencat 1 "1 Feb 1995" "SunOS 5.11" "User Commands" +.TH GENCAT 1 "Feb 1, 1995" .SH NAME gencat \- generate a formatted message catalog .SH SYNOPSIS @@ -37,12 +37,10 @@ space or tab character. Any other \fBASCII\fR spaces or tabs are considered as part of the subsequent field. .sp .ne 2 -.mk .na \fB\fB$set\fR \fIn comment\fR \fR .ad .RS 22n -.rt Where \fIn\fR specifies the set identifier of the following messages until the next \fB$set\fR, \fB$delset\fR, or end-of-file appears. \fIn\fR must be a number in the range (\fB1\fR-{\fBNL_SETMAX\fR}). Set identifiers within a @@ -54,12 +52,10 @@ a message text source file, all messages are located in the default message set .sp .ne 2 -.mk .na \fB\fB$delset\fR \fIn comment\fR \fR .ad .RS 22n -.rt Deletes message set \fIn\fR from an existing message catalog. Any string following the set number is treated as a comment. (\fBNote:\fR if \fIn\fR is not a valid set it is ignored.) @@ -67,24 +63,20 @@ not a valid set it is ignored.) .sp .ne 2 -.mk .na \fB\fB$\fR\fIcomment\fR \fR .ad .RS 22n -.rt A line beginning with a dollar symbol \fB$\fR followed by an \fBASCII\fR space or tab character is treated as a comment. .RE .sp .ne 2 -.mk .na \fB\fIm\fR \fImessage-text\fR \fR .ad .RS 22n -.rt The \fIm\fR denotes the message identifier, a number in the range (\fB1\fR-{\fBNL_MSGMAX\fR}). The \fImessage-text\fR is stored in the message catalog with the set identifier specified by the last \fB$set\fR directive, and @@ -99,12 +91,10 @@ be contiguous. The length of \fImessage-text\fR must be in the range .sp .ne 2 -.mk .na \fB\fB$quote\fR \fIc\fR \fR .ad .RS 22n -.rt This line specifies an optional quote character \fIc\fR, which can be used to surround \fImessage-text\fR so that trailing spaces or null (empty) messages are visible in a message source line. By default, or if an empty \fB$quote\fR @@ -122,19 +112,18 @@ the following table: .sp .TS -tab() box; -lw(1.83i) lw(1.83i) lw(1.83i) -lw(1.83i) lw(1.83i) lw(1.83i) -. -DescriptionSymbolSequence -newlineNL(LF)\en -horizontal tabHT\et -vertical tabVT\ev -backspaceBS\eb -carriage returnCR\er -form feedFF \ef -backslash\e\e\e -bit patternddd\eddd +box; +l l l +l l l . +Description Symbol Sequence +newline NL(LF) \en +horizontal tab HT \et +vertical tab VT \ev +backspace BS \eb +carriage return CR \er +form feed FF \ef +backslash \e \e\e +bit pattern ddd \eddd .TE .sp @@ -172,24 +161,20 @@ which is equivalent to: The following operands are supported: .sp .ne 2 -.mk .na \fB\fIcatfile\fR \fR .ad .RS 12n -.rt A path name of the formatted message catalog. If \(mi is specified, standard output is used. .RE .sp .ne 2 -.mk .na \fB\fImsgfile\fR \fR .ad .RS 12n -.rt A path name of a message text source file. If \(mi is specified for an instance of \fImsgfile\fR, standard input is used. The format of message text source files is defined in \fBMessage Text Source File Format\fR. @@ -207,23 +192,19 @@ that affect the execution of \fBgencat\fR: \fBLANG\fR, \fBLC_ALL\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR \fR .ad .RS 7n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR \fR .ad .RS 7n -.rt An error occurred. .RE @@ -235,15 +216,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIenabled +CSI enabled _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man1/genmsg.1 b/usr/src/man/man1/genmsg.1 index 9e2246ce2a..8b761cfe06 100644 --- a/usr/src/man/man1/genmsg.1 +++ b/usr/src/man/man1/genmsg.1 @@ -3,15 +3,15 @@ .\" 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 genmsg 1 "14 May 2004" "SunOS 5.11" "User Commands" +.TH GENMSG 1 "May 14, 2004" .SH NAME genmsg \- generate a message source file by extracting messages from source files .SH SYNOPSIS .LP .nf -\fBgenmsg\fR [\fB-abdfrntx\fR] [\fB-c\fR \fImessage-tag\fR] [\fB-g\fR \fIproject-file\fR] - [\fB-l\fR \fIproject-file\fR] [\fB-m\fR \fIprefix\fR] [\fB-M\fR \fIsuffix\fR] +\fBgenmsg\fR [\fB-abdfrntx\fR] [\fB-c\fR \fImessage-tag\fR] [\fB-g\fR \fIproject-file\fR] + [\fB-l\fR \fIproject-file\fR] [\fB-m\fR \fIprefix\fR] [\fB-M\fR \fIsuffix\fR] [\fB-o\fR \fImessage-file\fR] [\fB-p\fR \fIpreprocessor\fR] [\fB-s\fR \fIset-tags\fR] \fI file\fR... .fi @@ -32,15 +32,14 @@ argument for its output file. .sp .TS -tab() box; -lw(3.58i) |lw(1.92i) -lw(3.58i) |lw(1.92i) -. -\fICommand\fR\fIOutput File\fR +box; +l | l +l | l . +\fICommand\fR \fIOutput File\fR _ -\fBgenmsg prog.c\fRprog.c.msg -\fBgensmg main.c util.c tool.c\fRmain.c.msg -\fBgenmsg -o prog.msg mail.c util.c\fRprog.msg +\fBgenmsg prog.c\fR prog.c.msg +\fBgensmg main.c util.c tool.c\fR main.c.msg +\fBgenmsg -o prog.msg mail.c util.c\fR prog.msg .TE .sp @@ -61,12 +60,10 @@ maximum message numbers. Each line in a project file is composed of a set number and its maximum message number: .sp .ne 2 -.mk .na \fB\fISet_number\fR\fR .ad .RS 14n -.rt \fIMaximum_message_number\fR .RE @@ -100,12 +97,10 @@ check the appearance of your window program's initial size and position. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 19n -.rt Append the output into the message file \fImessage-file\fR that is specified by the \fB-o\fR option. If two different messages that have the same set and message number are found, the message in the specified message file is kept and @@ -114,36 +109,30 @@ the other message in the input file is discarded. .sp .ne 2 -.mk .na \fB\fB-b\fR\fR .ad .RS 19n -.rt Place the extracted comment after the corresponding message in the output file. This option changes the placement behavior of the \fB-s\fR or \fB-c\fR option. .RE .sp .ne 2 -.mk .na \fB\fB-c\fR\fI message-tag\fR\fR .ad .RS 19n -.rt Extract message comments having \fImessage-tag\fR inside them from the input files and write them with a '\fB$\fR' prefix as a comment in the output file. .RE .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad .RS 19n -.rt Include an original text of a message as a comment to be preserved along with its translations. With this option, the translator can see the original messages even after they are replaced with their translations. @@ -151,12 +140,10 @@ messages even after they are replaced with their translations. .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 19n -.rt Overwrite the input files and the project file when used with the \fB-l\fR or \fB-r\fR option. With the \fB-r\fR option, \fBgenmsg\fR overwrites only the input files. @@ -164,24 +151,20 @@ input files. .sp .ne 2 -.mk .na \fB\fB-g\fR\fI project-file\fR\fR .ad .RS 19n -.rt Generate \fIproject-file\fR that has a list of set numbers and their maximum message numbers in the input files. .RE .sp .ne 2 -.mk .na \fB\fB-l\fR\fI project-file\fR\fR .ad .RS 19n -.rt Replace message numbers with the calculated numbers based upon \fIproject-file\fR if the message numbers are \fB-1\fR in the input files, and then generate copies of the input files with the new message numbers and a copy @@ -192,57 +175,47 @@ in the input file as a base number and generates \fIproject-file\fR. .sp .ne 2 -.mk .na \fB\fB-m\fR\fI prefix\fR\fR .ad .RS 19n -.rt Fill in the message with \fIprefix\fR. This option is useful for testing. .RE .sp .ne 2 -.mk .na \fB\fB-M\fR\fI suffix\fR\fR .ad .RS 19n -.rt Fill in the message with \fIsuffix\fR. This option is useful for testing. .RE .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 19n -.rt Add comment lines to the output file indicating the file name and line number in the input files where each extracted string is encountered. .RE .sp .ne 2 -.mk .na \fB\fB-o\fR\fI message-file\fR\fR .ad .RS 19n -.rt Write the output to \fImessage-file\fR. .RE .sp .ne 2 -.mk .na \fB\fB-p\fR\fI preprocessor\fR\fR .ad .RS 19n -.rt Invoke \fIpreprocessor\fR to preprocess macros and define statements for the \fBcatgets\fR(3C) calls. \fBgenmsg\fR first invokes the option argument as a preprocesser and then starts the normal process against the output from the @@ -251,24 +224,20 @@ preprocessor. \fBgenmsg\fR initiates this process for all the input files. .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 19n -.rt Replace message numbers with \fB-1\fR. This is the reverse operation of the \fB-l\fR option. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fI set-tag\fR\fR .ad .RS 19n -.rt Extract set number comments having \fIset-tag\fR inside them from the input files and write them with a '\fB$\fR' prefix as a comment in the output file. If multiple comments are specified for one set number, the first one is @@ -277,24 +246,20 @@ extracted and the rest of them are discarded. .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad .RS 19n -.rt Generate a message that is three times as long as the original message. This option is useful for testing. .RE .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad .RS 19n -.rt Suppress warning messages about message and set number range checks and conflicts. .RE @@ -302,12 +267,10 @@ conflicts. .SH OPERANDS .sp .ne 2 -.mk .na \fB\fIfile\fR\fR .ad .RS 8n -.rt An input source file. .RE @@ -351,34 +314,28 @@ the following files: .sp .ne 2 -.mk .na \fB\fBtest.c.msg\fR\fR .ad .RS 14n -.rt Message file .RE .sp .ne 2 -.mk .na \fB\fBproj.new\fR\fR .ad .RS 14n -.rt Updated project file .RE .sp .ne 2 -.mk .na \fB\fBtest.c.new\fR\fR .ad .RS 14n -.rt New source file .RE @@ -570,23 +527,19 @@ that affect the execution of \fBgenmsg\fR: \fBLC_MESSAGES\fR and \fBNLSPATH\fR. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -603,7 +556,7 @@ call. For example: .sp .in +2 .nf - + const int set_num = 1; extern int msg_num(const char *); const char *msg = "Hello"; diff --git a/usr/src/man/man1/getconf.1 b/usr/src/man/man1/getconf.1 index 0d50a5321e..fd23451e3c 100644 --- a/usr/src/man/man1/getconf.1 +++ b/usr/src/man/man1/getconf.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 getconf 1 "1 Sep 2009" "SunOS 5.11" "User Commands" +.TH GETCONF 1 "Sep 1, 2009" .SH NAME getconf \- get configuration values .SH SYNOPSIS @@ -127,24 +127,20 @@ The following options are supported by \fB/usr/bin/getconf\fR, \fB/usr/xpg4/bin/getconf\fR, and \fB/usr/xpg6/bin/getconf\fR .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 19n -.rt Writes the names of the current system configuration variables to the standard output. .RE .sp .ne 2 -.mk .na \fB\fB-v\fR\fIspecification\fR\fR .ad .RS 19n -.rt Gives the specification which governs the selection of values for configuration variables. .RE @@ -156,7 +152,6 @@ The following options are supported by the \fBgetconf\fR built-in command in \fBksh93\fR: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad @@ -165,13 +160,11 @@ The following options are supported by the \fBgetconf\fR built-in command in \fB\fB--all\fR\fR .ad .RS 24n -.rt Call the native \fBgetconf -a\fR. .RE .sp .ne 2 -.mk .na \fB\fB-b\fR\fR .ad @@ -180,13 +173,11 @@ Call the native \fBgetconf -a\fR. \fB\fB--base\fR\fR .ad .RS 24n -.rt List base variable name without \fBcall\fR and standard prefixes. .RE .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad @@ -195,7 +186,6 @@ List base variable name without \fBcall\fR and standard prefixes. \fB\fB--call=\fR\fIRE\fR\fR .ad .RS 24n -.rt Display variables with \fBcall\fR prefix that matches \fIRE\fR. The \fBcall\fR prefixes are: .RS +4 @@ -242,7 +232,6 @@ Constant value .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad @@ -251,13 +240,11 @@ Constant value \fB\fB--defined\fR\fR .ad .RS 24n -.rt Only display defined values when no operands are specified. .RE .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad @@ -266,13 +253,11 @@ Only display defined values when no operands are specified. \fB\fB--lowercase\fR\fR .ad .RS 24n -.rt List variable names in lower case. .RE .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad @@ -281,13 +266,11 @@ List variable names in lower case. \fB\fB--name=\fR\fIRE\fR\fR .ad .RS 24n -.rt Display variables with names that match \fIRE\fR. .RE .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad @@ -296,7 +279,6 @@ Display variables with names that match \fIRE\fR. \fB\fB--portable\fR\fR .ad .RS 24n -.rt Display the named writable variables and values in a form that can be directly executed by \fBksh93\fR(1) to set the values. If \fIname\fR is omitted, lists all writable variables. @@ -304,7 +286,6 @@ all writable variables. .sp .ne 2 -.mk .na \fB\fB-q\fR\fR .ad @@ -313,13 +294,11 @@ all writable variables. \fB\fB--quote\fR\fR .ad .RS 24n -.rt Quote values (\fB"..."\fR). .RE .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad @@ -328,14 +307,12 @@ Quote values (\fB"..."\fR). \fB\fB--readonly\fR\fR .ad .RS 24n -.rt Display the named \fBreadonly\fR variables in \fIname\fR\fB=\fR\fIvalue\fR form. If \fIname\fR is omitted, lists all \fBreadonly\fR variables. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad @@ -344,7 +321,6 @@ form. If \fIname\fR is omitted, lists all \fBreadonly\fR variables. \fB\fB--standard=\fR\fIRE\fR\fR .ad .RS 24n -.rt Display variables with standard prefix that matches \fIRE\fR. Use the \fB--table\fR option to view all standard prefixes, including local additions. .sp @@ -352,7 +328,7 @@ The standard prefixes available on all systems are: .sp .in +2 .nf - + AES AST C @@ -370,7 +346,6 @@ XPG .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad @@ -379,14 +354,12 @@ XPG \fB\fB--table\fR\fR .ad .RS 24n -.rt Display the internal table that contains the name, standard, standard section, and system call symbol prefix for each variable. .RE .sp .ne 2 -.mk .na \fB\fB-w\fR\fR .ad @@ -395,14 +368,12 @@ and system call symbol prefix for each variable. \fB\fB--writable\fR\fR .ad .RS 24n -.rt Display the named writable variables in \fIname\fR\fB=\fR\fIvalue\fR form. If \fIname\fR is omitted, lists all writable variables. .RE .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad @@ -411,7 +382,6 @@ Display the named writable variables in \fIname\fR\fB=\fR\fIvalue\fR form. If \fB\fB--specification=name\fR\fR .ad .RS 24n -.rt Call the native \fBgetconf -v\fR \fIname\fR. .RE @@ -423,12 +393,10 @@ The following operands are supported by \fB/usr/bin/getconf\fR, \fB/usr/xpg4/bin/getconf\fR, and \fB/usr/xpg6/bin/getconf\fR: .sp .ne 2 -.mk .na \fB\fIpath_var\fR\fR .ad .RS 12n -.rt A name of a configuration variable whose value is available from the \fBpathconf\fR(2) function. All of the values in the following table are supported: @@ -438,35 +406,29 @@ supported: .sp .TS -tab(); -lw(1.83i) lw(1.83i) lw(1.83i) -lw(1.83i) lw(1.83i) lw(1.83i) -. -LINK_MAXNAME_MAX_POSIX_CHOWN_RESTRICTED -MAX_CANONPATH_MAX_POSIX_NO_TRUNC -MAX_INPUTPIPE_BUF_POSIX_VDISABLE +l l l +l l l . +LINK_MAX NAME_MAX _POSIX_CHOWN_RESTRICTED +MAX_CANON PATH_MAX _POSIX_NO_TRUNC +MAX_INPUT PIPE_BUF _POSIX_VDISABLE .TE .sp .ne 2 -.mk .na \fB\fIpathname\fR\fR .ad .RS 14n -.rt A path name for which the variable specified by \fIpath_var\fR is to be determined. .RE .sp .ne 2 -.mk .na \fB\fIsystem_var\fR\fR .ad .RS 14n -.rt A name of a configuration variable whose value is available from \fBconfstr\fR(3C) or \fBsysconf\fR(3C). All of the values in the following table are supported: @@ -476,128 +438,126 @@ table are supported: .sp .TS -tab(); -lw(2.75i) lw(2.75i) -lw(2.75i) lw(2.75i) -. -ARG_MAXBC_BASE_MAX -BC_DIM_MAXBC_SCALE_MAX -BC_STRING_MAXCHAR_BIT -CHARCLASS_NAME_MAXCHAR_MAX -CHAR_MINCHILD_MAX -CLK_TCKCOLL_WEIGHTS_MAX -CS_PATHEXPR_NEST_MAX -HOST_NAME_MAXINT_MAX -INT_MINLFS64_CFLAGS -LFS64_LDFLAGSLFS64_LIBS -LFS64_LINTFLAGSLFS_CFLAGS -LFS_LDFLAGSLFS_LIBS -LFS_LINTFLAGSLINE_MAX -LONG_BITLONG_MAX -LONG_MINMB_LEN_MAX -NGROUPS_MAXNL_ARGMAX -NL_LANGMAXNL_MSGMAX -NL_NMAXNL_SETMAX -NL_TEXTMAXNZERO -OPEN_MAXPOSIX2_BC_BASE_MAX -POSIX2_BC_DIM_MAXPOSIX2_BC_SCALE_MAX -POSIX2_BC_STRING_MAXPOSIX2_C_BIND -POSIX2_C_DEVPOSIX2_CHAR_TERM -POSIX2_COLL_WEIGHTS_MAXPOSIX2_C_VERSION -POSIX2_EXPR_NEST_MAXPOSIX2_FORT_DEV -POSIX2_FORT_RUNPOSIX2_LINE_MAX -POSIX2_LOCALEDEFPOSIX2_RE_DUP_MAX -POSIX2_SW_DEVPOSIX2_SYMLINKS -POSIX2_UPEPOSIX2_VERSION -POSIX_ALLOC_SIZE_MINPOSIX_REC_INCR_XFER_SIZE -POSIX_REC_MAX_XFER_SIZEPOSIX_REC_MIN_XFER_SIZE -POSIX_REC_XFER_ALIGNPOSIX_V6_ILP32_OFF32 -POSIX_V6_ILP32_OFF32_CFLAGSPOSIX_V6_ILP32_OFF32_LDFLAGS -POSIX_V6_ILP32_OFF32_LIBSPOSIX_V6_ILP32_OFFBIG -POSIX_V6_ILP32_OFFBIG_CFLAGSPOSIX_V6_ILP32_OFFBIG_LDFLAGS -POSIX_V6_ILP32_OFFBIG_LIBSPOSIX_V6_LP64_OFF64 -POSIX_V6_LP64_OFF64_CFLAGSPOSIX_V6_LP64_OFF64_LDFLAGS -POSIX_V6_LP64_OFF64_LIBSPOSIX_V6_LPBIG_OFFBIG -POSIX_V6_LPBIG_OFFBIG_CFLAGSPOSIX_V6_LPBIG_OFFBIG_LDFLAGS -POSIX_V6_LPBIG_OFFBIG_LIBSPOSIX_V6_WIDTH_RESTRICTED_ENVS -SYMLINK_MAXSYMLOOP_MAX -_POSIX2_BC_BASE_MAX_POSIX2_BC_DIM_MAX -_POSIX2_BC_SCALE_MAX_POSIX2_BC_STRING_MAX -_POSIX2_CHARCLASS_NAME_MAX_POSIX2_CHAR_TERM -_POSIX2_COLL_WEIGHTS_MAX_POSIX2_C_BIND -_POSIX2_C_DEV_POSIX2_C_VERSION -_POSIX2_EXPR_NEST_MAX_POSIX2_FORT_DEV -_POSIX2_FORT_RUN_POSIX2_LINE_MAX -_POSIX2_LOCALEDEF_POSIX2_PBS -_POSIX2_PBS_ACCOUNTING_POSIX2_PBS_CHECKPOINT -_POSIX2_PBS_LOCATE_POSIX2_PBS_MESSAGE -_POSIX2_PBS_TRACK_POSIX2_RE_DUP_MAX -_POSIX2_SW_DEV_POSIX2_UPE -_POSIX2_VERSION_POSIX_ADVISORY_INFO -_POSIX_AIO_LISTIO_MAX_POSIX_AIO_MAX -_POSIX_ARG_MAX_POSIX_ASYNC_IO -_POSIX_BARRIERS_POSIX_CHILD_MAX -_POSIX_CLOCKRES_MIN_POSIX_CLOCK_SELECTION -_POSIX_CPUTIME_POSIX_DELAYTIMER_MAX -_POSIX_HOST_NAME_MAX_POSIX_IPV6 -_POSIX_JOB_CONTROL_POSIX_LINK_MAX -_POSIX_LOGIN_NAME_MAX_POSIX_MAX_CANON -_POSIX_MAX_INPUT_POSIX_MONOTONIC_CLOCK -_POSIX_MQ_OPEN_MAX_POSIX_MQ_PRIO_MAX -_POSIX_NAME_MAX_POSIX_NGROUPS_MAX -_POSIX_OPEN_MAX_POSIX_PATH_MAX -_POSIX_PIPE_BUF_POSIX_PRIO_IO -_POSIX_RAW_SOCKETS_POSIX_READER_WRITER_LOCKS -_POSIX_REGEXP_POSIX_RE_DUP_MAX -_POSIX_RTSIG_MAX_POSIX_SAVED_IDS -_POSIX_SEM_NSEMS_MAX_POSIX_SEM_VALUE_MAX -_POSIX_SHELL_POSIX_SIGQUEUE_MAX -_POSIX_SPAWN_POSIX_SPIN_LOCKS -_POSIX_SPORADIC_SERVER_POSIX_SSIZE_MAX -_POSIX_SS_REPL_MAX_POSIX_STREAM_MAX -_POSIX_SYMLINK_MAX_POSIX_SYMLOOP_MAX -_POSIX_SYNC_IO_POSIX_THREAD_ATTR_STACKADDR -_POSIX_THREAD_ATTR_STACKSIZE_POSIX_THREAD_CPUTIME -_POSIX_THREAD_DESTRUCTOR_ITERATIONS_POSIX_THREAD_KEYS_MAX -_POSIX_THREAD_PRIORITY_SCHEDULING_POSIX_THREAD_PRIO_INHERIT -_POSIX_THREAD_PRIO_PROTECT_POSIX_THREAD_PROCESS_SHARED -_POSIX_THREAD_SAFE_FUNCTIONS_POSIX_THREAD_SPORADIC_SERVER -_POSIX_THREAD_THREADS_MAX_POSIX_TIMEOUTS -_POSIX_TIMER_MAX_POSIX_TRA_POSIX_TIMER_MAXCE -_POSIX_TIMESTAMP_RESOLUTION -_POSIX_TRACE_EVENT_FILTER_POSIX_TRACE_EVENT_NAME_MAX -_POSIX_TRACE_INHERIT_POSIX_TRACE_LOG -_POSIX_TRACE_NAME_MAX_POSIX_TRACE_SYS_MAX -_POSIX_TRACE_USER_EVENT_MAX_POSIX_TTY_NAME_MAX -_POSIX_TYPED_MEMORY_OBJECTS_POSIX_TZNAME_MAX -_POSIX_VERSION_POSIX_V6_ILP32_OFF32 -_POSIX_V6_ILP32_OFFBIG_POSIX_V6_LP64_OFF64 -_POSIX_V6_LPBIG_OFFBIG_V6_ILP32_OFF32 -_V6_ILP32_OFFBIG_V6_LP64_OFF64 -_V6_LPBIG_OFFBIGRE_DUP_MAX -SCHAR_MAXSCHAR_MIN -SHRT_MAXSHRT_MIN -SSIZE_MAXSTREAM_MAX -TMP_MAXTZNAME_MAX -UCHAR_MAXUINT_MAX -ULONG_MAXUSHRT_MAX -WORD_BITXBS5_ILP32_OFF32 -XBS5_ILP32_OFF32_CFLAGSXBS5_ILP32_OFF32_LDFLAGS -XBS5_ILP32_OFF32_LIBSXBS5_ILP32_OFF32_LINTFLAGS -XBS5_ILP32_OFFBIGXBS5_ILP32_OFFBIG_CFLAGS -XBS5_ILP32_OFFBIG_LDFLAGSXBS5_ILP32_OFFBIG_LIBS -XBS5_ILP32_OFFBIG_LINTFLAGSXBS5_LP64_OFF64 -XBS5_LP64_OFF64_CFLAGSXBS5_LP64_OFF64_LDFLAGS -XBS5_LP64_OFF64_LIBSXBS5_LP64_OFF64_LINTFLAGS -XBS5_LPBIG_OFFBIGXBS5_LPBIG_OFFBIG_CFLAGS -XBS5_LPBIG_OFFBIG_LDFLAGSXBS5_LPBIG_OFFBIG_LIBS -XBS5_LPBIG_OFFBIG_LINTFLAGS_XOPEN_CRYPT -_XOPEN_ENH_I18N_XOPEN_IOV_MAX -_XOPEN_LEGACY_XOPEN_NAME_MAX -_XOPEN_PATH_MAX_XOPEN_SHM -_XOPEN_STREAMS_XOPEN_VERSION -_XOPEN_XCU_VERSION_XOPEN_XPG2 -_XOPEN_XPG3_XOPEN_XPG4 +l l +l l . +ARG_MAX BC_BASE_MAX +BC_DIM_MAX BC_SCALE_MAX +BC_STRING_MAX CHAR_BIT +CHARCLASS_NAME_MAX CHAR_MAX +CHAR_MIN CHILD_MAX +CLK_TCK COLL_WEIGHTS_MAX +CS_PATH EXPR_NEST_MAX +HOST_NAME_MAX INT_MAX +INT_MIN LFS64_CFLAGS +LFS64_LDFLAGS LFS64_LIBS +LFS64_LINTFLAGS LFS_CFLAGS +LFS_LDFLAGS LFS_LIBS +LFS_LINTFLAGS LINE_MAX +LONG_BIT LONG_MAX +LONG_MIN MB_LEN_MAX +NGROUPS_MAX NL_ARGMAX +NL_LANGMAX NL_MSGMAX +NL_NMAX NL_SETMAX +NL_TEXTMAX NZERO +OPEN_MAX POSIX2_BC_BASE_MAX +POSIX2_BC_DIM_MAX POSIX2_BC_SCALE_MAX +POSIX2_BC_STRING_MAX POSIX2_C_BIND +POSIX2_C_DEV POSIX2_CHAR_TERM +POSIX2_COLL_WEIGHTS_MAX POSIX2_C_VERSION +POSIX2_EXPR_NEST_MAX POSIX2_FORT_DEV +POSIX2_FORT_RUN POSIX2_LINE_MAX +POSIX2_LOCALEDEF POSIX2_RE_DUP_MAX +POSIX2_SW_DEV POSIX2_SYMLINKS +POSIX2_UPE POSIX2_VERSION +POSIX_ALLOC_SIZE_MIN POSIX_REC_INCR_XFER_SIZE +POSIX_REC_MAX_XFER_SIZE POSIX_REC_MIN_XFER_SIZE +POSIX_REC_XFER_ALIGN POSIX_V6_ILP32_OFF32 +POSIX_V6_ILP32_OFF32_CFLAGS POSIX_V6_ILP32_OFF32_LDFLAGS +POSIX_V6_ILP32_OFF32_LIBS POSIX_V6_ILP32_OFFBIG +POSIX_V6_ILP32_OFFBIG_CFLAGS POSIX_V6_ILP32_OFFBIG_LDFLAGS +POSIX_V6_ILP32_OFFBIG_LIBS POSIX_V6_LP64_OFF64 +POSIX_V6_LP64_OFF64_CFLAGS POSIX_V6_LP64_OFF64_LDFLAGS +POSIX_V6_LP64_OFF64_LIBS POSIX_V6_LPBIG_OFFBIG +POSIX_V6_LPBIG_OFFBIG_CFLAGS POSIX_V6_LPBIG_OFFBIG_LDFLAGS +POSIX_V6_LPBIG_OFFBIG_LIBS POSIX_V6_WIDTH_RESTRICTED_ENVS +SYMLINK_MAX SYMLOOP_MAX +_POSIX2_BC_BASE_MAX _POSIX2_BC_DIM_MAX +_POSIX2_BC_SCALE_MAX _POSIX2_BC_STRING_MAX +_POSIX2_CHARCLASS_NAME_MAX _POSIX2_CHAR_TERM +_POSIX2_COLL_WEIGHTS_MAX _POSIX2_C_BIND +_POSIX2_C_DEV _POSIX2_C_VERSION +_POSIX2_EXPR_NEST_MAX _POSIX2_FORT_DEV +_POSIX2_FORT_RUN _POSIX2_LINE_MAX +_POSIX2_LOCALEDEF _POSIX2_PBS +_POSIX2_PBS_ACCOUNTING _POSIX2_PBS_CHECKPOINT +_POSIX2_PBS_LOCATE _POSIX2_PBS_MESSAGE +_POSIX2_PBS_TRACK _POSIX2_RE_DUP_MAX +_POSIX2_SW_DEV _POSIX2_UPE +_POSIX2_VERSION _POSIX_ADVISORY_INFO +_POSIX_AIO_LISTIO_MAX _POSIX_AIO_MAX +_POSIX_ARG_MAX _POSIX_ASYNC_IO +_POSIX_BARRIERS _POSIX_CHILD_MAX +_POSIX_CLOCKRES_MIN _POSIX_CLOCK_SELECTION +_POSIX_CPUTIME _POSIX_DELAYTIMER_MAX +_POSIX_HOST_NAME_MAX _POSIX_IPV6 +_POSIX_JOB_CONTROL _POSIX_LINK_MAX +_POSIX_LOGIN_NAME_MAX _POSIX_MAX_CANON +_POSIX_MAX_INPUT _POSIX_MONOTONIC_CLOCK +_POSIX_MQ_OPEN_MAX _POSIX_MQ_PRIO_MAX +_POSIX_NAME_MAX _POSIX_NGROUPS_MAX +_POSIX_OPEN_MAX _POSIX_PATH_MAX +_POSIX_PIPE_BUF _POSIX_PRIO_IO +_POSIX_RAW_SOCKETS _POSIX_READER_WRITER_LOCKS +_POSIX_REGEXP _POSIX_RE_DUP_MAX +_POSIX_RTSIG_MAX _POSIX_SAVED_IDS +_POSIX_SEM_NSEMS_MAX _POSIX_SEM_VALUE_MAX +_POSIX_SHELL _POSIX_SIGQUEUE_MAX +_POSIX_SPAWN _POSIX_SPIN_LOCKS +_POSIX_SPORADIC_SERVER _POSIX_SSIZE_MAX +_POSIX_SS_REPL_MAX _POSIX_STREAM_MAX +_POSIX_SYMLINK_MAX _POSIX_SYMLOOP_MAX +_POSIX_SYNC_IO _POSIX_THREAD_ATTR_STACKADDR +_POSIX_THREAD_ATTR_STACKSIZE _POSIX_THREAD_CPUTIME +_POSIX_THREAD_DESTRUCTOR_ITERATIONS _POSIX_THREAD_KEYS_MAX +_POSIX_THREAD_PRIORITY_SCHEDULING _POSIX_THREAD_PRIO_INHERIT +_POSIX_THREAD_PRIO_PROTECT _POSIX_THREAD_PROCESS_SHARED +_POSIX_THREAD_SAFE_FUNCTIONS _POSIX_THREAD_SPORADIC_SERVER +_POSIX_THREAD_THREADS_MAX _POSIX_TIMEOUTS +_POSIX_TIMER_MAX _POSIX_TRA_POSIX_TIMER_MAXCE +_POSIX_TIMESTAMP_RESOLUTION +_POSIX_TRACE_EVENT_FILTER _POSIX_TRACE_EVENT_NAME_MAX +_POSIX_TRACE_INHERIT _POSIX_TRACE_LOG +_POSIX_TRACE_NAME_MAX _POSIX_TRACE_SYS_MAX +_POSIX_TRACE_USER_EVENT_MAX _POSIX_TTY_NAME_MAX +_POSIX_TYPED_MEMORY_OBJECTS _POSIX_TZNAME_MAX +_POSIX_VERSION _POSIX_V6_ILP32_OFF32 +_POSIX_V6_ILP32_OFFBIG _POSIX_V6_LP64_OFF64 +_POSIX_V6_LPBIG_OFFBIG _V6_ILP32_OFF32 +_V6_ILP32_OFFBIG _V6_LP64_OFF64 +_V6_LPBIG_OFFBIG RE_DUP_MAX +SCHAR_MAX SCHAR_MIN +SHRT_MAX SHRT_MIN +SSIZE_MAX STREAM_MAX +TMP_MAX TZNAME_MAX +UCHAR_MAX UINT_MAX +ULONG_MAX USHRT_MAX +WORD_BIT XBS5_ILP32_OFF32 +XBS5_ILP32_OFF32_CFLAGS XBS5_ILP32_OFF32_LDFLAGS +XBS5_ILP32_OFF32_LIBS XBS5_ILP32_OFF32_LINTFLAGS +XBS5_ILP32_OFFBIG XBS5_ILP32_OFFBIG_CFLAGS +XBS5_ILP32_OFFBIG_LDFLAGS XBS5_ILP32_OFFBIG_LIBS +XBS5_ILP32_OFFBIG_LINTFLAGS XBS5_LP64_OFF64 +XBS5_LP64_OFF64_CFLAGS XBS5_LP64_OFF64_LDFLAGS +XBS5_LP64_OFF64_LIBS XBS5_LP64_OFF64_LINTFLAGS +XBS5_LPBIG_OFFBIG XBS5_LPBIG_OFFBIG_CFLAGS +XBS5_LPBIG_OFFBIG_LDFLAGS XBS5_LPBIG_OFFBIG_LIBS +XBS5_LPBIG_OFFBIG_LINTFLAGS _XOPEN_CRYPT +_XOPEN_ENH_I18N _XOPEN_IOV_MAX +_XOPEN_LEGACY _XOPEN_NAME_MAX +_XOPEN_PATH_MAX _XOPEN_SHM +_XOPEN_STREAMS _XOPEN_VERSION +_XOPEN_XCU_VERSION _XOPEN_XPG2 +_XOPEN_XPG3 _XOPEN_XPG4 .TE .sp @@ -703,12 +663,10 @@ The following environment variable is supported by the \fBksh93\fR built-in \fBgetconf\fR command: .sp .ne 2 -.mk .na \fB\fB_AST_FEATURES\fR\fR .ad .RS 17n -.rt Local writable values that are different from the default are stored in the \fB_AST_FEATURES\fR environment variable. The \fB_AST_FEATURES\fR value is a space-separated list of \fIname path value\fR 3-tuples, where \fIname\fR is the @@ -722,24 +680,20 @@ path is applicable, and \fIvalue\fR is the system configuration value. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt The specified variable is valid and information about its current state was written successfully. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -752,15 +706,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .SS "ksh93" @@ -768,13 +721,12 @@ StandardSee \fBstandards\fR(5). .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilitySee below. +Interface Stability See below. .TE .sp diff --git a/usr/src/man/man1/getfacl.1 b/usr/src/man/man1/getfacl.1 index 58fd3954ce..a90b61deff 100644 --- a/usr/src/man/man1/getfacl.1 +++ b/usr/src/man/man1/getfacl.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 getfacl 1 "5 Nov 1994" "SunOS 5.11" "User Commands" +.TH GETFACL 1 "Nov 5, 1994" .SH NAME getfacl \- display discretionary file information .SH SYNOPSIS @@ -35,24 +35,20 @@ exists. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 6n -.rt Displays the filename, the file owner, the file group owner, and the \fBACL\fR of the file. .RE .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad .RS 6n -.rt Displays the filename, the file owner, the file group owner, and the default \fBACL\fR of the file, if it exists. .RE @@ -63,12 +59,10 @@ Displays the filename, the file owner, the file group owner, and the default The following operands are supported: .sp .ne 2 -.mk .na \fB\fIfile\fR\fR .ad .RS 8n -.rt The path name of a regular file, special file, or named pipe. .RE @@ -181,14 +175,14 @@ would print: .sp .in +2 .nf -# file: foo -# owner: shea -# group: staff -user::rwx -user:spy:\|\(mi\|\(mi\|\(mi -user:mookie:r\|\(mi\|\(mi -group::r\|\(mi\|\(mi -mask::rw\|\(mi +# file: foo +# owner: shea +# group: staff +user::rwx +user:spy:\|\(mi\|\(mi\|\(mi +user:mookie:r\|\(mi\|\(mi +group::r\|\(mi\|\(mi +mask::rw\|\(mi other::\|\(mi\|\(mi\|\(mi .fi .in -2 @@ -221,7 +215,7 @@ would print: user::rwx user:spy:\|\(mi\|\(mi\|\(mi user:mookie:r\|\(mi\|\(mi #effective:\|\(mi\|\(mi\|\(mi -group::\|\(mi\|\(mi\|\(mi +group::\|\(mi\|\(mi\|\(mi mask::\|\(mi\|\(mi\|\(mi other::\|\(mi\|\(mi\|\(mi .fi @@ -266,23 +260,19 @@ default:other::\|\(mi\|\(mi\|\(mi .SH FILES .sp .ne 2 -.mk .na \fB\fB/etc/passwd\fR\fR .ad .RS 15n -.rt system password file .RE .sp .ne 2 -.mk .na \fB\fB/etc/group\fR\fR .ad .RS 15n -.rt group file .RE @@ -294,13 +284,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityEvolving +Interface Stability Evolving .TE .SH SEE ALSO diff --git a/usr/src/man/man1/getlabel.1 b/usr/src/man/man1/getlabel.1 index a480d8695d..f67e13e95f 100644 --- a/usr/src/man/man1/getlabel.1 +++ b/usr/src/man/man1/getlabel.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 getlabel 1 "11 Jul 2008" "SunOS 5.11" "User Commands" +.TH GETLABEL 1 "Jul 11, 2008" .SH NAME getlabel \- display the label of files .SH SYNOPSIS @@ -21,23 +21,19 @@ default format. .SH OPTIONS .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 6n -.rt Display the label that is associated with \fIfilename\fR in short form. .RE .sp .ne 2 -.mk .na \fB\fB-S\fR\fR .ad .RS 6n -.rt Display the label that is associated with \fIfilename\fR in long form. .RE @@ -47,34 +43,28 @@ Display the label that is associated with \fIfilename\fR in long form. \fBgetlabel\fR exits with one of the following values: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt Unsuccessful completion due to usage error. .RE .sp .ne 2 -.mk .na \fB\fB2\fR\fR .ad .RS 5n -.rt Unable to translate label. .RE @@ -86,13 +76,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPE ATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface Stability See below. +Interface Stability See below. .TE .sp diff --git a/usr/src/man/man1/getopt.1 b/usr/src/man/man1/getopt.1 index a9dcefaa02..97eb058e6a 100644 --- a/usr/src/man/man1/getopt.1 +++ b/usr/src/man/man1/getopt.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 getopt 1 "7 Jan 2000" "SunOS 5.11" "User Commands" +.TH GETOPT 1 "Jan 7, 2000" .SH NAME getopt \- parse command options .SH SYNOPSIS @@ -84,12 +84,11 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE -CSIenabled +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE +CSI enabled .TE .SH SEE ALSO diff --git a/usr/src/man/man1/getoptcvt.1 b/usr/src/man/man1/getoptcvt.1 index fd2ae0ef34..7a1f7f11e0 100644 --- a/usr/src/man/man1/getoptcvt.1 +++ b/usr/src/man/man1/getoptcvt.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 getoptcvt 1 "7 Jan 2000" "SunOS 5.11" "User Commands" +.TH GETOPTCVT 1 "Jan 7, 2000" .SH NAME getoptcvt \- convert to getopts to parse command options .SH SYNOPSIS @@ -16,7 +16,7 @@ getoptcvt \- convert to getopts to parse command options .LP .nf -\fB/usr/lib/getoptcvt\fR +\fB/usr/lib/getoptcvt\fR .fi .SH DESCRIPTION @@ -77,12 +77,10 @@ positional parameters and check for options that are valid for that command The following option is supported: .sp .ne 2 -.mk .na \fB\fB-b\fR\fR .ad .RS 6n -.rt Makes the converted script portable to earlier releases of the UNIX system. \fB/usr/lib/getoptcvt\fR modifies the shell script in \fIfilename\fR so that when the resulting shell script is executed, it determines at run time whether @@ -140,24 +138,20 @@ that affect the execution of \fBgetopts\fR: \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and \fBNLSPATH\fR. .sp .ne 2 -.mk .na \fB\fBOPTIND\fR \fR .ad .RS 11n -.rt This variable is used by \fBgetoptcvt\fR as the index of the next argument to be processed. .RE .sp .ne 2 -.mk .na \fB\fBOPTARG\fR \fR .ad .RS 11n -.rt This variable is used by \fBgetoptcvt\fR to store the argument if an option is using arguments. .RE @@ -168,23 +162,19 @@ using arguments. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR \fR .ad .RS 7n -.rt An option, specified or unspecified by \fIoptstring\fR, was found. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR \fR .ad .RS 7n -.rt The end of options was encountered or an error occurred. .RE @@ -196,12 +186,11 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE -CSIenabled +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE +CSI enabled .TE .SH SEE ALSO diff --git a/usr/src/man/man1/getopts.1 b/usr/src/man/man1/getopts.1 index a2f8d74058..39d7ef2f09 100644 --- a/usr/src/man/man1/getopts.1 +++ b/usr/src/man/man1/getopts.1 @@ -3,14 +3,14 @@ .\" Copyright 1992, X/Open Company Limited All Rights Reserved .\" Copyright (c) 2007 Sun Microsystems, Inc. All Rights Reserved .\" Portions Copyright (c) 1982-2007 AT&T Knowledge Ventures -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 getopts 1 "2 Nov 2007" "SunOS 5.11" "User Commands" +.TH GETOPTS 1 "Nov 2, 2007" .SH NAME getopts \- parse utility options .SH SYNOPSIS @@ -339,59 +339,49 @@ an SCCS or CVS identification string. Zero or more flags with optional number values can be specified to control option parsing. The flags are: .sp .ne 2 -.mk .na \fB\fBc\fR\fR .ad .RS 5n -.rt Cache this \fIoptstring\fR for multiple passes. Used to optimize built-ins that can be called many times within the same process. .RE .sp .ne 2 -.mk .na \fB\fBi\fR\fR .ad .RS 5n -.rt Ignore this \fIoptstring\fR when generating help. Used when combining \fIoptstring\fR values from multiple passes. .RE .sp .ne 2 -.mk .na \fB\fBl\fR\fR .ad .RS 5n -.rt Display only long option names in help messages. .RE .sp .ne 2 -.mk .na \fB\fBo\fR\fR .ad .RS 5n -.rt The \fB-\fR option character prefix is optional. This supports the obsolete \fBps\fR(1) option syntax. .RE .sp .ne 2 -.mk .na \fB\fBp\fR\fR .ad .RS 5n -.rt The number specifies the number of \fB-\fR characters that must prefix long option names. The default is \fB2\fR. \fB0\fR, \fB1\fR or \fB2\fR are accepted, for example \fBp0\fR for \fBdd\fR(1M) and \fBp1\fR for \fBfind\fR(1). @@ -399,12 +389,10 @@ for example \fBp0\fR for \fBdd\fR(1M) and \fBp1\fR for \fBfind\fR(1). .sp .ne 2 -.mk .na \fB\fBs\fR\fR .ad .RS 5n -.rt The number specifies the manual page section number, \fB1\fR by default. .RE @@ -528,89 +516,73 @@ used. usage and detailed descriptions. Specify \fIargs\fR as: .sp .ne 2 -.mk .na \fB\fB-?\fR\fR .ad .RS 13n -.rt Use this to generate a usage synopsis. .RE .sp .ne 2 -.mk .na \fB\fB--??\fR\fR .ad .RS 13n -.rt Use this to generate a verbose usage message. .RE .sp .ne 2 -.mk .na \fB\fB--??man\fR\fR .ad .RS 13n -.rt Use this to generate a formatted manual page. .RE .sp .ne 2 -.mk .na \fB\fB--??api\fR\fR .ad .RS 13n -.rt Use this to generate an easy to parse usage message. .RE .sp .ne 2 -.mk .na \fB\fB--??html\fR\fR .ad .RS 13n -.rt Use this to generate a man page in \fBhtml\fR format. .RE .sp .ne 2 -.mk .na \fB\fB--??nroff\fR\fR .ad .RS 13n -.rt Use this to generate a man page in \fBnroff\fR format. .RE .sp .ne 2 -.mk .na \fB\fB--??usage\fR\fR .ad .RS 13n -.rt Use this to list the current \fBoptstring\fR. .RE .sp .ne 2 -.mk .na \fB\fB--???name\fR\fR .ad .RS 13n -.rt Use this to list \fBversion=\fR\fIn\fR, where \fIn\fR is greater than \fB0\fR, if the option \fIname\fR is recognized by \fBgetopts\fR. .RE @@ -627,12 +599,10 @@ of the first non-option argument. The following options are supported by \fBksh93\fR: .sp .ne 2 -.mk .na \fB\fB-a\fR \fIname\fR\fR .ad .RS 11n -.rt Use \fIname\fR instead of the command name in usage messages. .RE @@ -642,12 +612,10 @@ Use \fIname\fR instead of the command name in usage messages. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIoptstring\fR\fR .ad .RS 13n -.rt A string containing the option characters recognised by the utility invoking \fBgetopts\fR. If a character is followed by a colon, the option is expected to have an argument, which should be supplied as a separate argument. Applications @@ -667,12 +635,10 @@ option character is not known or an option-argument is missing. .sp .ne 2 -.mk .na \fB\fIname\fR\fR .ad .RS 13n -.rt The name of a shell variable that is set by the \fBgetopts\fR utility to the option character that was found. .RE @@ -790,24 +756,20 @@ that affect the execution of \fBgetopts\fR: \fBLANG\fR, \fBLC_ALL\fR, \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and \fBNLSPATH\fR. .sp .ne 2 -.mk .na \fB\fBOPTIND\fR\fR .ad .RS 10n -.rt This variable is used by \fBgetopts\fR as the index of the next argument to be processed. .RE .sp .ne 2 -.mk .na \fB\fBOPTARG\fR\fR .ad .RS 10n -.rt This variable is used by \fBgetopts\fR to store the argument if an option is using arguments. .RE @@ -818,23 +780,19 @@ using arguments. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt An option, specified or unspecified by \fIoptstring\fR, was found. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt The end of options was encountered or an error occurred. .RE @@ -844,34 +802,28 @@ The end of options was encountered or an error occurred. The following exit values are returned by \fBksh93\fR: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt A specified option was found. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt An end of options was encountered. .RE .sp .ne 2 -.mk .na \fB\fB2\fR\fR .ad .RS 5n -.rt A usage or information message was generated. .RE @@ -884,15 +836,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .SS "ksh93" @@ -900,13 +851,12 @@ StandardSee \fBstandards\fR(5). .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityUncommitted +Interface Stability Uncommitted .TE .SH SEE ALSO diff --git a/usr/src/man/man1/gettext.1 b/usr/src/man/man1/gettext.1 index 20560276f8..129792825b 100644 --- a/usr/src/man/man1/gettext.1 +++ b/usr/src/man/man1/gettext.1 @@ -3,19 +3,19 @@ .\" 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 gettext 1 "17 Sep 2001" "SunOS 5.11" "User Commands" +.TH GETTEXT 1 "Sep 17, 2001" .SH NAME gettext \- retrieve text string from message database .SH SYNOPSIS .LP .nf -\fBgettext\fR [\fB-d\fR \fItextdomain\fR | \fB-\(midomain\fR=\fItextdomain\fR] +\fBgettext\fR [\fB-d\fR \fItextdomain\fR | \fB-\(midomain\fR=\fItextdomain\fR] [\fItextdomain\fR] \fImsgid\fR .fi .LP .nf -\fBgettext\fR \fB-s\fR [\fB-e\fR] [\fB-n\fR] +\fBgettext\fR \fB-s\fR [\fB-e\fR] [\fB-n\fR] [\fB-d\fR \fItextdomain\fR | \fB-\(midomain\fR=\fItextdomain\fR] \fImsgid\fR... .fi @@ -51,7 +51,6 @@ messages found in the selected catalog are translated. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-d\fR \fItextdomain\fR\fR .ad @@ -60,41 +59,34 @@ The following options are supported: \fB\fB-\(midomain\fR=\fItextdomain\fR\fR .ad .RS 26n -.rt Retrieves translated messages from the domain \fItextdomain\fR, if \fItextdomain\fR is not specified as an operand. .RE .sp .ne 2 -.mk .na \fB\fB-e\fR\fR .ad .RS 26n -.rt Enables expansion of some escape sequences if used with the \fB-s\fR option. .RE .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 26n -.rt Suppresses trailing newline if used with the \fB-s\fR option. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 26n -.rt Behaves like \fBecho\fR(1) (see DESCRIPTION above). If the \fB-s\fR option is specified, no expansion of C escape sequences is performed and a newline character is appended to the output, by default. @@ -106,70 +98,58 @@ character is appended to the output, by default. The following operands are supported: .sp .ne 2 -.mk .na \fB\fItextdomain\fR\fR .ad .RS 14n -.rt A domain name used to retrieve the messages. This overrides the specification by the \fB-d\fR or \fB-\(midomain\fR options, if present. .RE .sp .ne 2 -.mk .na \fB\fImsgid\fR\fR .ad .RS 14n -.rt A key to retrieve the localized message. .RE .SH ENVIRONMENT VARIABLES .sp .ne 2 -.mk .na \fB\fBLANG\fR\fR .ad .RS 17n -.rt Specifies locale name. .RE .sp .ne 2 -.mk .na \fB\fBLC_MESSAGES\fR\fR .ad .RS 17n -.rt Specifies messaging locale, and if present overrides \fBLANG\fR for messages. .RE .sp .ne 2 -.mk .na \fB\fBTEXTDOMAIN\fR\fR .ad .RS 17n -.rt Specifies the text domain name, which is identical to the message object filename without \fB\&.mo\fR suffix. .RE .sp .ne 2 -.mk .na \fB\fBTEXTDOMAINDIR\fR\fR .ad .RS 17n -.rt Specifies the pathname to the message database. If present, replaces \fB/usr/lib/locale\fR. .RE diff --git a/usr/src/man/man1/gettxt.1 b/usr/src/man/man1/gettxt.1 index 9d877fb784..bbdd452a5d 100644 --- a/usr/src/man/man1/gettxt.1 +++ b/usr/src/man/man1/gettxt.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 gettxt 1 "20 Dec 1996" "SunOS 5.11" "User Commands" +.TH GETTXT 1 "Dec 20, 1996" .SH NAME gettxt \- retrieve a text string from a message database .SH SYNOPSIS @@ -21,12 +21,10 @@ directory name \fIlocale\fR corresponds to the language in which the text strings are written; see \fBsetlocale\fR(3C). .sp .ne 2 -.mk .na \fB\fImsgfile\fR \fR .ad .RS 13n -.rt Name of the file in the directory \fB/usr/lib/locale/\fR\fIlocale\fR\fB/\fR\fBLC_MESSAGES\fR\fB \fR to retrieve \fImsgnum\fR from. The name of \fImsgfile\fR can be up to 14 characters in @@ -36,12 +34,10 @@ length, but may not contain either \e0 (null) or the \fBASCII\fR code for .sp .ne 2 -.mk .na \fB\fImsgnum\fR \fR .ad .RS 13n -.rt Sequence number of the string to retrieve from \fImsgfile\fR. The strings in \fImsgfile\fR are numbered sequentially from \fI1\fR to \fIn\fR, where \fIn\fR is the number of strings in the file. @@ -49,12 +45,10 @@ is the number of strings in the file. .sp .ne 2 -.mk .na \fB\fIdflt_msg\fR \fR .ad .RS 13n -.rt Default string to be displayed if \fBgettxt\fR fails to retrieve \fImsgnum\fR from \fImsgfile\fR. Nongraphic characters must be represented as alphabetic escape sequences. @@ -108,12 +102,10 @@ that affect the execution of \fBgettxt\fR: \fBLC_CTYPE\fR and \fB\fR\fBLC_MESSAGES\fR\fB\&. \fR .sp .ne 2 -.mk .na \fB\fBLC_CTYPE\fR \fR .ad .RS 16n -.rt Determines how \fBgettxt\fR handles characters. When \fBLC_CTYPE\fR is set to a valid value, \fBgettxt\fR can display and handle text and filenames containing valid characters for that locale. \fBgettxt\fR can display and handle Extended @@ -124,12 +116,10 @@ column widths. In the "C" locale, only characters from ISO 8859-1 are valid. .sp .ne 2 -.mk .na \fB\fBLC_MESSAGES\fR \fR .ad .RS 16n -.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 @@ -139,7 +129,6 @@ default form found in the program itself (in most cases, U.S. English). .SH FILES .sp .ne 2 -.mk .na \fB\fB/usr/lib/locale/C/\fR\fBLC_MESSAGES\fR\fB/* \fR\fR .ad @@ -150,7 +139,6 @@ default message files created by \fBmkmsgs\fR(1) .sp .ne 2 -.mk .na \fB\fB/usr/lib/locale/\fR\fIlocale\fR\fB/\fR\fBLC_MESSAGES\fR\fB/* \fR\fR .ad @@ -167,12 +155,11 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE -CSIEnabled +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE +CSI Enabled .TE .SH SEE ALSO diff --git a/usr/src/man/man1/getzonepath.1 b/usr/src/man/man1/getzonepath.1 index f0cde59c26..e4f5944dd7 100644 --- a/usr/src/man/man1/getzonepath.1 +++ b/usr/src/man/man1/getzonepath.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 getzonepath 1 "20 Jul 2007" "SunOS 5.11" "User Commands" +.TH GETZONEPATH 1 "Jul 20, 2007" .SH NAME getzonepath \- display root path of the zone corresponding to the specified label @@ -37,13 +37,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -StabilityCommitted +Stability Committed .TE .SH DIAGNOSTICS @@ -52,34 +51,28 @@ StabilityCommitted \fBgetzonepath\fR exits with one of the following values: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt Success .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt Usage error .RE .sp .ne 2 -.mk .na \fB\fB2\fR\fR .ad .RS 5n -.rt Failure; error message is the system error number from \fBgetzonerootbylabel\fR(3TSOL) .RE diff --git a/usr/src/man/man1/glob.1 b/usr/src/man/man1/glob.1 index 70e5975810..2144bfec3a 100644 --- a/usr/src/man/man1/glob.1 +++ b/usr/src/man/man1/glob.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 glob 1 "15 Apr 1994" "SunOS 5.11" "User Commands" +.TH GLOB 1 "Apr 15, 1994" .SH NAME glob \- shell built-in function to expand a word list .SH SYNOPSIS diff --git a/usr/src/man/man1/gprof.1 b/usr/src/man/man1/gprof.1 index d8f24b8cde..4e2d0bf807 100644 --- a/usr/src/man/man1/gprof.1 +++ b/usr/src/man/man1/gprof.1 @@ -3,15 +3,15 @@ .\" 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 gprof 1 "8 Feb 2007" "SunOS 5.11" "User Commands" +.TH GPROF 1 "Feb 8, 2007" .SH NAME gprof \- display call-graph profile data .SH SYNOPSIS .LP .nf -\fBgprof\fR [\fB-abcCDlsz\fR] [\fB-e\fR \fIfunction-name\fR] [\fB-E\fR \fIfunction-name\fR] - [\fB-f\fR \fIfunction-name\fR] [\fB-F\fR \fIfunction-name\fR] - [\fIimage-file\fR [\fIprofile-file\fR...]] +\fBgprof\fR [\fB-abcCDlsz\fR] [\fB-e\fR \fIfunction-name\fR] [\fB-E\fR \fIfunction-name\fR] + [\fB-f\fR \fIfunction-name\fR] [\fB-F\fR \fIfunction-name\fR] + [\fIimage-file\fR [\fIprofile-file\fR...]] [\fB-n\fR \fInumber of functions\fR] .fi @@ -72,12 +72,10 @@ profiling information to be saved in the \fBgmon.out\fR file. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 19n -.rt Suppress printing statically declared functions. If this option is given, all relevant information about the static function (for instance, time samples, calls to other functions, calls from other functions) belongs to the function @@ -86,23 +84,19 @@ loaded just before the static function in the \fBa.out\fR file. .sp .ne 2 -.mk .na \fB\fB-b\fR\fR .ad .RS 19n -.rt Brief. Suppress descriptions of each field in the profile. .RE .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad .RS 19n -.rt Discover the static call-graph of the program by a heuristic which examines the text space of the object file. Static-only parents or children are indicated with call counts of 0. Note that for dynamically linked executables, the linked @@ -111,23 +105,19 @@ shared objects' text segments are not examined. .sp .ne 2 -.mk .na \fB\fB-C\fR\fR .ad .RS 19n -.rt Demangle C++ symbol names before printing them out. .RE .sp .ne 2 -.mk .na \fB\fB-D\fR\fR .ad .RS 19n -.rt Produce a profile file \fBgmon.sum\fR that represents the difference of the profile information in all specified profile files. This summary profile file may be given to subsequent executions of \fBgprof\fR (also with \fB-D\fR) to @@ -142,12 +132,10 @@ from A to B as \fBn-m\fR. .sp .ne 2 -.mk .na \fB\fB-e\fR\fIfunction-name\fR\fR .ad .RS 19n -.rt Suppress printing the graph profile entry for routine \fIfunction-name\fR and all its descendants (unless they have other ancestors that are not suppressed). More than one \fB-e\fR option may be given. Only one \fIfunction-name\fR may @@ -156,12 +144,10 @@ be given with each \fB-e\fR option. .sp .ne 2 -.mk .na \fB\fB-E\fR\fIfunction-name\fR\fR .ad .RS 19n -.rt Suppress printing the graph profile entry for routine \fIfunction-name\fR (and its descendants) as \fB-e\fR, below, and also exclude the time spent in \fIfunction-name\fR (and its descendants) from the total and percentage time @@ -174,12 +160,10 @@ is the default. .sp .ne 2 -.mk .na \fB\fB-f\fR\fIfunction-name\fR\fR .ad .RS 19n -.rt Print the graph profile entry only for routine \fIfunction-name\fR and its descendants. More than one \fB-f\fR option may be given. Only one \fIfunction-name\fR may be given with each \fB-f\fR option. @@ -187,12 +171,10 @@ descendants. More than one \fB-f\fR option may be given. Only one .sp .ne 2 -.mk .na \fB\fB-F\fR\fIfunction-name\fR\fR .ad .RS 19n -.rt Print the graph profile entry only for routine \fIfunction-name\fR and its descendants (as \fB-f\fR, below) and also use only the times of the printed routines in total time and percentage computations. More than one \fB-F\fR @@ -202,12 +184,10 @@ option may be given. Only one \fIfunction-name\fR may be given with each .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 19n -.rt Suppress the reporting of graph profile entries for all local symbols. This option would be the equivalent of placing all of the local symbols for the specified executable image on the \fB-E\fR exclusion list. @@ -215,24 +195,20 @@ specified executable image on the \fB-E\fR exclusion list. .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 19n -.rt Limits the size of flat and graph profile listings to the top \fBn\fR offending functions. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 19n -.rt Produce a profile file \fBgmon.sum\fR which represents the sum of the profile information in all of the specified profile files. This summary profile file may be given to subsequent executions of \fBgprof\fR (also with \fB-s\fR) to @@ -242,12 +218,10 @@ the \fB-D\fR option. .sp .ne 2 -.mk .na \fB\fB-z\fR\fR .ad .RS 19n -.rt Display routines which have zero usage (as indicated by call counts and accumulated time). This is useful in conjunction with the \fB-c\fR option for discovering which routines were never called. Note that this has restricted use @@ -258,12 +232,10 @@ examined by the \fB-c\fR option. .SH ENVIRONMENT VARIABLES .sp .ne 2 -.mk .na \fB\fBPROFDIR\fR\fR .ad .RS 11n -.rt If this environment variable contains a value, place profiling output within that directory, in a file named \fIpid\fR\fB\&.\fR\fIprogramname\fR. \fIpid\fR is the process \fBID\fR and \fIprogramname\fR is the name of the program being @@ -276,45 +248,37 @@ file \fBgmon.out\fR. .SH FILES .sp .ne 2 -.mk .na \fB\fBa.out\fR\fR .ad .RS 30n -.rt executable file containing namelist .RE .sp .ne 2 -.mk .na \fB\fBgmon.out\fR\fR .ad .RS 30n -.rt dynamic call-graph and profile .RE .sp .ne 2 -.mk .na \fB\fBgmon.sum\fR\fR .ad .RS 30n -.rt summarized dynamic call-graph and profile .RE .sp .ne 2 -.mk .na \fB\fB$PROFDIR/\fR\fIpid\fR\fB\&.\fR\fIprogramname\fR\fR .ad .RS 30n -.rt .RE diff --git a/usr/src/man/man1/grep.1 b/usr/src/man/man1/grep.1 index 27b799b85f..879ba61485 100644 --- a/usr/src/man/man1/grep.1 +++ b/usr/src/man/man1/grep.1 @@ -2,38 +2,38 @@ .\" Copyright 1989 AT&T .\" Copyright (c) 2008, Sun Microsystems, Inc. All Rights Reserved .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 grep 1 "26 Feb 2008" "SunOS 5.11" "User Commands" +.TH GREP 1 "Feb 26, 2008" .SH NAME grep \- search a file for a pattern .SH SYNOPSIS .LP .nf -\fB/usr/bin/grep\fR [\fB-bchilnsvw\fR] \fIlimited-regular-expression\fR +\fB/usr/bin/grep\fR [\fB-bchilnsvw\fR] \fIlimited-regular-expression\fR [\fIfilename\fR]... .fi .LP .nf -\fB/usr/xpg4/bin/grep\fR [\fB-E\fR | \fB-F\fR] [\fB-c\fR | \fB-l\fR | \fB-q\fR] [\fB-bhinsvwx\fR] \fB-e\fR \fIpattern_list\fR... +\fB/usr/xpg4/bin/grep\fR [\fB-E\fR | \fB-F\fR] [\fB-c\fR | \fB-l\fR | \fB-q\fR] [\fB-bhinsvwx\fR] \fB-e\fR \fIpattern_list\fR... [\fB-f\fR \fIpattern_file\fR]... [\fIfile\fR]... .fi .LP .nf -\fB/usr/xpg4/bin/grep\fR [\fB-E\fR | \fB-F\fR] [\fB-c\fR | \fB-l\fR | \fB-q\fR] [\fB-bhinsvwx\fR] +\fB/usr/xpg4/bin/grep\fR [\fB-E\fR | \fB-F\fR] [\fB-c\fR | \fB-l\fR | \fB-q\fR] [\fB-bhinsvwx\fR] [\fB-e\fR \fIpattern_list\fR]... \fB-f\fR \fIpattern_file\fR... [\fIfile\fR]... .fi .LP .nf -\fB/usr/xpg4/bin/grep\fR [\fB-E\fR | \fB-F\fR] [\fB-c\fR | \fB-l\fR | \fB-q\fR] [\fB-bhinsvwx\fR] \fIpattern\fR +\fB/usr/xpg4/bin/grep\fR [\fB-E\fR | \fB-F\fR] [\fB-c\fR | \fB-l\fR | \fB-q\fR] [\fB-bhinsvwx\fR] \fIpattern\fR [\fIfile\fR]... .fi @@ -75,58 +75,48 @@ The following options are supported for both \fB/usr/bin/grep\fR and \fB/usr/xpg4/bin/grep\fR: .sp .ne 2 -.mk .na \fB\fB-b\fR\fR .ad .RS 6n -.rt Precedes each line by the block number on which it was found. This can be useful in locating block numbers by context (first block is 0). .RE .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad .RS 6n -.rt Prints only a count of the lines that contain the pattern. .RE .sp .ne 2 -.mk .na \fB\fB-h\fR\fR .ad .RS 6n -.rt Prevents the name of the file containing the matching line from being prepended to that line. Used when searching multiple files. .RE .sp .ne 2 -.mk .na \fB\fB-i\fR\fR .ad .RS 6n -.rt Ignores upper/lower case distinction during comparisons. .RE .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 6n -.rt Prints only the names of files with matching lines, separated by NEWLINE characters. Does not repeat the names of files when the pattern is found more than once. @@ -134,45 +124,37 @@ than once. .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 6n -.rt Precedes each line by its line number in the file (first line is 1). .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 6n -.rt Suppresses error messages about nonexistent or unreadable files. .RE .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 6n -.rt Prints all lines except those that contain the pattern. .RE .sp .ne 2 -.mk .na \fB\fB-w\fR\fR .ad .RS 6n -.rt Searches for the expression as a word as if surrounded by \fB\e<\fR and \fB\e>\fR\&. .RE @@ -183,12 +165,10 @@ Searches for the expression as a word as if surrounded by \fB\e<\fR and The following options are supported for \fB/usr/xpg4/bin/grep\fR only: .sp .ne 2 -.mk .na \fB\fB-e\fR \fIpattern_list\fR\fR .ad .RS 19n -.rt Specifies one or more patterns to be used during the search for input. Patterns in \fIpattern_list\fR must be separated by a NEWLINE character. A null pattern can be specified by two adjacent newline characters in \fIpattern_list\fR. @@ -200,12 +180,10 @@ matching lines, but the order of evaluation is unspecified. .sp .ne 2 -.mk .na \fB\fB-E\fR\fR .ad .RS 19n -.rt Matches using full regular expressions. Treats each pattern specified as a full regular expression. If any entire full regular expression pattern matches an input line, the line is matched. A null full regular expression matches every @@ -242,12 +220,10 @@ concatenation, then | and new-line. .sp .ne 2 -.mk .na \fB\fB-f\fR \fIpattern_file\fR\fR .ad .RS 19n -.rt Reads one or more patterns from the file named by the path name \fIpattern_file\fR. Patterns in \fIpattern_file\fR are terminated by a NEWLINE character. A null pattern can be specified by an empty line in @@ -257,12 +233,10 @@ each pattern is treated as a basic regular expression. .sp .ne 2 -.mk .na \fB\fB-F\fR\fR .ad .RS 19n -.rt Matches using fixed strings. Treats each pattern specified as a string instead of a regular expression. If an input line contains any of the patterns as a contiguous sequence of bytes, the line is matched. A null string matches every @@ -271,24 +245,20 @@ line. See \fBfgrep\fR(1) for more information. .sp .ne 2 -.mk .na \fB\fB-q\fR\fR .ad .RS 19n -.rt Quiet. Does not write anything to the standard output, regardless of matching lines. Exits with zero status if an input line is selected. .RE .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad .RS 19n -.rt Considers only input lines that use all characters in the line to match an entire fixed string or regular expression to be matching lines. .RE @@ -299,12 +269,10 @@ entire fixed string or regular expression to be matching lines. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIfile\fR\fR .ad .RS 8n -.rt A path name of a file to be searched for the patterns. If no \fIfile\fR operands are specified, the standard input is used. .RE @@ -312,24 +280,20 @@ operands are specified, the standard input is used. .SS "/usr/bin/grep" .sp .ne 2 -.mk .na \fB\fIpattern\fR\fR .ad .RS 11n -.rt Specifies a pattern to be used during the search for input. .RE .SS "/usr/xpg4/bin/grep" .sp .ne 2 -.mk .na \fB\fIpattern\fR\fR .ad .RS 11n -.rt Specifies one or more patterns to be used during the search for input. This operand is treated as if it were specified as \fB-e\fR \fIpattern_list\fR. .RE @@ -462,34 +426,28 @@ that affect the execution of \fBgrep\fR: \fBLANG\fR, \fBLC_ALL\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt One or more matches were found. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt No matches were found. .RE .sp .ne 2 -.mk .na \fB\fB2\fR\fR .ad .RS 5n -.rt Syntax errors or inaccessible files (even if matches were found). .RE @@ -502,13 +460,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSINot Enabled +CSI Not Enabled .TE .SS "/usr/xpg4/bin/grep" @@ -516,17 +473,16 @@ CSINot Enabled .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityCommitted +Interface Stability Committed _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .SH SEE ALSO diff --git a/usr/src/man/man1/groups.1 b/usr/src/man/man1/groups.1 index 2df922692e..d7f86c8268 100644 --- a/usr/src/man/man1/groups.1 +++ b/usr/src/man/man1/groups.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 groups 1 "14 Sep 1992" "SunOS 5.11" "User Commands" +.TH GROUPS 1 "Sep 14, 1992" .SH NAME groups \- print group membership of user .SH SYNOPSIS @@ -39,23 +39,19 @@ example% .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 diff --git a/usr/src/man/man1/hash.1 b/usr/src/man/man1/hash.1 index 5375800047..15c9f6c07e 100644 --- a/usr/src/man/man1/hash.1 +++ b/usr/src/man/man1/hash.1 @@ -1,13 +1,13 @@ '\" te .\" Copyright 1989 AT&T Copyright (c) 2002, Sun Microsystems, Inc. All Rights Reserved Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 hash 1 "17 Jul 2002" "SunOS 5.11" "User Commands" +.TH HASH 1 "Jul 17, 2002" .SH NAME hash, rehash, unhash, hashstat \- evaluate the internal hash table of the contents of directories @@ -31,17 +31,17 @@ contents of directories .SS "csh" .LP .nf -\fBrehash\fR +\fBrehash\fR .fi .LP .nf -\fBunhash\fR +\fBunhash\fR .fi .LP .nf -\fBhashstat\fR +\fBhashstat\fR .fi .SS "ksh" @@ -113,12 +113,10 @@ commands. The following operand is supported by \fBhash\fR: .sp .ne 2 -.mk .na \fB\fIutility\fR \fR .ad .RS 12n -.rt The name of a utility to be searched for and added to the list of remembered locations. .RE @@ -140,12 +138,10 @@ that affect the execution of \fBhash\fR: \fBLANG\fR, \fBLC_ALL\fR, \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and \fBNLSPATH\fR. .sp .ne 2 -.mk .na \fB\fBPATH\fR \fR .ad .RS 9n -.rt Determine the location of \fIutility\fR. .RE @@ -155,23 +151,19 @@ Determine the location of \fIutility\fR. The following exit values are returned by \fBhash\fR: .sp .ne 2 -.mk .na \fB\fB0\fR \fR .ad .RS 7n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR \fR .ad .RS 7n -.rt An error occurred. .RE @@ -183,13 +175,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man1/head.1 b/usr/src/man/man1/head.1 index 1d9399bdad..5f37a26077 100644 --- a/usr/src/man/man1/head.1 +++ b/usr/src/man/man1/head.1 @@ -3,14 +3,14 @@ .\" Copyright 1989 AT&T .\" Portions Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved .\" Portions Copyright (c) 1982-2007 AT&T Knowledge Ventures -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 head 1 "2 Nov 2007" "SunOS 5.11" "User Commands" +.TH HEAD 1 "Nov 2, 2007" .SH NAME head \- display first few lines of files .SH SYNOPSIS @@ -78,34 +78,28 @@ of the following characters to specify a different unit other than a single byte: .sp .ne 2 -.mk .na \fB\fBb\fR\fR .ad .RS 5n -.rt 512 bytes .RE .sp .ne 2 -.mk .na \fB\fBk\fR\fR .ad .RS 5n -.rt 1-kilobyte .RE .sp .ne 2 -.mk .na \fB\fBm\fR\fR .ad .RS 5n -.rt 1-megabyte .RE @@ -119,24 +113,20 @@ For backwards compatibility, \fB-number\fR is equivalent to \fB-n\fR number. The following options are supported by \fB/usr/bin/head\fR: .sp .ne 2 -.mk .na \fB\fB-n\fR \fInumber\fR\fR .ad .RS 13n -.rt The first \fInumber\fR lines of each input file is copied to standard output. The \fInumber\fR option-argument must be a positive decimal integer. .RE .sp .ne 2 -.mk .na \fB\fB-\fR\fInumber\fR\fR .ad .RS 13n -.rt The \fInumber\fR argument is a positive decimal integer with the same effect as the \fB-n\fR \fInumber\fR option. .RE @@ -152,7 +142,6 @@ The following options are supported by the head built-in command in \fBksh93\fR: .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad @@ -161,13 +150,11 @@ The following options are supported by the head built-in command in \fB\fB--lines=\fR\fIlines\fR\fR .ad .RS 18n -.rt Copy lines from each file. The default value is \fB10\fR. .RE .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad @@ -176,13 +163,11 @@ Copy lines from each file. The default value is \fB10\fR. \fB\fB--bytes=\fR\fIchars\fR\fR .ad .RS 18n -.rt Copy \fIchars\fR bytes from each file. .RE .sp .ne 2 -.mk .na \fB\fB-q\fR\fR .ad @@ -191,13 +176,11 @@ Copy \fIchars\fR bytes from each file. \fB\fB--quiet|silent\fR\fR .ad .RS 18n -.rt Never output filename headers. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad @@ -206,13 +189,11 @@ Never output filename headers. \fB\fB--skip=\fR\fIskip\fR\fR .ad .RS 18n -.rt Skip \fIskip\fR characters or lines from each file before copying. .RE .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad @@ -221,7 +202,6 @@ Skip \fIskip\fR characters or lines from each file before copying. \fB\fB--verbose\fR\fR .ad .RS 18n -.rt Always output filename headers. .RE @@ -231,12 +211,10 @@ Always output filename headers. The following operand is supported: .sp .ne 2 -.mk .na \fB\fB\fIfilename\fR\fR\fR .ad .RS 12n -.rt A path name of an input file. If no \fIfile\fR operands are specified, the standard input is used. .RE @@ -274,23 +252,19 @@ that affect the execution of \fBhead\fR: \fBLANG\fR, \fBLC_ALL\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -303,17 +277,16 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityCommitted +Interface Stability Committed _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .SS "ksh93" @@ -321,13 +294,12 @@ StandardSee \fBstandards\fR(5). .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilitySee below. +Interface Stability See below. .TE .sp diff --git a/usr/src/man/man1/history.1 b/usr/src/man/man1/history.1 index 78379e90a7..1edabba9a0 100644 --- a/usr/src/man/man1/history.1 +++ b/usr/src/man/man1/history.1 @@ -3,14 +3,14 @@ .\" Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved .\" Portions Copyright (c) 1982-2007 AT&T Knowledge Ventures .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 "2 Nov 2007" "SunOS 5.11" "User Commands" +.TH HISTORY 1 "Nov 2, 2007" .SH NAME history, fc, hist \- process command history list .SH SYNOPSIS @@ -105,23 +105,19 @@ Display the history list. If \fIn\fR is given, display only the \fIn\fR most recent events. .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 6n -.rt Reverse the order of printout to be most recent first rather than oldest first. .RE .sp .ne 2 -.mk .na \fB\fB-h\fR\fR .ad .RS 6n -.rt Display the history list without leading numbers. This is used to produce files suitable for sourcing using the \fB-h\fR option to the \fBcsh\fR built-in command, \fBsource\fR(1). @@ -164,7 +160,6 @@ gets executed. An event designator is a reference to a command line entry in the history list. .sp .ne 2 -.mk .na \fB\fB!\fR\fR .ad @@ -176,7 +171,6 @@ newline, \fB=\fR or \fB(\fR. .sp .ne 2 -.mk .na \fB\fB!!\fR\fR .ad @@ -188,7 +182,6 @@ previous command. .sp .ne 2 -.mk .na \fB\fB!\fR\fIn\fR\fR .ad @@ -199,7 +192,6 @@ Refer to command line \fIn\fR. .sp .ne 2 -.mk .na \fB\fB!\fR\fB-n\fR\fR .ad @@ -210,7 +202,6 @@ Refer to the current command line minus \fIn\fR. .sp .ne 2 -.mk .na \fB\fB!\fR\fIstr\fR\fR .ad @@ -221,7 +212,6 @@ Refer to the most recent command starting with \fIstr\fR. .sp .ne 2 -.mk .na \fB\fB!?\fR\fIstr\fR\fB?\fR\fR .ad @@ -232,7 +222,6 @@ Refer to the most recent command containing \fIstr\fR. .sp .ne 2 -.mk .na \fB\fB!?\fR\fIstr\fR\fB?\fR \fIadditional\fR\fR .ad @@ -244,7 +233,6 @@ Refer to the most recent command containing \fIstr\fR and append .sp .ne 2 -.mk .na \fB\fB!{\fR\fBcommand\fR\fB}\fR \fIadditional\fR\fR .ad @@ -256,7 +244,6 @@ Refer to the most recent command beginning with \fBcommand\fR and append .sp .ne 2 -.mk .na \fB\fB^\fR\fIprevious_word\fR\fB^\fR\fIreplacement\fR\fB^\fR\fR .ad @@ -297,111 +284,91 @@ word of the previous command, while \fB!!$\fR and \fB!$\fR both refer to the last word in the previous command. Word designators include: .sp .ne 2 -.mk .na \fB\fB#\fR\fR .ad .RS 10n -.rt The entire command line typed so far. .RE .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 10n -.rt The first input word (command). .RE .sp .ne 2 -.mk .na \fB\fIn\fR\fR .ad .RS 10n -.rt The \fIn\fR'th argument. .RE .sp .ne 2 -.mk .na \fB\fB^\fR\fR .ad .RS 10n -.rt The first argument, that is, \fB1\fR. .RE .sp .ne 2 -.mk .na \fB\fB$\fR\fR .ad .RS 10n -.rt The last argument. .RE .sp .ne 2 -.mk .na \fB\fB%\fR\fR .ad .RS 10n -.rt The word matched by (the most recent) \fB?\fR\fIs\fR search. .RE .sp .ne 2 -.mk .na \fB\fIx\fR\fB\(mi\fR\fIy\fR\fR .ad .RS 10n -.rt A range of words; \fB\(mi\fR\fIy\fR abbreviates \fB0\(mi\fR\fIy\fR. .RE .sp .ne 2 -.mk .na \fB\fB*\fR\fR .ad .RS 10n -.rt All the arguments, or a null value if there is just one word in the event. .RE .sp .ne 2 -.mk .na \fB\fIx\fR\fB*\fR\fR .ad .RS 10n -.rt Abbreviates \fIx\fR\fB\(mi$\fR\fI\&.\fR .RE .sp .ne 2 -.mk .na \fB\fIx\fR\fB\(mi\fR\fR .ad .RS 10n -.rt Like \fIx\fR\fB*\fR but omitting word \fB$\fR. .RE @@ -412,46 +379,38 @@ After the optional word designator, you can add a sequence of one or more of the following modifiers, each preceded by a \fB:\fR. .sp .ne 2 -.mk .na \fB\fBh\fR\fR .ad .RS 28n -.rt Remove a trailing pathname component, leaving the head. .RE .sp .ne 2 -.mk .na \fB\fBr\fR\fR .ad .RS 28n -.rt Remove a trailing suffix of the form `\fB\&.\fR\fIxxx\fR', leaving the basename. .RE .sp .ne 2 -.mk .na \fB\fBe\fR\fR .ad .RS 28n -.rt Remove all but the suffix, leaving the extension. .RE .sp .ne 2 -.mk .na \fB\fBs/\fR\fIoldchars\fR\fB/\fR\fIreplacements\fR\fB/\fR\fR .ad .RS 28n -.rt Substitute \fIreplacements\fR for \fIoldchars\fR. \fIoldchars\fR is a string that can contain embedded blank spaces, whereas \fIprevious_word\fR in the event designator can not. @@ -466,68 +425,56 @@ event designator can not. .sp .ne 2 -.mk .na \fB\fBt\fR\fR .ad .RS 28n -.rt Remove all leading pathname components, leaving the tail. .RE .sp .ne 2 -.mk .na \fB\fB&\fR\fR .ad .RS 28n -.rt Repeat the previous substitution. .RE .sp .ne 2 -.mk .na \fB\fBg\fR\fR .ad .RS 28n -.rt Apply the change to the first occurrence of a match in each word, by prefixing the above (for example, \fBg&\fR). .RE .sp .ne 2 -.mk .na \fB\fBp\fR\fR .ad .RS 28n -.rt Print the new command but do not execute it. .RE .sp .ne 2 -.mk .na \fB\fBq\fR\fR .ad .RS 28n -.rt Quote the substituted words, escaping further substitutions. .RE .sp .ne 2 -.mk .na \fB\fBx\fR\fR .ad .RS 28n -.rt Like \fBq\fR, but break into words at each space character, tab or newline. .RE @@ -609,24 +556,20 @@ listing. The flag \fB-r\fR reverses the order of the commands and the flag about command line editing.) .sp .ne 2 -.mk .na \fB\fBHISTFILE\fR\fR .ad .RS 12n -.rt If this variable is set when the shell is invoked, then the value is the pathname of the file that is used to store the command history. .RE .sp .ne 2 -.mk .na \fB\fBHISTSIZE\fR\fR .ad .RS 12n -.rt If this variable is set when the shell is invoked, then the number of previously entered commands that are accessible by this shell is greater than or equal to this number. The default is \fB128\fR. @@ -684,36 +627,30 @@ the \fBhist\fR command and the commands that are re-executed. and \fIlast\fR as one of the following: .sp .ne 2 -.mk .na \fB\fInumber\fR\fR .ad .RS 11n -.rt A positive number representing a command number. A \fB+\fR sign can precede \fInumber\fR. .RE .sp .ne 2 -.mk .na \fB\fB-\fR\fInumber\fR\fR .ad .RS 11n -.rt A negative number representing a command that was executed \fInumber\fR commands previously. For example, \fB-1\fR is the previous command. .RE .sp .ne 2 -.mk .na \fB\fIstring\fR\fR .ad .RS 11n -.rt \fIstring\fR indicates the most recently entered command that begins with \fIstring\fR. \fIstring\fR should not contain an \fB=\fR. .RE @@ -739,12 +676,10 @@ otherwise, \fBed\fR is used. The following options are supported: .sp .ne 2 -.mk .na \fB\fB\fR\fB-e\fR \fIeditor\fR\fR .ad .RS 13n -.rt Uses the editor named by \fIeditor\fR to edit the commands. The \fIeditor\fR string is a utility name, subject to search via the \fBPATH\fR variable. The value in the \fBFCEDIT\fR variable is used as a default when \fB-e\fR is not @@ -753,12 +688,10 @@ specified. If \fBFCEDIT\fR is null or unset, \fBed\fR is used as the editor. .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 13n -.rt (The letter ell.) Lists the commands rather than invoking an editor on them. The commands is written in the sequence indicated by the \fIfirst\fR and \fIlast\fR operands, as affected by \fB-r\fR, with each command preceded by the @@ -767,35 +700,29 @@ command number. .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 13n -.rt Suppresses command numbers when listing with \fB-l\fR. .RE .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 13n -.rt Reverses the order of the commands listed (with \fB-l\fR \fB)\fR or edited (with neither \fB-l\fR nor \fB-s\fR). .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 13n -.rt Re-executes the command without invoking an editor. .RE @@ -805,80 +732,66 @@ Re-executes the command without invoking an editor. \fBksh93\fR supports the following options: .sp .ne 2 -.mk .na \fB\fB-e\fR \fIeditor\fR\fR .ad .RS 13n -.rt Specify the editor to use to edit the history command. A value of \fB-\fR for \fIeditor\fR is equivalent to specifying the \fB-s\fR option. .RE .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 13n -.rt List the commands rather than editing and re-executing them. .RE .sp .ne 2 -.mk .na \fB\fB-N\fR \fInum\fR\fR .ad .RS 13n -.rt Start at \fInum\fR commands back. .RE .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 13n -.rt Suppress the command numbers when the commands are listed. .RE .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 13n -.rt Write the result of history expansion for each operand to standard output. All other options are ignored. .RE .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 13n -.rt Reverse the order of the commands. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 13n -.rt Re-execute the command without invoking an editor. In this case an operand of the form \fIold=new\fR can be specified to change the first occurrence of the string \fIold\fR in the command to \fInew\fR before re-executing the command. @@ -890,7 +803,6 @@ string \fIold\fR in the command to \fInew\fR before re-executing the command. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIfirst\fR\fR .ad @@ -899,30 +811,25 @@ The following operands are supported: \fB\fIlast\fR\fR .ad .RS 9n -.rt Selects the commands to list or edit. The number of previous commands that can be accessed is determined by the value of the \fBHISTSIZE\fR variable. The value of \fIfirst\fR or \fIlast\fR or both is one of the following: .sp .ne 2 -.mk .na \fB[\fB+\fR]\fInumber\fR\fR .ad .RS 14n -.rt A positive number representing a command number. Command numbers can be displayed with the \fB-l\fR option. .RE .sp .ne 2 -.mk .na \fB\fB\(mi\fR\fInumber\fR\fR .ad .RS 14n -.rt A negative decimal number representing the command that was executed \fInumber\fR of commands previously. For example, \fB\(mi1\fR is the immediately previous command. @@ -930,12 +837,10 @@ immediately previous command. .sp .ne 2 -.mk .na \fB\fIstring\fR\fR .ad .RS 14n -.rt A string indicating the most recently entered command that begins with that string. If the \fIold=new\fR operand is not also specified with \fB-s\fR, the string form of the \fIfirst\fR operand cannot contain an embedded equal sign. @@ -973,7 +878,7 @@ commands on the second: .sp .in +2 .nf -fc -r 10 20 fc 30 40 +fc -r 10 20 fc 30 40 fc 20 10 fc -r 40 30 .fi .in -2 @@ -991,7 +896,7 @@ For example, if there are only ten commands in the history list, numbered 1 to .sp .in +2 .nf -fc -l +fc -l fc 1 99 .fi .in -2 @@ -1002,12 +907,10 @@ lists and edits, respectively, all ten commands. .sp .ne 2 -.mk .na \fB\fIold=new\fR\fR .ad .RS 14n -.rt Replace the first occurrence of string \fIold\fR in the commands to be reexecuted by the string \fInew\fR. .RE @@ -1089,12 +992,10 @@ that affect the execution of \fBfc\fR: \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and \fBNLSPATH\fR. .sp .ne 2 -.mk .na \fB\fBFCEDIT\fR\fR .ad .RS 12n -.rt This variable, when expanded by the shell, determines the default value for the \fB-e\fR \fIeditor\fR option's \fIeditor\fR option-argument. If \fBFCEDIT\fR is null or unset, \fBed\fR(1) is used as the editor. @@ -1102,12 +1003,10 @@ null or unset, \fBed\fR(1) is used as the editor. .sp .ne 2 -.mk .na \fB\fBHISTFILE\fR\fR .ad .RS 12n -.rt Determine a pathname naming a command history file. If the \fBHISTFILE\fR variable is not set, the shell can attempt to access or create a file \fB\&.sh_history\fR in the user's home directory. If the shell cannot obtain @@ -1133,12 +1032,10 @@ take effect until another shell is invoked. .sp .ne 2 -.mk .na \fB\fBHISTSIZE\fR\fR .ad .RS 12n -.rt Determine a decimal number representing the limit to the number of previous commands that are accessible. If this variable is unset, an unspecified default greater than or equal to 128 are used. The variable \fBHISTSIZE\fR is accessed @@ -1152,23 +1049,19 @@ take effect until another shell is invoked. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion of the listing. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE diff --git a/usr/src/man/man1/hostid.1 b/usr/src/man/man1/hostid.1 index 6b1e3a6a02..fe544d7da8 100644 --- a/usr/src/man/man1/hostid.1 +++ b/usr/src/man/man1/hostid.1 @@ -3,13 +3,13 @@ .\" 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 hostid 1 "4 Feb 2009" "SunOS 5.11" "User Commands" +.TH HOSTID 1 "Feb 4, 2009" .SH NAME hostid \- print the numeric identifier of the current host .SH SYNOPSIS .LP .nf -\fB/usr/bin/hostid\fR +\fB/usr/bin/hostid\fR .fi .SH DESCRIPTION diff --git a/usr/src/man/man1/hostname.1 b/usr/src/man/man1/hostname.1 index 2458257b13..2db91762f4 100644 --- a/usr/src/man/man1/hostname.1 +++ b/usr/src/man/man1/hostname.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 hostname 1 "14 Sep 1992" "SunOS 5.11" "User Commands" +.TH HOSTNAME 1 "Sep 14, 1992" .SH NAME hostname \- set or print name of current host system .SH SYNOPSIS diff --git a/usr/src/man/man1/iconv.1 b/usr/src/man/man1/iconv.1 index 34d23cc35d..3071683444 100644 --- a/usr/src/man/man1/iconv.1 +++ b/usr/src/man/man1/iconv.1 @@ -2,14 +2,14 @@ .\" Copyright 1989 AT&T .\" Copyright (c) 2003, Sun Microsystems, Inc. All Rights Reserved .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 iconv 1 "14 Nov 2003" "SunOS 5.11" "User Commands" +.TH ICONV 1 "Nov 14, 2003" .SH NAME iconv \- code set conversion utility .SH SYNOPSIS @@ -50,12 +50,10 @@ conversion tables are provided in the \fBiconv\fR(5) manual page. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad .RS 18n -.rt Omits any characters that are invalid in the codeset of the input file from the output. When \fB-c\fR is not used, the results of encountering invalid characters in the input stream depend on the specified codesets for the @@ -70,34 +68,28 @@ specified for the \fItocodeset\fR of the \fB-t\fR option, the specification of .sp .ne 2 -.mk .na \fB\fB-f\fR \fIfromcodeset\fR\fR .ad .RS 18n -.rt Identifies the code set of the input file. The following two forms of the \fIfromcodeset\fR option-argument are recognized: .sp .ne 2 -.mk .na \fB\fIfromcode\fR\fR .ad .RS 12n -.rt -The \fIfromcode\fR option-argument must not contain a slash (\fB/\fR) +The \fIfromcode\fR option-argument must not contain a slash (\fB/\fR) character. It is interpreted as the name of one of the codeset descriptions. .RE .sp .ne 2 -.mk .na \fB\fIfrommap\fR\fR .ad .RS 12n -.rt The \fIfrommap\fR option-argument must contain a slash character. It is interpreted as the pathname of a charmap file as defined in \fBcharmap\fR(5). If the pathname does not represent a valid, readable charmap file, the results @@ -109,23 +101,19 @@ If this option is omitted, the codeset of the current locale is used. .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 18n -.rt Writes all supported \fIfromcode\fR and \fItocode\fR values to standard output. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 18n -.rt Suppresses any messages written to standard error concerning invalid characters. When \fB-s\fR is not used, the results of encountering invalid characters in the input stream depend on the specified codesets for the @@ -140,34 +128,28 @@ specified for the \fItocodeset\fR of the \fB-t\fR option, the specification of .sp .ne 2 -.mk .na \fB\fB-t\fR \fItocodeset\fR\fR .ad .RS 18n -.rt Identifies the code set used for the output file. The following two forms of the \fItocodeset\fR option-argument are recognized: .sp .ne 2 -.mk .na \fB\fItocode\fR\fR .ad .RS 10n -.rt -The \fItocode\fR option-argument must not contain a slash (\fB/\fR) character. +The \fItocode\fR option-argument must not contain a slash (\fB/\fR) character. It is interpreted as the name of one of the codeset descriptions. .RE .sp .ne 2 -.mk .na \fB\fItomap\fR\fR .ad .RS 10n -.rt The \fItomap\fR option-argument must contain a slash character. It is interpreted as the pathname of a charmap file as defined in \fBcharmap\fR(5). If the pathname does not represent a valid, readable charmap file, the results @@ -188,12 +170,10 @@ fails as an error. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIfile\fR\fR .ad .RS 8n -.rt A path name of an input file. If no file operands are specified, or if a file operand is '\fB-\fR', the standard input is used. .RE @@ -226,35 +206,29 @@ that affect the execution of \fBiconv\fR: \fBLANG\fR, \fBLC_ALL\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt An error has occurred. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB/usr/lib/iconv/iconv_data\fR\fR .ad .RS 29n -.rt list of conversions supported by conversion tables .RE @@ -266,13 +240,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man1/indxbib.1 b/usr/src/man/man1/indxbib.1 index 217e8ac09b..abb8453b8a 100644 --- a/usr/src/man/man1/indxbib.1 +++ b/usr/src/man/man1/indxbib.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 indxbib 1 "14 Sep 1992" "SunOS 5.11" "User Commands" +.TH INDXBIB 1 "Sep 14, 1992" .SH NAME indxbib \- create an inverted index to a bibliographic database .SH SYNOPSIS @@ -39,67 +39,55 @@ and numbers (dates) < 1000 or > 2099. These parameters can be changed. .SH FILES .sp .ne 2 -.mk .na \fB\fB/usr/lib/refer/mkey\fR\fR .ad .RS 23n -.rt .RE .sp .ne 2 -.mk .na \fB\fB/usr/lib/refer/inv\fR\fR .ad .RS 23n -.rt .RE .sp .ne 2 -.mk .na \fB\fIx\fR\fB\&.ia\fR\fR .ad .RS 23n -.rt entry file .RE .sp .ne 2 -.mk .na \fB\fIx\fR\fB\&.ib\fR\fR .ad .RS 23n -.rt posting file .RE .sp .ne 2 -.mk .na \fB\fIx\fR\fB\&.ic\fR\fR .ad .RS 23n -.rt tag file .RE .sp .ne 2 -.mk .na \fB\fIx\fR\fB\&.ig\fR\fR .ad .RS 23n -.rt reference file .RE diff --git a/usr/src/man/man1/ipcrm.1 b/usr/src/man/man1/ipcrm.1 index 050adf1bb4..0a7688a695 100644 --- a/usr/src/man/man1/ipcrm.1 +++ b/usr/src/man/man1/ipcrm.1 @@ -4,13 +4,13 @@ .\" 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 ipcrm 1 "9 Jan 2004" "SunOS 5.11" "User Commands" +.TH IPCRM 1 "Jan 9, 2004" .SH NAME ipcrm \- remove a message queue, semaphore set, or shared memory ID .SH SYNOPSIS .LP .nf -\fBipcrm\fR [\fB-z\fR \fIzone\fR] [\fB-m\fR \fIshmid\fR] [\fB-q\fR \fImsqid\fR] [\fB-s\fR \fIsemid\fR] +\fBipcrm\fR [\fB-z\fR \fIzone\fR] [\fB-m\fR \fIshmid\fR] [\fB-q\fR \fImsqid\fR] [\fB-s\fR \fIsemid\fR] [\fB-M\fR \fIshmkey\fR] [\fB-Q\fR \fImsgkey\fR] [\fB-S\fR \fIsemkey\fR] .fi @@ -25,12 +25,10 @@ identifiers. The following option is supported: .sp .ne 2 -.mk .na \fB\fB-z\fR \fIzone\fR\fR .ad .RS 11n -.rt Keys specified by other options refer to facilities in the specified zone (see \fBzones\fR(5)). The default is the zone in which the command is executing. This option is only useful when the command is executed in the global zone. @@ -41,12 +39,10 @@ This option is only useful when the command is executed in the global zone. The identifiers are specified by the following options: .sp .ne 2 -.mk .na \fB\fB-m\fR \fIshmid\fR\fR .ad .RS 13n -.rt Removes the shared memory identifier \fIshmid\fR from the system. The shared memory segment and data structure associated with it are destroyed after the last detach. @@ -54,36 +50,30 @@ last detach. .sp .ne 2 -.mk .na \fB\fB-q\fR \fImsqid\fR\fR .ad .RS 13n -.rt Removes the message queue identifier \fImsqid\fR from the system and destroys the message queue and data structure associated with it. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR \fIsemid\fR\fR .ad .RS 13n -.rt Removes the semaphore identifier \fIsemid\fR from the system and destroys the set of semaphores and data structure associated with it. .RE .sp .ne 2 -.mk .na \fB\fB-M\fR \fIshmkey\fR\fR .ad .RS 13n -.rt Removes the shared memory identifier, created with key \fIshmkey\fR, from the system. The shared memory segment and data structure associated with it are destroyed after the last detach. @@ -91,24 +81,20 @@ destroyed after the last detach. .sp .ne 2 -.mk .na \fB\fB-Q\fR \fImsgkey\fR\fR .ad .RS 13n -.rt Removes the message queue identifier, created with key \fImsgkey\fR, from the system and destroys the message queue and data structure associated with it. .RE .sp .ne 2 -.mk .na \fB\fB-S\fR \fIsemkey\fR\fR .ad .RS 13n -.rt Removes the semaphore identifier, created with key \fIsemkey\fR, from the system and destroys the set of semaphores and data structure associated with it. @@ -133,13 +119,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man1/ipcs.1 b/usr/src/man/man1/ipcs.1 index df29671afc..d029b52b52 100644 --- a/usr/src/man/man1/ipcs.1 +++ b/usr/src/man/man1/ipcs.1 @@ -1,10 +1,10 @@ '\" te -.\" Copyright 1989 AT&T +.\" Copyright 1989 AT&T .\" Copyright (c) 2008, 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 ipcs 1 "17 Jan 2008" "SunOS 5.11" "User Commands" +.TH IPCS 1 "Jan 17, 2008" .SH NAME ipcs \- report inter-process communication facilities status .SH SYNOPSIS @@ -27,34 +27,28 @@ the system. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-m\fR\fR .ad .RS 6n -.rt Prints information about active shared memory segments. .RE .sp .ne 2 -.mk .na \fB\fB-q\fR\fR .ad .RS 6n -.rt Prints information about active message queues. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 6n -.rt Prints information about active semaphores. .RE @@ -65,36 +59,30 @@ indicated is printed. If none of these three is specified, information about all three is printed subject to these options: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 12n -.rt Uses all XCU5 print options. (This is a shorthand notation for \fB-b\fR, \fB-c\fR, \fB-o\fR, \fB-p\fR, and \fB-t\fR.) .RE .sp .ne 2 -.mk .na \fB\fB-A\fR\fR .ad .RS 12n -.rt Uses all print options. (This is a shorthand notation for \fB-b\fR, \fB-c\fR, \fB-i\fR, \fB-J\fR, \fB-o\fR, \fB-p\fR, and \fB-t\fR.) .RE .sp .ne 2 -.mk .na \fB\fB-b\fR\fR .ad .RS 12n -.rt Prints information on biggest allowable size: maximum number of bytes in messages on queue for message queues, size of segments for shared memory, and number of semaphores in each set for semaphores. See below for meaning of @@ -103,23 +91,19 @@ columns in a listing. .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad .RS 12n -.rt Prints creator's login name and group name. See below. .RE .sp .ne 2 -.mk .na \fB\fB-D\fR \fImtype\fR\fR .ad .RS 12n -.rt Displays, in hexadecimal and \fBASCII\fR, the contents of all messages of type \fImtype\fR found on any message queue that the user invoking \fBipcs\fR has permission to read. If \fImtype\fR is \fB0\fR, all messages are displayed. If @@ -130,34 +114,28 @@ absolute value of \fImtype\fR are displayed. (See \fBmsgrcv\fR(2) and .sp .ne 2 -.mk .na \fB\fB-i\fR\fR .ad .RS 12n -.rt Prints number of \fBISM\fR attaches to shared memory segments. .RE .sp .ne 2 -.mk .na \fB\fB-J\fR\fR .ad .RS 12n -.rt Prints the creator's project. .RE .sp .ne 2 -.mk .na \fB\fB-o\fR\fR .ad .RS 12n -.rt Prints information on outstanding usage: number of messages on queue and total number of bytes in messages on queue for message queues and number of processes attached to shared memory segments. @@ -165,12 +143,10 @@ attached to shared memory segments. .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 12n -.rt Prints process number information: process \fBID\fR of last process to send a message, process \fBID\fR of last process to receive a message on message queues, process \fBID\fR of creating process, and process \fBID\fR of last @@ -179,12 +155,10 @@ process to attach or detach on shared memory segments. See below. .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad .RS 12n -.rt Prints time information: time of the last control operation that changed the access permissions for all facilities, time of last \fBmsgsnd\fR(2) and last \fBmsgrcv\fR(2) on message queues, time of last \fBshmat\fR(2) and last @@ -194,12 +168,10 @@ access permissions for all facilities, time of last \fBmsgsnd\fR(2) and last .sp .ne 2 -.mk .na \fB\fB-z\fR \fIzone\fR\fR .ad .RS 12n -.rt Prints information about facilities associated with the specified zone (see \fBzones\fR(5)). The zone can be specified as either a name or a numeric id. The default is to display information about the zone in which the command is @@ -209,12 +181,10 @@ zone. .sp .ne 2 -.mk .na \fB\fB-Z\fR\fR .ad .RS 12n -.rt When executing in the global zone, prints information about all zones. Otherwise, prints information about the zone in which the command is executing. The output includes the zone associated with each facility. @@ -229,43 +199,35 @@ appears. \fBNote:\fR These options only determine what information is provided for each facility; they do not determine which facilities are listed. .sp .ne 2 -.mk .na \fB\fBT\fR (all)\fR .ad .RS 19n -.rt Type of the facility: .sp .ne 2 -.mk .na \fB\fBq\fR\fR .ad .RS 5n -.rt message queue .RE .sp .ne 2 -.mk .na \fB\fBm\fR\fR .ad .RS 5n -.rt shared memory segment .RE .sp .ne 2 -.mk .na \fB\fBs\fR\fR .ad .RS 5n -.rt semaphore .RE @@ -273,23 +235,19 @@ semaphore .sp .ne 2 -.mk .na \fB\fBID\fR (all)\fR .ad .RS 19n -.rt The identifier for the facility entry. .RE .sp .ne 2 -.mk .na \fB\fBKEY\fR (all)\fR .ad .RS 19n -.rt The key used as an argument to \fBmsgget\fR(2), \fBsemget\fR(2), or \fBshmget\fR(2) to create the facility entry. (\fBNote:\fR The key of a shared memory segment is changed to \fBIPC_PRIVATE\fR when the segment has been @@ -298,44 +256,36 @@ removed until all processes attached to the segment detach it.) .sp .ne 2 -.mk .na \fB\fBMODE\fR (all)\fR .ad .RS 19n -.rt The facility access modes and flags: The mode consists of 11 characters that are interpreted as follows. The first two characters are: .sp .ne 2 -.mk .na \fB\fBR\fR\fR .ad .RS 5n -.rt A process is waiting on a \fBmsgrcv\fR(2). .RE .sp .ne 2 -.mk .na \fB\fBS\fR\fR .ad .RS 5n -.rt A process is waiting on a \fBmsgsnd\fR(2). .RE .sp .ne 2 -.mk .na \fB\fB-\fR\fR .ad .RS 5n -.rt The corresponding special flag is not set. .RE @@ -349,45 +299,37 @@ last character is currently unused. The permissions are indicated as follows: .sp .ne 2 -.mk .na \fB\fBr\fR\fR .ad .RS 8n -.rt Read permission is granted. .RE .sp .ne 2 -.mk .na \fB\fBw\fR\fR .ad .RS 8n -.rt Write permission is granted. .RE .sp .ne 2 -.mk .na \fB\fBa\fR\fR .ad .RS 8n -.rt Alter permission is granted. .RE .sp .ne 2 -.mk .na \fB\fB\(mi\fR\fR .ad .RS 8n -.rt The indicated permission is not granted. .RE @@ -395,260 +337,214 @@ The indicated permission is not granted. .sp .ne 2 -.mk .na \fB\fBOWNER\fR (all)\fR .ad .RS 19n -.rt The login name of the owner of the facility entry. .RE .sp .ne 2 -.mk .na \fB\fBGROUP\fR (all)\fR .ad .RS 19n -.rt The group name of the group of the owner of the facility entry. .RE .sp .ne 2 -.mk .na \fB\fBCREATOR\fR (a,A,c)\fR .ad .RS 19n -.rt The login name of the creator of the facility entry. .RE .sp .ne 2 -.mk .na \fB\fBCGROUP\fR (a,A,c)\fR .ad .RS 19n -.rt The group name of the group of the creator of the facility entry. .RE .sp .ne 2 -.mk .na \fB\fBCBYTES\fR (a,A,o)\fR .ad .RS 19n -.rt The number of bytes in messages currently outstanding on the associated message queue. .RE .sp .ne 2 -.mk .na \fB\fBQNUM\fR (a,A,o)\fR .ad .RS 19n -.rt The number of messages currently outstanding on the associated message queue. .RE .sp .ne 2 -.mk .na \fB\fBQBYTES\fR (a,A,b)\fR .ad .RS 19n -.rt The maximum number of bytes allowed in messages outstanding on the associated message queue. .RE .sp .ne 2 -.mk .na \fB\fBLSPID\fR (a,A,p)\fR .ad .RS 19n -.rt The process \fBID\fR of the last process to send a message to the associated queue. .RE .sp .ne 2 -.mk .na \fB\fBLRPID\fR (a,A,p)\fR .ad .RS 19n -.rt The process \fBID\fR of the last process to receive a message from the associated queue. .RE .sp .ne 2 -.mk .na \fB\fBSTIME\fR (a,A,t)\fR .ad .RS 19n -.rt The time the last message was sent to the associated queue. .RE .sp .ne 2 -.mk .na \fB\fBRTIME\fR (a,A,t)\fR .ad .RS 19n -.rt The time the last message was received from the associated queue. .RE .sp .ne 2 -.mk .na \fB\fBCTIME\fR (a,A,t)\fR .ad .RS 19n -.rt The time when the associated entry was created or changed. .RE .sp .ne 2 -.mk .na \fB\fBISMATTCH\fR (a,i)\fR .ad .RS 19n -.rt The number of \fBISM\fR attaches to the associated shared memory segments. .RE .sp .ne 2 -.mk .na \fB\fBNATTCH\fR (a,A,o)\fR .ad .RS 19n -.rt The number of processes attached to the associated shared memory segment. .RE .sp .ne 2 -.mk .na \fB\fBSEGSZ\fR (a,A,b)\fR .ad .RS 19n -.rt The size of the associated shared memory segment. .RE .sp .ne 2 -.mk .na \fB\fBCPID\fR (a,A,p)\fR .ad .RS 19n -.rt The process \fBID\fR of the creator of the shared memory entry. .RE .sp .ne 2 -.mk .na \fB\fBLPID\fR (a,A,p)\fR .ad .RS 19n -.rt The process \fBID\fR of the last process to attach or detach the shared memory segment. .RE .sp .ne 2 -.mk .na \fB\fBATIME\fR (a,A,t)\fR .ad .RS 19n -.rt The time the last attach was completed to the associated shared memory segment. .RE .sp .ne 2 -.mk .na \fB\fBDTIME\fR (a,A,t)\fR .ad .RS 19n -.rt The time the last detach was completed on the associated shared memory segment. .RE .sp .ne 2 -.mk .na \fB\fBNSEMS\fR (a,A,b)\fR .ad .RS 19n -.rt The number of semaphores in the set associated with the semaphore entry. .RE .sp .ne 2 -.mk .na \fB\fBOTIME\fR (a,A,t)\fR .ad .RS 19n -.rt The time the last semaphore operation was completed on the set associated with the semaphore entry. .RE .sp .ne 2 -.mk .na \fB\fBPROJECT\fR (J,A)\fR .ad .RS 19n -.rt The project name of the creator of the facility entry. .RE .sp .ne 2 -.mk .na \fB\fBZONE\fR (Z)\fR .ad .RS 19n -.rt The zone with which the facility is associated. .RE @@ -660,35 +556,29 @@ that affect the execution of \fBipcs\fR: \fBLANG\fR, \fBLC_ALL\fR, \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and \fBNLSPATH\fR. .sp .ne 2 -.mk .na \fB\fBTZ\fR\fR .ad .RS 6n -.rt Determine the timezone for the time strings written by \fBipcs\fR. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB/etc/group\fR\fR .ad .RS 15n -.rt group names .RE .sp .ne 2 -.mk .na \fB\fB/etc/passwd\fR\fR .ad .RS 15n -.rt user names .RE @@ -700,15 +590,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .SH SEE ALSO diff --git a/usr/src/man/man1/isainfo.1 b/usr/src/man/man1/isainfo.1 index e705d9a355..3ecebf30fa 100644 --- a/usr/src/man/man1/isainfo.1 +++ b/usr/src/man/man1/isainfo.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 isainfo 1 "8 Feb 2007" "SunOS 5.11" "User Commands" +.TH ISAINFO 1 "Feb 8, 2007" .SH NAME isainfo \- describe instruction set architectures .SH SYNOPSIS @@ -32,59 +32,49 @@ currently running system. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-b\fR\fR .ad .RS 6n -.rt Prints the number of bits in the address space of the native instruction set. .RE .sp .ne 2 -.mk .na \fB\fB-k\fR\fR .ad .RS 6n -.rt Prints the name of the instruction set(s) used by the operating system kernel components such as device drivers and \fBSTREAMS\fR modules. .RE .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 6n -.rt Prints the name of the native instruction set used by portable applications supported by the current version of the operating system. .RE .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 6n -.rt When used with the \fB-b\fR, \fB-k\fR or \fB-n\fR options, prints more detailed information. .RE .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad .RS 6n -.rt Prints instruction extensions to the native ABI which are supported by the platform. .RE @@ -151,12 +141,10 @@ i386: fpu tsc cx8 sep cmov mmx ammx a3dnow a3dnowx fxsr sse sse2 pause .SH EXIT STATUS .sp .ne 2 -.mk .na \fBNon-zero\fR .ad .RS 12n -.rt Options are not specified correctly, or the command is unable to recognize attributes of the system on which it is running. An error message is printed to \fBstderr\fR. diff --git a/usr/src/man/man1/isalist.1 b/usr/src/man/man1/isalist.1 index 5f406ec73e..1c18b5c47e 100644 --- a/usr/src/man/man1/isalist.1 +++ b/usr/src/man/man1/isalist.1 @@ -3,13 +3,13 @@ .\" 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 isalist 1 "20 Mar 2008" "SunOS 5.11" "User Commands" +.TH ISALIST 1 "Mar 20, 2008" .SH NAME isalist \- display the native instruction sets executable on this platform .SH SYNOPSIS .LP .nf -\fBisalist\fR +\fBisalist\fR .fi .SH DESCRIPTION diff --git a/usr/src/man/man1/jobs.1 b/usr/src/man/man1/jobs.1 index 9bb06b3cee..972b8a654f 100644 --- a/usr/src/man/man1/jobs.1 +++ b/usr/src/man/man1/jobs.1 @@ -1,16 +1,16 @@ '\" te .\" Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved -.\" Copyright 1989 AT&T +.\" Copyright 1989 AT&T .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved .\" Portions Copyright (c) 1982-2007 AT&T Knowledge Ventures -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 jobs 1 "2 Nov 2007" "SunOS 5.11" "User Commands" +.TH JOBS 1 "Nov 2, 2007" .SH NAME jobs, fg, bg, stop, notify \- control process execution .SH SYNOPSIS @@ -128,34 +128,28 @@ omitted, all jobs that are stopped or running in the background is reported. The following options modify or enhance the output of \fBjobs\fR: .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 6n -.rt Reports the process group \fBID\fR and working directory of the jobs. .RE .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 6n -.rt Reports only the process group \fBID\fR of the jobs. .RE .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad .RS 6n -.rt Replaces any \fIjob_id\fR found in \fIcommand\fR or \fIarguments\fR with the corresponding process group \fBID\fR, and then executes \fIcommand\fR passing it \fIarguments\fR. @@ -209,56 +203,46 @@ The acceptable syntax for a Job Identifier is of the form: where \fIjob_id\fR can be specified in any of the following formats: .sp .ne 2 -.mk .na \fB\fB%\fR or \fB+\fR\fR .ad .RS 13n -.rt for the current job .RE .sp .ne 2 -.mk .na \fB\fB\(mi\fR\fR .ad .RS 13n -.rt for the previous job .RE .sp .ne 2 -.mk .na \fB\fB?\fR\fI<string>\fR\fR .ad .RS 13n -.rt specify the job for which the command line uniquely contains \fIstring\fR. .RE .sp .ne 2 -.mk .na \fB\fIn\fR\fR .ad .RS 13n -.rt for job number \fIn\fR, where \fIn\fR is a job number .RE .sp .ne 2 -.mk .na \fB\fIpref\fR\fR .ad .RS 13n -.rt where \fIpref\fR is a unique prefix of the command name (for example, if the command \fBls \(mil name\fR were running in the background, it could be referred to as \fB%ls\fR); \fIpref\fR cannot contain blanks unless it is @@ -285,12 +269,10 @@ The C shell built-in, \fBjobs\fR, without an argument, lists the active jobs under job control. .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 6n -.rt List process \fBID\fRs, in addition to the normal information. .RE @@ -323,34 +305,28 @@ A reference to a job begins with a `\fB%\fR'. By itself, the percent sign refers to the current job. .sp .ne 2 -.mk .na \fB\fB%\fR \fB%+\fR \fB%%\fR\fR .ad .RS 12n -.rt The current job. .RE .sp .ne 2 -.mk .na \fB\fB%\(mi\fR\fR .ad .RS 12n -.rt The previous job. .RE .sp .ne 2 -.mk .na \fB\fB%\fR\fIj\fR\fR .ad .RS 12n -.rt Refer to job \fIj\fR as in: `\fBkill\fR \fB-9\fR \fB%\fR\fIj\fR'. \fIj\fR can be a job number, or a string that uniquely specifies the command line by which it was started; `\fBfg %vi\fR' might bring a stopped \fBvi\fR job to the @@ -359,12 +335,10 @@ foreground, for instance. .sp .ne 2 -.mk .na \fB\fB%?\fR\fIstring\fR\fR .ad .RS 12n -.rt Specify the job for which the command line uniquely contains \fIstring\fR. .RE @@ -403,12 +377,10 @@ shell execution environment. The following options modify or enhance the output of \fBjobs\fR: .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 6n -.rt (The letter ell.) Provides more information about each job listed. This information includes the job number, current job, process group \fBID\fR, state and the command that formed the job. @@ -416,23 +388,19 @@ and the command that formed the job. .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 6n -.rt Displays only jobs that have stopped or exited since last notified. .RE .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 6n -.rt Displays only the process \fBID\fRs for the process group leaders of the selected jobs. .RE @@ -473,69 +441,57 @@ There are several ways to refer to jobs in the shell. A job can be referred to by the process id of any process of the job or by one of the following: .sp .ne 2 -.mk .na \fB\fB%\fR\fInumber\fR\fR .ad .RS 12n -.rt The job with the specified number. .RE .sp .ne 2 -.mk .na \fB\fB%\fR\fIstring\fR\fR .ad .RS 12n -.rt Any job whose command line begins with \fIstring\fR; works only in the interactive mode when the history file is active. .RE .sp .ne 2 -.mk .na \fB\fB%?\fR\fIstring\fR\fR .ad .RS 12n -.rt Any job whose command line contains \fIstring\fR; works only in the interactive mode when the history file is active. .RE .sp .ne 2 -.mk .na \fB\fB%%\fR\fR .ad .RS 12n -.rt Current job. .RE .sp .ne 2 -.mk .na \fB\fB%+\fR\fR .ad .RS 12n -.rt Equivalent to \fB%%\fR. .RE .sp .ne 2 -.mk .na \fB\fB%\(mi\fR\fR .ad .RS 12n -.rt Previous job. .RE @@ -593,35 +549,29 @@ job from the list of known jobs in the current shell environment. The following options modify or enhances the output of \fBjobs\fR: .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 6n -.rt Displays process IDs after the job number in addition to the usual information. .RE .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 6n -.rt Displays only the jobs whose status has changed since the last prompt was displayed. .RE .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 6n -.rt Displays the process group leader IDs for the specified jobs. .RE @@ -631,62 +581,51 @@ Displays the process group leader IDs for the specified jobs. the following: .sp .ne 2 -.mk .na \fB\fInumber\fR\fR .ad .RS 12n -.rt The process id of \fBjob\fR. .RE .sp .ne 2 -.mk .na \fB\fB-\fR\fInumber\fR\fR .ad .RS 12n -.rt The process group id of \fBjob\fR. .RE .sp .ne 2 -.mk .na \fB\fB%\fR\fInumber\fR\fR .ad .RS 12n -.rt The job number. .RE .sp .ne 2 -.mk .na \fB\fB%\fR\fIstring\fR\fR .ad .RS 12n -.rt The job whose name begins with \fIstring\fR. .RE .sp .ne 2 -.mk .na \fB\fB%?\fR\fIstring\fR\fR .ad .RS 12n -.rt The job whose name contains \fIstring\fR. .RE .sp .ne 2 -.mk .na \fB\fB%+\fR\fR .ad @@ -695,18 +634,15 @@ The job whose name contains \fIstring\fR. \fB\fB%%\fR\fR .ad .RS 12n -.rt The current job. .RE .sp .ne 2 -.mk .na \fB\fB%-\fR\fR .ad .RS 12n -.rt The previous job. .RE @@ -741,12 +677,10 @@ lines of the form: where the fields are as follows: .sp .ne 2 -.mk .na \fB\fIcurrent\fR\fR .ad .RS 14n -.rt The character \fB+\fR identifies the job that would be used as a default for the \fBfg\fR or \fBbg\fR commands. This job can also be specified using the \fIjob_id\fR \fB%+\fR or \fB%%\fR \fB\&.\fR The character \fB\(mi\fR identifies @@ -760,12 +694,10 @@ least two suspended jobs, then the previous job is also a suspended job. .sp .ne 2 -.mk .na \fB\fIjob-number\fR\fR .ad .RS 14n -.rt A number that can be used to identify the process group to the \fBwait\fR, \fBfg\fR, \fBbg,\fR and \fBkill\fR utilities. Using these utilities, the job can be identified by prefixing the job number with \fB%\fR. @@ -773,99 +705,81 @@ can be identified by prefixing the job number with \fB%\fR. .sp .ne 2 -.mk .na \fB\fIstate\fR\fR .ad .RS 14n -.rt One of the following strings in the POSIX Locale: .sp .ne 2 -.mk .na \fB\fBRunning\fR\fR .ad .RS 20n -.rt Indicates that the job has not been suspended by a signal and has not exited. .RE .sp .ne 2 -.mk .na \fB\fBDone\fR\fR .ad .RS 20n -.rt Indicates that the job completed and returned exit status zero. .RE .sp .ne 2 -.mk .na \fB\fBDone\fR(\fIcode\fR)\fR .ad .RS 20n -.rt Indicates that the job completed normally and that it exited with the specified \fBnon-zero\fR exit status, \fIcode\fR, expressed as a decimal number. .RE .sp .ne 2 -.mk .na \fB\fBStopped\fR\fR .ad .RS 20n -.rt Indicates that the job was stopped. .RE .sp .ne 2 -.mk .na \fB\fBStopped(SIGTSTP)\fR\fR .ad .RS 20n -.rt Indicates that the job was suspended by the \fBSIGTSTP\fR signal. .RE .sp .ne 2 -.mk .na \fB\fBStopped(SIGSTOP)\fR\fR .ad .RS 20n -.rt Indicates that the job was suspended by the \fBSIGSTOP\fR signal. .RE .sp .ne 2 -.mk .na \fB\fBStopped(SIGTTIN)\fR\fR .ad .RS 20n -.rt Indicates that the job was suspended by the \fBSIGTTIN\fR signal. .RE .sp .ne 2 -.mk .na \fB\fBStopped(SIGTTOU)\fR\fR .ad .RS 20n -.rt Indicates that the job was suspended by the \fBSIGTTOU\fR signal. .RE @@ -878,12 +792,10 @@ the termination. .sp .ne 2 -.mk .na \fB\fIcommand\fR\fR .ad .RS 14n -.rt The associated command that was specified to the shell. .RE @@ -906,23 +818,19 @@ that affect the execution of \fBjobs\fR, \fBfg\fR, and \fBbg\fR: \fBLANG\fR, The following exit values are returned for \fBjobs\fR, \fBfg\fR, and \fBbg\fR: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -932,23 +840,19 @@ An error occurred. The following exit values are returned for \fBjobs\fR: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt The information for each job is written to standard output. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt One or more jobs does not exist. .RE @@ -957,23 +861,19 @@ One or more jobs does not exist. The following exit values are returned for \fBfg\fR: .sp .ne 2 -.mk .na \fB\fBexit status of last job\fR\fR .ad .RS 27n -.rt One or more jobs has been brought into the foreground. .RE .sp .ne 2 -.mk .na \fB\fBnon-zero\fR\fR .ad .RS 27n -.rt One or more jobs does not exist or has completed. .RE @@ -982,23 +882,19 @@ One or more jobs does not exist or has completed. The following exit values are returned for \fBbg\fR: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt All background jobs are started. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt One more jobs does not exist or there are no background jobs. .RE @@ -1011,15 +907,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .SS "ksh93" @@ -1027,13 +922,12 @@ StandardSee \fBstandards\fR(5). .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityUncommitted +Interface Stability Uncommitted .TE .SH SEE ALSO diff --git a/usr/src/man/man1/join.1 b/usr/src/man/man1/join.1 index 02ec2fbde8..274899a63c 100644 --- a/usr/src/man/man1/join.1 +++ b/usr/src/man/man1/join.1 @@ -1,25 +1,25 @@ '\" te .\" Copyright 1989 AT&T Copyright (c) 1992, X/Open Company Limited All Rights Reserved Portions Copyright (c) 2003, Sun Microsystems, Inc. All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 join 1 "8 Feb 2000" "SunOS 5.11" "User Commands" +.TH JOIN 1 "Feb 8, 2000" .SH NAME join \- relational database operator .SH SYNOPSIS .LP .nf -\fBjoin\fR [\fB-a\fR \fIfilenumber\fR | \fB-v\fR \fIfilenumber\fR] [\fB-1\fR \fIfieldnumber\fR] +\fBjoin\fR [\fB-a\fR \fIfilenumber\fR | \fB-v\fR \fIfilenumber\fR] [\fB-1\fR \fIfieldnumber\fR] [\fB-2\fR \fIfieldnumber\fR] [\fB-o\fR \fIlist\fR] [\fB-e\fR \fIstring\fR] [\fB-t\fR \fIchar\fR] \fIfile1\fR \fIfile2\fR .fi .LP .nf -\fBjoin\fR [\fB-a\fR \fIfilenumber\fR] [\fB-j\fR \fIfieldnumber\fR] [\fB-j1\fR \fIfieldnumber\fR] +\fBjoin\fR [\fB-a\fR \fIfilenumber\fR] [\fB-j\fR \fIfieldnumber\fR] [\fB-j1\fR \fIfieldnumber\fR] [\fB-j2\fR \fIfieldnumber\fR] [\fB-o\fR \fIlist\fR] [\fB-e\fR \fIstring\fR] [\fB-t\fR \fIchar\fR] \fIfile1\fR \fIfile2\fR .fi @@ -53,12 +53,10 @@ should be a \fB1\fR or a \fB2\fR referring to either \fIfile1\fR or \fIfile2\fR, respectively. .sp .ne 2 -.mk .na \fB\fB-a\fR \fIfilenumber\fR \fR .ad .RS 20n -.rt In addition to the normal output, produce a line for each unpairable line in file \fIfilenumber\fR, where \fIfilenumber\fR is \fB1\fR or \fB2\fR. If both \fB-a\fR \fB1\fR and \fB-a\fR \fB2\fR are specified, all unpairable lines will @@ -67,58 +65,48 @@ be output. .sp .ne 2 -.mk .na \fB\fB-e\fR \fIstring\fR \fR .ad .RS 20n -.rt Replace empty output fields in the list selected by option \fB-o\fR with the string \fIstring\fR. .RE .sp .ne 2 -.mk .na \fB\fB-j\fR \fIfieldnumber\fR \fR .ad .RS 20n -.rt Equivalent to \fB-1\fR\fIfieldnumber\fR \fB-\fR\fB2\fR\fIfieldnumber\fR. .RE .sp .ne 2 -.mk .na \fB\fB-j1\fR \fIfieldnumber\fR \fR .ad .RS 20n -.rt Equivalent to \fB-1\fR\fIfieldnumber\fR. .RE .sp .ne 2 -.mk .na \fB\fB-j2\fR \fIfieldnumber\fR \fR .ad .RS 20n -.rt Equivalent to \fB-2\fR\fIfieldnumber\fR. Fields are numbered starting with \fB1\fR. .RE .sp .ne 2 -.mk .na \fB\fB-o\fR \fIlist\fR \fR .ad .RS 20n -.rt Each output line includes the fields specified in \fIlist\fR. Fields selected by \fIlist\fR that do not appear in the input will be treated as empty output fields. (See the \fB-e\fR option.) Each element of which has the either the @@ -129,12 +117,10 @@ specifically requested. .sp .ne 2 -.mk .na \fB\fB-t\fR \fIchar\fR \fR .ad .RS 20n -.rt Use character \fIchar\fR as a separator. Every appearance of \fIchar\fR in a line is significant. The character \fIchar\fR is used as the field separator for both input and output. With this option specified, the collating term @@ -143,12 +129,10 @@ should be the same as \fBsort\fR without the \fB-b\fR option. .sp .ne 2 -.mk .na \fB\fB-v\fR \fIfilenumber\fR \fR .ad .RS 20n -.rt Instead of the default output, produce a line only for each unpairable line in \fIfilenumber\fR, where \fIfilenumber\fR is \fB1\fR or \fB2\fR. If both \fB-v\fR \fB1\fR and \fB-v\fR \fB2\fR are specified, all unpairable lines will @@ -157,24 +141,20 @@ be output. .sp .ne 2 -.mk .na \fB\fB-1\fR \fIfieldnumber\fR \fR .ad .RS 20n -.rt Join on the \fIfieldnumber\fRth field of file 1. Fields are decimal integers starting with \fB1\fR. .RE .sp .ne 2 -.mk .na \fB\fB-2\fR\fIfieldnumber\fR \fR .ad .RS 20n -.rt Join on the \fIfieldnumber\fRth field of file 2. Fields are decimal integers starting with \fB1\fR. .RE @@ -185,23 +165,19 @@ starting with \fB1\fR. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIfile1\fR \fR .ad .RS 10n -.rt .RE .sp .ne 2 -.mk .na \fB\fIfile2\fR \fR .ad .RS 10n -.rt A path name of a file to be joined. If either of the \fIfile1\fR or \fIfile2\fR operands is \fB\(mi\fR, the standard input is used in its place. .RE @@ -311,23 +287,19 @@ that affect the execution of \fBjoin\fR: \fBLANG\fR, \fBLC_ALL\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR \fR .ad .RS 7n -.rt All input files were output successfully. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR \fR .ad .RS 7n -.rt An error occurred. .RE @@ -339,15 +311,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man1/kbd.1 b/usr/src/man/man1/kbd.1 index 226c8ea660..6207323894 100644 --- a/usr/src/man/man1/kbd.1 +++ b/usr/src/man/man1/kbd.1 @@ -3,15 +3,15 @@ .\" 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 kbd 1 "29 Jan 2007" "SunOS 5.11" "User Commands" +.TH KBD 1 "Jan 29, 2007" .SH NAME kbd \- manipulate the state of keyboard, or display the type of keyboard, or change the default keyboard abort sequence effect .SH SYNOPSIS .LP .nf -\fBkbd\fR [\fB-r\fR] [\fB-t\fR ] [\fB-l\fR] [\fB-a\fR enable | disable | alternate] - [\fB-c\fR on | off] [\fB-d\fR \fIkeyboard device\fR] +\fBkbd\fR [\fB-r\fR] [\fB-t\fR ] [\fB-l\fR] [\fB-a\fR enable | disable | alternate] + [\fB-c\fR on | off] [\fB-d\fR \fIkeyboard device\fR] [\fB-D\fR \fIautorepeat delay\fR] [\fB-R\fR \fIautorepeat rate\fR] .fi @@ -251,7 +251,6 @@ frequency, run \fBkbd\fR \fB-i\fR. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-a\fR \fBenable\fR | \fBdisable\fR | \fBalternate\fR\fR .ad @@ -267,35 +266,29 @@ The default keyboard behavior can be changed using this option. The \fB-a\fR option can only be used by a super-user. .sp .ne 2 -.mk .na \fB\fBenable\fR\fR .ad .RS 13n -.rt Enables the default effect of the keyboard abort sequence (suspend the operating system and enter the debugger or the monitor). .RE .sp .ne 2 -.mk .na \fB\fBdisable\fR\fR .ad .RS 13n -.rt Disables the default/alternate effect and ignores keyboard abort sequences. .RE .sp .ne 2 -.mk .na \fB\fBalternate\fR\fR .ad .RS 13n -.rt Enables the alternate effect of the keyboard abort sequences (suspend the operating system and enter the debugger or the monitor) upon receiving the Alternate Break character sequence on the console. The Alternate Break sequence @@ -308,7 +301,6 @@ the serial console port when this value is used. .sp .ne 2 -.mk .na \fB\fB-b\fR \fBkeyboard\fR | \fBconsole\fR\fR .ad @@ -317,23 +309,19 @@ the serial console port when this value is used. Sets the beeper frequency for keyboard or console. .sp .ne 2 -.mk .na \fB\fBkeyboard\fR\fR .ad .RS 12n -.rt Set the keyboard beeper frequency to the operand in HZ. See \fBOPERANDS\fR. .RE .sp .ne 2 -.mk .na \fB\fBconsole\fR\fR .ad .RS 12n -.rt Sets the console beeper frequency to the operand in HZ. See \fBOPERANDS\fR. .RE @@ -341,7 +329,6 @@ Sets the console beeper frequency to the operand in HZ. See \fBOPERANDS\fR. .sp .ne 2 -.mk .na \fB\fB-c\fR \fBon\fR | \fBoff\fR\fR .ad @@ -350,23 +337,19 @@ Sets the console beeper frequency to the operand in HZ. See \fBOPERANDS\fR. Turns the clicking of the keyboard on or off. .sp .ne 2 -.mk .na \fB\fBon\fR\fR .ad .RS 7n -.rt Enables clicking .RE .sp .ne 2 -.mk .na \fB\fBoff\fR\fR .ad .RS 7n -.rt Disables clicking .RE @@ -374,7 +357,6 @@ Disables clicking .sp .ne 2 -.mk .na \fB\fB-d\fR \fIkeyboard device\fR\fR .ad @@ -385,7 +367,6 @@ Specifies the keyboard device being set. The default setting is \fB/dev/kbd\fR. .sp .ne 2 -.mk .na \fB\fB-D\fR \fIautorepeat delay\fR\fR .ad @@ -396,7 +377,6 @@ Sets the autorepeat delay in milliseconds. .sp .ne 2 -.mk .na \fB\fB-i\fR\fR .ad @@ -412,7 +392,6 @@ Security Rights Profile. .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad @@ -426,7 +405,6 @@ If used with -R or -D option, this option returns the value before the changes. .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad @@ -437,7 +415,6 @@ Resets the keyboard as if power-up. .sp .ne 2 -.mk .na \fB\fB-R\fR \fIautorepeat rate\fR\fR .ad @@ -448,7 +425,6 @@ Sets the autorepeat rate in milliseconds. .sp .ne 2 -.mk .na \fB\fB\fR\fB-s\fR \fB[\fR\fIlanguage\fR\fB]\fR\fR .ad @@ -463,7 +439,6 @@ prompting for the user to specify the \fIlanguage\fR. See \fBOPERANDS\fR. .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad @@ -478,12 +453,10 @@ Returns the type of the keyboard being used. The following operands are supported: .sp .ne 2 -.mk .na \fBfrequency\fR .ad .RS 13n -.rt The frequency value specified to be set in kernel. The receiver of this value is specified by the \fB-b\fR option. This value should be between 0 and 32767 otherwise will be ejected with \fBEINVAL\fR. @@ -491,12 +464,10 @@ otherwise will be ejected with \fBEINVAL\fR. .sp .ne 2 -.mk .na \fBlanguage\fR .ad .RS 13n -.rt The language specified to be set in kernel. If the language is not found, the languages supported are listed for selection. It only applies to \fB-s\fR option. @@ -605,7 +576,7 @@ example% kbd -s 7. Dutch 22. Slove \&...... -To select the keyboard layout, enter a number [default n]: +To select the keyboard layout, enter a number [default n]: example% .fi @@ -643,23 +614,19 @@ example% .SH FILES .sp .ne 2 -.mk .na \fB\fB/dev/kbd\fR\fR .ad .RS 20n -.rt Keyboard device file. .RE .sp .ne 2 -.mk .na \fB\fB/etc/default/kbd\fR\fR .ad .RS 20n -.rt Keyboard default file containing software defaults for keyboard configurations. .RE diff --git a/usr/src/man/man1/kdestroy.1 b/usr/src/man/man1/kdestroy.1 index 6abecc7897..7d37cf33dd 100644 --- a/usr/src/man/man1/kdestroy.1 +++ b/usr/src/man/man1/kdestroy.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 kdestroy 1 "30 Apr 2004" "SunOS 5.11" "User Commands" +.TH KDESTROY 1 "Apr 30, 2004" .SH NAME kdestroy \- destroy Kerberos tickets .SH SYNOPSIS @@ -37,24 +37,20 @@ file so that your tickets are destroyed automatically when you logout. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-c\fR \fIcache_name\fR\fR .ad .RS 17n -.rt Uses \fIcache_name\fR as the credentials (ticket) cache name and location. If this option is not used, the default cache name and location are used. .RE .sp .ne 2 -.mk .na \fB\fB-q\fR\fR .ad .RS 17n -.rt Runs quietly. Your terminal will not beep when \fBkdestroy\fR fails to destroy the tickets. .RE @@ -65,12 +61,10 @@ the tickets. \fBkdestroy\fR uses the following environment variable: .sp .ne 2 -.mk .na \fB\fBKRB5CCNAME\fR\fR .ad .RS 14n -.rt Location of the credentials (ticket) cache. See \fBkrb5envvar\fR(5) for syntax and details. .RE @@ -78,12 +72,10 @@ and details. .SH FILES .sp .ne 2 -.mk .na \fB\fB/tmp/krb5cc_\fIuid\fR\fR\fR .ad .RS 19n -.rt Default credentials cache (\fIuid\fR is the decimal \fBUID\fR of the user). .RE @@ -95,17 +87,16 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityEvolving +Interface Stability Evolving _ -Command argumentsEvolving +Command arguments Evolving _ -Command outputUnstable +Command output Unstable .TE .SH SEE ALSO diff --git a/usr/src/man/man1/keylogin.1 b/usr/src/man/man1/keylogin.1 index e673230c4e..2e4c46ca25 100644 --- a/usr/src/man/man1/keylogin.1 +++ b/usr/src/man/man1/keylogin.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 keylogin 1 "2 Dec 2005" "SunOS 5.11" "User Commands" +.TH KEYLOGIN 1 "Dec 2, 2005" .SH NAME keylogin \- decrypt and store secret key with keyserv .SH SYNOPSIS @@ -43,12 +43,10 @@ multiple authentication mechanisms. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 6n -.rt Update the \fB/etc/.rootkey\fR file. This file holds the unencrypted secret key of the superuser. Only the superuser can use this option. It is used so that processes running as superuser can issue authenticated requests without @@ -68,12 +66,10 @@ file. .SH FILES .sp .ne 2 -.mk .na \fB\fB/etc/.rootkey\fR\fR .ad .RS 17n -.rt superuser's secret key .RE diff --git a/usr/src/man/man1/keylogout.1 b/usr/src/man/man1/keylogout.1 index ad1354bf57..5f04f4b6ba 100644 --- a/usr/src/man/man1/keylogout.1 +++ b/usr/src/man/man1/keylogout.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 keylogout 1 "2 Dec 2005" "SunOS 5.11" "User Commands" +.TH KEYLOGOUT 1 "Dec 2, 2005" .SH NAME keylogout \- delete stored secret key with keyserv .SH SYNOPSIS @@ -36,12 +36,10 @@ no longer configured. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 6n -.rt Force \fBkeylogout\fR to delete the secret key for the superuser. By default, \fBkeylogout\fR by the superuser is disallowed because it would break all RPC services, such as \fBNFS,\fR that are started by the superuser. diff --git a/usr/src/man/man1/kill.1 b/usr/src/man/man1/kill.1 index eed72c9a34..bb0e0dc3a1 100644 --- a/usr/src/man/man1/kill.1 +++ b/usr/src/man/man1/kill.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 kill 1 "11 Aug 2009" "SunOS 5.11" "User Commands" +.TH KILL 1 "Aug 11, 2009" .SH NAME kill \- terminate or signal processes .SH SYNOPSIS @@ -69,12 +69,10 @@ See NOTES for descriptions of the shell built-in versions of \fBkill\fR. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 18n -.rt (The letter ell.) Writes all values of \fIsignal_name\fR supported by the implementation, if no operand is specified. If an \fIexit_status\fR operand is specified and it is a value of the \fB?\fR shell special parameter and @@ -87,12 +85,10 @@ to that signal is written. Otherwise, the results are unspecified. .sp .ne 2 -.mk .na \fB\fB-s\fR \fIsignal_name\fR\fR .ad .RS 18n -.rt Specifies the signal to send, using one of the symbolic names defined in the \fB<signal.h>\fR description. Values of \fIsignal_name\fR is recognized in a case-independent fashion, without the \fBSIG\fR prefix. In addition, the @@ -102,25 +98,21 @@ corresponding signal is sent instead of \fBSIGTERM\fR. .sp .ne 2 -.mk .na \fB\fB-\fR\fIsignal_name\fR\fR .ad .RS 18n -.rt Equivalent to \fB-s\fR \fIsignal_name\fR. .RE .sp .ne 2 -.mk .na \fB\fB-\fR\fIsignal_number\fR\fR .ad .RS 18n -.rt Specifies a non-negative decimal integer, \fIsignal_number\fR, representing the -signal to be used instead of \fBSIGTERM\fR, as the \fIsig\fR argument in the +signal to be used instead of \fBSIGTERM\fR, as the \fIsig\fR argument in the effective call to \fBkill\fR(2). .RE @@ -130,12 +122,10 @@ effective call to \fBkill\fR(2). The following operands are supported: .sp .ne 2 -.mk .na \fB\fIpid\fR\fR .ad .RS 15n -.rt One of the following: .RS +4 .TP @@ -160,12 +150,10 @@ supporting the job control option. .sp .ne 2 -.mk .na \fB\fIexit_status\fR\fR .ad .RS 15n -.rt A decimal integer specifying a signal number or the exit status of a process terminated by a signal. .RE @@ -279,24 +267,20 @@ that affect the execution of \fBkill\fR: \fBLANG\fR, \fBLC_ALL\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt At least one matching process was found for each \fIpid\fR operand, and the specified signal was successfully processed for at least one matching process. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -309,17 +293,16 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityCommitted +Interface Stability Committed _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .SS "ksh93" @@ -327,15 +310,14 @@ StandardSee \fBstandards\fR(5). .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityUncommitted +Interface Stability Uncommitted .TE .SH SEE ALSO @@ -391,12 +373,10 @@ or \fBHUP\fR (hangup), then the job or process is sent a \fBCONT\fR (continue) signal as well. .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 6n -.rt Lists the signal names that can be sent. .RE @@ -446,62 +426,51 @@ terminates the processes unless the signal is being caught or ignored. Specify \fIjob\fR as one of the following: .sp .ne 2 -.mk .na \fB\fInumber\fR\fR .ad .RS 12n -.rt The process id of \fIjob\fR. .RE .sp .ne 2 -.mk .na \fB\fB-\fR\fInumber\fR\fR .ad .RS 12n -.rt The process group id of \fIjob\fR. .RE .sp .ne 2 -.mk .na \fB\fB%\fR\fInumber\fR\fR .ad .RS 12n -.rt The job number. .RE .sp .ne 2 -.mk .na \fB\fB%\fR\fIstring\fR\fR .ad .RS 12n -.rt The job whose name begins with \fIstring\fR. .RE .sp .ne 2 -.mk .na \fB\fB%?\fR\fIstring\fR\fR .ad .RS 12n -.rt The job whose name contains \fIstring\fR. .RE .sp .ne 2 -.mk .na \fB\fB%+\fR\fR .ad @@ -510,18 +479,15 @@ The job whose name contains \fIstring\fR. \fB\fB%%\fR\fR .ad .RS 12n -.rt The current job. .RE .sp .ne 2 -.mk .na \fB\fB%-\fR\fR .ad .RS 12n -.rt The previous job. .RE @@ -539,111 +505,91 @@ corresponding signal number is written to standard output. If a number is specified the corresponding signal name is written to standard output. .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 14n -.rt List signal names or signal numbers rather than sending signals as described above. The \fB-n\fR and \fB-s\fR options cannot be specified. .RE .sp .ne 2 -.mk .na \fB\fB-n\fR \fIsignum\fR\fR .ad .RS 14n -.rt Specify a signal number to send. Signal numbers are not portable across platforms, except for the following: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt No signal. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 6n -.rt \fBHUP\fR .RE .sp .ne 2 -.mk .na \fB\fB2\fR\fR .ad .RS 6n -.rt \fBINT\fR .RE .sp .ne 2 -.mk .na \fB\fB3\fR\fR .ad .RS 6n -.rt \fBQUIT\fR .RE .sp .ne 2 -.mk .na \fB\fB6\fR\fR .ad .RS 6n -.rt \fBABRT\fR .RE .sp .ne 2 -.mk .na \fB\fB9\fR\fR .ad .RS 6n -.rt \fBKILL\fR .RE .sp .ne 2 -.mk .na \fB\fB14\fR\fR .ad .RS 6n -.rt \fBALRM\fR .RE .sp .ne 2 -.mk .na \fB\fB15\fR\fR .ad .RS 6n -.rt \fBTERM\fR .RE @@ -651,12 +597,10 @@ No signal. .sp .ne 2 -.mk .na \fB\fB-s\fR \fIsigname\fR\fR .ad .RS 14n -.rt Specify a signal name to send. The signal names are derived from their names in \fB<signal.h>\fR without the \fBSIG\fR prefix and are case insensitive. \fBkill\fR \fB-l\fR generates the list of signals on the current platform. @@ -667,24 +611,20 @@ Specify a signal name to send. The signal names are derived from their names in \fBkill\fR in \fBksh93\fR exits with one of the following values: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt At least one matching process was found for each job operand, and the specified signal was successfully sent to at least one matching process. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE diff --git a/usr/src/man/man1/kinit.1 b/usr/src/man/man1/kinit.1 index ce3dbcf9cf..806fe86b72 100644 --- a/usr/src/man/man1/kinit.1 +++ b/usr/src/man/man1/kinit.1 @@ -4,15 +4,15 @@ .\" 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 kinit 1 "12 Nov 2008" "SunOS 5.11" "User Commands" +.TH KINIT 1 "Nov 12, 2008" .SH NAME kinit \- obtain and cache Kerberos ticket-granting ticket .SH SYNOPSIS .LP .nf -\fB/usr/bin/kinit\fR [\fB-ARvV\fR] [\fB-p\fR | \fB-P\fR] [\fB-f\fR | \fB-F\fR] [\fB-a\fR] [\fB-c\fR \fIcache_name\fR] - [\fB-k\fR [\fB-t\fR \fIkeytab_file\fR]] [\fB-l\fR \fIlifetime\fR] - [\fB-r\fR \fIrenewable_life\fR] [\fB-s\fR \fIstart_time\fR] [\fB-S\fR \fIservice_name\fR] +\fB/usr/bin/kinit\fR [\fB-ARvV\fR] [\fB-p\fR | \fB-P\fR] [\fB-f\fR | \fB-F\fR] [\fB-a\fR] [\fB-c\fR \fIcache_name\fR] + [\fB-k\fR [\fB-t\fR \fIkeytab_file\fR]] [\fB-l\fR \fIlifetime\fR] + [\fB-r\fR \fIrenewable_life\fR] [\fB-s\fR \fIstart_time\fR] [\fB-S\fR \fIservice_name\fR] [\fIprincipal\fR] .fi @@ -52,57 +52,47 @@ you end your login session. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 24n -.rt Requests tickets with the local addresses. .RE .sp .ne 2 -.mk .na \fB\fB-A\fR\fR .ad .RS 24n -.rt Requests address-less tickets. .RE .sp .ne 2 -.mk .na \fB\fB-c\fR \fIcache_name\fR\fR .ad .RS 24n -.rt Uses \fIcache_name\fR as the credentials (ticket) cache name and location. If this option is not used, the default cache name and location are used. .RE .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 24n -.rt Requests forwardable tickets. .RE .sp .ne 2 -.mk .na \fB\fB-F\fR\fR .ad .RS 24n -.rt Not forwardable. Does not request forwardable tickets. .sp Tickets that have been acquired on one host cannot normally be used on another @@ -115,12 +105,10 @@ option allows a user to explicitly obtain a non-forwardable ticket. .sp .ne 2 -.mk .na \fB\fB-k\fR [\fB-t\fR \fIkeytab_file\fR]\fR .ad .RS 24n -.rt Requests a host ticket, obtained from a key in the local host's \fIkeytab\fR file. The name and location of the keytab file can be specified with the \fB-t\fR \fIkeytab_file\fR option. Otherwise, the default name and location is @@ -129,12 +117,10 @@ used. .sp .ne 2 -.mk .na \fB\fB-l\fR \fIlifetime\fR\fR .ad .RS 24n -.rt Requests a ticket with the lifetime \fIlifetime\fR. If the \fB-l\fR option is not specified, the default ticket lifetime (configured by each site) is used. Specifying a ticket lifetime longer than the maximum ticket lifetime @@ -174,23 +160,19 @@ Value specified in the Kerberos database for the user principal. .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 24n -.rt Requests proxiable tickets. .RE .sp .ne 2 -.mk .na \fB\fB-P\fR\fR .ad .RS 24n -.rt Not proxiable. Does not request proxiable tickets. .sp A proxiable ticket is a ticket that allows you to get a ticket for a service @@ -200,12 +182,10 @@ option allows a user to explicitly obtain a non-proxiable ticket. .sp .ne 2 -.mk .na \fB\fB-r\fR \fIrenewable_life\fR\fR .ad .RS 24n -.rt Requests renewable tickets, with a total lifetime of \fIrenewable_life\fR. See the \fBTime\fR \fBFormats\fR section for the valid time duration formats that you can specify for \fIrenewable_life\fR. See \fBkdc.conf\fR(4) and @@ -242,24 +222,20 @@ Value specified in the Kerberos database for the user principal. .sp .ne 2 -.mk .na \fB\fB-R\fR\fR .ad .RS 24n -.rt Requests renewal of the ticket-granting ticket. Notice that an expired ticket cannot be renewed, even if the ticket is still within its renewable life. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR \fIstart_time\fR\fR .ad .RS 24n -.rt Requests a postdated ticket, valid starting at \fIstart_time\fR. Postdated tickets are issued with the \fIinvalid\fR flag set, and need to be fed back to the \fBKDC\fR before use. See the \fBTime\fR \fBFormats\fR section for either @@ -270,23 +246,19 @@ trying to match a time duration. .sp .ne 2 -.mk .na \fB\fB-S\fR \fIservice_name\fR\fR .ad .RS 24n -.rt Specifies an alternate service name to use when getting initial tickets. .RE .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 24n -.rt Requests that the ticket granting ticket in the cache (with the \fIinvalid\fR flag set) be passed to the \fBKDC\fR for validation. If the ticket is within its requested time range, the cache is replaced with the validated ticket. @@ -294,24 +266,20 @@ its requested time range, the cache is replaced with the validated ticket. .sp .ne 2 -.mk .na \fB\fB-V\fR\fR .ad .RS 24n -.rt Verbose output. Displays further information to the user, such as confirmation of authentication and version. .RE .sp .ne 2 -.mk .na \fB\fB-X\fR \fB\fIattribute\fR[=\fIvalue\fR]\fR\fR .ad .RS 24n -.rt Specifies a pre-authentication attribute and value to be passed to pre-authentication plugins. The acceptable \fIattribute\fR and \fIvalue\fR values vary from pre-authentication plugin to plugin. This option can be @@ -322,12 +290,10 @@ The following attributes are recognized by the OpenSSL \fBpkinit\fR pre-authentication mechanism: .sp .ne 2 -.mk .na \fB\fBX509_user_identity=URI\fR\fR .ad .RS 27n -.rt Specifies where to find user's X509 identity information. .sp Valid URI types are \fBFILE\fR, \fBDIR\fR, \fBPKCS11\fR, \fBPKCS12\fR, and @@ -336,12 +302,10 @@ Valid URI types are \fBFILE\fR, \fBDIR\fR, \fBPKCS11\fR, \fBPKCS12\fR, and .sp .ne 2 -.mk .na \fB\fBX509_anchors=URI\fR\fR .ad .RS 27n -.rt Specifies where to find trusted X509 anchor information. .sp Valid URI types are \fBFILE\fR and \fBDIR\fR. See the\fBPKINIT URI Types\fR @@ -350,12 +314,10 @@ section for details. .sp .ne 2 -.mk .na \fB\fBflag_RSA_PROTOCOL[=yes]\fR\fR .ad .RS 27n -.rt Specifies the use of RSA, rather than the default Diffie-Hellman protoco. .RE @@ -364,7 +326,6 @@ Specifies the use of RSA, rather than the default Diffie-Hellman protoco. .SS "PKINIT URI Types" .sp .ne 2 -.mk .na \fBFILE:\fIfile-name\fR[,\fIkey-file-name\fR]\fR .ad @@ -373,12 +334,10 @@ Specifies the use of RSA, rather than the default Diffie-Hellman protoco. This option has context-specific behavior. .sp .ne 2 -.mk .na \fBX509_user_identity\fR .ad .RS 22n -.rt \fIfile-name\fR specifies the name of a PEM-format file containing the user's certificate. If \fIkey-file-name\fR is not specified, the user's private key is expected to be in \fIfile-name\fR as well. Otherwise, \fIkey-file-name\fR is @@ -387,12 +346,10 @@ the name of the file containing the private key. .sp .ne 2 -.mk .na \fBX509_anchors\fR .ad .RS 22n -.rt \fIfile-name\fR is assumed to be the name of an OpenSSL-style ca-bundle file. The \fBca-bundle\fR file should be base-64 encoded. .RE @@ -401,7 +358,6 @@ The \fBca-bundle\fR file should be base-64 encoded. .sp .ne 2 -.mk .na \fBDIR:\fIdirectory-name\fR\fR .ad @@ -410,12 +366,10 @@ The \fBca-bundle\fR file should be base-64 encoded. This option has context-specific behavior. .sp .ne 2 -.mk .na \fBX509_user_identity\fR .ad .RS 22n -.rt \fIdirectory-name\fR specifies a directory with files named \fB*.crt\fR and \fB*.key\fR, where the first part of the file name is the same for matching pairs of certificate and private key files. When a file with a name ending with @@ -426,12 +380,10 @@ contain the private key. If no such file is found, then the certificate in the .sp .ne 2 -.mk .na \fBX509_anchors\fR .ad .RS 22n -.rt \fIdirectory-name\fR is assumed to be an OpenSSL-style hashed CA directory where each CA cert is stored in a file named \fBhash-of-ca-cert.\fR\fI#\fR. This infrastructure is encouraged, but all files in the directory are examined @@ -442,7 +394,6 @@ and if they contain certificates (in PEM format), and are used. .sp .ne 2 -.mk .na \fBPKCS12:\fIpkcs12-file-name\fR\fR .ad @@ -454,7 +405,6 @@ the user's certificate and private key. .sp .ne 2 -.mk .na \fBPKCS11:[slotid=\fIslot-id\fR][:token=\fItoken-label\fR][:certid=\fIcert-id\fR][:certlabel=\fIcert-label\fR]\fR .ad @@ -472,7 +422,6 @@ particular certificate to use for \fBpkinit\fR. .sp .ne 2 -.mk .na \fBENV:\fIenvironment-variable-name\fR\fR .ad @@ -494,39 +443,36 @@ The following absolute time formats can be used for the \fB-s\fR .sp .TS -tab() box; -cw(2.75i) cw(2.75i) -lw(2.75i) lw(2.75i) -. -Absolute Time FormatExample -\fIyymmddhhmm\fR[\fIss\fR]990702133530 -\fIhhmm\fR[\fIss\fR]133530 -\fIyy\fR.\fImm\fR.\fBdd\fR.\fIhh\fR.\fImm\fR.\fIss\fR99:07:02:13:35:30 -\fIhh\fR:\fImm\fR[:\fIss\fR]13:35:30 -\fIldate\fR:\fIltime\fR07-07-99:13:35:30 -\fBdd\fR-\fImonth\fR-\fIyyyy\fR:\fIhh\fR:\fImm\fR[:\fIss\fR]02-july-1999:13:35:30 +box; +c c +l l . +Absolute Time Format Example +\fIyymmddhhmm\fR[\fIss\fR] 990702133530 +\fIhhmm\fR[\fIss\fR] 133530 +\fIyy\fR.\fImm\fR.\fBdd\fR.\fIhh\fR.\fImm\fR.\fIss\fR 99:07:02:13:35:30 +\fIhh\fR:\fImm\fR[:\fIss\fR] 13:35:30 +\fIldate\fR:\fIltime\fR 07-07-99:13:35:30 +\fBdd\fR-\fImonth\fR-\fIyyyy\fR:\fIhh\fR:\fImm\fR[:\fIss\fR] 02-july-1999:13:35:30 .TE .sp .sp .TS -tab(); -cw(2.75i) cw(2.75i) -lw(2.75i) lw(2.75i) -. -VariableDescription -\fBdd\fRday -\fIhh\fRhour (24-hour clock) -\fImm\fRminutes -\fIss\fRseconds -\fIyy\fRT{ +c c +l l . +Variable Description +\fBdd\fR day +\fIhh\fR hour (24-hour clock) +\fImm\fR minutes +\fIss\fR seconds +\fIyy\fR T{ year within century (0-68 is 2000 to 2068; 69-99 is 1969 to 1999) T} -\fIyyyy\fRyear including century -\fImonth\fRlocale's full or abbreviated month name -\fIldate\fRlocale's appropriate date representation -\fIltime\fRlocale's appropriate time representation +\fIyyyy\fR year including century +\fImonth\fR locale's full or abbreviated month name +\fIldate\fR locale's appropriate date representation +\fIltime\fR locale's appropriate time representation .TE .sp @@ -539,51 +485,46 @@ minutes, and 30 seconds. .sp .TS -tab() box; -cw(2.75i) cw(2.75i) -lw(2.75i) lw(2.75i) -. -Time Duration FormatExample -\fI#\fRd14d -\fI#\fRh7h -\fI#\fRm5m -\fI#\fRs30s -\fI#\fRd\fI#\fRh\fI#\fRm\fI#\fRs14d7h5m30s -\fI#\fRh\fI#\fRm[\fI#\fRs]7h5m30s -\fIdays\fR-\fIhh\fR:\fImm\fR:\fIss\fR14-07:05:30 -\fIhours\fR:\fImm\fR[:\fIss\fR]7:05:30 +box; +c c +l l . +Time Duration Format Example +\fI#\fRd 14d +\fI#\fRh 7h +\fI#\fRm 5m +\fI#\fRs 30s +\fI#\fRd\fI#\fRh\fI#\fRm\fI#\fRs 14d7h5m30s +\fI#\fRh\fI#\fRm[\fI#\fRs] 7h5m30s +\fIdays\fR-\fIhh\fR:\fImm\fR:\fIss\fR 14-07:05:30 +\fIhours\fR:\fImm\fR[:\fIss\fR] 7:05:30 .TE .sp .sp .TS -tab(); -cw(2.75i) cw(2.75i) -lw(2.75i) lw(2.75i) -. -DelimiterDescription -dnumber of days -hnumber of hours -mnumber of minutes -snumber of seconds +c c +l l . +Delimiter Description +d number of days +h number of hours +m number of minutes +s number of seconds .TE .sp .sp .TS -tab(); -cw(2.75i) cw(2.75i) -lw(2.75i) lw(2.75i) -. -VariableDescription -\fI#\fRnumber -\fIdays\fRnumber of days -\fIhours\fRnumber of hours -\fIhh\fRhour (24-hour clock) -\fImm\fRminutes -\fIss\fRseconds +c c +l l . +Variable Description +\fI#\fR number +\fIdays\fR number of days +\fIhours\fR number of hours +\fIhh\fR hour (24-hour clock) +\fImm\fR minutes +\fIss\fR seconds .TE .SH ENVIRONMENT VARIABLES @@ -592,12 +533,10 @@ VariableDescription \fBkinit\fR uses the following environment variable: .sp .ne 2 -.mk .na \fB\fBKRB5CCNAME\fR\fR .ad .RS 14n -.rt Location of the credentials (ticket) cache. See \fBkrb5envvar\fR(5) for syntax and details. .RE @@ -605,34 +544,28 @@ and details. .SH FILES .sp .ne 2 -.mk .na \fB\fB/tmp/krb5cc_\fIuid\fR\fR\fR .ad .RS 25n -.rt Default credentials cache (\fIuid\fR is the decimal \fBUID\fR of the user). .RE .sp .ne 2 -.mk .na \fB\fB/etc/krb5/krb5.keytab\fR\fR .ad .RS 25n -.rt Default location for the local host's \fBkeytab\fR file. .RE .sp .ne 2 -.mk .na \fB\fB/etc/krb5/krb5.conf\fR\fR .ad .RS 25n -.rt Default location for the local host's configuration file. See \fBkrb5.conf\fR(4). .RE @@ -645,13 +578,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilitySee below. +Interface Stability See below. .TE .sp diff --git a/usr/src/man/man1/klist.1 b/usr/src/man/man1/klist.1 index a026d59cc8..4c367f1fc6 100644 --- a/usr/src/man/man1/klist.1 +++ b/usr/src/man/man1/klist.1 @@ -4,14 +4,14 @@ .\" 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 klist 1 "16 Nov 2006" "SunOS 5.11" "User Commands" +.TH KLIST 1 "Nov 16, 2006" .SH NAME klist \- list currently held Kerberos tickets .SH SYNOPSIS .LP .nf -\fB/usr/bin/klist\fR [\fB-e\fR] - [ [\fB-c\fR] [\fB-f\fR] [\fB-s\fR] [\fB-a\fR [\fB-n\fR]] [\fIcache_name\fR]] +\fB/usr/bin/klist\fR [\fB-e\fR] + [ [\fB-c\fR] [\fB-f\fR] [\fB-s\fR] [\fB-a\fR [\fB-n\fR]] [\fIcache_name\fR]] [\fB-k\fR [\fB-t\fR] [\fB-K\fR] [\fIkeytab_file\fR]] .fi @@ -38,200 +38,164 @@ user. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 20n -.rt Displays list of addresses in credentials. Uses the configured nameservice to translate numeric network addresses to the associated hostname if possible. .RE .sp .ne 2 -.mk .na \fB\fB-c\fR [\fIcache_name\fR]\fR .ad .RS 20n -.rt Lists tickets held in a credentials cache. This is the default if neither \fB-c\fR nor \fB-k\fR is specified. .RE .sp .ne 2 -.mk .na \fB\fB-e\fR\fR .ad .RS 20n -.rt Displays the encryption types of the session key and the ticket for each credential in the credential cache, or each key in the keytab file. .RE .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 20n -.rt Shows the flags present in the credentials, using the following abbreviations: .sp .ne 2 -.mk .na \fBa\fR .ad .RS 5n -.rt Anonymous .RE .sp .ne 2 -.mk .na \fBA\fR .ad .RS 5n -.rt Pre-authenticated .RE .sp .ne 2 -.mk .na \fBd\fR .ad .RS 5n -.rt Post-dated .RE .sp .ne 2 -.mk .na \fBD\fR .ad .RS 5n -.rt Post-dateable .RE .sp .ne 2 -.mk .na \fBf\fR .ad .RS 5n -.rt Forwarded .RE .sp .ne 2 -.mk .na \fBF\fR .ad .RS 5n -.rt Forwardable .RE .sp .ne 2 -.mk .na \fBH\fR .ad .RS 5n -.rt Hardware authenticated .RE .sp .ne 2 -.mk .na \fBi\fR .ad .RS 5n -.rt Invalid .RE .sp .ne 2 -.mk .na \fBI\fR .ad .RS 5n -.rt Initial .RE .sp .ne 2 -.mk .na \fBO\fR .ad .RS 5n -.rt Okay as delegate .RE .sp .ne 2 -.mk .na \fBp\fR .ad .RS 5n -.rt Proxy .RE .sp .ne 2 -.mk .na \fBP\fR .ad .RS 5n -.rt Proxiable .RE .sp .ne 2 -.mk .na \fBR\fR .ad .RS 5n -.rt Renewable .RE .sp .ne 2 -.mk .na \fBT\fR .ad .RS 5n -.rt Transit policy checked .RE @@ -239,47 +203,39 @@ Transit policy checked .sp .ne 2 -.mk .na \fB\fB-k\fR [\fIkeytab_file\fR]\fR .ad .RS 20n -.rt List keys held in a \fBkeytab\fR file. .RE .sp .ne 2 -.mk .na \fB\fB-K\fR\fR .ad .RS 20n -.rt Displays the value of the encryption key in each keytab entry in the keytab file. .RE .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 20n -.rt Shows numeric \fBIP\fR addresses instead of reverse-resolving addresses. Only valid with \fB-a\fR option. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 20n -.rt Causes \fBklist\fR to run silently (produce no output), but to still set the exit status according to whether it finds the credentials cache. The exit status is \fB0\fR if \fBklist\fR finds a credentials cache, and `\fB1\fRif it @@ -288,12 +244,10 @@ does not, or if the local-realm TGT has expired. .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad .RS 20n -.rt Displays the time entry timestamps for each keytab entry in the keytab file. .RE @@ -303,12 +257,10 @@ Displays the time entry timestamps for each keytab entry in the keytab file. \fBklist\fR uses the following environment variable: .sp .ne 2 -.mk .na \fB\fBKRB5CCNAME\fR\fR .ad .RS 14n -.rt Location of the credentials (ticket) cache. See \fBkrb5envvar\fR(5) for syntax and details. .RE @@ -316,34 +268,28 @@ and details. .SH FILES .sp .ne 2 -.mk .na \fB\fB/tmp/krb5cc_\fIuid\fR\fR\fR .ad .RS 25n -.rt Default credentials cache (\fIuid\fR is the decimal \fBUID\fR of the user). .RE .sp .ne 2 -.mk .na \fB\fB/etc/krb5/krb5.keytab\fR\fR .ad .RS 25n -.rt Default location for the local host's \fBkeytab\fR file. .RE .sp .ne 2 -.mk .na \fB\fB/etc/krb5/krb5.conf\fR\fR .ad .RS 25n -.rt Default location for the local host's configuration file. See \fBkrb5.conf\fR(4). .RE @@ -356,13 +302,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilitySee below. +Interface Stability See below. .TE .sp diff --git a/usr/src/man/man1/kmdb.1 b/usr/src/man/man1/kmdb.1 index db004bb384..c688045b59 100644 --- a/usr/src/man/man1/kmdb.1 +++ b/usr/src/man/man1/kmdb.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 kmdb 1 "3 May 2007" "SunOS 5.11" "User Commands" +.TH KMDB 1 "May 3, 2007" .SH NAME kmdb \- in situ kernel debugger .SH SYNOPSIS @@ -53,12 +53,10 @@ functionality implemented by \fBkmdb\fR, see the \fBmdb\fR(1) man page and the .SS "Loading and Unloading" .sp .ne 2 -.mk .na \fBBoot-time Loading\fR .ad .RS 21n -.rt When requested, the kernel runtime linker (\fBkrtld\fR) loads \fBkmdb\fR prior to the transfer of control to the kernel. If the \fB-d\fR flag is used, the debugger gains control of the system prior to the execution of the initial @@ -80,12 +78,10 @@ are available. .sp .ne 2 -.mk .na \fBRun-time Loading\fR .ad .RS 21n -.rt \fBkmdb\fR can also be loaded after the system has booted, using the \fB-K\fR flag to \fBmdb\fR(1). When loaded in this fashion, it will immediately gain control of the system. Run-time-loaded \fBkmdb\fR can be unloaded using the @@ -95,12 +91,10 @@ flag to the \fB::quit dcmd\fR. .sp .ne 2 -.mk .na \fBTerminal types\fR .ad .RS 21n -.rt When loaded, \fBkmdb\fR attempts to determine the proper terminal type in use on the system console. If the system being debugged has an attached keyboard and local display that are both used for the system console, \fBkmdb\fR uses @@ -207,7 +201,6 @@ This section lists dcmds that are unique to \fBkmdb\fR or those with behavior that differs in \fBkmdb\fR as compared to \fBmdb\fR(1). .sp .ne 2 -.mk .na \fB\fB[\fR\fIaddress\fR]\fB::bp [+/-dDestT]\fR [\fB-c\fR \fIcmd\fR] [\fB-n\fR \fIcount\fR] \fIsym\fR ...\fR @@ -241,7 +234,6 @@ meta-characters, it must be quoted. .sp .ne 2 -.mk .na \fB\fB::branches\fR [\fB-v\fR]\fR .ad @@ -261,7 +253,6 @@ displayed. .sp .ne 2 -.mk .na \fB[\fIfunction\fR] \fB::call\fR [\fIarg\fR [\fIarg\fR ...]]\fR .ad @@ -282,7 +273,6 @@ affected. .sp .ne 2 -.mk .na \fB[\fIaddr\fR] \fB::cpuregs\fR [\fB-c\fR \fIcpuid\fR]\fR .ad @@ -294,7 +284,6 @@ format used by \fB::regs\fR. .sp .ne 2 -.mk .na \fB[\fIaddr\fR] \fB::cpustack\fR [\fB-c\fR \fIcpuid\fR]\fR .ad @@ -306,7 +295,6 @@ the point at which the specified CPU entered or was stopped by the debugger. .sp .ne 2 -.mk .na \fB\fIaddr\fR[,\fIlen\fR] \fB::in\fR [\fB-L\fR \fIlen\fR]\fR .ad @@ -324,7 +312,6 @@ the same alignment as the length. .sp .ne 2 -.mk .na \fB\fIaddr\fR[,\fIlen\fR] \fB::out\fR [\fB-L\fR \fIlen\fR] \fIvalue\fR\fR .ad @@ -342,7 +329,6 @@ the same alignment as the length. .sp .ne 2 -.mk .na \fB\fB::quit\fR [\fB-u\fR]\fR .ad @@ -362,7 +348,6 @@ requests permission to reboot the machine. .sp .ne 2 -.mk .na \fB\fB::step [over|out|branch]\fR\fR .ad @@ -385,7 +370,6 @@ debugger, a message to that effect is printed and the step will fail. .sp .ne 2 -.mk .na \fB\fBcpuid::switch\fR\fR .ad @@ -403,7 +387,6 @@ representative CPU. .sp .ne 2 -.mk .na \fB\fB::term\fR\fR .ad @@ -414,7 +397,6 @@ Display the current terminal type. .sp .ne 2 -.mk .na \fB\fIaddr\fR\fB[,\fR\fIlen\fR]\fB::wp [+/-dDestT]\fR [\fB-rwx\fR] [\fB-pi\fR] [\fB-n\fR \fIcount\fR] [\fB-c\fR \fIcmd\fR]\fR @@ -463,13 +445,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityEvolving +Interface Stability Evolving .TE .SH SEE ALSO diff --git a/usr/src/man/man1/kmfcfg.1 b/usr/src/man/man1/kmfcfg.1 index 5ff293370f..c42643c270 100644 --- a/usr/src/man/man1/kmfcfg.1 +++ b/usr/src/man/man1/kmfcfg.1 @@ -3,13 +3,13 @@ .\" 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 kmfcfg 1 "3 Feb 2009" "SunOS 5.11" "User Commands" +.TH KMFCFG 1 "Feb 3, 2009" .SH NAME kmfcfg \- Key Management Policy and Plugin Configuration Utility .SH SYNOPSIS .LP .nf -\fBkmfcfg\fR \fIsubcommand\fR [\fIoption\fR ...] +\fBkmfcfg\fR \fIsubcommand\fR [\fIoption\fR ...] .fi .SH DESCRIPTION @@ -33,7 +33,6 @@ information, install or uninstall a KMF plugin, and modify the plugin option. The following subcommands are supported: .sp .ne 2 -.mk .na \fB\fBcreate\fR\fR .ad @@ -82,7 +81,6 @@ create [dbfile=\fIdbfile\fR] policy=\fIpolicyname\fR The \fBcreate\fR subcommand supports the following options: .sp .ne 2 -.mk .na \fB\fBcrl-basefilename=\fR\fIfilename\fR\fR .ad @@ -112,7 +110,6 @@ file-based CRL plugins are \fBfile\fR and \fBpkcs11\fR keystores. For the .sp .ne 2 -.mk .na \fB\fBcrl-get-crl-uri=true | false\fR\fR .ad @@ -127,7 +124,6 @@ The default for this attribute is \fBfalse\fR. .sp .ne 2 -.mk .na \fB\fBcrl-ignore-crl-date=true | false\fR\fR .ad @@ -141,7 +137,6 @@ The default for this attribute is \fBfalse\fR. .sp .ne 2 -.mk .na \fB\fBcrl-ignore-crl-sign=true | false\fR\fR .ad @@ -155,7 +150,6 @@ The default for this attribute is \fBfalse\fR. .sp .ne 2 -.mk .na \fB\fBcrl-proxy=\fR \fIURL\fR\fR .ad @@ -171,7 +165,6 @@ value is \fB8080\fR. An example \fBcrl-proxy\fR setting might be: .sp .ne 2 -.mk .na \fB\fBdbfile=\fR\fIdbfile\fR\fR .ad @@ -183,7 +176,6 @@ KMF policy database file \fB/etc/security/kmfpolicy.xml\fR. .sp .ne 2 -.mk .na \fB\fBekuoids=\fR\fIEKUOIDS\fR\fR .ad @@ -197,7 +189,6 @@ example, \fB1.2.3.4\fR. An example \fBekuoids\fR setting might be: .sp .ne 2 -.mk .na \fB\fBekunames=\fR\fIEKUNAMES\fR\fR .ad @@ -218,7 +209,6 @@ attribute is set, then the extended key usage checking is turned on. .sp .ne 2 -.mk .na \fB\fBignore-date=true | false\fR\fR .ad @@ -231,7 +221,6 @@ periods defined in the certificates when evaluating their validity. .sp .ne 2 -.mk .na \fB\fBignore-unknown-eku=true | false\fR\fR .ad @@ -244,7 +233,6 @@ in the Extended Key Usage extension. .sp .ne 2 -.mk .na \fB\fBignore-trust-anchor=true | false\fR\fR .ad @@ -258,7 +246,6 @@ validation. .sp .ne 2 -.mk .na \fB\fBkeyusage=\fR\fIKUVALUES\fR\fR .ad @@ -273,7 +260,6 @@ being defined. The list of values allowed are: \fBdigitalSignature\fR, .sp .ne 2 -.mk .na \fB\fBocsp-ignore-response-sign=true | false\fR\fR .ad @@ -285,7 +271,6 @@ not verified. This attribute value is default to \fBfalse\fR. .sp .ne 2 -.mk .na \fB\fBocsp-proxy=\fR\fIURL\fR\fR .ad @@ -298,7 +283,6 @@ the port number is not specified, the default value is 8080. An example .sp .ne 2 -.mk .na \fB\fBocsp-response-lifetime=\fR\fItimelimit\fR\fR .ad @@ -312,7 +296,6 @@ be:\fBocsp-response-lifetime=6-hour\fR. .sp .ne 2 -.mk .na \fB\fBocsp-responder-cert-name=\fR\fIIssuerDN\fR\fR .ad @@ -334,7 +317,6 @@ be provided. .sp .ne 2 -.mk .na \fB\fBocsp-responder=\fR\fIURL\fR\fR .ad @@ -346,7 +328,6 @@ example, \fBocsp-responder=http://ocsp.verisign.com/ocsp/status\fR .sp .ne 2 -.mk .na \fBo\fBcsp-use-cert-responder=true | fals\fRe\fR .ad @@ -358,7 +339,6 @@ itself if possible. .sp .ne 2 -.mk .na \fB\fBpolicy=\fR\fIpolicyname\fR\fR .ad @@ -369,7 +349,6 @@ The policy record to be created. \fIpolicyname\fR is required. .sp .ne 2 -.mk .na \fB\fBvalidity-adjusttime=\fR\fIadjusttime\fR\fR .ad @@ -396,7 +375,6 @@ is false. .sp .ne 2 -.mk .na \fB\fBdelete\fR\fR .ad @@ -417,12 +395,10 @@ delete [dbfile=\fIdbfile\fR] policy=\fIpolicyname\fR The \fBdelete\fR subcommand supports the following options: .sp .ne 2 -.mk .na \fBdbfile=\fIdbfile\fR\fR .ad .RS 21n -.rt Read policy definitions from the indicated file. If \fIdbfile\fR is not specified, , the default is the system KMF policy database file: \fB/etc/security/kmfpolicy.xml\fR. @@ -430,12 +406,10 @@ specified, , the default is the system KMF policy database file: .sp .ne 2 -.mk .na \fBpolicy=\fIpolicyname\fR\fR .ad .RS 21n -.rt The name of the policy to delete. \fIpolicyname\fR is required, if using the system database. .RE @@ -444,7 +418,6 @@ system database. .sp .ne 2 -.mk .na \fB\fBexport\fR\fR .ad @@ -464,12 +437,10 @@ kmfcfg export policy=\fIpolicyname\fR outfile=\fInewdbfile\fR [dbfile=\fIdbfile\ The \fBexport\fR subcommand supports the following options: .sp .ne 2 -.mk .na \fBdbfile=\fIdbfile\fR\fR .ad .RS 24n -.rt The DB file where the exported policy is read. If \fIdbfile\fR is not specified, the default is the system KMF policy database file: \fB/etc/security/kmfpolicy.xml\fR. @@ -477,23 +448,19 @@ specified, the default is the system KMF policy database file: .sp .ne 2 -.mk .na \fBoutfile=\fIoutputdbfile\fR\fR .ad .RS 24n -.rt The DB file where the exported policy is stored. .RE .sp .ne 2 -.mk .na \fBpolicy=\fIpolicyname\fR\fR .ad .RS 24n -.rt The policy record to be exported. .RE @@ -501,7 +468,6 @@ The policy record to be exported. .sp .ne 2 -.mk .na \fB\fBhelp\fR\fR .ad @@ -522,7 +488,6 @@ help .sp .ne 2 -.mk .na \fB\fBimport\fR\fR .ad @@ -542,34 +507,28 @@ kmfcfg import policy=\fIpolicyname\fR infile=\fIinputdbfile\fR [dbfile=\fIdbfile The \fBimport\fR subcommand supports the following options: .sp .ne 2 -.mk .na \fBpolicy=\fIpolicyname\fR\fR .ad .RS 22n -.rt The policy record to be imported. .RE .sp .ne 2 -.mk .na \fBinfile=\fIinputdbfile\fR\fR .ad .RS 22n -.rt The DB file to read the policy from. .RE .sp .ne 2 -.mk .na \fBdbfile=\fIoutdbfile\fR\fR .ad .RS 22n -.rt The DB file to add the new policy. If not specified, the default is the system KMF policy database file \fB/etc/security/kmfpolicy.xml\fR. .RE @@ -578,7 +537,6 @@ KMF policy database file \fB/etc/security/kmfpolicy.xml\fR. .sp .ne 2 -.mk .na \fB\fBlist\fR\fR .ad @@ -599,24 +557,20 @@ list [dbfile=\fIdbfile\fR] [policy=\fIpolicyname\fR] The \fBlist\fR subcommand supports the following options: .sp .ne 2 -.mk .na \fBdbfile=\fIdbfile\fR\fR .ad .RS 21n -.rt Reads policy definitions from the indicated file. If not specified, the default is the system KMF policy database file \fB/etc/security/kmfpolicy.xml\fR. .RE .sp .ne 2 -.mk .na \fBpolicy=\fIpolicyname\fR\fR .ad .RS 21n -.rt Only display policy definition for the named policy. .RE @@ -624,7 +578,6 @@ Only display policy definition for the named policy. .sp .ne 2 -.mk .na \fB\fBmodify\fR\fR .ad @@ -682,36 +635,30 @@ subcommand. The \fBmodify\fR subcommand supports the following unique options: .sp .ne 2 -.mk .na \fB\fBcrl-none=true | false\fR\fR .ad .RS 30n -.rt If \fBcrl-none\fR is set to \fBtrue\fR, CRL checking is turned off. If this attribute is set to \fBtrue\fR, other CRL attributes cannot be set. .RE .sp .ne 2 -.mk .na \fBdfile=[\fIdbfile\fR]\fR .ad .RS 30n -.rt The database file to modify a policy. If not specified, the default is the system KMF policy database file \fB/etc/security/kmfpolicy.xml\fR. .RE .sp .ne 2 -.mk .na \fBeku-none=true | false\fR .ad .RS 30n -.rt If \fBeku-none\fR is set to \fBtrue\fR, extended key usage checking is turned off. The extended key usage attributes, \fBekuname\fR and \fBekuoids\fR cannot be set at the same time if \fBeku-none\fR is set to \fBtrue\fR. @@ -719,12 +666,10 @@ be set at the same time if \fBeku-none\fR is set to \fBtrue\fR. .sp .ne 2 -.mk .na \fBkeyusage-none=true | false\fR .ad .RS 30n -.rt If \fBkeyusage-none\fR is set to true, key usage checking is turned off. .sp The \fBkeyusage\fR attribute cannot be set at the same time if this attribute @@ -733,24 +678,20 @@ is set to \fBtrue\fR. .sp .ne 2 -.mk .na \fBocsp-none=true | false\fR .ad .RS 30n -.rt If \fBocsp-none\fR is set to true, OCSP checking is turned off. Any other OCSP attribute is not set at the same time if this attribute is set to \fBtrue\fR. .RE .sp .ne 2 -.mk .na \fBpolicy=\fIpolicyname\fR\fR .ad .RS 30n -.rt The name of the policy to modify. \fIpolicyname\fR is required. The \fBdefault\fR policy in the system KMF policy database cannot be modified. .RE @@ -760,7 +701,6 @@ The \fBdefault\fR policy in the system KMF policy database cannot be modified. .SS "Plugin Subcommands" .sp .ne 2 -.mk .na \fB\fBinstall keystore=\fR\fIkeystore_name\fR \fBmodulepath=\fR\fIpathname\fR\e \fB[option=\fR\fIoption_str\fR\fB]\fR\fR @@ -777,7 +717,6 @@ the calling program's instruction set architecture. .sp .ne 2 -.mk .na \fB\fBlist plugin\fR\fR .ad @@ -791,7 +730,6 @@ as described in the \fBSUBCOMMANDS\fR section. .sp .ne 2 -.mk .na \fB\fBmodify plugin keystore=\fR\fIkeystore_name\fR \fBoption=\fR\fIoption_str\fR\fR @@ -808,7 +746,6 @@ configuration as described in the \fBSUBCOMMANDS\fR section. .sp .ne 2 -.mk .na \fB\fBuninstall keystore=\fR\fIkeystore_name\fR\fR .ad @@ -842,30 +779,25 @@ ekuname=ipsecTunnel,ipsecUser The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB/etc/security/kmfpolicy.xml\fR\fR .ad @@ -882,13 +814,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityUncommitted +Interface Stability Uncommitted .TE .SH SEE ALSO diff --git a/usr/src/man/man1/kpasswd.1 b/usr/src/man/man1/kpasswd.1 index 0ca557784a..52b43b7a0f 100644 --- a/usr/src/man/man1/kpasswd.1 +++ b/usr/src/man/man1/kpasswd.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 kpasswd 1 "30 Jul 2001" "SunOS 5.11" "User Commands" +.TH KPASSWD 1 "Jul 30, 2001" .SH NAME kpasswd \- change a user's Kerberos password .SH SYNOPSIS @@ -33,12 +33,10 @@ numbers, punctuation, and all other characters.) The following operand is supported: .sp .ne 2 -.mk .na \fB\fIprincipal\fR\fR .ad .RS 13n -.rt Change the password for the Kerberos principal \fIprincipal\fR. Otherwise, the principal is derived from the identity of the user invoking the \fBkpasswd\fR command. @@ -47,12 +45,10 @@ command. .SH FILES .sp .ne 2 -.mk .na \fB\fB/tmp/ovsec_adm.\fIxxxxxx\fR\fR\fR .ad .RS 25n -.rt Temporary credentials cache for the lifetime of the password changing operation. (\fIxxxxxx\fR is a random string.) .RE @@ -65,13 +61,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled .TE .SH SEE ALSO diff --git a/usr/src/man/man1/krb5-config.1 b/usr/src/man/man1/krb5-config.1 index 4fdd886015..cdd2889c9d 100644 --- a/usr/src/man/man1/krb5-config.1 +++ b/usr/src/man/man1/krb5-config.1 @@ -3,14 +3,14 @@ .\" 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 krb5-config 1 "24 Aug 2009" "SunOS 5.11" "User Commands" +.TH KRB5-CONFIG 1 "Aug 24, 2009" .SH NAME krb5-config \- link against the installed Kerberos libraries .SH SYNOPSIS .LP .nf -\fBkrb5-config\fR - [\fB--all\fR | \fB--cflags\fR | \fB--exec-prefix\fR | \fB--help\fR | \fB--libs\fR \fIlibrary\fR | +\fBkrb5-config\fR + [\fB--all\fR | \fB--cflags\fR | \fB--exec-prefix\fR | \fB--help\fR | \fB--libs\fR \fIlibrary\fR | \fB--prefix\fR | \fB--vendor\fR | \fB--version\fR] .fi @@ -25,45 +25,37 @@ compile and link programs against the installed Kerberos libraries. The following options are supported: .sp .ne 2 -.mk .na \fB\fB--all\fR\fR .ad .RS 18n -.rt Displays the version, vendor, prefix and \fBexec-prefix\fR. .RE .sp .ne 2 -.mk .na \fB\fB--cflags\fR\fR .ad .RS 18n -.rt Displays the compiler flags with which Kerberos was built. .RE .sp .ne 2 -.mk .na \fB\fB--exec-prefix\fR\fR .ad .RS 18n -.rt Displays the \fBexec-prefix\fR with which Kerberos was built. .RE .sp .ne 2 -.mk .na \fB\fB--help\fR\fR .ad .RS 18n -.rt Displays the usage message. .sp This is the default. @@ -71,23 +63,19 @@ This is the default. .sp .ne 2 -.mk .na \fB\fB--libs\fR \fIlibrary\fR\fR .ad .RS 18n -.rt Displays compiler options required to link with \fIlibrary\fR. .sp The following \fIlibrary\fR values are supported: .sp .ne 2 -.mk .na \fB\fBkrb5\fR\fR .ad .RS 8n -.rt Kerberos 5 application .RE @@ -95,34 +83,28 @@ Kerberos 5 application .sp .ne 2 -.mk .na \fB\fB--prefix\fR\fR .ad .RS 18n -.rt Displays the prefix with which Kerberos was built. .RE .sp .ne 2 -.mk .na \fB\fB--vendor\fR\fR .ad .RS 18n -.rt Displays the vendor of the installed Kerberos implementation. .RE .sp .ne 2 -.mk .na \fB\fB--version\fR\fR .ad .RS 18n -.rt Displays the version of the installed Kerberos implementation. .RE @@ -165,23 +147,19 @@ The following example shows the C compiler options needed to link against The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB>\fB0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -193,13 +171,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityVolatile +Interface Stability Volatile .TE .SH SEE ALSO diff --git a/usr/src/man/man1/ksh93.1 b/usr/src/man/man1/ksh93.1 index af325bc61c..1b1d0f618e 100644 --- a/usr/src/man/man1/ksh93.1 +++ b/usr/src/man/man1/ksh93.1 @@ -2,7 +2,7 @@ .\" Copyright (c) 1982-2007 AT&T Knowledge Ventures .\" To view license terms, see http://www.opensource.org/licenses/cpl1.0.txt .\" Portions Copyright (c) 2009, Sun Microsystems, Inc. -.TH ksh93 1 "11 Aug sam2009" "SunOS 5.11" "User Commands" +.TH KSH93 1 "Aug 11, 2009" .SH NAME ksh93, rksh93 \- Korn Shell, a standard and restricted command and programming language @@ -131,7 +131,6 @@ list. Unless otherwise stated, the value returned by a command is that of the last simple-command executed in the command. .sp .ne 2 -.mk .na \fB\fBfor\fR \fIvname\fR \fB[ in\fR \fIword\fR \fB\&... ] ;do\fR \fIlist\fR \fB;done\fR\fR @@ -147,7 +146,6 @@ there are no more words in the list. See \fBParameter Expansion\fR. .sp .ne 2 -.mk .na \fB\fB(( [\fR\fIexpr1\fR\fB] ; [\fR\fIexpr2\fR] ; [\fIexpr3\fR\fB] )) ;do\fR \fIlist\fR \fB;done\fR\fR @@ -163,7 +161,6 @@ evaluated to \fB1\fR. See \fBArithmetic Evaluation\fR. .sp .ne 2 -.mk .na \fB\fBselect\fR \fIvname\fR [ in \fIword\fR \fB\&... ] ;do\fR \fIlist\fR \fB;done\fR\fR @@ -187,7 +184,6 @@ displaying the \fBPS3\fR prompt for the next selection. .sp .ne 2 -.mk .na \fB\fBcase\fR \fIword\fR \fBin [ [(]\fR \fIpattern\fR \fB[ |\fR \fIpattern\fR \fB] ... )\fR \fIlist\fR \fB;; ] ... esac\fR\fR @@ -204,7 +200,6 @@ is used in place of \fB;;\fR the next subsequent list, if any, is executed. .sp .ne 2 -.mk .na \fB\fBif\fR \fIlist\fR \fB;then\fR \fIlist\fR \fB[ ;elif\fR \fIlist\fR \fB;then\fR \fIlist\fR ] \fB\&... [ ;else\fR \fIlist\fR \fB]\fR \fB;fi\fR\fR @@ -223,7 +218,6 @@ exit status. .sp .ne 2 -.mk .na \fB\fBwhile\fR \fIlist\fR \fB;do\fR \fIlist\fR \fB;done\fR\fR .ad @@ -243,7 +237,6 @@ termination test. .sp .ne 2 -.mk .na \fB\fB((\fR\fIexpression\fR\fB))\fR\fR .ad @@ -257,7 +250,6 @@ described in this manual page. If the value of the arithmetic expression is .sp .ne 2 -.mk .na \fB\fB(\fR\fIlist\fR\fB;)\fR\fR .ad @@ -274,7 +266,6 @@ a line or after a \fB;\fR to be recognized. .sp .ne 2 -.mk .na \fB\fB[[\fR \fIexpression\fR \fB]]\fR\fR .ad @@ -287,7 +278,6 @@ of \fIexpression\fR. .sp .ne 2 -.mk .na \fB\fBfunction\fR \fIvarname\fR \fB{\fR \fIlist\fR \fB;}\fR\fR .ad @@ -311,7 +301,6 @@ it. See \fBFunctions\fR. .sp .ne 2 -.mk .na \fB\fBtime [\fR \fIpipeline\fR \fB]\fR\fR .ad @@ -409,7 +398,6 @@ to the \fBtypeset\fR, \fBexport\fR, or \fBreadonly\fR special built-in commands. The syntax for an \fIassignment\fR is of the form: .sp .ne 2 -.mk .na \fB\fIvarname\fR\fB=\fR\fIword\fR\fR .ad @@ -425,7 +413,6 @@ and \fIword\fR. .sp .ne 2 -.mk .na \fB\fIvarname\fR\fB=(\fR\fIassignlist\fR\fB)\fR\fR .ad @@ -435,7 +422,6 @@ No space is permitted between \fIvarname\fR and the \fB=\fR. An \fIassignlist\fR can be one of the following: .sp .ne 2 -.mk .na \fB\fIword ...\fR\fR .ad @@ -446,7 +432,6 @@ Indexed array assignment. .sp .ne 2 -.mk .na \fB\fB[\fR\fIword\fR\fB]=\fR\fIword ...\fR\fR .ad @@ -458,7 +443,6 @@ indexed array instead. .sp .ne 2 -.mk .na \fB\fIassignment ...\fR\fR .ad @@ -475,7 +459,6 @@ elements to be defined. .sp .ne 2 -.mk .na \fB\fBtypeset [\fR\fIoptions\fR] \fIassignment\fR \fB\&...\fR\fR .ad @@ -710,7 +693,6 @@ argument zero when the shell is invoked. The character \fB$\fR is used to introduce substitutable parameters. .sp .ne 2 -.mk .na \fB\fB${\fR\fIparameter\fR\fB}\fR\fR .ad @@ -732,7 +714,6 @@ is substituted, separated by the first character of the value of \fBIFS\fR. .sp .ne 2 -.mk .na \fB\fB${#\fR\fIparameter\fR\fB}\fR\fR .ad @@ -745,7 +726,6 @@ substituted. .sp .ne 2 -.mk .na \fB\fB${#\fR\fIvname\fR\fB[*]}\fR\fR .ad @@ -760,7 +740,6 @@ The number of elements in the array \fIvname\fR is substituted. .sp .ne 2 -.mk .na \fB\fB${!\fR\fIvname\fR\fB}\fR\fR .ad @@ -772,7 +751,6 @@ Expands to the name of the variable referred to by \fIvname\fR. This is .sp .ne 2 -.mk .na \fB\fB${!\fR\fIvname\fR\fB[\fR\fIsubscript\fR\fB]}\fR\fR .ad @@ -788,7 +766,6 @@ used in double quotes, each array subscript yields a separate argument. .sp .ne 2 -.mk .na \fB\fB${!\fR\fIprefix\fR\fB*}\fR\fR .ad @@ -799,7 +776,6 @@ Expands to the names of the variables whose names begin with \fIprefix\fR. .sp .ne 2 -.mk .na \fB\fB${\fR\fIparameter\fR\fB:-\fR\fIword\fR\fB}\fR\fR .ad @@ -826,7 +802,6 @@ whether \fIparameter\fR is set or not. .sp .ne 2 -.mk .na \fB\fB${\fR\fIparameter\fR\fB:=\fR\fIword\fR\fB}\fR\fR .ad @@ -854,7 +829,6 @@ whether \fIparameter\fR is set or not. .sp .ne 2 -.mk .na \fB\fB${\fR\fIparameter\fR\fB:?\fR\fIword\fR\fB}\fR\fR .ad @@ -882,7 +856,6 @@ whether \fIparameter\fR is set or not. .sp .ne 2 -.mk .na \fB\fB${\fR\fIparameter\fR\fB:+\fR\fIword\fR\fB}\fR\fR .ad @@ -909,7 +882,6 @@ whether \fIparameter\fR is set or not. .sp .ne 2 -.mk .na \fB\fB${\fR\fIparameter\fR\fB:\fR\fIoffset\fR:\fIlength\fR}\fR .ad @@ -937,7 +909,6 @@ subscript for indexed arrays. The order for associative arrays is unspecified. .sp .ne 2 -.mk .na \fB\fB${\fR\fIparameter\fR\fB#\fR\fIpattern\fR\fB}\fR\fR .ad @@ -959,7 +930,6 @@ to each element in turn. .sp .ne 2 -.mk .na \fB\fB${\fR\fIparameter\fR\fB%\fR\fIpattern\fR\fB}\fR\fR .ad @@ -980,7 +950,6 @@ applied to each element in turn. .sp .ne 2 -.mk .na \fB\fB${\fR\fIparameter\fR\fB/\fR\fIpattern\fR\fB/\fR\fIstring\fR\fB}\fR\fR .ad @@ -1025,56 +994,46 @@ The fourth form restricts the pattern match to the end of the \fIstring\fR. The following parameters are automatically set by the shell: .sp .ne 2 -.mk .na \fB\fB#\fR\fR .ad .RS 19n -.rt The number of positional parameters in decimal. .RE .sp .ne 2 -.mk .na \fB\fB-\fR\fR .ad .RS 19n -.rt Options supplied to the shell on invocation or by the \fBset\fR command. .RE .sp .ne 2 -.mk .na \fB\fB?\fR\fR .ad .RS 19n -.rt The decimal value returned by the last executed command. .RE .sp .ne 2 -.mk .na \fB\fB$\fR\fR .ad .RS 19n -.rt The process number of this shell. .RE .sp .ne 2 -.mk .na \fB\fB_\fR\fR .ad .RS 19n -.rt Initially, the value of \fB_\fR is the absolute pathname of the shell or script being executed as passed in the environment. It is subsequently assigned the last argument of the previous command. @@ -1086,36 +1045,30 @@ mail. .sp .ne 2 -.mk .na \fB\fB!\fR\fR .ad .RS 19n -.rt The process number of the last background command invoked or the most recent job put in the background with the \fBbg\fR built-in command. .RE .sp .ne 2 -.mk .na \fB\fB\&.sh.command\fR\fR .ad .RS 19n -.rt When processing a \fBDEBUG\fR trap, this variable contains the current command line that is about to run. .RE .sp .ne 2 -.mk .na \fB\fB\&.sh.edchar\fR\fR .ad .RS 19n -.rt This variable contains the value of the keyboard character (or sequence of characters if the first character is an ESC, \fBASCII 033\fR) that has been entered when processing a \fBKEYBD\fR trap. If the value is changed as part of @@ -1125,24 +1078,20 @@ caused the trap. See the \fBKey Bindings\fR section of this manual page. .sp .ne 2 -.mk .na \fB\fB\&.sh.edcol\fR\fR .ad .RS 19n -.rt The character position of the cursor at the time of the most recent \fBKEYBD\fR trap. .RE .sp .ne 2 -.mk .na \fB\fB\&.sh.edmode\fR\fR .ad .RS 19n -.rt The value is set to ESC when processing a \fBKEYBD\fR trap while in \fBvi\fR insert mode. Otherwise, \fB\&.sh.edmode\fR is null when processing a \fBKEYBD\fR trap. See the \fBvi Editing Mode\fR section of this manual page. @@ -1150,46 +1099,38 @@ insert mode. Otherwise, \fB\&.sh.edmode\fR is null when processing a .sp .ne 2 -.mk .na \fB\fB\&.sh.edtext\fR\fR .ad .RS 19n -.rt The characters in the input buffer at the time of the most recent \fBKEYBD\fR trap. The value is null when not processing a \fBKEYBD\fR trap. .RE .sp .ne 2 -.mk .na \fB\fB\&.sh.file\fR\fR .ad .RS 19n -.rt The pathname of the file than contains the current command. .RE .sp .ne 2 -.mk .na \fB\fB\&.sh.fun\fR\fR .ad .RS 19n -.rt The name of the current function that is being executed. .RE .sp .ne 2 -.mk .na \fB\fB\&.sh.match\fR\fR .ad .RS 19n -.rt An indexed array which stores the most recent match and sub-pattern matches after conditional pattern matches that match and after variables expansions using the operators \fB#\fR, \fB%\fR, or \fB/\fR. The \fB0\fRth element stores @@ -1200,138 +1141,114 @@ assigned a new value. .sp .ne 2 -.mk .na \fB\fB\&.sh.name\fR\fR .ad .RS 19n -.rt Set to the name of the variable at the time that a discipline function is invoked. .RE .sp .ne 2 -.mk .na \fB\fB\&.sh.subscript\fR\fR .ad .RS 19n -.rt Set to the name subscript of the variable at the time that a discipline function is invoked. .RE .sp .ne 2 -.mk .na \fB\fB\&.sh.subshell\fR\fR .ad .RS 19n -.rt The current depth for sub-shells and command substitution. .RE .sp .ne 2 -.mk .na \fB\fB\&.sh.value\fR\fR .ad .RS 19n -.rt Set to the value of the variable at the time that the set or append discipline function is invoked. .RE .sp .ne 2 -.mk .na \fB\fB\&.sh.version\fR\fR .ad .RS 19n -.rt Set to a value that identifies the version of this shell. .RE .sp .ne 2 -.mk .na \fB\fBLINENO\fR\fR .ad .RS 19n -.rt The current line number within the script or function being executed. .RE .sp .ne 2 -.mk .na \fB\fBOLDPWD\fR\fR .ad .RS 19n -.rt The previous working directory set by the \fBcd\fR command. .RE .sp .ne 2 -.mk .na \fB\fBOPTARG\fR\fR .ad .RS 19n -.rt The value of the last option argument processed by the \fBgetopts\fR built-in command. .RE .sp .ne 2 -.mk .na \fB\fBOPTIND\fR\fR .ad .RS 19n -.rt The index of the last option argument processed by the \fBgetopts\fR built-in command. .RE .sp .ne 2 -.mk .na \fB\fBPPID\fR\fR .ad .RS 19n -.rt The process number of the parent of the shell. .RE .sp .ne 2 -.mk .na \fB\fBPWD\fR\fR .ad .RS 19n -.rt The present working directory set by the \fBcd\fR command. .RE .sp .ne 2 -.mk .na \fB\fBRANDOM\fR\fR .ad .RS 19n -.rt Each time this variable is referenced, a random integer, uniformly distributed between \fB0\fR and \fB32767\fR, is generated. The sequence of random numbers can be initialized by assigning a numeric value to \fBRANDOM\fR. @@ -1339,24 +1256,20 @@ can be initialized by assigning a numeric value to \fBRANDOM\fR. .sp .ne 2 -.mk .na \fB\fBREPLY\fR\fR .ad .RS 19n -.rt This variable is set by the \fBselect\fR statement and by the \fBread\fR built-in command when no arguments are supplied. .RE .sp .ne 2 -.mk .na \fB\fBSECONDS\fR\fR .ad .RS 19n -.rt Each time this variable is referenced, the number of seconds since shell invocation is returned. If this variable is assigned a value, then the value returned upon reference is the value that was assigned plus the number of @@ -1368,35 +1281,29 @@ seconds since the assignment. The following variables are used by the shell: .sp .ne 2 -.mk .na \fB\fBCDPATH\fR\fR .ad .RS 14n -.rt Defines the search path for the \fBcd\fR command. .RE .sp .ne 2 -.mk .na \fB\fBCOLUMNS\fR\fR .ad .RS 14n -.rt Defines the width of the edit window for the shell edit modes and for printing select lists. .RE .sp .ne 2 -.mk .na \fB\fBEDITOR\fR\fR .ad .RS 14n -.rt If the \fBVISUAL\fR variable is not set, the value of this variable is checked for the patterns as described with \fBVISUAL\fR and the corresponding editing option is turned on. @@ -1407,12 +1314,10 @@ page. .sp .ne 2 -.mk .na \fB\fBENV\fR\fR .ad .RS 14n -.rt Performs parameter expansion, command substitution, and arithmetic substitution on the value to generate the pathname of the script that is executed when the shell is invoked. This file is typically used for alias and function @@ -1425,12 +1330,10 @@ See the \fBInvocation\fR section of this manual page. .sp .ne 2 -.mk .na \fB\fBFCEDIT\fR\fR .ad .RS 14n -.rt Obsolete name for the default editor name for the \fBhist\fR command. \fBFCEDIT\fR is not used when \fBHISTEDIT\fR is set. .sp @@ -1439,24 +1342,20 @@ The shell specifies a default value to \fBFCEDIT\fR. .sp .ne 2 -.mk .na \fB\fBFIGNORE\fR\fR .ad .RS 14n -.rt A pattern that defines the set of file names that is ignored when performing file name matching. .RE .sp .ne 2 -.mk .na \fB\fBFPATH\fR\fR .ad .RS 14n -.rt The search path for function definitions. The directories in this path are searched for a file with the same name as the function or command when a function with the \fB-u\fR attribute is referenced and when a command is not @@ -1468,34 +1367,28 @@ adjacent colon (\fB:\fR) characters or a beginning or ending colon (\fB:\fR). .sp .ne 2 -.mk .na \fB\fBHISTCMD\fR\fR .ad .RS 14n -.rt The number of the current command in the history file. .RE .sp .ne 2 -.mk .na \fB\fBHISTEDIT\fR\fR .ad .RS 14n -.rt The name for the default editor name for the \fBhist\fR command. .RE .sp .ne 2 -.mk .na \fB\fBHISTFILE\fR\fR .ad .RS 14n -.rt If this variable is set when the shell is invoked, the value is the pathname of the file that is used to store the command history. See the \fBCommand Re-entry\fR section of this manual page. @@ -1503,12 +1396,10 @@ Re-entry\fR section of this manual page. .sp .ne 2 -.mk .na \fB\fBHISTSIZE\fR\fR .ad .RS 14n -.rt If this variable is set when the shell is invoked, then the number of previously entered commands that are accessible by this shell is greater than or equal to this number. The default is \fB512\fR. @@ -1516,12 +1407,10 @@ or equal to this number. The default is \fB512\fR. .sp .ne 2 -.mk .na \fB\fBHOME\fR\fR .ad .RS 14n -.rt The default argument (home directory) for the \fBcd\fR command. .sp \fBHOME\fR is not set by the shell. \fBHOME\fR is set by \fBlogin\fR(1). @@ -1529,12 +1418,10 @@ The default argument (home directory) for the \fBcd\fR command. .sp .ne 2 -.mk .na \fB\fBIFS\fR\fR .ad .RS 14n -.rt Internal field separators, normally SPACE, TAB, and NEWLINE that are used to separate the results of command substitution or parameter expansion and to separate fields with the built-in command read. The first character of the @@ -1555,48 +1442,40 @@ The shell specifies a default value to \fBIFS\fR. .sp .ne 2 -.mk .na \fB\fBLANG\fR\fR .ad .RS 14n -.rt This variable determines the locale category for any category not specifically selected with a variable starting with \fBLC_\fR or \fBLANG\fR. .RE .sp .ne 2 -.mk .na \fB\fBLC_ALL\fR\fR .ad .RS 14n -.rt This variable overrides the value of the \fBLANG\fR variable and any other \fBLC_\fR variable. .RE .sp .ne 2 -.mk .na \fB\fBLC_COLLATE\fR\fR .ad .RS 14n -.rt This variable determines the locale category for character collation information. .RE .sp .ne 2 -.mk .na \fB\fBLC_CTYPE\fR\fR .ad .RS 14n -.rt This variable determines the locale category for character handling functions. It determines the character classes for pattern matching. See the \fBFile Name Generation\fR section of this manual page. @@ -1604,23 +1483,19 @@ Generation\fR section of this manual page. .sp .ne 2 -.mk .na \fB\fBLC_NUMERIC\fR\fR .ad .RS 14n -.rt This variable determines the locale category for the decimal point character. .RE .sp .ne 2 -.mk .na \fB\fBLINES\fR\fR .ad .RS 14n -.rt If this variable is set, the value is used to determine the column length for printing select lists. Select lists prints vertically until about two-thirds of \fBLINES\fR lines are filled. @@ -1628,12 +1503,10 @@ printing select lists. Select lists prints vertically until about two-thirds of .sp .ne 2 -.mk .na \fB\fBMAIL\fR\fR .ad .RS 14n -.rt If this variable is set to the name of a mail file \fBand\fR the \fBMAILPATH\fR variable is not set, then the shell informs the user of arrival of mail in the specified file. @@ -1644,12 +1517,10 @@ specified file. .sp .ne 2 -.mk .na \fB\fBMAILCHECK\fR\fR .ad .RS 14n -.rt Specifies how often in seconds the shell checks for changes in the modification time of any of the files specified by the \fBMAILPATH\fR or \fBMAIL\fR variables. The default value is \fB600\fR seconds. When the time has elapsed @@ -1660,12 +1531,10 @@ The shell specifies a default value to \fBMAILCHECK\fR. .sp .ne 2 -.mk .na \fB\fBMAILPATH\fR\fR .ad .RS 14n -.rt A colon ( \fB:\fR ) separated list of file names. If this variable is set, then the shell informs the user of any modifications to the specified files that have occurred within the last \fBMAILCHECK\fR seconds. Each file name can be @@ -1677,12 +1546,10 @@ message is \fByou have mail in $_\fR. .sp .ne 2 -.mk .na \fB\fBPATH\fR\fR .ad .RS 14n -.rt The search path for commands. Except in \fB\&.profile\fR, users cannot change \fBPATH\fR if executing under \fBrksh93\fR. See the \fBExecution\fR section of this manual page. @@ -1692,12 +1559,10 @@ The shell specifies a default value to \fBPATH\fR. .sp .ne 2 -.mk .na \fB\fBPS1\fR\fR .ad .RS 14n -.rt The value of this variable is expanded for parameter expansion, command substitution, and arithmetic substitution to define the primary prompt string which by default is \fB$\fR. The character \fB!\fR in the primary prompt string @@ -1710,12 +1575,10 @@ The shell specifies a default value to \fBPS1\fR. .sp .ne 2 -.mk .na \fB\fBPS2\fR\fR .ad .RS 14n -.rt Secondary prompt string, by default, \fB>\fR. .sp The shell specifies a default value to \fBPS2\fR. @@ -1723,12 +1586,10 @@ The shell specifies a default value to \fBPS2\fR. .sp .ne 2 -.mk .na \fB\fBPS3\fR\fR .ad .RS 14n -.rt Selection prompt string used within a select loop, by default \fB#?\fR. .sp The shell specifies a default value to \fBPS3\fR. @@ -1736,12 +1597,10 @@ The shell specifies a default value to \fBPS3\fR. .sp .ne 2 -.mk .na \fB\fBPS4\fR\fR .ad .RS 14n -.rt The value of this variable is expanded for parameter evaluation, command substitution, and arithmetic substitution and precedes each line of an execution trace. By default, \fBPS4\fR is \fB+\fR. When \fBPS4\fR is unset, the @@ -1752,12 +1611,10 @@ The shell specifies a default value to \fBPS4\fR. .sp .ne 2 -.mk .na \fB\fBSHELL\fR\fR .ad .RS 14n -.rt The pathname of the shell is kept in the environment. At invocation, if the basename of this variable is \fBrsh\fR, \fBrksh\fR, \fBrksh93\fR, or \fBkrsh\fR, the shell becomes restricted. @@ -1768,12 +1625,10 @@ basename of this variable is \fBrsh\fR, \fBrksh\fR, \fBrksh93\fR, or .sp .ne 2 -.mk .na \fB\fBTIMEFORMAT\fR\fR .ad .RS 14n -.rt The value of this parameter is used as a format string specifying how the timing information for pipelines prefixed with the \fBtime\fR reserved word should be displayed. The \fB%\fR character introduces a format sequence that is @@ -1782,7 +1637,6 @@ expanded to a time value or other information. The format sequences and their meanings are as follows. .sp .ne 2 -.mk .na \fB\fB%%\fR\fR .ad @@ -1793,7 +1647,6 @@ A literal \fB%\fR. .sp .ne 2 -.mk .na \fB\fB%[\fIp\fR][l]R\fR\fR .ad @@ -1804,7 +1657,6 @@ The elapsed time in seconds. .sp .ne 2 -.mk .na \fB\fB%[\fIp\fR][l]U\fR\fR .ad @@ -1815,7 +1667,6 @@ The number of CPU seconds spent in user mode. .sp .ne 2 -.mk .na \fB\fB%[\fIp\fR][l]S\fR\fR .ad @@ -1826,7 +1677,6 @@ The number of CPU seconds spent in system mode. .sp .ne 2 -.mk .na \fB\fB%P\fR\fR .ad @@ -1853,12 +1703,10 @@ used. If the value is null, no timing information is displayed. .sp .ne 2 -.mk .na \fB\fBTMOUT\fR\fR .ad .RS 14n -.rt If set to a value greater than zero, \fBTMOUT\fR is the default time-out value for the \fBread\fR built-in command. The \fBselect\fR compound command terminates after \fBTMOUT\fR seconds when input is from a terminal. Otherwise, @@ -1871,12 +1719,10 @@ The shell specifies a default value to \fBTMOUT\fR. .sp .ne 2 -.mk .na \fB\fBVISUAL\fR\fR .ad .RS 14n -.rt If the value of this variable matches the pattern \fB*[Vv][Ii]*\fR, then the \fBvi\fR option is turned on. See \fBSpecial Commands\fR. If the value matches the pattern \fB*gmacs*\fR , the \fBgmacs\fR option is turned on. If the value @@ -1953,12 +1799,10 @@ character \fB\&.\fR itself. For other uses of pattern matching the \fB/\fR and \fB\&.\fR are not specially treated. .sp .ne 2 -.mk .na \fB\fB*\fR\fR .ad .RS 11n -.rt Match any string, including the null string. When used for file name expansion, if the \fBglobstar\fR option is on, two adjacent \fB*\fRs by themselves match all files and zero or more directories and subdirectories. If the two adjacent @@ -1967,23 +1811,19 @@ all files and zero or more directories and subdirectories. If the two adjacent .sp .ne 2 -.mk .na \fB\fB?\fR\fR .ad .RS 11n -.rt Matches any single character. .RE .sp .ne 2 -.mk .na \fB[\fB\&...\fR]\fR .ad .RS 11n -.rt Match any one of the enclosed characters. A pair of characters separated by \fB-\fR matches any character lexically between the pair, inclusive. If the first character following the opening \fB[\fR is a \fB!\fR, any character not @@ -2018,56 +1858,46 @@ be matched whereas \fB|\fR requires that only one pattern be matched. Composite patterns can be formed with one or more of the following sub-patterns: .sp .ne 2 -.mk .na \fB\fB?(\fR\fIpattern-list\fR\fB)\fR\fR .ad .RS 22n -.rt Optionally matches any one of the specified patterns. .RE .sp .ne 2 -.mk .na \fB\fB*(\fR\fIpattern-list\fR\fB)\fR\fR .ad .RS 22n -.rt Matches zero or more occurrences of the specified patterns. .RE .sp .ne 2 -.mk .na \fB\fB+(\fR\fIpattern-list\fR\fB)\fR\fR .ad .RS 22n -.rt Matches one or more occurrences of the specified patterns. .RE .sp .ne 2 -.mk .na \fB\fB{\fR\fIn\fR\fB(\fR\fIpattern-list\fR\fB)\fR\fR .ad .RS 22n -.rt Matches \fIn\fR occurrences of the specified patterns. .RE .sp .ne 2 -.mk .na \fB\fB{\fR\fIm\fR\fB,\fR\fIn\fR\fB(\fR\fIpattern-list\fR\fB)\fR\fR .ad .RS 22n -.rt Matches from \fIm\fR to \fIn\fR occurrences of the specified patterns. If \fIm\fR is omitted, \fB0\fR is used. If \fIn\fR is omitted at least \fIm\fR occurrences are matched. @@ -2075,23 +1905,19 @@ occurrences are matched. .sp .ne 2 -.mk .na \fB\fB@(\fR\fIpattern-list\fR\fB)\fR\fR .ad .RS 22n -.rt Matches exactly one of the specified patterns. .RE .sp .ne 2 -.mk .na \fB\fB!(\fR\fIpattern-list\fR\fB)\fR\fR .ad .RS 22n -.rt Matches anything except one of the specified patterns. .RE @@ -2111,67 +1937,55 @@ character \fB\e\fR is treated specially even when inside a character class. All character. In addition the following escape sequences are recognized: .sp .ne 2 -.mk .na \fB\fB\ed\fR\fR .ad .RS 7n -.rt Matches any character in the digit class. .RE .sp .ne 2 -.mk .na \fB\fB\eD\fR\fR .ad .RS 7n -.rt Matches any character not in the digit class. .RE .sp .ne 2 -.mk .na \fB\fB\es\fR\fR .ad .RS 7n -.rt Matches any character in the space class. .RE .sp .ne 2 -.mk .na \fB\fB\eS\fR\fR .ad .RS 7n -.rt Matches any character not in the space class. .RE .sp .ne 2 -.mk .na \fB\fB\ew\fR\fR .ad .RS 7n -.rt Matches any character in the word class. .RE .sp .ne 2 -.mk .na \fB\fB\eW\fR\fR .ad .RS 7n -.rt Matches any character not in the word class. .RE @@ -2187,47 +2001,39 @@ ending character matches. The behavior is unspecified when the first character of a \fIpattern-pair\fR is alphanumeric except for the following: .sp .ne 2 -.mk .na \fB\fBD\fR\fR .ad .RS 5n -.rt Causes the ending character to terminate the search for this pattern without finding a match. .RE .sp .ne 2 -.mk .na \fB\fBE\fR\fR .ad .RS 5n -.rt Causes the ending character to be interpreted as an escape character. .RE .sp .ne 2 -.mk .na \fB\fBL\fR\fR .ad .RS 5n -.rt Causes the ending character to be interpreted as a quote character causing all characters to be ignored when looking for a match. .RE .sp .ne 2 -.mk .na \fB\fBQ\fR\fR .ad .RS 5n -.rt Causes the ending character to be interpreted as a quote character causing all characters other than any escape character to be ignored when looking for a match. @@ -2255,57 +2061,47 @@ sub-patterns. If \fIoptions\fR is present, it can consist of one or more of the following: .sp .ne 2 -.mk .na \fB\fB+\fR\fR .ad .RS 5n -.rt Enable the following options. This is the default. .RE .sp .ne 2 -.mk .na \fB\fB-\fR\fR .ad .RS 5n -.rt Disable the following options. .RE .sp .ne 2 -.mk .na \fB\fBE\fR\fR .ad .RS 5n -.rt The remainder of the pattern uses extended regular expression syntax like the \fBegrep\fR(1) command. .RE .sp .ne 2 -.mk .na \fB\fBF\fR\fR .ad .RS 5n -.rt The remainder of the pattern uses \fBfgrep\fR(1) expression syntax. .RE .sp .ne 2 -.mk .na \fB\fBg\fR\fR .ad .RS 5n -.rt File the longest match (greedy). .sp This is the default. @@ -2313,35 +2109,29 @@ This is the default. .sp .ne 2 -.mk .na \fB\fBG\fR\fR .ad .RS 5n -.rt The remainder of the pattern uses basic regular expression syntax like the \fBgrep\fR(1) command. .RE .sp .ne 2 -.mk .na \fB\fBi\fR\fR .ad .RS 5n -.rt Treat the match as case insensitive. .RE .sp .ne 2 -.mk .na \fB\fBK\fR\fR .ad .RS 5n -.rt The remainder of the pattern uses shell pattern syntax. .sp This is the default. @@ -2349,12 +2139,10 @@ This is the default. .sp .ne 2 -.mk .na \fB\fBl\fR\fR .ad .RS 5n -.rt Left anchor the pattern. .sp This is the default for \fBK\fR style patterns. @@ -2362,12 +2150,10 @@ This is the default for \fBK\fR style patterns. .sp .ne 2 -.mk .na \fB\fBN\fR\fR .ad .RS 5n -.rt This is ignored. However, when it is the first letter and is used with file name generation, and no matches occur, the file pattern expands to the empty string. @@ -2375,12 +2161,10 @@ string. .sp .ne 2 -.mk .na \fB\fBr\fR\fR .ad .RS 5n -.rt Right anchor the pattern. .sp This is the default for \fBK\fR style patterns. @@ -2399,23 +2183,19 @@ Each of the metacharacters listed in the \fBDefinitions\fR has a special meaning to the shell. .sp .ne 2 -.mk .na \fB\fBg\fR\fR .ad .RS 5n -.rt File the longest match (greedy). This is the default. .RE .sp .ne 2 -.mk .na \fB\fBi\fR\fR .ad .RS 5n -.rt Treat the match as case insensitive. .RE @@ -2437,56 +2217,46 @@ the single quotes. A single quoted string preceded by an unquoted \fB$\fR is processed as an \fBANSI-C\fR string except for the following: .sp .ne 2 -.mk .na \fB\fB\e0\fR\fR .ad .RS 19n -.rt Causes the remainder of the string to be ignored. .RE .sp .ne 2 -.mk .na \fB\fB\ec\fR\fIx\fR\fR .ad .RS 19n -.rt Expands to the character CTRL-x. .RE .sp .ne 2 -.mk .na \fB\fB\eC\fR[\fB\&.\fR\fIname\fR\fB\&.\fR]\fR .ad .RS 19n -.rt Expands to the collating element \fIname\fR. .RE .sp .ne 2 -.mk .na \fB\fB\ee\fR\fR .ad .RS 19n -.rt Equivalent to the escape character (\fBASCII\fR 033), .RE .sp .ne 2 -.mk .na \fB\fB\eE\fR\fR .ad .RS 19n -.rt Equivalent to the escape character (\fBASCII\fR 033), .RE @@ -2547,10 +2317,10 @@ be used within an arithmetic expression: .sp .in +2 .nf -abs acos acosh asin asinh atan atan2 atanh cbrt +abs acos acosh asin asinh atan atan2 atanh cbrt copysign cos cosh erf erfc exp exp2 expm1 fabs -fdim finite floor fma fmax fmod hypot ilogb -int isinf isnan lgamma log log2 logb +fdim finite floor fma fmax fmod hypot ilogb +int isinf isnan lgamma log log2 logb nearbyint nextafter nexttoward pow remainder rint round sin sinh sqrt tan tanh tgamma trunc .fi @@ -2603,12 +2373,10 @@ Each expression can be constructed from one or more of the following unary or binary expressions: .sp .ne 2 -.mk .na \fB\fB-a\fR \fIfile\fR\fR .ad .RS 21n -.rt True, if \fIfile\fR exists. .sp This option is the same as \fB-e\fR. This option is obsolete. @@ -2616,258 +2384,212 @@ This option is the same as \fB-e\fR. This option is obsolete. .sp .ne 2 -.mk .na \fB\fB-b\fR \fIfile\fR\fR .ad .RS 21n -.rt True, if \fIfile\fR exists and is a block special file. .RE .sp .ne 2 -.mk .na \fB\fB-c\fR \fIfile\fR\fR .ad .RS 21n -.rt True, if \fIfile\fR exists and is a character special file. .RE .sp .ne 2 -.mk .na \fB\fB-d\fR \fIfile\fR\fR .ad .RS 21n -.rt True, if \fIfile\fR exists and is a directory. .RE .sp .ne 2 -.mk .na \fB\fB-e\fR \fIfile\fR\fR .ad .RS 21n -.rt True, if \fIfile\fR exists. .RE .sp .ne 2 -.mk .na \fB\fB-f\fR \fIfile\fR\fR .ad .RS 21n -.rt True, if \fIfile\fR exists and is an ordinary file. .RE .sp .ne 2 -.mk .na \fB\fB-g\fR \fIfile\fR\fR .ad .RS 21n -.rt True, if \fIfile\fR exists and it has its \fBsetgid\fR bit set. .RE .sp .ne 2 -.mk .na \fB\fB-G\fR \fIfile\fR\fR .ad .RS 21n -.rt True, if \fIfile\fR exists and its group matches the effective group id of this process. .RE .sp .ne 2 -.mk .na \fB\fB-h\fR \fIfile\fR\fR .ad .RS 21n -.rt True, if \fIfile\fR exists and is a symbolic link. .RE .sp .ne 2 -.mk .na \fB\fB-k\fR \fIfile\fR\fR .ad .RS 21n -.rt True, if \fIfile\fR exists and it has its sticky bit set. .RE .sp .ne 2 -.mk .na \fB\fB-L\fR \fIfile\fR\fR .ad .RS 21n -.rt True, if \fIfile\fR exists and is a symbolic link. .RE .sp .ne 2 -.mk .na \fB\fB-n\fR \fIstring\fR\fR .ad .RS 21n -.rt True, if length of \fIstring\fR is \fBnon-zero\fR. .RE .sp .ne 2 -.mk .na \fB\fB-N\fR \fIfile\fR\fR .ad .RS 21n -.rt True, if \fIfile\fR exists and the modification time is greater than the last access time. .RE .sp .ne 2 -.mk .na \fB\fB-o\fR \fIoption\fR\fR .ad .RS 21n -.rt True, if option named \fIoption\fR is on. .RE .sp .ne 2 -.mk .na \fB\fB-o\fR \fI?option\fR\fR .ad .RS 21n -.rt True, if option named \fIoption\fR is a valid option name. .RE .sp .ne 2 -.mk .na \fB\fB-O\fR \fIfile\fR\fR .ad .RS 21n -.rt True, if \fIfile\fR exists and is owned by the effective user id of this process. .RE .sp .ne 2 -.mk .na \fB\fB-p\fR \fIfile\fR\fR .ad .RS 21n -.rt True, if \fIfile\fR exists and is a \fBFIFO\fR special file or a pipe. .RE .sp .ne 2 -.mk .na \fB\fB-r\fR \fIfile\fR\fR .ad .RS 21n -.rt True, if \fIfile\fR exists and is readable by current process. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR \fIfile\fR\fR .ad .RS 21n -.rt True, if \fIfile\fR exists and has size greater than zero. .RE .sp .ne 2 -.mk .na \fB\fB-S\fR \fIfile\fR\fR .ad .RS 21n -.rt True, if \fIfile\fR exists and is a socket. .RE .sp .ne 2 -.mk .na \fB\fB-t\fR \fIfildes\fR\fR .ad .RS 21n -.rt True, if file descriptor number \fIfildes\fR is open and associated with a terminal device. .RE .sp .ne 2 -.mk .na \fB\fB-u\fR \fIfile\fR\fR .ad .RS 21n -.rt True, if \fIfile\fR exists and it has its \fBsetuid\fR bit set. .RE .sp .ne 2 -.mk .na \fB\fB-w\fR \fIfile\fR\fR .ad .RS 21n -.rt True, if \fIfile\fR exists and is writable by current process. .RE .sp .ne 2 -.mk .na \fB\fB-x\fR \fIfile\fR\fR .ad .RS 21n -.rt True, if \fIfile\fR exists and is executable by current process. If \fIfile\fR exists and is a directory, then true if the current process has permission to search in the directory. @@ -2875,69 +2597,57 @@ search in the directory. .sp .ne 2 -.mk .na \fB\fB-z\fR \fIstring\fR\fR .ad .RS 21n -.rt True, if length of \fIstring\fR is zero. .RE .sp .ne 2 -.mk .na \fB\fIfile1\fR \fB-ef\fR \fIfile2\fR\fR .ad .RS 21n -.rt True, if \fIfile1\fR and \fIfile2\fR exist and refer to the same file. .RE .sp .ne 2 -.mk .na \fB\fIfile1\fR \fB-nt\fR \fIfile2\fR\fR .ad .RS 21n -.rt True, if \fIfile1\fR exists and \fIfile2\fR does not, or \fIfile1\fR is newer than \fIfile2\fR. .RE .sp .ne 2 -.mk .na \fB\fIfile1\fR \fB-ot\fR \fIfile2\fR\fR .ad .RS 21n -.rt True, if \fIfile2\fR exists and \fIfile1\fR does not, or \fIfile1\fR is older than \fIfile2\fR. .RE .sp .ne 2 -.mk .na \fB\fIstring\fR\fR .ad .RS 21n -.rt True, if \fIstring\fR is not null. .RE .sp .ne 2 -.mk .na \fB\fIstring\fR \fB==\fR \fIpattern\fR\fR .ad .RS 21n -.rt True, if \fIstring\fR matches \fIpattern\fR. Any part of \fIpattern\fR can be quoted to cause it to be matched as a string. With a successful match to \fIpattern\fR, the \fB\&.sh.match\fR array variable contains the match and @@ -2946,23 +2656,19 @@ sub-pattern matches. .sp .ne 2 -.mk .na \fB\fIstring\fR \fB=\fR \fIpattern\fR\fR .ad .RS 21n -.rt Same as \fB==\fR, but is obsolete. .RE .sp .ne 2 -.mk .na \fB\fIstring\fR \fB!=\fR \fIpattern\fR\fR .ad .RS 21n -.rt True, if \fIstring\fR does not match \fIpattern\fR. When the \fIstring\fR matches the \fIpattern\fR the \fB\&.sh.match\fR array variable contains the match and sub-pattern matches. @@ -2970,36 +2676,30 @@ match and sub-pattern matches. .sp .ne 2 -.mk .na \fB\fIstring\fR \fB=~\fR \fIere\fR\fR .ad .RS 21n -.rt True if \fIstring\fR matches the pattern \fB~(E)\fR\fIere\fR where \fIere\fR is an extended regular expression. .RE .sp .ne 2 -.mk .na \fB\fIstring1\fR \fB<\fR \fIstring2\fR\fR .ad .RS 21n -.rt True, if \fIstring1\fR comes before \fIstring2\fR based on \fBASCII\fR value of their characters. .RE .sp .ne 2 -.mk .na \fB\fIstring1\fR \fB>\fR \fIstring2\fR\fR .ad .RS 21n -.rt True, if \fIstring1\fR comes after \fIstring2\fR based on \fBASCII\fR value of their characters. .RE @@ -3012,67 +2712,55 @@ open file whose descriptor number is \fIn\fR. The following obsolete arithmetic comparisons are supported: .sp .ne 2 -.mk .na \fB\fIexp1\fR \fB-eq\fR \fIexp2\fR\fR .ad .RS 17n -.rt True, if \fIexp1\fR is equal to \fIexp2\fR. .RE .sp .ne 2 -.mk .na \fB\fIexp1\fR \fB-ge\fR \fIexp2\fR\fR .ad .RS 17n -.rt True, if \fIexp1\fR is greater than or equal to \fIexp2\fR. .RE .sp .ne 2 -.mk .na \fB\fIexp1\fR \fB-gt\fR \fIexp2\fR\fR .ad .RS 17n -.rt True, if \fIexp1\fR is greater than \fIexp2\fR. .RE .sp .ne 2 -.mk .na \fB\fIexp1\fR \fB-le\fR \fIexp2\fR\fR .ad .RS 17n -.rt True, if \fIexp1\fR is less than or equal to \fIexp2\fR. .RE .sp .ne 2 -.mk .na \fB\fIexp1\fR \fB-lt\fR \fIexp2\fR\fR .ad .RS 17n -.rt True, if \fIexp1\fR is less than \fIexp2\fR. .RE .sp .ne 2 -.mk .na \fB\fIexp1\fR \fB-ne\fR \fIexp2\fR\fR .ad .RS 17n -.rt True, if \fIexp1\fR is not equal to \fIexp2\fR. .RE @@ -3082,45 +2770,37 @@ A compound expression can be constructed from these primitives by using any of the following, listed in decreasing order of precedence: .sp .ne 2 -.mk .na \fB\fB(\fR\fIexpression\fR\fB)\fR\fR .ad .RS 30n -.rt True, if \fIexpression\fR is true. Used to group expressions. .RE .sp .ne 2 -.mk .na \fB\fB!\fR \fIexpression\fR\fR .ad .RS 30n -.rt True, if \fIexpression\fR is false. .RE .sp .ne 2 -.mk .na \fB\fIexpression1\fR \fB&&\fR \fIexpression2\fR\fR .ad .RS 30n -.rt True, if \fIexpression1\fR and \fIexpression2\fR are both true. .RE .sp .ne 2 -.mk .na \fB\fIexpression1\fR \fB||\fR \fIexpression2\fR\fR .ad .RS 30n -.rt True, if either \fIexpression1\fR or \fIexpression2\fR is true. .RE @@ -3150,23 +2830,19 @@ No intervening space is allowed between the characters of redirection operators. .sp .ne 2 -.mk .na \fB\fB<\fR\fIword\fR\fR .ad .RS 14n -.rt Use file \fIword\fR as standard input (file descriptor 0). .RE .sp .ne 2 -.mk .na \fB\fB>\fR\fIword\fR\fR .ad .RS 14n -.rt Use file \fIword\fR as standard output (file descriptor 1). If the file does not exist then it is created. If the file exists, and the \fBnoclobber\fR option is on, this causes an error. Otherwise, it is truncated to zero length. @@ -3174,23 +2850,19 @@ option is on, this causes an error. Otherwise, it is truncated to zero length. .sp .ne 2 -.mk .na \fB\fB>|\fR\fIword\fR\fR .ad .RS 14n -.rt Same as \fB>\fR, except that it overrides the \fBnoclobber\fR option. .RE .sp .ne 2 -.mk .na \fB\fB>>\fR\fIword\fR\fR .ad .RS 14n -.rt Use file \fIword\fR as standard output. If the file exists, then output is appended to it (by first seeking to the end-of-file). Otherwise, the file is created. @@ -3198,23 +2870,19 @@ created. .sp .ne 2 -.mk .na \fB\fB<>\fR\fIword\fR\fR .ad .RS 14n -.rt Open file \fIword\fR for reading and writing as standard input. .RE .sp .ne 2 -.mk .na \fB\fB<<\fR\fB[-]\fR\fIword\fR\fR .ad .RS 14n -.rt The shell input is read up to a line that is the same as \fIword\fR after any quoting has been removed, or to an end-of-file. No parameter substitution, command substitution, arithmetic substitution or file name generation is @@ -3233,12 +2901,10 @@ columns for the purposes of determining the indentation. .sp .ne 2 -.mk .na \fB\fB<<<\fR\fIword\fR\fR .ad .RS 14n -.rt A short form of here document in which \fIword\fR becomes the contents of the here-document after any parameter expansion, command substitution, and arithmetic substitution occur. @@ -3246,70 +2912,58 @@ arithmetic substitution occur. .sp .ne 2 -.mk .na \fB\fB<&\fR\fIdigit\fR\fR .ad .RS 14n -.rt The standard input is duplicated from file descriptor \fIdigit\fR, and similarly for the standard output using \fB>&\fR\fIdigit\fR. See \fBdup\fR(2). .RE .sp .ne 2 -.mk .na \fB\fB<&\fR\fIdigit\fR\fB-\fR\fR .ad .RS 14n -.rt The file descriptor specified by \fIdigit\fR is moved to standard input. Similarly for the standard output using \fB>&\fR\fIdigit\fR\fB-\fR. .RE .sp .ne 2 -.mk .na \fB\fB<&-\fR\fR .ad .RS 14n -.rt The standard input is closed. Similarly for the standard output using \fB>&-\fR. .RE .sp .ne 2 -.mk .na \fB\fB<&p\fR\fR .ad .RS 14n -.rt The input from the co-process is moved to standard input. .RE .sp .ne 2 -.mk .na \fB\fB>&p\fR\fR .ad .RS 14n -.rt The output to the co-process is moved to standard output. .RE .sp .ne 2 -.mk .na \fB\fB<#((\fR\fIexpr\fR\fB))\fR\fR .ad .RS 14n -.rt Evaluate arithmetic expression \fIexpr\fR and position file descriptor 0 to the resulting value bytes from the start of the file. The variables \fBCUR\fR and \fBEOF\fR evaluate to the current offset and end-of-file offset respectively @@ -3318,34 +2972,28 @@ when evaluating \fIexpr\fR. .sp .ne 2 -.mk .na \fB\fB>#((\fR\fIexpr\fR\fB))\fR\fR .ad .RS 14n -.rt The same as \fB<#\fR except applies to file descriptor 1. .RE .sp .ne 2 -.mk .na \fB\fB<#\fR\fIpattern\fR\fR .ad .RS 14n -.rt Seek forward to the beginning of the next line containing pattern. .RE .sp .ne 2 -.mk .na \fB\fB<##\fR\fIpattern\fR\fR .ad .RS 14n -.rt The same as \fB<#\fR, except that the portion of the file that is skipped is copied to standard output. .RE @@ -3591,67 +3239,55 @@ There are several ways to refer to jobs in the shell. A job can be referred to by the process id of any process of the job or by one of the following: .sp .ne 2 -.mk .na \fB\fB%\fR\fInumber\fR\fR .ad .RS 12n -.rt The job with the specified number. .RE .sp .ne 2 -.mk .na \fB\fB%\fR\fIstring\fR\fR .ad .RS 12n -.rt Any job whose command line begins with \fIstring\fR. .RE .sp .ne 2 -.mk .na \fB\fB%?\fR\fIstring\fR\fR .ad .RS 12n -.rt Any job whose command line contains \fIstring\fR. .RE .sp .ne 2 -.mk .na \fB\fB%%\fR\fR .ad .RS 12n -.rt Current job. .RE .sp .ne 2 -.mk .na \fB\fB%+\fR\fR .ad .RS 12n -.rt Equivalent to \fB%%\fR. .RE .sp .ne 2 -.mk .na \fB\fB%-\fR\fR .ad .RS 12n -.rt Previous job. .RE @@ -3871,168 +3507,138 @@ beginning. The RETURN or the LINE FEED key is not entered after edit commands except when noted. .sp .ne 2 -.mk .na \fB\fB^F\fR\fR .ad .RS 13n -.rt Move the cursor forward (right) one character. .RE .sp .ne 2 -.mk .na \fB\fBM-[C\fR\fR .ad .RS 13n -.rt Move the cursor forward (right) one character. .RE .sp .ne 2 -.mk .na \fB\fBM-f\fR\fR .ad .RS 13n -.rt Move the cursor forward one word. The \fBemacs\fR editor's idea of a word is a string of characters consisting of only letters, digits and underscores. .RE .sp .ne 2 -.mk .na \fB\fB^B\fR\fR .ad .RS 13n -.rt Move the cursor backward (left) one character. .RE .sp .ne 2 -.mk .na \fB\fBM-[D\fR\fR .ad .RS 13n -.rt Move the cursor backward (left) one character. .RE .sp .ne 2 -.mk .na \fB\fBM-b\fR\fR .ad .RS 13n -.rt Move the cursor backward one word. .RE .sp .ne 2 -.mk .na \fB\fB^A\fR\fR .ad .RS 13n -.rt Move the cursor to the beginning of the line. .RE .sp .ne 2 -.mk .na \fB\fBM-[H\fR\fR .ad .RS 13n -.rt Move the cursor to the beginning of the line. .RE .sp .ne 2 -.mk .na \fB\fB^E\fR\fR .ad .RS 13n -.rt Move the cursor to the end of the line. .RE .sp .ne 2 -.mk .na \fB\fBM-[Y\fR\fR .ad .RS 13n -.rt Move the cursor to the end of line. .RE .sp .ne 2 -.mk .na \fB\fB^]\fR\fIchar\fR\fR .ad .RS 13n -.rt Move the cursor forward to the character \fIchar\fR on the current line. .RE .sp .ne 2 -.mk .na \fB\fBM-^]\fR\fIchar\fR\fR .ad .RS 13n -.rt Move the cursor backwards to the character \fIchar\fR on the current line. .RE .sp .ne 2 -.mk .na \fB\fB^X^X\fR\fR .ad .RS 13n -.rt Interchange the cursor and the mark. .RE .sp .ne 2 -.mk .na \fB\fIerase\fR\fR .ad .RS 13n -.rt Delete the previous character. The user-defined erase character is defined by the \fBstty\fR(1) command, and is usually \fB^H\fR or \fB#\fR. .RE .sp .ne 2 -.mk .na \fB\fIlnext\fR\fR .ad .RS 13n -.rt Removes the next character's editing features. The user-defined literal next character is defined by the \fBstty\fR(1) command, or is \fB^V\fR if not defined. @@ -4040,68 +3646,56 @@ defined. .sp .ne 2 -.mk .na \fB\fB^D\fR\fR .ad .RS 13n -.rt Delete the current character. .RE .sp .ne 2 -.mk .na \fB\fBM-d\fR\fR .ad .RS 13n -.rt Delete the current word. .RE .sp .ne 2 -.mk .na \fB\fBM-^H\fR\fR .ad .RS 13n -.rt MetaBACKSPACE. Delete the previous word. .RE .sp .ne 2 -.mk .na \fB\fBM-h\fR\fR .ad .RS 13n -.rt Delete the previous word. .RE .sp .ne 2 -.mk .na \fB\fBM-^?\fR\fR .ad .RS 13n -.rt MetaDEL. Delete the previous word. If your interrupt character is \fB^?\fR (DEL, the default), this command does not work. .RE .sp .ne 2 -.mk .na \fB\fB^T\fR\fR .ad .RS 13n -.rt Transpose the current character with the previous character, and advance the cursor in \fBemacs\fR mode. Transpose two previous characters in \fBgmacs\fR mode. @@ -4109,45 +3703,37 @@ mode. .sp .ne 2 -.mk .na \fB\fB^C\fR\fR .ad .RS 13n -.rt Capitalize the current character. .RE .sp .ne 2 -.mk .na \fB\fBM-c\fR\fR .ad .RS 13n -.rt Capitalize the current word. .RE .sp .ne 2 -.mk .na \fB\fBM-l\fR\fR .ad .RS 13n -.rt Change the current word to lower case. .RE .sp .ne 2 -.mk .na \fB\fB^K\fR\fR .ad .RS 13n -.rt Delete from the cursor to the end of the line. If preceded by a numerical parameter whose value is less than the current cursor position, delete from specified position up to the cursor. If preceded by a numerical parameter whose @@ -4157,34 +3743,28 @@ to specified cursor position. .sp .ne 2 -.mk .na \fB\fB^W\fR\fR .ad .RS 13n -.rt Kill from the cursor to the mark. .RE .sp .ne 2 -.mk .na \fB\fBM-p\fR\fR .ad .RS 13n -.rt Push the region from the cursor to the mark on the stack. .RE .sp .ne 2 -.mk .na \fB\fIkill\fR\fR .ad .RS 13n -.rt Kill the entire current line. The user-defined kill character is defined by the \fBstty\fR(1) command, usually a \fB^G\fR or \fB@\fR. If two kill characters are entered in succession, all kill characters from then on cause a line feed. @@ -4193,101 +3773,83 @@ This is useful when using paper terminals. .sp .ne 2 -.mk .na \fB\fB^Y\fR\fR .ad .RS 13n -.rt Restore the last item removed from line. Yank the item back to the line. .RE .sp .ne 2 -.mk .na \fB\fB^L\fR\fR .ad .RS 13n -.rt Line feed and print the current line. .RE .sp .ne 2 -.mk .na \fB\fBM-^L\fR\fR .ad .RS 13n -.rt Clear the screen. .RE .sp .ne 2 -.mk .na \fB\fB^@\fR\fR .ad .RS 13n -.rt Null character. Set mark. .RE .sp .ne 2 -.mk .na \fB\fBM-\fR\fIspace\fR\fR .ad .RS 13n -.rt MetaSPACE. Set the mark. .RE .sp .ne 2 -.mk .na \fB\fB^J\fR\fR .ad .RS 13n -.rt New line. Execute the current line. .RE .sp .ne 2 -.mk .na \fB\fB^M\fR\fR .ad .RS 13n -.rt Return. Execute the current line. .RE .sp .ne 2 -.mk .na \fB\fBEOF\fR\fR .ad .RS 13n -.rt End-of-file character, normally \fB^D\fR, is processed as an \fBend-of-file\fR only if the current line is null. .RE .sp .ne 2 -.mk .na \fB\fB^P\fR\fR .ad .RS 13n -.rt Fetch the previous command. Each time \fB^P\fR is entered the previous command back in time is accessed. Moves back one line when it is not on the first line of a multi-line command. @@ -4295,68 +3857,56 @@ of a multi-line command. .sp .ne 2 -.mk .na \fB\fBM-[A\fR\fR .ad .RS 13n -.rt Equivalent to \fB^P\fR. .RE .sp .ne 2 -.mk .na \fB\fBM-<\fR\fR .ad .RS 13n -.rt Fetch the least recent (oldest) history line. .RE .sp .ne 2 -.mk .na \fB\fBM->\fR\fR .ad .RS 13n -.rt Fetch the most recent (youngest) history line. .RE .sp .ne 2 -.mk .na \fB\fB^N\fR\fR .ad .RS 13n -.rt Fetch the next command line. Each time \fB^N\fR is entered the next command line forward in time is accessed. .RE .sp .ne 2 -.mk .na \fB\fBM-[B\fR\fR .ad .RS 13n -.rt Equivalent to \fB^N\fR. .RE .sp .ne 2 -.mk .na \fB\fB^R\fR\fIstring\fR\fR .ad .RS 13n -.rt Reverse search history for a previous command line containing \fIstring\fR. If a parameter of zero is specified, the search is forward. \fIstring\fR is terminated by a RETURN or NEWLINE. If string is preceded by a \fB^\fR, the @@ -4367,24 +3917,20 @@ case a parameter of zero reverses the direction of the search. .sp .ne 2 -.mk .na \fB\fB^O\fR\fR .ad .RS 13n -.rt Operate. Execute the current line and fetch the next line relative to current line from the history file. .RE .sp .ne 2 -.mk .na \fB\fBM-\fR\fIdigits\fR\fR .ad .RS 13n -.rt Escape. Define numeric parameter. The digits are taken as a parameter to the next command. The commands that accept a parameter are: \fB^F\fR, \fB^B\fR, \fBERASE\fR, \fB^C\fR, \fB^D\fR, \fB^K\fR, \fB^R\fR, \fB^P\fR, \fB^N\fR, @@ -4394,12 +3940,10 @@ next command. The commands that accept a parameter are: \fB^F\fR, \fB^B\fR, .sp .ne 2 -.mk .na \fB\fBM-\fR\fIletter\fR\fR .ad .RS 13n -.rt Soft-key. Search the alias list for an alias by the name \fIletter\fR. If an alias of \fIletter\fR is defined, insert its value on the input queue. \fIletter\fR must not be one of the metafunctions in this section. @@ -4407,12 +3951,10 @@ alias of \fIletter\fR is defined, insert its value on the input queue. .sp .ne 2 -.mk .na \fB\fBM-[\fR\fIletter\fR\fR .ad .RS 13n -.rt Soft key. Search the alias list for an alias by the name \fIletter\fR. If an alias of this name is defined, insert its value on the input queue. This can be used to program function keys on many terminals. @@ -4420,12 +3962,10 @@ used to program function keys on many terminals. .sp .ne 2 -.mk .na \fB\fBM-.\fR\fR .ad .RS 13n -.rt The last word of the previous command is inserted on the line. If preceded by a numeric parameter, the value of this parameter determines which word to insert rather than the last word. @@ -4433,46 +3973,38 @@ rather than the last word. .sp .ne 2 -.mk .na \fB\fBM-_\fR\fR .ad .RS 13n -.rt Same as \fBM-.\fR. .RE .sp .ne 2 -.mk .na \fB\fBM-*\fR\fR .ad .RS 13n -.rt Attempt filename generation on the current word. As asterisk is appended if the word does not match any file or contain any special pattern characters. .RE .sp .ne 2 -.mk .na \fB\fBM-\fRESC\fR .ad .RS 13n -.rt Command or file name completion as described in this manual page. .RE .sp .ne 2 -.mk .na \fB\fB^I\fRTAB\fR .ad .RS 13n -.rt Attempts command or file name completion as described in this manual page. If a partial completion occurs, repeating this behaves as if \fBM-=\fR were entered. If no match is found or entered after SPACE, a TAB is inserted. @@ -4480,12 +4012,10 @@ If no match is found or entered after SPACE, a TAB is inserted. .sp .ne 2 -.mk .na \fB\fBM-=\fR\fR .ad .RS 13n -.rt If not preceded by a numeric parameter, generates the list of matching commands or file names as described in this manual page. Otherwise, the word under the cursor is replaced by the item corresponding to the value of the numeric @@ -4495,23 +4025,19 @@ is not on a word, the word is inserted instead. .sp .ne 2 -.mk .na \fB\fB^U\fR\fR .ad .RS 13n -.rt Multiply parameter of next command by \fB4\fR. .RE .sp .ne 2 -.mk .na \fB\fB\e\fR\fR .ad .RS 13n -.rt Escape the next character. Editing characters, the user's erase, kill and interrupt (normally \fB^?\fR) characters can be entered in a command line or in a search string if preceded by a \fB\e\fR\&. The \fB\e\fR removes the next @@ -4520,23 +4046,19 @@ character's editing features, if any. .sp .ne 2 -.mk .na \fB\fBM-^V\fR\fR .ad .RS 13n -.rt Display the version of the shell. .RE .sp .ne 2 -.mk .na \fB\fBM-#\fR\fR .ad .RS 13n -.rt If the line does not begin with a \fB#\fR, a \fB#\fR is inserted at the beginning of the line and after each NEWLINE, and the line is entered. This causes a comment to be inserted in the history file. If the line begins with a @@ -4575,48 +4097,40 @@ By default the editor is in input mode. The following input edit commands are supported: .sp .ne 2 -.mk .na \fBERASE\fR .ad .RS 10n -.rt User defined erase character as defined by the \fBstty\fR command, usually \fB^H\fR or \fB#\fR. Delete previous character. .RE .sp .ne 2 -.mk .na \fB\fB^W\fR\fR .ad .RS 10n -.rt Delete the previous blank separated word. On some systems the \fBviraw\fR option might be required for this to work. .RE .sp .ne 2 -.mk .na \fBEOF\fR .ad .RS 10n -.rt As the first character of the line causes the shell to terminate unless the \fBignoreeof\fR option is set. Otherwise this character is ignored. .RE .sp .ne 2 -.mk .na \fB\fIlnext\fR\fR .ad .RS 10n -.rt User defined literal next character as defined by the \fBstty\fR(1) or \fB^V\fR if not defined. Removes the next character's editing features, if any. On some systems the \fBviraw\fR option might be required for this to work. @@ -4624,23 +4138,19 @@ systems the \fBviraw\fR option might be required for this to work. .sp .ne 2 -.mk .na \fB\fB\e\fR\fR .ad .RS 10n -.rt Escape the next ERASE or KILL character. .RE .sp .ne 2 -.mk .na \fB\fB^I\fR TAB\fR .ad .RS 10n -.rt Attempts command or file name completion as described in this manual page and returns to input mode. If a partial completion occurs, repeating this behaves as if \fB=\fR were entered from control mode. If no match is found or entered @@ -4656,255 +4166,209 @@ The motion edit commands move the cursor. The following motion edit commands are supported: .sp .ne 2 -.mk .na \fB\fB[\fR\fIcount\fR\fB]l\fR\fR .ad .RS 13n -.rt Move the cursor forward (right) one character. .RE .sp .ne 2 -.mk .na \fB\fB[\fR\fIcount\fR\fB][C\fR\fR .ad .RS 13n -.rt Move the cursor forward (right) one character. .RE .sp .ne 2 -.mk .na \fB\fB[\fR\fIcount\fR\fB]w\fR\fR .ad .RS 13n -.rt Move the cursor forward one alphanumeric word. .RE .sp .ne 2 -.mk .na \fB\fB[\fR\fIcount\fR\fB]W\fR\fR .ad .RS 13n -.rt Move the cursor to the beginning of the next word that follows a blank. .RE .sp .ne 2 -.mk .na \fB\fB[\fR\fIcount\fR\fB]e\fR\fR .ad .RS 13n -.rt Move the cursor to the end of the word. .RE .sp .ne 2 -.mk .na \fB\fB[\fR\fIcount\fR\fB]E\fR\fR .ad .RS 13n -.rt Move the cursor to the end of the current blank delimited word. .RE .sp .ne 2 -.mk .na \fB\fB[\fR\fIcount\fR\fB]h\fR\fR .ad .RS 13n -.rt Move the cursor backward (left) one character. .RE .sp .ne 2 -.mk .na \fB\fB[\fR\fIcount\fR\fB][D\fR\fR .ad .RS 13n -.rt Move the cursor backward (left) one character. .RE .sp .ne 2 -.mk .na \fB\fB[\fR\fIcount\fR\fB]b\fR\fR .ad .RS 13n -.rt Move the cursor backward one word. .RE .sp .ne 2 -.mk .na \fB\fB[\fR\fIcount\fR\fB]B\fR\fR .ad .RS 13n -.rt Move the cursor to the preceding blank separated word. .RE .sp .ne 2 -.mk .na \fB\fB[\fR\fIcount\fR\fB]|\fR\fR .ad .RS 13n -.rt Move the cursor to column \fIcount\fR. .RE .sp .ne 2 -.mk .na \fB\fB[\fR\fIcount\fR\fB]f\fR\fIc\fR\fR .ad .RS 13n -.rt Find the next character \fIc\fR in the current line. .RE .sp .ne 2 -.mk .na \fB\fB[\fR\fIcount\fR\fB]F\fR\fIc\fR\fR .ad .RS 13n -.rt Find the previous character \fIc\fR in the current line. .RE .sp .ne 2 -.mk .na \fB\fB[\fR\fIcount\fR\fB]t\fR\fIC\fR\fR .ad .RS 13n -.rt Equivalent to \fBf\fR followed by \fBh\fR. .RE .sp .ne 2 -.mk .na \fB\fB[\fR\fIcount\fR\fB]T\fR\fIc\fR\fR .ad .RS 13n -.rt Equivalent to \fBF\fR followed by \fBl\fR. .RE .sp .ne 2 -.mk .na \fB\fB[\fR\fIcount\fR\fB];\fR\fR .ad .RS 13n -.rt Repeat \fIcount\fR times the last single character find command: \fBf\fR, \fBF\fR, \fBt,\fR or \fBT\fR. .RE .sp .ne 2 -.mk .na \fB\fB[\fR\fIcount\fR\fB],\fR\fR .ad .RS 13n -.rt Reverse the last single character find command \fIcount\fR times. .RE .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 13n -.rt Move the cursor to the start of line. .RE .sp .ne 2 -.mk .na \fB\fB^\fR\fR .ad .RS 13n -.rt Move the cursor to start of line. .RE .sp .ne 2 -.mk .na \fB\fB[H\fR\fR .ad .RS 13n -.rt Move the cursor to the first non-blank character in the line. .RE .sp .ne 2 -.mk .na \fB\fB$\fR\fR .ad .RS 13n -.rt Move the cursor to the end of the line. .RE .sp .ne 2 -.mk .na \fB\fB[Y\fR\fR .ad .RS 13n -.rt Move the cursor to the end of the line. .RE .sp .ne 2 -.mk .na \fB\fB%\fR\fR .ad .RS 13n -.rt Moves to balancing \fB(\fR, \fB)\fR, \fB{\fR, \fB}\fR, \fB[\fR, or \fB]\fR. If cursor is not on one of the characters described in this section, the remainder of the line is searched for the first occurrence of one of the characters @@ -4920,24 +4384,20 @@ The search edit commands access your command history. The following search edit commands are supported: .sp .ne 2 -.mk .na \fB\fB[\fR\fIcount\fR\fB]k\fR\fR .ad .RS 13n -.rt Fetch the previous command. Each time \fBk\fR is entered, the previous command back in time is accessed. .RE .sp .ne 2 -.mk .na \fB\fB[\fR\fIcount\fR\fB]-\fR\fR .ad .RS 13n -.rt Fetch the previous command. Each time \fBk\fR is entered, the previous command back in time is accessed. .sp @@ -4946,12 +4406,10 @@ Equivalent to \fBk\fR. .sp .ne 2 -.mk .na \fB\fB[\fR\fIcount\fR\fB][A\fR\fR .ad .RS 13n -.rt Fetch the previous command. Each time \fBk\fR is entered, the previous command back in time is accessed. .sp @@ -4960,24 +4418,20 @@ Equivalent to \fBk\fR. .sp .ne 2 -.mk .na \fB\fB[\fR\fIcount\fR\fB]j\fR\fR .ad .RS 13n -.rt Fetch the next command. Each time \fBj\fR is entered, the next command forward in time is accessed. .RE .sp .ne 2 -.mk .na \fB\fB[\fR\fIcount\fR\fB]+\fR\fR .ad .RS 13n -.rt Fetch the next command. Each time \fBj\fR is entered, the next command forward in time is accessed. .sp @@ -4986,12 +4440,10 @@ Equivalent to \fBj\fR. .sp .ne 2 -.mk .na \fB\fB[\fR\fIcount\fR\fB][B\fR\fR .ad .RS 13n -.rt Fetch the next command. Each time \fBj\fR is entered, the next command forward in time is accessed. .sp @@ -5000,24 +4452,20 @@ Equivalent to \fBj\fR. .sp .ne 2 -.mk .na \fB\fB[\fR\fIcount\fR\fB]G\fR\fR .ad .RS 13n -.rt Fetch command number \fIcount\fR. The default is the least recent history command. .RE .sp .ne 2 -.mk .na \fB\fB/\fR\fIstring\fR\fR .ad .RS 13n -.rt Search backward through history for a previous command containing \fIstring\fR. \fIstring\fR is terminated by a RETURN or NEWLINE. If string is preceded by a \fB^\fR, the matched line must begin with \fIstring\fR. If \fIstring\fR is @@ -5026,12 +4474,10 @@ null, the previous string is used. .sp .ne 2 -.mk .na \fB\fB?\fR\fIstring\fR\fR .ad .RS 13n -.rt Search forward through history for a previous command containing \fIstring\fR. \fIstring\fR is terminated by a RETURN or NEWLINE. If string is preceded by a \fB^\fR, the matched line must begin with \fIstring\fR. If \fIstring\fR is @@ -5042,24 +4488,20 @@ Same as \fI/\fR except that search is in the forward direction. .sp .ne 2 -.mk .na \fB\fBn\fR\fR .ad .RS 13n -.rt Search in the backwards direction for the next match of the last pattern to \fI/\fR or \fI?\fR commands. .RE .sp .ne 2 -.mk .na \fB\fBN\fR\fR .ad .RS 13n -.rt Search in the forward direction for next match of the last pattern to \fI/\fR or \fI?\fR. .RE @@ -5070,29 +4512,24 @@ or \fI?\fR. The following commands modify the line: .sp .ne 2 -.mk .na \fB\fBa\fR\fR .ad .RS 19n -.rt Enter input mode and enter text after the current character. .RE .sp .ne 2 -.mk .na \fB\fBA\fR\fR .ad .RS 19n -.rt Append text to the end of the line. Equivalent to \fB$a\fR. .RE .sp .ne 2 -.mk .na \fB\fB[\fR\fIcount\fR\fB]c\fR\fImotion\fR\fR .ad @@ -5101,7 +4538,6 @@ Append text to the end of the line. Equivalent to \fB$a\fR. \fB\fBc[\fR\fIcount\fR\fB]\fR\fImotion\fR\fR .ad .RS 19n -.rt Delete current character through the character that \fImotion\fR would move the cursor to and enter input mode. If \fImotion\fR is \fBc\fR, the entire line is deleted and input mode entered. @@ -5109,194 +4545,160 @@ deleted and input mode entered. .sp .ne 2 -.mk .na \fB\fBC\fR\fR .ad .RS 19n -.rt Delete the current character through the end of line and enter input mode. Equivalent to \fBc$\fR. .RE .sp .ne 2 -.mk .na \fB\fBS\fR\fR .ad .RS 19n -.rt Equivalent to \fBcc\fR. .RE .sp .ne 2 -.mk .na \fB\fB[\fR\fIcount\fR\fB]s\fR\fR .ad .RS 19n -.rt Replace characters under the cursor in input mode. .RE .sp .ne 2 -.mk .na \fB\fBD[\fR\fIcount\fR\fB]d\fR\fImotion\fR\fR .ad .RS 19n -.rt Delete the current character through the end of line. Equivalent to d$. .RE .sp .ne 2 -.mk .na \fB\fBd[\fR\fIcount\fR\fB]\fR\fImotion\fR\fR .ad .RS 19n -.rt Delete current character through the character that \fImotion\fR would move to. If \fImotion\fR is d , the entire line is deleted. .RE .sp .ne 2 -.mk .na \fB\fBi\fR\fR .ad .RS 19n -.rt Enter input mode and insert text before the current character. .RE .sp .ne 2 -.mk .na \fB\fBI\fR\fR .ad .RS 19n -.rt Insert text before the beginning of the line. Equivalent to \fB0i\fR. .RE .sp .ne 2 -.mk .na \fB\fB[\fR\fIcount\fR\fB]P\fR\fR .ad .RS 19n -.rt Place the previous text modification before the cursor. .RE .sp .ne 2 -.mk .na \fB\fB[\fR\fIcount\fR\fB]p\fR\fR .ad .RS 19n -.rt Place the previous text modification after the cursor. .RE .sp .ne 2 -.mk .na \fB\fBR\fR\fR .ad .RS 19n -.rt Enter input mode and replace characters on the screen with characters you type overlay fashion. .RE .sp .ne 2 -.mk .na \fB\fB[\fR\fIcount\fR\fB]r\fR\fIc\fR\fR .ad .RS 19n -.rt Replace the \fIcount\fR characters starting at the current cursor position with \fIc\fR, and advance the cursor. .RE .sp .ne 2 -.mk .na \fB\fB[\fR\fIcount\fR\fB]x\fR\fR .ad .RS 19n -.rt Delete current character. .RE .sp .ne 2 -.mk .na \fB\fB[\fIcount\fR]X\fR\fR .ad .RS 19n -.rt Delete preceding character. .RE .sp .ne 2 -.mk .na \fB\fB[\fIcount\fR].\fR\fR .ad .RS 19n -.rt Repeat the previous text modification command. .RE .sp .ne 2 -.mk .na \fB\fB[\fIcount\fR]~\fR\fR .ad .RS 19n -.rt Invert the case of the \fIcount\fR characters starting at the current cursor position and advance the cursor. .RE .sp .ne 2 -.mk .na \fB\fB[\fIcount\fR]_\fR\fR .ad .RS 19n -.rt Causes the \fIcount\fR word of the previous command to be appended and input mode entered. The last word is used if \fIcount\fR is omitted. .RE .sp .ne 2 -.mk .na \fB\fB*\fR\fR .ad .RS 19n -.rt Causes an \fB*\fR to be appended to the current word and file name generation attempted. If no match is found, it rings the bell. Otherwise, the word is replaced by the matching pattern and input mode is entered. @@ -5304,12 +4706,10 @@ replaced by the matching pattern and input mode is entered. .sp .ne 2 -.mk .na \fB\fB\e\fR\fR .ad .RS 19n -.rt Command or file name completion as described in this manual page. .RE @@ -5319,7 +4719,6 @@ Command or file name completion as described in this manual page. The following miscellaneous edit commands are supported: .sp .ne 2 -.mk .na \fB\fB[\fR\fIcount\fR\fB]y\fR\fImotion\fR\fR .ad @@ -5328,7 +4727,6 @@ The following miscellaneous edit commands are supported: \fB\fBy[\fR\fIcount\fR\fB]\fR\fImotion\fR\fR .ad .RS 18n -.rt Yank the current character through the character to which \fImotion\fR would move the cursor. Put the yanked characters in the delete buffer. The text and cursor position are unchanged. @@ -5336,57 +4734,47 @@ cursor position are unchanged. .sp .ne 2 -.mk .na \fB\fByy\fR\fR .ad .RS 18n -.rt Yank the current line. .RE .sp .ne 2 -.mk .na \fB\fBY\fR\fR .ad .RS 18n -.rt Yank the current line from the current cursor location to the end of the line. Equivalent to \fBy$\fR. .RE .sp .ne 2 -.mk .na \fB\fBu\fR\fR .ad .RS 18n -.rt Undo the last text modifying command. .RE .sp .ne 2 -.mk .na \fB\fBU\fR\fR .ad .RS 18n -.rt Undo all the text modifying commands performed on current line. .RE .sp .ne 2 -.mk .na \fB\fB[\fR\fIcount\fR\fB]V\fR\fR .ad .RS 18n -.rt Return the command : .sp .in +2 @@ -5401,45 +4789,37 @@ in the input buffer. If \fIcount\fR is omitted, the current line is used. .sp .ne 2 -.mk .na \fB\fB^L\fR\fR .ad .RS 18n -.rt Line feed and print the current line. This command only works in control mode. .RE .sp .ne 2 -.mk .na \fB\fB^J\fR\fR .ad .RS 18n -.rt New line. Execute the current line, regardless of mode. .RE .sp .ne 2 -.mk .na \fB\fB^M\fR\fR .ad .RS 18n -.rt Return. Execute the current line, regardless of mode. .RE .sp .ne 2 -.mk .na \fB\fB#\fR\fR .ad .RS 18n -.rt If the first character of the command is a \fB#\fR , delete this \fB#\fR and each \fB#\fR that follows a NEWLINE. .sp @@ -5453,12 +4833,10 @@ history file. .sp .ne 2 -.mk .na \fB\fB[\fR\fIcount\fR\fB]=\fR\fR .ad .RS 18n -.rt If \fIcount\fR is not specified, generate the list of matching commands or file names as described in this manual page. .sp @@ -5469,24 +4847,20 @@ not on a word, it is inserted after the current cursor location. .sp .ne 2 -.mk .na \fB\fB@\fR\fIletter\fR\fR .ad .RS 18n -.rt Search your alias list for an alias by the name \fIletter\fR. If an alias of this name is defined, insert its value on the input queue for processing. .RE .sp .ne 2 -.mk .na \fB\fB^V\fR\fR .ad .RS 18n -.rt Display version of the shell. .RE @@ -5536,7 +4910,6 @@ field splitting and file name generation are not performed. .RE .sp .ne 2 -.mk .na \fB\fB+ : [\fR\fIarg ...\fR\fB]\fR\fR .ad @@ -5547,7 +4920,6 @@ The command only expands parameters. .sp .ne 2 -.mk .na \fB\fB+ .\fR \fIname\fR \fB[\fR\fIarg ...\fR\fB]\fR\fR .ad @@ -5567,7 +4939,6 @@ last command executed. .sp .ne 2 -.mk .na \fB\fB++ alias [\fR\fB-ptx\fR\fB] [\fR\fIname\fR\fB[ =\fR\fIvalue\fR\fB]] ...\fR\fR @@ -5592,7 +4963,6 @@ obsolete -x option has no effect. The exit status is \fBnon-zero\fR if a .sp .ne 2 -.mk .na \fB\fBbg [\fR \fIjob\fR\fB\&...]\fR\fR .ad @@ -5606,7 +4976,6 @@ a description of the format of \fIjob\fR. .sp .ne 2 -.mk .na \fB\fB+ break [\fR\fIn\fR\fB]\fR\fR .ad @@ -5618,7 +4987,6 @@ loop, if any. If \fIn\fR is specified, then break \fIn\fR levels. .sp .ne 2 -.mk .na \fB\fBbuiltin [\fR\fB-ds\fR \fB] [\fR\fB-f\fR \fIfile\fR\fB] [\fR\fIname ...\fR\fB]\fR\fR @@ -5648,7 +5016,6 @@ argument of \fB0\fR. .sp .ne 2 -.mk .na \fB\fBcd\fR \fB[\fR\fB-LP\fR\fB] [\fR\fIarg\fR\fB]\fR\fR .ad @@ -5684,7 +5051,6 @@ determines which method is used. The \fBcd\fR command cannot be executed by .sp .ne 2 -.mk .na \fB\fBcommand\fR \fB[\fR\fB-pvVx\fR\fB]\fR \fIname\fR \fB[\fR\fIarg ...\fR\fB]\fR\fR @@ -5716,7 +5082,6 @@ With the \fB-v\fR option, \fBcommand\fR is equivalent to the built-in .sp .ne 2 -.mk .na \fB\fB+continue\fR \fB[\fR\fIn\fR\fB]\fR\fR .ad @@ -5729,7 +5094,6 @@ Resumes the next iteration of the enclosing \fBfor\fR, \fBwhile\fR, .sp .ne 2 -.mk .na \fB\fBdisown\fR \fB[\fR\fIjob...\fR\fB]\fR\fR .ad @@ -5741,7 +5105,6 @@ all active jobs if \fIjob\fR is omitted, when a login shell terminates. .sp .ne 2 -.mk .na \fB\fBecho\fR \fB[\fR\fIarg ...\fR\fB]\fR\fR .ad @@ -5756,7 +5119,6 @@ this section should be used. See \fBecho\fR(1) for usage and description. .sp .ne 2 -.mk .na \fB\fB+eval\fR \fB[\fR\fIarg ...\fR\fB]\fR\fR .ad @@ -5768,7 +5130,6 @@ executed. .sp .ne 2 -.mk .na \fB\fB+exec\fR [\fB-c\fR] [\fB-a\fR \fIname ...\fR] \fB[\fR\fIarg ...\fR\fB]\fR\fR @@ -5789,7 +5150,6 @@ mechanism are closed when invoking another program. .sp .ne 2 -.mk .na \fB\fB+exit\fR \fB[\fR\fIn\fR\fB]\fR\fR .ad @@ -5804,7 +5164,6 @@ option turned on. See \fBset\fR. .sp .ne 2 -.mk .na \fB\fB++export\fR \fB[\fR\fB-p\fR\fB]\fR \fB[\fR\fIname\fR\fB[=\fR\fIvalue\fR\fB]] ...\fR\fR @@ -5820,7 +5179,6 @@ automatic export to the environment of subsequently-executed commands. .sp .ne 2 -.mk .na \fB\fBfalse\fR\fR .ad @@ -5831,7 +5189,6 @@ Does nothing, and exits \fB1\fR. Used with \fBuntil\fR for infinite loops. .sp .ne 2 -.mk .na \fB\fBfg\fR \fB[\fR\fIjob ...\fR\fB]\fR\fR .ad @@ -5845,7 +5202,6 @@ description of the format of \fIjob\fR. .sp .ne 2 -.mk .na \fB\fBgetconf\fR \fB[\fR\fIname\fR \fB[\fR\fIpathname\fR\fB]]\fR\fR .ad @@ -5864,7 +5220,6 @@ pathname \fB/\fR is used for each of the parameters that requires .sp .ne 2 -.mk .na \fB\fBgetopts\fR \fB[\fR \fB-a\fR \fIname\fR\fB]\fR \fIoptstring\fR \fIvname\fR \fB[\fR\fIarg ...\fR\fB]\fR\fR @@ -5896,7 +5251,6 @@ specified as the first option. .sp .ne 2 -.mk .na \fB\fBhist\fR \fB[\fR \fB-e\fR \fIename\fR\fB]\fR\fB[\fR\fB-nlr\fR\fB]\fR \fB[\fR \fIfirst\fR\fB[\fR\fIlast\fR \fB] ]\fR\fR @@ -5934,7 +5288,6 @@ the optional substitution \fIold\fR\fB=\fR\fInew\fR is performed. .sp .ne 2 -.mk .na \fB\fBjobs\fR \fB-lnp\fR \fB[\fR\fIjob ...\fR\fB]\fR\fR .ad @@ -5949,7 +5302,6 @@ listed. See \fBJobs\fR for a description of the format of \fIjob\fR. .sp .ne 2 -.mk .na \fB\fBkill\fR \fB[\fR\fB-s\fR \fIsigname\fR\fB]\fR \fIjob ...\fR\fR .ad @@ -5982,7 +5334,6 @@ number, the signal name corresponding to the least significant 8 bits of .sp .ne 2 -.mk .na \fB\fBlet\fR \fB[\fR\fIarg ...\fR\fB]\fR\fR .ad @@ -5996,7 +5347,6 @@ the last expression is \fBnon-zero\fR, and \fB1\fR otherwise. .sp .ne 2 -.mk .na \fB\fB+newgrp\fR \fB[\fR\fIarg ...\fR\fB]\fR\fR .ad @@ -6007,7 +5357,6 @@ Equivalent to \fBexec\fR \fB/bin/newgrp\fR \fIarg ...\fR .sp .ne 2 -.mk .na \fB\fBprint\fR [\fB-Renprs\fR] \fB[\fR \fB-u\fR \fIunit\fR\fB] [\fR \fB-f\fR \fIformat\fR \fB] [\fR \fIarg ...\fR\fB]\fR\fR @@ -6021,122 +5370,100 @@ described by \fBprintf\fR. In this case, any \fBe\fR, \fBn\fR, \fBr\fR, or specified, the following escape conventions are applied: .sp .ne 2 -.mk .na \fB\fB\ea\fR\fR .ad .RS 8n -.rt Alert character (\fBASCII\fR 07) .RE .sp .ne 2 -.mk .na \fB\fB\eb\fR\fR .ad .RS 8n -.rt Backspace character (\fBASCII\fR 010) .RE .sp .ne 2 -.mk .na \fB\fB\ec\fR\fR .ad .RS 8n -.rt Causes print to end without processing more arguments and not adding a NEWLINE .RE .sp .ne 2 -.mk .na \fB\fB\ef\fR\fR .ad .RS 8n -.rt Form-feed character (\fBASCII\fR 014) .RE .sp .ne 2 -.mk .na \fB\fB\en\fR\fR .ad .RS 8n -.rt NEWLINE character (\fBASCII\fR 012) .RE .sp .ne 2 -.mk .na \fB\fB\er\fR\fR .ad .RS 8n -.rt RETURN character (\fBASCII\fR 015) .RE .sp .ne 2 -.mk .na \fB\fB\et\fR\fR .ad .RS 8n -.rt TAB character (\fBASCII\fR 011) .RE .sp .ne 2 -.mk .na \fB\fB\ev\fR\fR .ad .RS 8n -.rt Vertical TAB character (\fBASCII\fR 013) .RE .sp .ne 2 -.mk .na \fB\fB\eE\fR\fR .ad .RS 8n -.rt Escape character (\fBASCII\fR 033) .RE .sp .ne 2 -.mk .na \fB\fB\e\e\fR\fR .ad .RS 8n -.rt Backslash character \fB\e\fR .RE .sp .ne 2 -.mk .na \fB\fB\e0\fR\fIx\fR\fR .ad .RS 8n -.rt Character defined by the 1, 2, or 3-digit octal string specified by \fIx\fR .RE @@ -6153,7 +5480,6 @@ arguments to be written onto the history file instead of standard output. The .sp .ne 2 -.mk .na \fB\fBprintf\fR \fIformat\fR\fB[\fR\fIarg ...\fR\fB]\fR\fR .ad @@ -6193,7 +5519,6 @@ field width. .sp .ne 2 -.mk .na \fB\fBpwd\fR [\fB-LP\fR]\fR .ad @@ -6208,7 +5533,6 @@ used. .sp .ne 2 -.mk .na \fB\fBread\fR \fB[\fR\fB-Aprs\fR\fB] [\fR\fB-d\fR \fIdelim\fR\fB] [\fR \fB-n\fR \fIn\fR\fB] [[\fR \fB-N\fR \fIn\fR\fB] [[\fR\fB-t\fR \fItimeout\fR\fB] @@ -6251,7 +5575,6 @@ end-of-file is encountered or read has timed out. .sp .ne 2 -.mk .na \fB\fB++readonly\fR \fB[\fR\fB-p\fR\fB] [\fR \fIvname\fR\fB[=\fR\fIvalue\fR\fB]] ...\fR\fR @@ -6267,7 +5590,6 @@ be inserted before each one. Otherwise, the specified \fIvname\fRs are marked .sp .ne 2 -.mk .na \fB\fB+return\fR \fB[\fR\fIn\fR\fB]\fR\fR .ad @@ -6282,7 +5604,6 @@ script, then it behaves the same as exit. .sp .ne 2 -.mk .na \fB\fB+set [ \(+-BCGabefhkmnoprstuvx] [\(+-o [\fR \fIoption\fR \fB] ] ... [ \(+-A\fR \fIvname\fR\fB]\fR \fB[\fR\fIarg...\fR\fB]\fR\fR @@ -6292,7 +5613,6 @@ script, then it behaves the same as exit. The \fBset\fR command supports the following options: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad @@ -6303,7 +5623,6 @@ All subsequent variables that are defined are automatically exported. .sp .ne 2 -.mk .na \fB\fB-A\fR\fR .ad @@ -6316,7 +5635,6 @@ unset first. .sp .ne 2 -.mk .na \fB\fB-b\fR\fR .ad @@ -6328,7 +5646,6 @@ than waiting for the next prompt. .sp .ne 2 -.mk .na \fB\fB-B\fR\fR .ad @@ -6339,7 +5656,6 @@ Enable brace pattern field generation. This is the default behavior. .sp .ne 2 -.mk .na \fB\fB-C\fR\fR .ad @@ -6352,7 +5668,6 @@ file when turned on. .sp .ne 2 -.mk .na \fB\fB-e\fR\fR .ad @@ -6364,7 +5679,6 @@ set, and exit. This mode is disabled while reading profiles. .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad @@ -6375,7 +5689,6 @@ Disables file name generation. .sp .ne 2 -.mk .na \fB\fB-G\fR\fR .ad @@ -6388,7 +5701,6 @@ by a \fB/\fR only directories and subdirectories are matched. .sp .ne 2 -.mk .na \fB\fB-h\fR\fR .ad @@ -6399,7 +5711,6 @@ Each command becomes a tracked alias when first encountered. .sp .ne 2 -.mk .na \fB\fB-k\fR\fR .ad @@ -6411,7 +5722,6 @@ command, not just those that precede the command name. .sp .ne 2 -.mk .na \fB\fB-m\fR\fR .ad @@ -6425,7 +5735,6 @@ for interactive shells. .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad @@ -6437,7 +5746,6 @@ Ignored for interactive shells. .sp .ne 2 -.mk .na \fB\fB-o\fR\fR .ad @@ -6451,7 +5759,6 @@ settings. This option can be repeated to enable or disable multiple options. The following argument can be one of the following option names: .sp .ne 2 -.mk .na \fB\fBallexport\fR\fR .ad @@ -6462,7 +5769,6 @@ Same as \fB-a\fR. .sp .ne 2 -.mk .na \fB\fBbgnice\fR\fR .ad @@ -6473,7 +5779,6 @@ All background jobs are run at a lower priority. This is the default mode. .sp .ne 2 -.mk .na \fB\fBbraceexpand\fR\fR .ad @@ -6484,7 +5789,6 @@ Same as \fB-\fRB. .sp .ne 2 -.mk .na \fB\fBemacs\fR\fR .ad @@ -6495,7 +5799,6 @@ Puts you in an \fBemacs\fR style inline editor for command entry. .sp .ne 2 -.mk .na \fB\fBerrexit\fR\fR .ad @@ -6506,7 +5809,6 @@ Same as \fB-e\fR. .sp .ne 2 -.mk .na \fB\fBglobstar\fR\fR .ad @@ -6517,7 +5819,6 @@ Same as \fB-G\fR. .sp .ne 2 -.mk .na \fB\fBgmacs\fR\fR .ad @@ -6528,7 +5829,6 @@ Puts you in a \fBgmacs\fR style inline editor for command entry. .sp .ne 2 -.mk .na \fB\fBignoreeof\fR\fR .ad @@ -6539,7 +5839,6 @@ The shell does not exit on end-of-file. The command \fBexit\fR must be used. .sp .ne 2 -.mk .na \fB\fBkeyword\fR\fR .ad @@ -6550,7 +5849,6 @@ Same as \fB-k\fR. .sp .ne 2 -.mk .na \fB\fBmarkdirs\fR\fR .ad @@ -6562,7 +5860,6 @@ appended. .sp .ne 2 -.mk .na \fB\fBmonitor\fR\fR .ad @@ -6573,7 +5870,6 @@ Same as \fB-m\fR. .sp .ne 2 -.mk .na \fB\fBmultiline\fR\fR .ad @@ -6585,7 +5881,6 @@ than the width of the screen. This might not work for all terminals. .sp .ne 2 -.mk .na \fB\fBnoclobber\fR\fR .ad @@ -6596,7 +5891,6 @@ Same as \fB-C\fR. .sp .ne 2 -.mk .na \fB\fBnoexec\fR\fR .ad @@ -6607,7 +5901,6 @@ Same as \fB-n\fR. .sp .ne 2 -.mk .na \fB\fBnoglob\fR\fR .ad @@ -6618,7 +5911,6 @@ Same as \fB-f\fR. .sp .ne 2 -.mk .na \fB\fBnolog\fR\fR .ad @@ -6629,7 +5921,6 @@ Do not save function definitions in the history file. .sp .ne 2 -.mk .na \fB\fBnotify\fR\fR .ad @@ -6640,7 +5931,6 @@ Same as \fB-b\fR. .sp .ne 2 -.mk .na \fB\fBnounset\fR\fR .ad @@ -6651,7 +5941,6 @@ Same as \fB-u\fR. .sp .ne 2 -.mk .na \fB\fBpipefail\fR\fR .ad @@ -6664,7 +5953,6 @@ to fail or zero if no command has failed. .sp .ne 2 -.mk .na \fB\fBprivileged\fR\fR .ad @@ -6675,7 +5963,6 @@ Same as \fB-p\fR. .sp .ne 2 -.mk .na \fB\fBshowme\fR\fR .ad @@ -6688,7 +5975,6 @@ Otherwise, the leading \fB;\fR is ignored. .sp .ne 2 -.mk .na \fB\fBtrackall\fR\fR .ad @@ -6699,7 +5985,6 @@ Same as \fB-h\fR. .sp .ne 2 -.mk .na \fB\fBverbose\fR\fR .ad @@ -6710,7 +5995,6 @@ Same as \fB-v\fR. .sp .ne 2 -.mk .na \fB\fBvi\fR\fR .ad @@ -6722,7 +6006,6 @@ escape character 033. This puts you in control mode. A return sends the line. .sp .ne 2 -.mk .na \fB\fBviraw\fR\fR .ad @@ -6733,7 +6016,6 @@ Each character is processed as it is typed in \fBvi\fR mode. .sp .ne 2 -.mk .na \fB\fBxtrace\fR\fR .ad @@ -6748,7 +6030,6 @@ If no option name is supplied, the current options settings are printed. .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad @@ -6763,7 +6044,6 @@ be set to the real \fBuid\fR and \fBgid\fR. .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad @@ -6774,7 +6054,6 @@ Enables the restricted shell. This option cannot be unset once set. .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad @@ -6785,7 +6064,6 @@ Sort the positional parameters lexicographically. .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad @@ -6796,7 +6074,6 @@ Obsolete. Exit after reading and executing one command. .sp .ne 2 -.mk .na \fB\fB-u\fR\fR .ad @@ -6807,7 +6084,6 @@ Treat \fBunset\fR parameters as an error when substituting. .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad @@ -6818,7 +6094,6 @@ Print shell input lines as they are read. .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad @@ -6829,7 +6104,6 @@ Print commands and their arguments as they are executed. .sp .ne 2 -.mk .na \fB\fB--\fR\fR .ad @@ -6852,7 +6126,6 @@ all variables are printed on the standard output. .sp .ne 2 -.mk .na \fB\fB+shift\fR \fB[\fR\fIn\fR\fB]\fR\fR .ad @@ -6866,7 +6139,6 @@ equal to \fB$#\fR. .sp .ne 2 -.mk .na \fB\fBsleep\fR \fIseconds\fR\fR .ad @@ -6878,7 +6150,6 @@ specified by \fIseconds\fR. .sp .ne 2 -.mk .na \fB\fB+trap\fR \fB-p\fR \fB[\fR\fIaction\fR\fB]\fR \fB[\fR\fIsig\fR\fB] ...\fR\fR @@ -6911,7 +6182,6 @@ a list of commands associated with each signal number. .sp .ne 2 -.mk .na \fB\fBtrue\fR\fR .ad @@ -6922,7 +6192,6 @@ Does nothing, and exits \fB0\fR. Used with while for infinite loops. .sp .ne 2 -.mk .na \fB\fB++typeset [\(+-AHflabnprtux ] [ \(+-EFLRZi[\fR\fIn\fR\fB] ] [\fR \fIvname\fR\fB[=\fR\fIvalue\fR \fB] ]\fR\fR @@ -6947,36 +6216,30 @@ printed. The following list of attributes can be specified: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 6n -.rt Declares \fIvname\fR to be an indexed array. This is optional unless except for compound variable assignments. .RE .sp .ne 2 -.mk .na \fB\fB-A\fR\fR .ad .RS 6n -.rt Declares \fIvname\fR to be an associative array. Sub-scripts are strings rather than arithmetic expressions. .RE .sp .ne 2 -.mk .na \fB\fB-b\fR\fR .ad .RS 6n -.rt The variable can hold any number of bytes of data. The data can be text or binary. The value is represented by the \fBbase64\fR encoding of the data. If \fB-Z\fR is also specified, the size in bytes of the data in the buffer is @@ -6989,12 +6252,10 @@ the data. .sp .ne 2 -.mk .na \fB\fB-E\fR\fR .ad .RS 6n -.rt Declares \fIvname\fR to be a double precision floating point number. If \fIn\fR is \fBnon-zero\fR, it defines the number of significant figures that are used when expanding \fIvname\fR. Otherwise, ten significant figures is used. @@ -7002,12 +6263,10 @@ when expanding \fIvname\fR. Otherwise, ten significant figures is used. .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 6n -.rt The names refer to function names rather than variable names. No assignments can be made and the only other valid options are \fB-t\fR, \fB-u\fR, and \fB-x.\fR The \fB-t\fR option turns on execution tracing for this function. The @@ -7024,12 +6283,10 @@ The \fB-i\fR attribute cannot be specified with \fB-f\fR. .sp .ne 2 -.mk .na \fB\fB-F\fR\fR .ad .RS 6n -.rt Declares \fIvname\fR to be a double precision floating point number. If \fIn\fR is \fBnon-zero\fR, it defines the number of places after the decimal point that are used when expanding \fIvname\fR. Otherwise ten places after the decimal @@ -7038,23 +6295,19 @@ point is used. .sp .ne 2 -.mk .na \fB\fB-H\fR\fR .ad .RS 6n -.rt This option provides UNIX to hostname file mapping on non-UNIX machines. .RE .sp .ne 2 -.mk .na \fB\fB-i\fR\fR .ad .RS 6n -.rt Declares \fIvname\fR to be represented internally as integer. The right hand side of an assignment is evaluated as an arithmetic expression when assigning to an integer. If \fIn\fR is \fBnon-zero\fR, it defines the output arithmetic @@ -7066,24 +6319,20 @@ The \fB-i\fR attribute cannot be specified along with \fB-R\fR, \fB-L\fR, .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 6n -.rt All uppercase characters are converted to lowercase. The uppercase option, \fB-u\fR, is turned off. .RE .sp .ne 2 -.mk .na \fB\fB-L\fR\fR .ad .RS 6n -.rt Left justify and remove leading blanks from \fIvalue\fR. If \fIn\fR is \fBnon-zero\fR, it defines the width of the field, otherwise it is determined by the width of the value of first assignment. When the variable is assigned @@ -7095,12 +6344,10 @@ The \fB-i\fR attribute cannot be specified with \fB-L\fR. .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 6n -.rt Declares \fIvname\fR to be a reference to the variable whose name is defined by the value of variable \fIvname\fR. This is usually used to reference a variable inside a function whose name has been passed as an argument. @@ -7108,12 +6355,10 @@ inside a function whose name has been passed as an argument. .sp .ne 2 -.mk .na \fB\fB-R\fR\fR .ad .RS 6n -.rt Right justify and fill with leading blanks. If \fIn\fR is \fBnon-zero\fR, it defines the width of the field, otherwise it is determined by the width of the value of first assignment. The field is left filled with blanks or truncated @@ -7124,48 +6369,40 @@ The \fB-i\fR attribute cannot be specified with \fB-R\fR. .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 6n -.rt The specified \fIvname\fRs are marked read-only and these names cannot be changed by subsequent assignment. .RE .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad .RS 6n -.rt Tags the variables. Tags are user definable and have no special meaning to the shell. .RE .sp .ne 2 -.mk .na \fB\fB-u\fR\fR .ad .RS 6n -.rt All lowercase characters are converted to uppercase. The lowercase option, \fB-l\fR, is turned off. .RE .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad .RS 6n -.rt The specified \fIvname\fRs are marked for automatic export to the environment of subsequently-executed commands. Variables whose names contain a . cannot be exported. @@ -7173,12 +6410,10 @@ exported. .sp .ne 2 -.mk .na \fB\fB-Z\fR\fR .ad .RS 6n -.rt Right justify and fill with leading zeros if the first non-blank character is a digit and the \fB-L\fR option has not been set. Remove leading zeros if the \fB-L\fR option is also set. If \fIn\fR is \fBnon-zero\fR, it defines the width @@ -7192,7 +6427,6 @@ The \fB-i\fR attribute cannot be specified with \fB-Z\fR. .sp .ne 2 -.mk .na \fB\fBulimit [\fR\fB-HSacdfmnpstv\fR\fB] [\fR \fIlimit\fR\fB]\fR\fR .ad @@ -7209,57 +6443,47 @@ If no option is specified, \fB-f\fR is assumed. The following are the available resource limits: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 6n -.rt Lists all of the current resource limits. .RE .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad .RS 6n -.rt The number of 512-byte blocks on the size of core dumps. .RE .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad .RS 6n -.rt The number of Kbytes on the size of the data area. .RE .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 6n -.rt The number of 512-byte blocks on files that can be written by the current process or by child processes (files of any size can be read). .RE .sp .ne 2 -.mk .na \fB\fB-H\fR\fR .ad .RS 6n -.rt Specifies a hard limit for the specified resource. .sp A hard limit cannot be increased once it is set. @@ -7271,56 +6495,46 @@ this case, the soft limit is printed unless \fB-H\fR is specified. .sp .ne 2 -.mk .na \fB\fB-m\fR\fR .ad .RS 6n -.rt The number of Kbytes on the size of physical memory. .RE .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 6n -.rt The number of file descriptors plus 1. .RE .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 6n -.rt The number of 512-byte blocks for pipe buffering. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 6n -.rt The number of Kbytes on the size of the stack area. .RE .sp .ne 2 -.mk .na \fB\fB-S\fR\fR .ad .RS 6n -.rt Specifies a soft limit for the specified resource. .sp A soft limit can be increased up to the value of the hard limit. @@ -7332,23 +6546,19 @@ this case, the soft limit is printed unless \fB-H\fR is specified. .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad .RS 6n -.rt The number of CPU seconds to be used by each process. .RE .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 6n -.rt The number of Kbytes for virtual memory. .RE @@ -7356,7 +6566,6 @@ The number of Kbytes for virtual memory. .sp .ne 2 -.mk .na \fB\fBumask\fR \fB[\fR\fB-S\fR\fB]\fR\fB[\fR\fImask\fR\fB]\fR\fR .ad @@ -7376,7 +6585,6 @@ See \fBumask\fR(2) .sp .ne 2 -.mk .na \fB\fB+unalias\fR \fB[\fR\fB-a\fR\fB]\fR \fIname\fR\fR .ad @@ -7388,7 +6596,6 @@ list. The \fB-a\fR option causes all the aliases to be unset. .sp .ne 2 -.mk .na \fB\fB+unset\fR \fB[\fR\fB-fnv\fR\fB]\fR \fIvname\fR\fR .ad @@ -7407,7 +6614,6 @@ their special meaning even if they are subsequently assigned to. .sp .ne 2 -.mk .na \fB\fBwait\fR \fB[\fR\fIjob\fR\fB]\fR\fR .ad @@ -7422,7 +6628,6 @@ of the format of \fIjob\fR. .sp .ne 2 -.mk .na \fB\fBwhence\fR \fB[\fR\fB-afpv\fR\fB]\fR \fIname ...\fR\fR .ad @@ -7460,12 +6665,10 @@ Commands are then read as described, and the following options are interpreted by the shell when it is invoked: .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad .RS 15n -.rt If the \fB-c\fR option is present, then commands are read from the first \fIarg\fR. Any remaining arguments become positional parameters starting at \fB0\fR. @@ -7473,12 +6676,10 @@ If the \fB-c\fR option is present, then commands are read from the first .sp .ne 2 -.mk .na \fB\fB-D\fR\fR .ad .RS 15n -.rt A list of all double quoted strings that are preceded by a \fB$\fR is printed on standard output and the shell exits. This set of strings is subject to language translation when the locale is not C or POSIX. No commands are @@ -7487,12 +6688,10 @@ executed. .sp .ne 2 -.mk .na \fB\fB-i\fR\fR .ad .RS 15n -.rt If the \fB-i\fR option is present or if the shell input and output are attached to a terminal (as told by \fBtcgetattr\fR(3C), this shell is interactive. In this case \fBTERM\fR is ignored (so that \fBkill 0\fR does not kill an @@ -7502,12 +6701,10 @@ interruptible). In all cases, \fBQUIT\fR is ignored by the shell. .sp .ne 2 -.mk .na \fB\fB-R\fR \fIfilename\fR\fR .ad .RS 15n -.rt The \fB-R\fR \fIfilename\fR option is used to generate a cross reference database that can be used by a separate utility to find definitions and references for variables and commands. @@ -7515,23 +6712,19 @@ references for variables and commands. .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 15n -.rt If the \fB-r\fR option is present, the shell is a restricted shell. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 15n -.rt If the \fB-s\fR option is present or if no arguments remain, then commands are read from the standard input. Shell output, except for the output of the \fBSpecial Commands\fR listed, is written to file descriptor 2. @@ -7621,7 +6814,6 @@ bytes). The following exit values are returned: .sp .ne 2 -.mk .na \fB\fBnon-zero\fR\fR .ad @@ -7637,7 +6829,6 @@ sub-shell is abandoned. .sp .ne 2 -.mk .na \fB\fIexit status of last command executed\fR\fR .ad @@ -7656,7 +6847,6 @@ See the \fBksh93 exit\fR command for additional details. .SH FILES .sp .ne 2 -.mk .na \fB\fB/etc/profile\fR\fR .ad @@ -7667,7 +6857,6 @@ The system initialization file, executed for login shells. .sp .ne 2 -.mk .na \fB\fB/etc/ksh.kshrc\fR\fR .ad @@ -7678,7 +6867,6 @@ The system wide startup file, executed for interactive shells. .sp .ne 2 -.mk .na \fB\fB$HOME/.profile\fR\fR .ad @@ -7690,7 +6878,6 @@ The personal initialization file, executed for login shells after .sp .ne 2 -.mk .na \fB\fB$HOME/.kshrc\fR\fR .ad @@ -7702,7 +6889,6 @@ interactive shells when \fBENV\fR is not set. .sp .ne 2 -.mk .na \fB\fB/etc/suid-profile\fR\fR .ad @@ -7714,7 +6900,6 @@ initialization file when the real and effective user or group id do not match. .sp .ne 2 -.mk .na \fB\fB/dev/null\fR\fR .ad @@ -7735,13 +6920,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilitySee below. +Interface Stability See below. .TE .sp diff --git a/usr/src/man/man1/ktutil.1 b/usr/src/man/man1/ktutil.1 index b228087441..b1060daf21 100644 --- a/usr/src/man/man1/ktutil.1 +++ b/usr/src/man/man1/ktutil.1 @@ -4,13 +4,13 @@ .\" 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 ktutil 1 "16 Nov 2006" "SunOS 5.11" "User Commands" +.TH KTUTIL 1 "Nov 16, 2006" .SH NAME ktutil \- Kerberos keytab maintenance utility .SH SYNOPSIS .LP .nf -\fB/usr/bin/ktutil\fR +\fB/usr/bin/ktutil\fR .fi .SH DESCRIPTION @@ -25,7 +25,6 @@ appropriate permissions. .SH COMMANDS .sp .ne 2 -.mk .na \fB\fBclear_list\fR\fR .ad @@ -34,13 +33,11 @@ appropriate permissions. \fB\fBclear\fR\fR .ad .RS 23n -.rt Clears the current keylist. .RE .sp .ne 2 -.mk .na \fB\fBread_kt\fR \fIfile\fR\fR .ad @@ -49,14 +46,12 @@ Clears the current keylist. \fB\fBrkt\fR \fIfile\fR\fR .ad .RS 23n -.rt Reads a keytab into the current keylist. You must specify a keytab \fIfile\fR to read. .RE .sp .ne 2 -.mk .na \fB\fBwrite_kt\fR \fIfile\fR\fR .ad @@ -65,7 +60,6 @@ to read. \fB\fBwkt\fR \fIfile\fR\fR .ad .RS 23n -.rt Writes the current keylist to a keytab \fIfile\fR. You must specify a keytab file to write. If the keytab file already exists, the current keylist is appended to the existing keytab file. @@ -73,7 +67,6 @@ appended to the existing keytab file. .sp .ne 2 -.mk .na \fB\fBadd_entry\fR \fInumber\fR\fR .ad @@ -82,14 +75,12 @@ appended to the existing keytab file. \fB\fBaddent\fR \fInumber\fR\fR .ad .RS 23n -.rt Adds an entry to the current keylist. Specify the entry by the keylist slot number. .RE .sp .ne 2 -.mk .na \fB\fBdelete_entry\fR \fInumber\fR\fR .ad @@ -98,14 +89,12 @@ number. \fB\fBdelent\fR \fInumber\fR\fR .ad .RS 23n -.rt Deletes an entry from the current keylist. Specify the entry by the keylist slot number. .RE .sp .ne 2 -.mk .na \fB\fBlist\fR\fR .ad @@ -114,13 +103,11 @@ slot number. \fB\fBl\fR\fR .ad .RS 23n -.rt Lists the current keylist. .RE .sp .ne 2 -.mk .na \fB\fBlist_request\fR\fR .ad @@ -129,13 +116,11 @@ Lists the current keylist. \fB\fBlr\fR\fR .ad .RS 23n -.rt Lists available requests (commands). .RE .sp .ne 2 -.mk .na \fB\fBquit\fR\fR .ad @@ -148,7 +133,6 @@ Lists available requests (commands). \fB\fBq\fR\fR .ad .RS 23n -.rt Exits utility. .RE @@ -189,12 +173,10 @@ example# \fBmv /tmp/krb5.keytab /etc/krb5/krb5.keytab\fR .SH FILES .sp .ne 2 -.mk .na \fB\fB/etc/krb5/krb5.keytab\fR\fR .ad .RS 25n -.rt keytab file for Kerberos clients .RE @@ -206,13 +188,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilitySee below. +Interface Stability See below. .TE .sp diff --git a/usr/src/man/man1/lari.1 b/usr/src/man/man1/lari.1 index cc4c72ba55..39e4ff3531 100644 --- a/usr/src/man/man1/lari.1 +++ b/usr/src/man/man1/lari.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 lari 1 "28 Nov 2007" "SunOS 5.11" "User Commands" +.TH LARI 1 "Nov 28, 2007" .SH NAME lari \- link analysis of runtime interfaces .SH SYNOPSIS @@ -64,7 +64,7 @@ directly to the runtime linker, \fBld.so.1\fR(1): .sp .in +2 .nf -\fBLD_DEBUG=files,bindings,detail LD_DEBUG_OUTPUT=lari.dbg \ +\fBLD_DEBUG=files,bindings,detail LD_DEBUG_OUTPUT=lari.dbg \ LD_BIND_NOW=yes\fR .fi .in -2 @@ -104,12 +104,10 @@ of these \fImapfiles\fR can be created by \fBlari\fR. The following options are supported. .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 13n -.rt Displays all interface information for the objects analyzed. \fBNote:\fR The output from this option can be substantial, but is often useful for piping to other analysis tools. @@ -117,12 +115,10 @@ other analysis tools. .sp .ne 2 -.mk .na \fB\fB-b\fR\fR .ad .RS 13n -.rt Limits the interface information to those symbols that have been explicitly bound to. \fBNote:\fR Symbols defined as protected might have been bound to from within the defining object. This binding is satisfied at link-edit time @@ -132,12 +128,10 @@ displayed with this option. .sp .ne 2 -.mk .na \fB\fB-C\fR\fR .ad .RS 13n -.rt Demangles C++ symbol names. This option is useful for augmenting runtime interface information. When generating interface definitions, demangled names are added to the \fImapfiles\fR as comments. @@ -145,36 +139,30 @@ are added to the \fImapfiles\fR as comments. .sp .ne 2 -.mk .na \fB\fB-d\fR \fImapdir\fR\fR .ad .RS 13n -.rt Defines the directory, \fImapdir\fR, in which \fImapfiles\fR are created. By default, the current working directory is used. .RE .sp .ne 2 -.mk .na \fB\fB-D\fR\fR .ad .RS 13n -.rt Interprets any input \fIfiles\fR as debugging information rather than as dynamic objects. .RE .sp .ne 2 -.mk .na \fB\fB-i\fR\fR .ad .RS 13n -.rt Displays interesting interface binding information. This mode is the default if no other output controlling option is supplied. See \fBInteresting Information\fR under EXTENDED DESCRIPTION. @@ -182,12 +170,10 @@ Information\fR under EXTENDED DESCRIPTION. .sp .ne 2 -.mk .na \fB\fB-m\fR\fR .ad .RS 13n -.rt Creates \fImapfiles\fR for each dynamic object that is processed. These \fImapfiles\fR reflect the interface requirements of each object as required by the input file being processed. @@ -195,12 +181,10 @@ the input file being processed. .sp .ne 2 -.mk .na \fB\fB-o\fR\fR .ad .RS 13n -.rt Limits the interface information to those symbols that are deemed an overhead. When creating \fImapfiles\fR, any overhead symbols are itemized as local symbols. See \fBOverhead Information\fR under EXTENDED DESCRIPTION. @@ -208,36 +192,30 @@ symbols. See \fBOverhead Information\fR under EXTENDED DESCRIPTION. .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 13n -.rt Saves the bindings information produced from \fBldd\fR(1) for further analysis. See FILES. .RE .sp .ne 2 -.mk .na \fB\fB-V\fR\fR .ad .RS 13n -.rt Appends interesting symbol visibilities. Symbols that are defined as \fBsingleton\fR or are defined \fBprotected\fR are identified with this option. .RE .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 13n -.rt Ignores any objects that are already versioned. Versioned objects have had their interfaces defined, but can contribute to the interface information displayed. For example, a versioned shared object might reveal overhead symbols @@ -271,12 +249,10 @@ information field provides one or more of the following tokens that describe the symbol's use: .sp .ne 2 -.mk .na \fB\fIcnt\fR:\fIbnd\fR\fR .ad .RS 11n -.rt Two decimal values indicate the symbol count, \fBcnt\fR, and the number of bindings to this object, \fBbnd\fR. The symbol count is the number of occurrences of this symbol definition that have been found in the objects that @@ -287,45 +263,37 @@ that have been bound to this symbol definition by the runtime linker. .sp .ne 2 -.mk .na \fB\fBE\fR\fR .ad .RS 11n -.rt This symbol definition has been bound to from an external object. .RE .sp .ne 2 -.mk .na \fB\fBS\fR\fR .ad .RS 11n -.rt This symbol definition has been bound to from the same object. .RE .sp .ne 2 -.mk .na \fB\fBD\fR\fR .ad .RS 11n -.rt This symbol definition has been directly bound to. .RE .sp .ne 2 -.mk .na \fB\fBI\fR\fR .ad .RS 11n -.rt This symbol definition provides for an interposer. An object that explicitly identifies itself as an interposor defines all global symbols as interposers. See the \fB-z\fR \fBinterpose\fR option of \fBld\fR(1), and the @@ -336,34 +304,28 @@ dynamic executable can be defined as interposers by using the \fBINTERPOSE\fR .sp .ne 2 -.mk .na \fB\fBC\fR\fR .ad .RS 11n -.rt This symbol definition is the reference data of a copy-relocation. .RE .sp .ne 2 -.mk .na \fB\fBF\fR\fR .ad .RS 11n -.rt This symbol definition resides in a filtee. .RE .sp .ne 2 -.mk .na \fB\fBP\fR\fR .ad .RS 11n -.rt This symbol is defined as protected. This symbol might have an internal binding from the object in which the symbol is declared. Any internal bindings with this attribute can not be interposed upon by another symbol definition. @@ -371,48 +333,40 @@ this attribute can not be interposed upon by another symbol definition. .sp .ne 2 -.mk .na \fB\fBA\fR\fR .ad .RS 11n -.rt This symbol definition is the address of a procedure linkage table entry within a dynamic executable. .RE .sp .ne 2 -.mk .na \fB\fBU\fR\fR .ad .RS 11n -.rt This symbol lookup originated from a user request, for example, \fBdlsym\fR(3C). .RE .sp .ne 2 -.mk .na \fB\fBR\fR\fR .ad .RS 11n -.rt This symbol definition is acting as a filter, and provides for redirection to a filtee. .RE .sp .ne 2 -.mk .na \fB\fBr\fR\fR .ad .RS 11n -.rt A binding to this symbol was rejected at some point during a symbol search. A rejection can occur when a direct binding request finds a symbol that has been tagged to prevent direct binding. In this scenario, the symbol search is @@ -424,12 +378,10 @@ is repeated using a default search model. .sp .ne 2 -.mk .na \fB\fBN\fR\fR .ad .RS 11n -.rt This symbol definition explicitly prohibits directly binding to the definition. .RE @@ -699,12 +651,10 @@ foo.so { .SH FILES .sp .ne 2 -.mk .na \fB\fB$TMPDIR/lari.dbg.\fIfile\fR\fR\fR .ad .RS 25n -.rt Binding output produced by \fBldd\fR(1). .RE @@ -716,13 +666,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilitySee below. +Interface Stability See below. .TE .sp diff --git a/usr/src/man/man1/last.1 b/usr/src/man/man1/last.1 index 91995ecbe4..1fe2b015ad 100644 --- a/usr/src/man/man1/last.1 +++ b/usr/src/man/man1/last.1 @@ -4,13 +4,13 @@ .\" 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 last 1 "24 Jul 2004" "SunOS 5.11" "User Commands" +.TH LAST 1 "Jul 24, 2004" .SH NAME last \- display login and logout information about users and terminals .SH SYNOPSIS .LP .nf -\fBlast\fR [\fB-a\fR] [\fB-n\fR \fInumber\fR | \fB-number\fR] [\fB-f\fR \fIfilename\fR] +\fBlast\fR [\fB-a\fR] [\fB-n\fR \fInumber\fR | \fB-number\fR] [\fB-f\fR \fIfilename\fR] [\fIname\fR | \fItty\fR]... .fi @@ -60,35 +60,29 @@ continues the search. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 25n -.rt Displays the hostname in the last column. .RE .sp .ne 2 -.mk .na \fB\fB-f\fR\fI filename\fR\fR .ad .RS 25n -.rt Uses \fIfilename\fR as the name of the accounting file instead of \fB/var/adm/wtmpx\fR. .RE .sp .ne 2 -.mk .na \fB\fB-n\fR\fI number\||\|\fR\fB-\fR\fInumber\fR\fR .ad .RS 25n -.rt Limits the number of entries displayed to that specified by \fInumber\fR. These options are identical; the \fB-\fR\fInumber\fR option is provided as a transition tool only and is removed in future releases. @@ -102,12 +96,10 @@ Date and time format is based on locale specified by the \fBLC_ALL\fR, .SH FILES .sp .ne 2 -.mk .na \fB\fB/var/adm/wtmpx\fR\fR .ad .RS 18n -.rt accounting file .RE diff --git a/usr/src/man/man1/lastcomm.1 b/usr/src/man/man1/lastcomm.1 index 0378f4cef5..4915a97dc0 100644 --- a/usr/src/man/man1/lastcomm.1 +++ b/usr/src/man/man1/lastcomm.1 @@ -4,13 +4,13 @@ .\" 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 "10 Jan 2000" "SunOS 5.11" "User Commands" +.TH LASTCOMM 1 "Jan 10, 2000" .SH NAME lastcomm \- display the last commands executed, in reverse order .SH SYNOPSIS .LP .nf -\fBlastcomm\fR [\fB-f\fR \fIfile\fR] [\fB-x\fR] [\fIcommand-name\fR] ... [\fIuser-name\fR] ... +\fBlastcomm\fR [\fB-f\fR \fIfile\fR] [\fB-x\fR] [\fIcommand-name\fR] ... [\fIuser-name\fR] ... [\fIterminal-name\fR] ... .fi @@ -53,23 +53,19 @@ have the following meanings: .sp .ne 2 -.mk .na \fB\fBF\fR\fR .ad .RS 5n -.rt The process performed a \fBfork\fR but not an \fBexec\fR. .RE .sp .ne 2 -.mk .na \fB\fBS\fR\fR .ad .RS 5n -.rt The process ran as a set-user-id program. .RE @@ -106,24 +102,20 @@ The date and time the process exited. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-f\fR \fIfile\fR\fR .ad .RS 11n -.rt Uses \fIfile\fR as the source of accounting data. \fIfile\fR may be either an extended process accounting file or a standard process accounting file. .RE .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad .RS 11n -.rt Uses the currently active extended process accounting file. If extended processing accounting is inactive, no output will be produced. .RE @@ -169,23 +161,19 @@ produces a listing of all the commands executed by user \fBroot\fR. .SH FILES .sp .ne 2 -.mk .na \fB\fB/var/adm/pacct\fR\fR .ad .RS 24n -.rt standard accounting file .RE .sp .ne 2 -.mk .na \fB\fB/var/adm/exacct/proc\fR\fR .ad .RS 24n -.rt extended accounting file .RE diff --git a/usr/src/man/man1/ld.1 b/usr/src/man/man1/ld.1 index 4acda64771..5e156f8a07 100644 --- a/usr/src/man/man1/ld.1 +++ b/usr/src/man/man1/ld.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 ld 1 "18 Sep 2009" "SunOS 5.11" "User Commands" +.TH LD 1 "Sep 18, 2009" .SH NAME ld \- link-editor for object files .SH SYNOPSIS @@ -141,7 +141,6 @@ processing of archive libraries, remains unchanged. The following options are supported. .sp .ne 2 -.mk .na \fB\fB-32\fR | \fB-64\fR\fR .ad @@ -168,7 +167,6 @@ link-editor\fR in \fILinker and Libraries Guide\fR. .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad @@ -182,7 +180,6 @@ Executables\fR under DESCRIPTION. .sp .ne 2 -.mk .na \fB\fB-b\fR\fR .ad @@ -205,7 +202,6 @@ relocation of 64-bit executables. .sp .ne 2 -.mk .na \fB\fB-B\fR \fBdirect\fR | \fBnodirect\fR\fR .ad @@ -235,7 +231,6 @@ Libraries Guide\fR. .sp .ne 2 -.mk .na \fB\fB-B\fR \fBdynamic\fR | \fBstatic\fR\fR .ad @@ -250,7 +245,6 @@ option. .sp .ne 2 -.mk .na \fB\fB-B\fR \fBeliminate\fR\fR .ad @@ -269,7 +263,6 @@ mapfile\fR in \fILinker and Libraries Guide\fR. .sp .ne 2 -.mk .na \fB\fB-B\fR \fBgroup\fR\fR .ad @@ -287,7 +280,6 @@ also asserts the \fB-z\fR \fBdefs\fR option. .sp .ne 2 -.mk .na \fB\fB-B\fR \fBlocal\fR\fR .ad @@ -306,7 +298,6 @@ objects. See also the \fB-B\fR \fBeliminate\fR option and the \fB-B\fR .sp .ne 2 -.mk .na \fB\fB-B\fR \fBreduce\fR\fR .ad @@ -325,7 +316,6 @@ shared object is created. .sp .ne 2 -.mk .na \fB\fB-B\fR \fBsymbolic\fR\fR .ad @@ -347,7 +337,6 @@ recommended. .sp .ne 2 -.mk .na \fB\fB-c\fR \fIname\fR\fR .ad @@ -360,7 +349,6 @@ together with providing alternative object dependencies. See \fBcrle\fR(1). .sp .ne 2 -.mk .na \fB\fB-C\fR\fR .ad @@ -371,7 +359,6 @@ Demangles C++ symbol names displayed in diagnostic messages. .sp .ne 2 -.mk .na \fB\fB-d\fR \fBy\fR | \fBn\fR\fR .ad @@ -385,7 +372,6 @@ linking. When \fB-d\fR \fBn\fR is specified, \fBld\fR uses static linking. See .sp .ne 2 -.mk .na \fB\fB-D\fR \fItoken\fR,...\fR .ad @@ -398,7 +384,6 @@ available. See \fIDebugging Aids\fR in \fILinker and Libraries Guide\fR. .sp .ne 2 -.mk .na \fB\fB-e\fR \fIepsym\fR\fR .ad @@ -413,7 +398,6 @@ Sets the entry point address for the output file to be the symbol \fIepsym\fR. .sp .ne 2 -.mk .na \fB\fB-f\fR \fIname\fR\fR .ad @@ -432,7 +416,6 @@ allowed. This option can not be combined with the \fB-F\fR option. See .sp .ne 2 -.mk .na \fB\fB-F\fR \fIname\fR\fR .ad @@ -451,7 +434,6 @@ Filters\fR in \fILinker and Libraries Guide\fR. .sp .ne 2 -.mk .na \fB\fB-G\fR\fR .ad @@ -467,7 +449,6 @@ See Chapter 4, \fIShared Objects,\fR in \fILinker and Libraries Guide\fR. .sp .ne 2 -.mk .na \fB\fB-h\fR \fIname\fR\fR .ad @@ -487,7 +468,6 @@ object to search for at runtime. See \fIRecording a Shared Object Name\fR in .sp .ne 2 -.mk .na \fB\fB-i\fR\fR .ad @@ -500,7 +480,6 @@ search, which would interfere with the link-editing being performed. .sp .ne 2 -.mk .na \fB\fB-I\fR \fIname\fR\fR .ad @@ -520,7 +499,6 @@ control to the interpreter rather than to the \fBa.out\fR directly. .sp .ne 2 -.mk .na \fB\fB-l\fR \fIx\fR\fR .ad @@ -548,7 +526,6 @@ of \fB-l\fR is significant. See \fILinking With Additional Libraries\fR in .sp .ne 2 -.mk .na \fB\fB-L\fR \fIpath\fR\fR .ad @@ -572,7 +549,6 @@ environment variable is also interpreted by the runtime environment. See .sp .ne 2 -.mk .na \fB\fB-m\fR\fR .ad @@ -584,7 +560,6 @@ any non-fatal multiply-defined symbols, on the standard output. .sp .ne 2 -.mk .na \fB\fB-M\fR \fImapfile\fR\fR .ad @@ -599,7 +574,6 @@ mapfiles are provided in \fB/usr/lib/ld\fR. See FILES. .sp .ne 2 -.mk .na \fB\fB-N\fR \fIstring\fR\fR .ad @@ -616,7 +590,6 @@ when combined with the \fB-dy\fR and \fB-r\fR options. .sp .ne 2 -.mk .na \fB\fB-o\fR \fIoutfile\fR\fR .ad @@ -632,7 +605,6 @@ default object file is \fBa.out\fR. .sp .ne 2 -.mk .na \fB\fB-p\fR \fIauditlib\fR\fR .ad @@ -648,7 +620,6 @@ Guide\fR. .sp .ne 2 -.mk .na \fB\fB-P\fR \fIauditlib\fR\fR .ad @@ -664,7 +635,6 @@ Guide\fR. .sp .ne 2 -.mk .na \fB\fB-Q\fR \fBy\fR | \fBn\fR\fR .ad @@ -681,7 +651,6 @@ sections can be manipulated by the \fBmcs\fR(1) utility. .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad @@ -698,7 +667,6 @@ used with the \fB-a\fR option. .sp .ne 2 -.mk .na \fB\fB-R\fR \fIpath\fR\fR .ad @@ -730,7 +698,6 @@ dynamic objects to be relocated to different locations in the file system. .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad @@ -752,7 +719,6 @@ and \fB-z\fR \fBnoldynsym\fR options. .sp .ne 2 -.mk .na \fB\fB-S\fR \fIsupportlib\fR\fR .ad @@ -767,7 +733,6 @@ Libraries Guide\fR. .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad @@ -779,7 +744,6 @@ different alignments. .sp .ne 2 -.mk .na \fB\fB-u\fR \fIsymname\fR\fR .ad @@ -799,7 +763,6 @@ Additional Symbols with the u option\fR in \fILinker and Libraries Guide\fR. .sp .ne 2 -.mk .na \fB\fB-V\fR\fR .ad @@ -814,7 +777,6 @@ Outputs a message giving information about the version of \fBld\fR being used. .sp .ne 2 -.mk .na \fB\fB-Y\fR \fBP,\fR\fIdirlist\fR\fR .ad @@ -826,7 +788,6 @@ colon-separated path list. .sp .ne 2 -.mk .na \fB\fB-z\fR \fBabsexec\fR\fR .ad @@ -841,7 +802,6 @@ executable. .sp .ne 2 -.mk .na \fB\fB-z\fR \fBallextract\fR | \fBdefaultextract\fR | \fBweakextract\fR\fR .ad @@ -865,7 +825,6 @@ Guide\fR. .sp .ne 2 -.mk .na \fB\fB-z\fR \fBaltexec64\fR\fR .ad @@ -881,7 +840,6 @@ link-editor\fR in \fILinker and Libraries Guide\fR. .sp .ne 2 -.mk .na \fB\fB-z\fR \fBcombreloc\fR | \fBnocombreloc\fR\fR .ad @@ -911,7 +869,6 @@ option is unnecessary, and has no effect. .sp .ne 2 -.mk .na \fB\fB-z\fR \fBdefs\fR | \fBnodefs\fR\fR .ad @@ -937,7 +894,6 @@ unspecified. Use of the \fB-z\fR \fBnodefs\fR option is not recommended. .sp .ne 2 -.mk .na \fB\fB-z\fR \fBdirect\fR | \fBnodirect\fR\fR .ad @@ -954,7 +910,6 @@ enabled. .sp .ne 2 -.mk .na \fB\fB-z\fR \fBendfiltee\fR\fR .ad @@ -967,7 +922,6 @@ further filtee searches by the filter. See \fIReducing Filtee Searches\fR in .sp .ne 2 -.mk .na \fB\fB-z\fR \fBfiniarray=\fR\fIfunction\fR\fR .ad @@ -981,7 +935,6 @@ Termination Sections\fR in \fILinker and Libraries Guide\fR. .sp .ne 2 -.mk .na \fB\fB-z\fR \fBglobalaudit\fR\fR .ad @@ -1002,7 +955,6 @@ the \fBLD_AUDIT\fR environment variable. See \fBld.so.1\fR(1). .sp .ne 2 -.mk .na \fB\fB-z\fR \fBgroupperm\fR | \fBnogroupperm\fR\fR .ad @@ -1015,7 +967,6 @@ had been built using the \fB-B\fR \fBgroup\fR option. .sp .ne 2 -.mk .na \fB\fB-z\fR \fBhelp\fR\fR .ad @@ -1030,7 +981,6 @@ Print a summary of the command line options on the standard output and exit. .sp .ne 2 -.mk .na \fB\fB-z\fR \fBignore\fR | \fBrecord\fR\fR .ad @@ -1050,7 +1000,6 @@ contributes to the link-edit, must reference an eliminated section. .sp .ne 2 -.mk .na \fB\fB-z\fR \fBinitarray=\fR\fIfunction\fR\fR .ad @@ -1064,7 +1013,6 @@ Termination Sections\fR in \fILinker and Libraries Guide\fR. .sp .ne 2 -.mk .na \fB\fB-z\fR \fBinitfirst\fR\fR .ad @@ -1079,7 +1027,6 @@ This option is only meaningful when building a shared object. .sp .ne 2 -.mk .na \fB\fB-z\fR \fBinterpose\fR\fR .ad @@ -1099,7 +1046,6 @@ effect. .sp .ne 2 -.mk .na \fB\fB-z\fR \fBlazyload\fR | \fBnolazyload\fR\fR .ad @@ -1116,7 +1062,6 @@ and Libraries Guide\fR. .sp .ne 2 -.mk .na \fB\fB-z\fR \fBld32\fR=\fIarg1\fR,\fIarg2\fR,...\fR .ad @@ -1150,7 +1095,6 @@ determination is carried out \fBprior\fR to any \fB-z\fR .sp .ne 2 -.mk .na \fB\fB-z\fR \fBloadfltr\fR\fR .ad @@ -1165,7 +1109,6 @@ in effect. See the \fBld.so.1\fR(1). .sp .ne 2 -.mk .na \fB\fB-z\fR \fBmuldefs\fR\fR .ad @@ -1183,7 +1126,6 @@ be taken. .sp .ne 2 -.mk .na \fB\fB-z\fR \fBnocompstrtab\fR\fR .ad @@ -1197,7 +1139,6 @@ set. .sp .ne 2 -.mk .na \fB\fB-z\fR \fBnodefaultlib\fR\fR .ad @@ -1210,7 +1151,6 @@ dependencies of the object can be satisfied from its runpath. .sp .ne 2 -.mk .na \fB\fB-z\fR \fBnodelete\fR\fR .ad @@ -1223,7 +1163,6 @@ the object to the process by using \fBdlopen\fR(3C) with the .sp .ne 2 -.mk .na \fB\fB-z\fR \fBnodlopen\fR\fR .ad @@ -1237,7 +1176,6 @@ building a shared object. .sp .ne 2 -.mk .na \fB\fB-z\fR \fBnodump\fR\fR .ad @@ -1248,7 +1186,6 @@ Marks the object as not available to \fBdldump\fR(3C). .sp .ne 2 -.mk .na \fB\fB-z\fR \fBnoldynsym\fR\fR .ad @@ -1276,7 +1213,6 @@ See the \fB-s\fR and \fB-z\fR \fBredlocsym\fR options. .sp .ne 2 -.mk .na \fB\fB-z\fR \fBnopartial\fR\fR .ad @@ -1288,7 +1224,6 @@ files, are expanded in the output file being generated. .sp .ne 2 -.mk .na \fB\fB-z\fR \fBnoversion\fR\fR .ad @@ -1300,7 +1235,6 @@ Does not record any versioning sections. Any version sections or associated .sp .ne 2 -.mk .na \fB\fB-z\fR \fBnow\fR\fR .ad @@ -1314,7 +1248,6 @@ environment variable in effect. See \fBld.so.1\fR(1). .sp .ne 2 -.mk .na \fB\fB-z\fR \fBorigin\fR\fR .ad @@ -1327,7 +1260,6 @@ analysis of objects to provide for \fB$ORIGIN\fR processing is now default. .sp .ne 2 -.mk .na \fB\fB-z\fR \fBpreinitarray=\fR\fIfunction\fR\fR .ad @@ -1341,7 +1273,6 @@ and Termination Sections\fR in \fILinker and Libraries Guide\fR. .sp .ne 2 -.mk .na \fB\fB-z\fR \fBredlocsym\fR\fR .ad @@ -1358,7 +1289,6 @@ options. .sp .ne 2 -.mk .na \fB\fB-z\fR \fBrelaxreloc\fR\fR .ad @@ -1374,7 +1304,6 @@ authors, and is not intended for general use. .sp .ne 2 -.mk .na \fB\fB-z\fR \fBrescan-now\fR\fR .ad @@ -1410,7 +1339,6 @@ advised. .sp .ne 2 -.mk .na \fB\fB-z\fR \fBrescan-start\fR ... \fB-z\fR \fBrescan-end\fR\fR .ad @@ -1435,7 +1363,6 @@ Archive rescan groups cannot be nested. .sp .ne 2 -.mk .na \fB\fB-z\fR \fBtarget=sparc|x86\fR \fI\fR\fR .ad @@ -1459,7 +1386,6 @@ link-editor\fR in \fILinker and Libraries Guide\fR. .sp .ne 2 -.mk .na \fB\fB-z\fR \fBtext\fR\fR .ad @@ -1476,7 +1402,6 @@ incurs the least relocation overhead when loaded into memory. See .sp .ne 2 -.mk .na \fB\fB-z\fR \fBtextoff\fR\fR .ad @@ -1489,7 +1414,6 @@ object. .sp .ne 2 -.mk .na \fB\fB-z\fR \fBtextwarn\fR\fR .ad @@ -1502,7 +1426,6 @@ executable. .sp .ne 2 -.mk .na \fB\fB-z\fR \fBverbose\fR\fR .ad @@ -1517,7 +1440,6 @@ additional diagnostics that are deemed too noisy to be generated by default. .sp .ne 2 -.mk .na \fB\fB-z\fR\fBwrap=\fR\fIsymbol\fR\fR .ad @@ -1567,7 +1489,6 @@ occurring. .SH ENVIRONMENT VARIABLES .sp .ne 2 -.mk .na \fB\fBLD_ALTEXEC\fR\fR .ad @@ -1581,7 +1502,6 @@ compiler drivers. See the \fB-z altexec64\fR option. .sp .ne 2 -.mk .na \fB\fBLD_LIBRARY_PATH\fR\fR .ad @@ -1631,7 +1551,6 @@ effect. .sp .ne 2 -.mk .na \fB\fBLD_NOEXEC_64\fR\fR .ad @@ -1646,7 +1565,6 @@ find the use of the 32-bit link-editor faster. .sp .ne 2 -.mk .na \fB\fBLD_OPTIONS\fR\fR .ad @@ -1667,7 +1585,6 @@ immediately following the name used to invoke \fBld\fR, as in: .sp .ne 2 -.mk .na \fB\fBLD_RUN_PATH\fR\fR .ad @@ -1680,7 +1597,6 @@ specified, \fB-R\fR supersedes. .sp .ne 2 -.mk .na \fB\fBSGS_SUPPORT\fR\fR .ad @@ -1702,45 +1618,37 @@ characters '\fBLD_\fR' are reserved for possible future enhancements to \fBld\fR .SH FILES .sp .ne 2 -.mk .na \fB\fBlib\fIx\fR.so\fR\fR .ad .RS 15n -.rt shared object libraries. .RE .sp .ne 2 -.mk .na \fB\fBlib\fIx\fR.a\fR\fR .ad .RS 15n -.rt archive libraries. .RE .sp .ne 2 -.mk .na \fB\fBa.out\fR\fR .ad .RS 15n -.rt default output file. .RE .sp .ne 2 -.mk .na \fB\fILIBPATH\fR\fR .ad .RS 15n -.rt For 32-bit libraries, the default search path is \fB/usr/ccs/lib\fR, followed by \fB/lib\fR, and finally \fB/usr/lib\fR. For 64-bit libraries, the default search path is \fB/lib/64\fR, followed by \fB/usr/lib/64\fR. @@ -1748,12 +1656,10 @@ search path is \fB/lib/64\fR, followed by \fB/usr/lib/64\fR. .sp .ne 2 -.mk .na \fB\fB/usr/lib/ld\fR\fR .ad .RS 15n -.rt A directory containing several \fBmapfiles\fR that can be used during link-editing. These \fBmapfiles\fR provide various capabilities, such as defining memory layouts, aligning bss, and defining non-executable stacks. @@ -1767,13 +1673,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed .TE .SH SEE ALSO diff --git a/usr/src/man/man1/ld.so.1.1 b/usr/src/man/man1/ld.so.1.1 index 7a6ef269a9..b86dfdce5e 100644 --- a/usr/src/man/man1/ld.so.1.1 +++ b/usr/src/man/man1/ld.so.1.1 @@ -3,13 +3,13 @@ .\" 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.so.1 1 "26 Aug 2009" "SunOS 5.11" "User Commands" +.TH LD.SO.1 1 "Aug 26, 2009" .SH NAME ld.so.1 \- runtime linker for dynamic objects .SH SYNOPSIS .LP .nf -\fB/lib/ld.so.1\fR +\fB/lib/ld.so.1\fR .fi .LP @@ -158,12 +158,10 @@ dynamic object. The following option is supported: .sp .ne 2 -.mk .na \fB\fB-e\fR\ envar\fR .ad .RS 13n -.rt Specify a runtime linker specific environment variable. See ENVIRONMENT VARIABLES. .RE @@ -179,7 +177,6 @@ variables specified without a value, that have a \fB_32\fR or \fB_64\fR suffix, effectively cancel any associated generic environment variable setting. .sp .ne 2 -.mk .na \fB\fBLD_AUDIT\fR, \fBLD_AUDIT_32\fR, and \fBLD_AUDIT_64\fR\fR .ad @@ -194,7 +191,6 @@ Guide\fR. Also, see the \fB-p\fR and \fB-P\fR options of \fBld\fR(1). .sp .ne 2 -.mk .na \fB\fBLD_BIND_LAZY\fR, \fBLD_BIND_LAZY_32\fR, and \fBLD_BIND_LAZY_64\fR\fR .ad @@ -216,7 +212,6 @@ If both \fBLD_BIND_LAZY\fR and \fBLD_BIND_NOW\fR are specified, then .sp .ne 2 -.mk .na \fB\fBLD_BIND_NOW\fR, \fBLD_BIND_NOW_32\fR, and \fBLD_BIND_NOW_64\fR\fR .ad @@ -236,7 +231,6 @@ If both \fBLD_BIND_NOW\fR and \fBLD_BIND_LAZY\fR are specified, then .sp .ne 2 -.mk .na \fB\fBLD_CONFIG\fR, \fBLD_CONFIG_32\fR, and \fBLD_CONFIG_64\fR\fR .ad @@ -249,7 +243,6 @@ object dependencies. See \fBcrle\fR(1). .sp .ne 2 -.mk .na \fB\fBLD_DEBUG\fR, \fBLD_DEBUG_32\fR, and \fBLD_DEBUG_64\fR\fR .ad @@ -266,7 +259,6 @@ debugging information is sent. The filename is suffixed with the process .sp .ne 2 -.mk .na \fB\fBLD_DEMANGLE\fR, \fBLD_DEMANGLE_32\fR, and \fBLD_DEMANGLE_64\fR\fR .ad @@ -279,7 +271,6 @@ runtime linker attempts to decode (demangle) any C++ symbol name. .sp .ne 2 -.mk .na \fB\fBLD_FLAGS\fR, \fBLD_FLAGS_32\fR, and \fBLD_FLAGS_64\fR\fR .ad @@ -293,7 +284,6 @@ EXAMPLES. .sp .ne 2 -.mk .na \fB\fBLD_LIBRARY_PATH\fR, \fBLD_LIBRARY_PATH_32\fR, and \fBLD_LIBRARY_PATH_64\fR\fR @@ -309,7 +299,6 @@ adds additional semantics to \fBld\fR(1). .sp .ne 2 -.mk .na \fB\fBLD_LOADFLTR\fR, \fBLD_LOADFLTR_32\fR, and \fBLD_LOADFLTR_64\fR\fR .ad @@ -326,7 +315,6 @@ filter is loaded. Also, see the \fB-z\fR \fBloadfltr\fR option of \fBld\fR(1). .sp .ne 2 -.mk .na \fB\fBLD_NOAUDIT\fR, \fBLD_NOAUDIT_32\fR, and \fBLD_NOAUDIT_64\fR\fR .ad @@ -340,7 +328,6 @@ libraries. .sp .ne 2 -.mk .na \fB\fBLD_NOAUXFLTR\fR, \fBLD_NOAUXFLTR_32\fR, and \fBLD_NOAUXFLTR_64\fR\fR .ad @@ -355,7 +342,6 @@ value, the runtime linker disables this alternative shared object lookup. .sp .ne 2 -.mk .na \fB\fBLD_NOCONFIG\fR, \fBLD_NOCONFIG_32\fR, and \fBLD_NOCONFIG_64\fR\fR .ad @@ -368,7 +354,6 @@ disables this configuration file processing. .sp .ne 2 -.mk .na \fB\fBLD_NODIRCONFIG\fR, \fBLD_NODIRCONFIG_32\fR, and \fBLD_NODIRCONFIG_64\fR\fR @@ -381,7 +366,6 @@ provided in a configuration file is ignored. .sp .ne 2 -.mk .na \fB\fBLD_NODIRECT\fR, \fBLD_NODIRECT_32\fR, and \fBLD_NODIRECT_64\fR\fR .ad @@ -396,7 +380,6 @@ value, the runtime linker ignores any direct binding information. .sp .ne 2 -.mk .na \fB\fBLD_NOENVCONFIG\fR, \fBLD_NOENVCONFIG_32\fR, and \fBLD_NOENVCONFIG_64\fR\fR @@ -409,7 +392,6 @@ provided in a configuration file are ignored. .sp .ne 2 -.mk .na \fB\fBLD_NOLAZYLOAD\fR, \fBLD_NOLAZYLOAD_32\fR, and \fBLD_NOLAZYLOAD_64\fR\fR .ad @@ -424,7 +406,6 @@ and loads the dependency immediately. .sp .ne 2 -.mk .na \fB\fBLD_NOOBJALTER\fR, \fBLD_NOOBJALTER_32\fR, and \fBLD_NOOBJALTER_64\fR\fR .ad @@ -436,7 +417,6 @@ dependencies provided in a configuration file are ignored. .sp .ne 2 -.mk .na \fB\fBLD_NOVERSION\fR, \fBLD_NOVERSION_32\fR, and \fBLD_NOVERSION_64\fR\fR .ad @@ -449,7 +429,6 @@ non-null value, the runtime linker disables this version checking. .sp .ne 2 -.mk .na \fB\fBLD_ORIGIN\fR, \fBLD_ORIGIN_32\fR, and \fBLD_ORIGIN_64\fR\fR .ad @@ -465,7 +444,6 @@ default thus making this option redundant. .sp .ne 2 -.mk .na \fB\fBLD_PRELOAD\fR, \fBLD_PRELOAD_32\fR, and \fBLD_PRELOAD_64\fR\fR .ad @@ -481,7 +459,6 @@ interpose on the symbol definitions provided by the program. .sp .ne 2 -.mk .na \fB\fBLD_PROFILE\fR, \fBLD_PROFILE_32\fR, and \fBLD_PROFILE_64\fR\fR .ad @@ -511,7 +488,6 @@ objects. .sp .ne 2 -.mk .na \fB\fBLD_SIGNAL\fR, \fBLD_SIGNAL_32\fR, and \fBLD_SIGNAL_64\fR\fR .ad @@ -637,7 +613,6 @@ example% \fBLD_FLAGS_64=library_path=/lib/one/64,preload=foo.so\fR .SH FILES .sp .ne 2 -.mk .na \fB\fB/lib/ld.so.1\fR\fR .ad @@ -648,7 +623,6 @@ Default runtime linker. .sp .ne 2 -.mk .na \fB\fB/lib/libc.so.1\fR\fR .ad @@ -659,7 +633,6 @@ Alternate interpreter for \fBSVID ABI\fR compatibility. .sp .ne 2 -.mk .na \fB\fB/usr/lib/ld.so\fR\fR .ad @@ -670,7 +643,6 @@ Alternate interpreter for \fBSVID ABI\fR compatibility. .sp .ne 2 -.mk .na \fB\fB/usr/lib/0@0.so.1\fR\fR .ad @@ -681,7 +653,6 @@ A compatibility library to support null character pointers. See NOTES. .sp .ne 2 -.mk .na \fB\fB/lib/secure\fR and \fB/usr/lib/secure\fR\fR .ad @@ -692,7 +663,6 @@ A compatibility library to support null character pointers. See NOTES. .sp .ne 2 -.mk .na \fB\fB/lib/secure/64\fR and \fB/usr/lib/secure/64\fR\fR .ad @@ -703,7 +673,6 @@ A compatibility library to support null character pointers. See NOTES. .sp .ne 2 -.mk .na \fB\fB/lib/64/ld.so.1\fR\fR .ad @@ -714,7 +683,6 @@ Default runtime linker for 64-bit applications. .sp .ne 2 -.mk .na \fB\fB/usr/lib/64/0@0.so.1\fR\fR .ad @@ -725,7 +693,6 @@ A 64-bit compatibility library to support null character pointers. See NOTES. .sp .ne 2 -.mk .na \fB\fB/var/ld/ld.config\fR\fR .ad @@ -736,7 +703,6 @@ Default configuration file for 32-bit applications. .sp .ne 2 -.mk .na \fB\fB/var/ld/64/ld.config\fR\fR .ad diff --git a/usr/src/man/man1/ldap.1 b/usr/src/man/man1/ldap.1 index 96715889c3..febdc2a95c 100644 --- a/usr/src/man/man1/ldap.1 +++ b/usr/src/man/man1/ldap.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 ldap 1 "28 Aug 2006" "SunOS 5.11" "User Commands" +.TH LDAP 1 "Aug 28, 2006" .SH NAME ldap \- LDAP as a naming repository .SH DESCRIPTION @@ -77,52 +77,51 @@ the use of \fBserviceSearchDescriptors\fR. For more information, see .sp .TS -tab() box; -cw(1.83i) |cw(1.83i) |cw(1.83i) -lw(1.83i) |lw(1.83i) |lw(1.83i) -. -DatabaseObject ClassContainer +box; +c | c | c +l | l | l . +Database Object Class Container _ -passwdposixAccountou=people,dc=... -shadowAccount +passwd posixAccount ou=people,dc=... + shadowAccount _ -groupposixGroupou=Group,dc=... +group posixGroup ou=Group,dc=... _ -servicesipServiceou=Services,dc=... +services ipService ou=Services,dc=... _ -protocolsipProtocolou=Protocols,dc=... +protocols ipProtocol ou=Protocols,dc=... _ -rpconcRpcou=Rpc,dc=... +rpc oncRpc ou=Rpc,dc=... _ -hostsipHostou=Hosts,dc=... -ipnodesipHostou=Hosts,dc=... +hosts ipHost ou=Hosts,dc=... +ipnodes ipHost ou=Hosts,dc=... _ -ethersieee802Deviceou=Ethers,dc=... +ethers ieee802Device ou=Ethers,dc=... _ -bootparamsbootableDeviceou=Ethers,dc=... +bootparams bootableDevice ou=Ethers,dc=... _ -networksipNetworkou=Networks,dc=... -netmasksipNetwork ou=Networks,dc=... +networks ipNetwork ou=Networks,dc=... +netmasks ipNetwork ou=Networks,dc=... _ -netgroupnisNetgroupou=Netgroup,dc=... +netgroup nisNetgroup ou=Netgroup,dc=... _ -aliasesmailGroupou=Aliases,dc=... +aliases mailGroup ou=Aliases,dc=... _ -publickeynisKeyObject +publickey nisKeyObject _ -genericnisObjectnisMapName=...,dc=... +generic nisObject nisMapName=...,dc=... _ -printersprinterServiceou=Printers,dc=... +printers printerService ou=Printers,dc=... _ -auth_attrSolarisAuthAttrou=SolarisAuthAttr,dc=... +auth_attr SolarisAuthAttr ou=SolarisAuthAttr,dc=... _ -prof_attrSolarisProfAttrou=SolarisProfAttr,dc=... +prof_attr SolarisProfAttr ou=SolarisProfAttr,dc=... _ -exec_attrSolarisExecAttrou=SolarisProfAttr,dc=... +exec_attr SolarisExecAttr ou=SolarisProfAttr,dc=... _ -user_attrSolarisUserAttrou=people,dc=... +user_attr SolarisUserAttr ou=people,dc=... _ -audit_userSolarisAuditUserou=people,dc=... +audit_user SolarisAuditUser ou=people,dc=... .TE .sp @@ -222,53 +221,44 @@ different databases in the \fBnsswitch.conf\fR file. The following is a list of the user commands related to LDAP: .sp .ne 2 -.mk .na \fB\fBidsconfig\fR(1M)\fR .ad .RS 18n -.rt Prepares a SunOne Directory Server to be ready to support Solaris LDAP clients. .RE .sp .ne 2 -.mk .na \fB\fBldapaddent\fR(1M)\fR .ad .RS 18n -.rt Creates LDAP entries from corresponding \fB/etc\fR files. .RE .sp .ne 2 -.mk .na \fB\fBldapclient\fR(1M)\fR .ad .RS 18n -.rt Initializes LDAP clients, or generates a configuration profile to be stored in the directory. .RE .sp .ne 2 -.mk .na \fB\fBldaplist\fR(1)\fR .ad .RS 18n -.rt Lists the contents of the LDAP naming space. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB/var/ldap/ldap_client_cred\fR\fR .ad @@ -277,7 +267,6 @@ Lists the contents of the LDAP naming space. \fB\fB/var/ldap/ldap_client_file\fR\fR .ad .RS 30n -.rt Files that contain the LDAP configuration of the client. Do not manually modify these files. Their content is not guaranteed to be human readable. Use \fBldapclient\fR(1M) to update them. @@ -285,35 +274,29 @@ these files. Their content is not guaranteed to be human readable. Use .sp .ne 2 -.mk .na \fB\fB/etc/nsswitch.conf\fR\fR .ad .RS 30n -.rt Configuration file for the name-service switch. .RE .sp .ne 2 -.mk .na \fB\fB/etc/nsswitch.ldap\fR\fR .ad .RS 30n -.rt Sample configuration file for the name-service switch configured with LDAP and files. .RE .sp .ne 2 -.mk .na \fB\fB/etc/pam.conf\fR\fR .ad .RS 30n -.rt PAM framework configuration file. .RE diff --git a/usr/src/man/man1/ldapdelete.1 b/usr/src/man/man1/ldapdelete.1 index 0d4ff64f42..67ee1def35 100644 --- a/usr/src/man/man1/ldapdelete.1 +++ b/usr/src/man/man1/ldapdelete.1 @@ -4,17 +4,17 @@ .\" 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 ldapdelete 1 "15 Jan 2004" "SunOS 5.11" "User Commands" +.TH LDAPDELETE 1 "Jan 15, 2004" .SH NAME ldapdelete \- ldap delete entry tool .SH SYNOPSIS .LP .nf -\fBldapdelete\fR [\fB-n\fR] [\fB-v\fR] [\fB-c\fR] [\fB-d\fR \fIdebuglevel\fR] [\fB-f\fR \fIfile\fR] - [\fB-D\fR \fIbindDN\fR] [\fB-w\fR \fIpasswd\fR | \fB-j\fR \fIfile\fR] [\fB-J\fR [:\fIcriticality\fR]] - [\fB-?\fR] [\fB-H\fR] [\fB-h\fR \fIldaphost\fR] [\fB-V\fR \fIversion\fR] [\fB-i\fR \fIlocale\fR] - [\fB-k\fR \fIpath\fR] [\fB-P\fR \fIpath\fR] [\fB-N\fR \fIcertificate\fR] [\fB-y\fR \fIproxyid\fR] - [\fB-p\fR \fIldapport\fR] [\fB-O\fR \fIhoplimit\fR] [\fB-o\fR \fIattributename\fR=\fIvalue\fR] +\fBldapdelete\fR [\fB-n\fR] [\fB-v\fR] [\fB-c\fR] [\fB-d\fR \fIdebuglevel\fR] [\fB-f\fR \fIfile\fR] + [\fB-D\fR \fIbindDN\fR] [\fB-w\fR \fIpasswd\fR | \fB-j\fR \fIfile\fR] [\fB-J\fR [:\fIcriticality\fR]] + [\fB-?\fR] [\fB-H\fR] [\fB-h\fR \fIldaphost\fR] [\fB-V\fR \fIversion\fR] [\fB-i\fR \fIlocale\fR] + [\fB-k\fR \fIpath\fR] [\fB-P\fR \fIpath\fR] [\fB-N\fR \fIcertificate\fR] [\fB-y\fR \fIproxyid\fR] + [\fB-p\fR \fIldapport\fR] [\fB-O\fR \fIhoplimit\fR] [\fB-o\fR \fIattributename\fR=\fIvalue\fR] [\fB-W\fR \fIpassword\fR] [\fIdn\fR]... .fi @@ -32,7 +32,6 @@ arguments are provided, a list of \fBDN\fRs is read from \fIfile\fR, if the The following options are supported: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad @@ -43,7 +42,6 @@ Bypass confirmation question when deleting a branch. .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad @@ -55,7 +53,6 @@ continue with deletions. The default is to exit after reporting an error. .sp .ne 2 -.mk .na \fB\fB-d\fR \fIdebuglevel\fR \fR .ad @@ -65,56 +62,46 @@ Sets the \fBLDAP\fR debugging level. Useful levels of debugging for \fBldapdelete\fR are: .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 7n -.rt Trace .RE .sp .ne 2 -.mk .na \fB\fB2\fR\fR .ad .RS 7n -.rt Packets .RE .sp .ne 2 -.mk .na \fB\fB4\fR\fR .ad .RS 7n -.rt Arguments .RE .sp .ne 2 -.mk .na \fB\fB32\fR\fR .ad .RS 7n -.rt Filters .RE .sp .ne 2 -.mk .na \fB\fB128\fR\fR .ad .RS 7n -.rt Access control .RE @@ -125,7 +112,6 @@ example, to request trace and filter information, specify a \fIdebuglevel\fR of .sp .ne 2 -.mk .na \fB\fB-D\fR \fIbindDN\fR\fR .ad @@ -136,7 +122,6 @@ Uses the distinguished name \fIbindDN\fR to bind to the directory. .sp .ne 2 -.mk .na \fB\fB-E\fR\fR .ad @@ -148,7 +133,6 @@ control. .sp .ne 2 -.mk .na \fB\fB-f\fR \fIfile\fR\fR .ad @@ -160,7 +144,6 @@ input. .sp .ne 2 -.mk .na \fB\fB-?\fR\fR .ad @@ -171,7 +154,6 @@ Display the usage help text that briefly describes all options. .sp .ne 2 -.mk .na \fB\fB-H\fR\fR .ad @@ -182,7 +164,6 @@ Display the usage help text that briefly describes all options. .sp .ne 2 -.mk .na \fB\fB-h\fR \fIldaphost\fR\fR .ad @@ -193,7 +174,6 @@ Specifies an alternate host on which the LDAP server is running. .sp .ne 2 -.mk .na \fB\fB-i\fR \fIlocale\fR\fR .ad @@ -216,7 +196,6 @@ the data in the file. .sp .ne 2 -.mk .na \fB\fB-j\fR \fIfilename\fR\fR .ad @@ -231,7 +210,6 @@ alternative between \fB-j\fR and \fB-w\fR/\fB-W\fR. .sp .ne 2 -.mk .na \fB\fB-J\fR [:\fIcriticality\fR[:\fIvalue\fR|::\fIb64value\fR|\fIb64value\fR|:\ fIfileurl\fR]]\fR @@ -243,7 +221,6 @@ Criticality is a boolean value (default is \fBfalse\fR). .sp .ne 2 -.mk .na \fB\fB-k\fR \fIpath\fR\fR .ad @@ -256,7 +233,6 @@ your directory server. This is for NLS support. .sp .ne 2 -.mk .na \fB\fB-M\fR\fR .ad @@ -269,7 +245,6 @@ the referral. .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad @@ -281,7 +256,6 @@ conjunction with options \fB-v\fR and \fB-d\fR for debugging. .sp .ne 2 -.mk .na \fB\fB-N\fR \fIcertificate\fR\fR .ad @@ -293,7 +267,6 @@ authentication. For example: \fB-N\fR \fB"Directory-Cert"\fR. .sp .ne 2 -.mk .na \fB\fB-o\fR \fIattributename\fR=\fIvalue\fR\fR .ad @@ -305,56 +278,46 @@ operation, authorization ID, authentication ID, and so forth. The different attribute names and their values are as follows: .sp .ne 2 -.mk .na \fB\fBsecProp\fR=\fI"number"\fR\fR .ad .RS 20n -.rt For defining SASL security properties. .RE .sp .ne 2 -.mk .na \fB\fBrealm\fR=\fI"value"\fR\fR .ad .RS 20n -.rt Specifies SASL realm (default is \fBrealm=none\fR). .RE .sp .ne 2 -.mk .na \fB\fBauthzid\fR=\fI"value"\fR\fR .ad .RS 20n -.rt Specify the authorization ID name for SASL bind. .RE .sp .ne 2 -.mk .na \fB\fBauthid\fR=\fI"value"\fR\fR .ad .RS 20n -.rt Specify the authentication ID for SASL bind. .RE .sp .ne 2 -.mk .na \fB\fBmech\fR=\fI"value"\fR\fR .ad .RS 20n -.rt Specifies the various SASL mechanisms. .RE @@ -362,7 +325,6 @@ Specifies the various SASL mechanisms. .sp .ne 2 -.mk .na \fB\fB-O\fR \fIhopLimit\fR\fR .ad @@ -374,7 +336,6 @@ delete. By default, there is no limit. .sp .ne 2 -.mk .na \fB\fB-p\fR \fIldapport\fR\fR .ad @@ -385,7 +346,6 @@ Specifies an alternate \fBTCP\fR port where the LDAP server is listening. .sp .ne 2 -.mk .na \fB\fB-P\fR \fIpath\fR\fR .ad @@ -414,7 +374,6 @@ Use the \fB-P\fR option alone to specify server authentication only. .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad @@ -425,7 +384,6 @@ Uses verbose mode, with diagnostics written to standard output. .sp .ne 2 -.mk .na \fB\fB-V\fR \fIversion\fR\fR .ad @@ -438,7 +396,6 @@ servers that do not support v3. .sp .ne 2 -.mk .na \fB\fB-W\fR \fIpassword\fR\fR .ad @@ -454,7 +411,6 @@ mutually exclusive of \fB-j\fR. .sp .ne 2 -.mk .na \fB\fB-w\fR \fIpasswd\fR\fR .ad @@ -471,7 +427,6 @@ the password will not be visible to other users. .sp .ne 2 -.mk .na \fB\fB-Y\fR \fIproxyid\fR\fR .ad @@ -483,7 +438,6 @@ operation, usually in double quotes ("") for the shell. .sp .ne 2 -.mk .na \fB\fB-Z\fR\fR .ad @@ -500,12 +454,10 @@ options needed to identify the certificate and the key database. The following operand is supported: .sp .ne 2 -.mk .na \fB\fIdn\fR\fR .ad .RS 6n -.rt Specifies one or several distinguished names of entries to delete. .RE @@ -521,7 +473,7 @@ To delete the entry named with commonName \fBDelete Me\fR directly below the .in +2 .nf example% \fBldapdelete -D "cn=Administrator, o=XYZ, c=US" \e - "cn=Delete Me, o=XYZ, c=US"\fR + "cn=Delete Me, o=XYZ, c=US"\fR .fi .in -2 .sp @@ -551,12 +503,11 @@ See \fBattributes\fR(5) for a description of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE -Stability LevelEvolving +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE +Stability Level Evolving .TE .SH EXIT STATUS @@ -565,23 +516,19 @@ Stability LevelEvolving The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR \fR .ad .RS 13n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fBNon-zero \fR .ad .RS 13n -.rt An error occurred. A diagnostic message is written to standard error. .RE diff --git a/usr/src/man/man1/ldaplist.1 b/usr/src/man/man1/ldaplist.1 index 9ee7235527..3756a0d2d3 100644 --- a/usr/src/man/man1/ldaplist.1 +++ b/usr/src/man/man1/ldaplist.1 @@ -3,15 +3,15 @@ .\" 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 "7 Jun 2008" "SunOS 5.11" "User Commands" +.TH LDAPLIST 1 "Jun 7, 2008" .SH NAME ldaplist \- search and list naming information from an LDAP directory using the configured profile .SH SYNOPSIS .LP .nf -\fB/usr/bin/ldaplist\fR [\fB-dlv\fR] [\fB-h\fR \fILDAP_server\fR[\fB:\fR\fIserverPort\fR] [\fB-M\fR \fIdomainName\fR] - [\fB-N\fR \fIprofileName\fR] [\fB-a\fR \fIauthenticationMethod\fR] [\fB-P\fR \fIcertifPath\fR] +\fB/usr/bin/ldaplist\fR [\fB-dlv\fR] [\fB-h\fR \fILDAP_server\fR[\fB:\fR\fIserverPort\fR] [\fB-M\fR \fIdomainName\fR] + [\fB-N\fR \fIprofileName\fR] [\fB-a\fR \fIauthenticationMethod\fR] [\fB-P\fR \fIcertifPath\fR] [\fB-D\fR \fIbindDN\fR] [\fB-w\fR \fIbindPassword\fR] [\fB-j\fR \fIpasswdFile\fR]] [\fIdatabase\fR [\fIkey\fR]...] .fi @@ -150,7 +150,6 @@ If the key is not specified, all the containers in the current search The following options are supported: .sp .ne 2 -.mk .na \fB\fB-a\fR \fIauthenticationMethod\fR\fR .ad @@ -182,7 +181,6 @@ must use this option to provide an authentication method. .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad @@ -194,7 +192,6 @@ default, the entries are listed. .sp .ne 2 -.mk .na \fB\fB-D\fR \fIbindDN\fR\fR .ad @@ -205,7 +202,6 @@ Specifies an entry which has read permission to the requested database. .sp .ne 2 -.mk .na \fB\fB-g\fR\fR .ad @@ -216,7 +212,6 @@ Lists the database mapping. .sp .ne 2 -.mk .na \fB\fB-h\fR\fR .ad @@ -229,7 +224,6 @@ This option has been deprecated. .sp .ne 2 -.mk .na \fB\fB-h\fR \fILDAP_server[:serverPort]\fR\fR .ad @@ -244,7 +238,6 @@ default LDAP server port number is \fB636\fR. .sp .ne 2 -.mk .na \fB\fB-j\fR \fIpasswdFile\fR\fR .ad @@ -259,7 +252,6 @@ This option is mutually exclusive of the \fB-w\fR option. .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad @@ -271,7 +263,6 @@ default, \fBldaplist\fR lists only the Distinguished Name of the entries found. .sp .ne 2 -.mk .na \fB\fB-M\fR \fIdomainName\fR\fR .ad @@ -283,7 +274,6 @@ is not specified, the default domain name is used. .sp .ne 2 -.mk .na \fB\fB-N\fR \fIprofileName\fR\fR .ad @@ -295,7 +285,6 @@ the server specified by \fB-H\fR option. The default value is default. .sp .ne 2 -.mk .na \fB\fB-p\fR \fIcertifPath\fR\fR .ad @@ -309,7 +298,6 @@ support, which is specified in the \fIauthenticationMethod\fR and .sp .ne 2 -.mk .na \fB\fB-w\fR \fIbindPassword\fR\fR .ad @@ -329,7 +317,6 @@ password. .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad @@ -438,7 +425,7 @@ server is specified explicitly. .sp .in +2 .nf -example% \fBldaplist -H 10.10.10.10:3890 \e +example% \fBldaplist -H 10.10.10.10:3890 \e -M another.domain.name -N special_duaprofile \e -D "cn=directory manager" -w secret \e user1\fR @@ -452,41 +439,34 @@ example% \fBldaplist -H 10.10.10.10:3890 \e The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt Successfully matched some entries. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt Successfully searched the table and no matches were found. .RE .sp .ne 2 -.mk .na \fB\fB2\fR\fR .ad .RS 5n -.rt An error occurred. An error message is output. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB/var/ldap/ldap_client_file\fR\fR .ad @@ -495,7 +475,6 @@ An error occurred. An error message is output. \fB\fB/var/ldap/ldap_client_cred\fR\fR .ad .RS 30n -.rt Files that contain the LDAP configuration of the client. Do not manually modify these files. Their content is not guaranteed to be human readable. To update these files, use \fBldapclient\fR(1M) @@ -509,13 +488,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed .TE .SH SEE ALSO diff --git a/usr/src/man/man1/ldapmodify.1 b/usr/src/man/man1/ldapmodify.1 index 0907f51e86..15e38d9d1f 100644 --- a/usr/src/man/man1/ldapmodify.1 +++ b/usr/src/man/man1/ldapmodify.1 @@ -4,30 +4,30 @@ .\" 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 ldapmodify 1 "15 Jan 2004" "SunOS 5.11" "User Commands" +.TH LDAPMODIFY 1 "Jan 15, 2004" .SH NAME ldapmodify, ldapadd \- ldap entry addition and modification tools .SH SYNOPSIS .LP .nf -\fBldapmodify\fR [\fB-a\fR] [\fB-c\fR] [\fB-r\fR] [\fB-n\fR] [\fB-v\fR] [\fB-F\fR] [\fB-b\fR] [\fB-A\fR] [\fB-q\fR] - [\fB-H\fR] [\fB-?\fR] [\fB-E\fR] [\fB-J\fR] [\fB-Z\fR] [\fB-M\fR] [\fB-d\fR \fIdebuglevel\fR] - [\fB-D\fR \fIbindDN\fR] [\fB-j\fR \fIfilename\fR] [\fB-J\fR [:\fIcriticality\fR]] - [\fB-B\fR \fIbaseDN\fR] [\fB-V\fR \fIversion\fR] [\fB-Y\fR \fIproxyDN\fR] [\fB-O\fR \fIhopLimit\fR] - [\fB-i\fR \fIlocale\fR] [\fB-k\fR \fIpath\fR] [\fB-e\fR \fIerrorFile\fR] [\fB-P\fR \fIpath\fR] - [\fB-N\fR \fIcertificate\fR] [\fB-w\fR \fIpasswd\fR] [\fB-o\fR \fIattributename\fR=\fIvalue\fR] - [\fB-h\fR \fIldaphost\fR] [\fB-W\fR \fIpassword\fR] [\fB-p\fR \fIldapport\fR] [\fB-f\fR \fIfile\fR] +\fBldapmodify\fR [\fB-a\fR] [\fB-c\fR] [\fB-r\fR] [\fB-n\fR] [\fB-v\fR] [\fB-F\fR] [\fB-b\fR] [\fB-A\fR] [\fB-q\fR] + [\fB-H\fR] [\fB-?\fR] [\fB-E\fR] [\fB-J\fR] [\fB-Z\fR] [\fB-M\fR] [\fB-d\fR \fIdebuglevel\fR] + [\fB-D\fR \fIbindDN\fR] [\fB-j\fR \fIfilename\fR] [\fB-J\fR [:\fIcriticality\fR]] + [\fB-B\fR \fIbaseDN\fR] [\fB-V\fR \fIversion\fR] [\fB-Y\fR \fIproxyDN\fR] [\fB-O\fR \fIhopLimit\fR] + [\fB-i\fR \fIlocale\fR] [\fB-k\fR \fIpath\fR] [\fB-e\fR \fIerrorFile\fR] [\fB-P\fR \fIpath\fR] + [\fB-N\fR \fIcertificate\fR] [\fB-w\fR \fIpasswd\fR] [\fB-o\fR \fIattributename\fR=\fIvalue\fR] + [\fB-h\fR \fIldaphost\fR] [\fB-W\fR \fIpassword\fR] [\fB-p\fR \fIldapport\fR] [\fB-f\fR \fIfile\fR] [\fB-l\fR \fInb-ldap-connections\fR] .fi .LP .nf -\fBldapadd\fR [\fB-c\fR] [\fB-n\fR] [\fB-v\fR] [\fB-F\fR] - [ [\fB-b\fR] [\fB-A\fR] [\fB-q\fR] [\fB-H\fR] [\fB-?\fR] [\fB-E\fR] [\fB-J\fR] [\fB-Z\fR] [\fB-M\fR]\fB-d\fR \fIdebuglevel\fR] - [\fB-D\fR \fIbindDN\fR] [\fB-j\fR \fIfilename\fR] [\fB-B\fR \fIbaseDN\fR] [\fB-V\fR \fIversion\fR] - [\fB-Y\fR \fIproxyDN\fR] [\fB-O\fR \fIhopLimit\fR] [\fB-i\fR \fIlocale\fR] [\fB-k\fR \fIpath\fR] - [\fB-e\fR \fIerrorFile\fR] [\fB-P\fR \fIpath\fR] [\fB-N\fR \fIcertificate\fR] [\fB-w\fR \fIpasswd\fR] - [\fB-o\fR \fIattributename\fR=\fIvalue\fR] [\fB-h\fR \fIldaphost\fR] [\fB-W\fR \fIpassword\fR] +\fBldapadd\fR [\fB-c\fR] [\fB-n\fR] [\fB-v\fR] [\fB-F\fR] + [ [\fB-b\fR] [\fB-A\fR] [\fB-q\fR] [\fB-H\fR] [\fB-?\fR] [\fB-E\fR] [\fB-J\fR] [\fB-Z\fR] [\fB-M\fR]\fB-d\fR \fIdebuglevel\fR] + [\fB-D\fR \fIbindDN\fR] [\fB-j\fR \fIfilename\fR] [\fB-B\fR \fIbaseDN\fR] [\fB-V\fR \fIversion\fR] + [\fB-Y\fR \fIproxyDN\fR] [\fB-O\fR \fIhopLimit\fR] [\fB-i\fR \fIlocale\fR] [\fB-k\fR \fIpath\fR] + [\fB-e\fR \fIerrorFile\fR] [\fB-P\fR \fIpath\fR] [\fB-N\fR \fIcertificate\fR] [\fB-w\fR \fIpasswd\fR] + [\fB-o\fR \fIattributename\fR=\fIvalue\fR] [\fB-h\fR \fIldaphost\fR] [\fB-W\fR \fIpassword\fR] [\fB-p\fR \fIldapport\fR] [\fB-f\fR \fIfile\fR] [\fB-l\fR \fInb-ldap-connections\fR] .fi @@ -50,7 +50,6 @@ pairs for the same entry. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad @@ -62,7 +61,6 @@ entries. If invoked as \fBldapadd\fR, this option is always set. .sp .ne 2 -.mk .na \fB\fB-A\fR\fR .ad @@ -74,7 +72,6 @@ option. .sp .ne 2 -.mk .na \fB\fB-b\fR\fR .ad @@ -91,7 +88,6 @@ attribute. For example, the corresponding LDIF input would be: "\fB jpegPhoto: .sp .ne 2 -.mk .na \fB\fB-B\fR\ \fIbaseDN\fR\fR .ad @@ -104,7 +100,6 @@ providing bulk import functionality. .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad @@ -117,7 +112,6 @@ reporting an error. .sp .ne 2 -.mk .na \fB\fB-D\fR \fIbindDN\fR \fR .ad @@ -128,7 +122,6 @@ Uses the distinguished name \fIbindDN\fR to bind to the directory. .sp .ne 2 -.mk .na \fB\fB-d\fR \fIdebuglevel\fR\fR .ad @@ -138,56 +131,46 @@ Sets the \fBLDAP\fR debugging level. Useful levels of debugging for \fBldapmodify\fR and \fBldapadd\fR are: .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 7n -.rt Trace .RE .sp .ne 2 -.mk .na \fB\fB2\fR\fR .ad .RS 7n -.rt Packets .RE .sp .ne 2 -.mk .na \fB\fB4\fR\fR .ad .RS 7n -.rt Arguments .RE .sp .ne 2 -.mk .na \fB\fB32\fR\fR .ad .RS 7n -.rt Filters .RE .sp .ne 2 -.mk .na \fB\fB128\fR\fR .ad .RS 7n -.rt Access control .RE @@ -198,7 +181,6 @@ example, to request trace and filter information, specify a \fIdebuglevel\fR of .sp .ne 2 -.mk .na \fB\fB-e\fR\ \fIerrorFile\fR\fR .ad @@ -211,7 +193,6 @@ large LDIF input. .sp .ne 2 -.mk .na \fB\fB-E\fR\fR .ad @@ -223,7 +204,6 @@ control. .sp .ne 2 -.mk .na \fB\fB-F\fR\fR .ad @@ -237,7 +217,6 @@ record should be applied. .sp .ne 2 -.mk .na \fB\fB-f\fR \fIfile\fR\fR .ad @@ -249,7 +228,6 @@ standard input. .sp .ne 2 -.mk .na \fB\fB-?\fR\fR .ad @@ -260,7 +238,6 @@ Display the usage help text that briefly describes all options. .sp .ne 2 -.mk .na \fB\fB-H\fR\fR .ad @@ -271,7 +248,6 @@ Display the usage help text that briefly describes all options. .sp .ne 2 -.mk .na \fB\fB-h\fR \fIldaphost\fR\fR .ad @@ -282,7 +258,6 @@ Specifies an alternate host on which the LAPD server is running. .sp .ne 2 -.mk .na \fB\fB-i\fR \fIlocale\fR\fR .ad @@ -296,7 +271,6 @@ the specified character set to UTF8, thus overriding the \fBLANG\fR setting. .sp .ne 2 -.mk .na \fB\fB-j\fR \fIfilename\fR\fR .ad @@ -310,7 +284,6 @@ the \fB-w\fR and \fB-W\fR options. .sp .ne 2 -.mk .na \fB\fB-J\fR [:\fIcriticality\fR[:\fIvalue\fR|::\fIb64value\fR|\fIb64value\fR|:\ fIfileurl\fR]]\fR @@ -322,7 +295,6 @@ Criticality is a boolean value (default is \fBfalse\fR). .sp .ne 2 -.mk .na \fB\fB-k\fR \fIpath\fR\fR .ad @@ -335,7 +307,6 @@ your directory server. This is for NLS support. .sp .ne 2 -.mk .na \fB\fB-l\fR\fI nb-ldap-connections\fR\fR .ad @@ -348,7 +319,6 @@ default is one connection. .sp .ne 2 -.mk .na \fB\fB-M\fR\fR .ad @@ -361,7 +331,6 @@ referral. .sp .ne 2 -.mk .na \fB\fB-n\fR \fR .ad @@ -373,7 +342,6 @@ with \fB-v\fR and \fB-d\fR for debugging. .sp .ne 2 -.mk .na \fB\fB-N\fR \fIcertificate\fR\fR .ad @@ -385,7 +353,6 @@ authentication. For example: \fB-N\fR \fB"Directory-Cert"\fR. .sp .ne 2 -.mk .na \fB\fB-o\fR \fIattributename\fR=\fIvalue\fR\fR .ad @@ -397,56 +364,46 @@ operation, authorization ID, authentication ID, and so forth. The different attribute names and their values are as follows: .sp .ne 2 -.mk .na \fB\fBsecProp\fR=\fI"number"\fR\fR .ad .RS 20n -.rt For defining SASL security properties. .RE .sp .ne 2 -.mk .na \fB\fBrealm\fR=\fI"value"\fR\fR .ad .RS 20n -.rt Specifies SASL realm (default is \fBrealm=none\fR). .RE .sp .ne 2 -.mk .na \fB\fBauthzid\fR=\fI"value"\fR\fR .ad .RS 20n -.rt Specify the authorization ID name for SASL bind. .RE .sp .ne 2 -.mk .na \fB\fBauthid\fR=\fI"value"\fR\fR .ad .RS 20n -.rt Specify the authentication ID for SASL bind. .RE .sp .ne 2 -.mk .na \fB\fBmech\fR=\fI"value"\fR\fR .ad .RS 20n -.rt Specifies the various SASL mechanisms. .RE @@ -454,7 +411,6 @@ Specifies the various SASL mechanisms. .sp .ne 2 -.mk .na \fB\fB-O\fR \fIhopLimit\fR\fR .ad @@ -466,7 +422,6 @@ modify. By default, there is no limit. .sp .ne 2 -.mk .na \fB\fB-p\fR \fIldapport\fR \fR .ad @@ -478,7 +433,6 @@ listening. .sp .ne 2 -.mk .na \fB\fB-P\fR \fIpath\fR\fR .ad @@ -507,7 +461,6 @@ Use the \fB-P\fR option alone to specify server authentication only. .sp .ne 2 -.mk .na \fB\fB-r\fR \fR .ad @@ -520,7 +473,6 @@ specified, the \fB-r\fR option is ignored. .sp .ne 2 -.mk .na \fB\fB-v\fR \fR .ad @@ -531,7 +483,6 @@ Uses verbose mode, with diagnostics written to standard output. .sp .ne 2 -.mk .na \fB\fB-V\fR \fIversion\fR\fR .ad @@ -544,7 +495,6 @@ servers that do not support v3. .sp .ne 2 -.mk .na \fB\fB-W\fR \fIpassword\fR\fR .ad @@ -560,7 +510,6 @@ mutually exclusive of \fB-j\fR. .sp .ne 2 -.mk .na \fB\fB-w\fR \fIpasswd\fR \fR .ad @@ -578,7 +527,6 @@ users. .sp .ne 2 -.mk .na \fB\fB-Y\fR \fIproxyid\fR\fR .ad @@ -590,7 +538,6 @@ operation, usually in double quotes ("") for the shell. .sp .ne 2 -.mk .na \fB\fB-Z\fR\fR .ad @@ -607,23 +554,19 @@ options needed to identify the certificate and the key database. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR \fR .ad .RS 13n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fBNon-zero \fR .ad .RS 13n -.rt An error occurred. A diagnostic message is written to standard error. .RE @@ -811,12 +754,11 @@ See \fBattributes\fR(5) for a description of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE -Stability LevelEvolving +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE +Stability Level Evolving .TE .SH SEE ALSO diff --git a/usr/src/man/man1/ldapmodrdn.1 b/usr/src/man/man1/ldapmodrdn.1 index ef8d6b7401..f813635225 100644 --- a/usr/src/man/man1/ldapmodrdn.1 +++ b/usr/src/man/man1/ldapmodrdn.1 @@ -3,18 +3,18 @@ .\" 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 ldapmodrdn 1 "15 Jan 2004" "SunOS 5.11" "User Commands" +.TH LDAPMODRDN 1 "Jan 15, 2004" .SH NAME ldapmodrdn \- ldap modify entry RDN tool .SH SYNOPSIS .LP .nf -\fBldapmodrdn\fR [\fB-r\fR] [\fB-n\fR] [\fB-v\fR] [\fB-c\fR] [\fB-E\fR] [\fB-H\fR] [\fB-?\fR] [\fB-M\fR] [\fB-R\fR] - [\fB-Z\fR] [\fB-V\fR \fIversion\fR] [\fB-d\fR \fIdebuglevel\fR] [\fB-D\fR \fIbindDN\fR] - [\fB-w\fR \fIpasswd\fR] [\fB-h\fR \fIldaphost\fR] [\fB-i\fR \fIlocale\fR] [\fB-j\fR \fIfilename\fR] - [\fB-J\fR [:\fIcriticality\fR]] [\fB-k\fR \fIpath\fR] [\fB-N\fR \fIcertificate\fR] - [\fB-O\fR \fIhopLimit\fR] [\fB-P\fR \fIpath\fR] [\fB-W\fR \fIpassword\fR] [\fB-p\fR \fIldapport\fR] - [\fB-o\fR \fIattributename\fR=\fIvalue\fR] [\fB-f\fR \fIfile\fR] [\fB-Y\fR \fIproxyDN\fR] +\fBldapmodrdn\fR [\fB-r\fR] [\fB-n\fR] [\fB-v\fR] [\fB-c\fR] [\fB-E\fR] [\fB-H\fR] [\fB-?\fR] [\fB-M\fR] [\fB-R\fR] + [\fB-Z\fR] [\fB-V\fR \fIversion\fR] [\fB-d\fR \fIdebuglevel\fR] [\fB-D\fR \fIbindDN\fR] + [\fB-w\fR \fIpasswd\fR] [\fB-h\fR \fIldaphost\fR] [\fB-i\fR \fIlocale\fR] [\fB-j\fR \fIfilename\fR] + [\fB-J\fR [:\fIcriticality\fR]] [\fB-k\fR \fIpath\fR] [\fB-N\fR \fIcertificate\fR] + [\fB-O\fR \fIhopLimit\fR] [\fB-P\fR \fIpath\fR] [\fB-W\fR \fIpassword\fR] [\fB-p\fR \fIldapport\fR] + [\fB-o\fR \fIattributename\fR=\fIvalue\fR] [\fB-f\fR \fIfile\fR] [\fB-Y\fR \fIproxyDN\fR] [\fIdn\fR \fIrdn\fR] .fi @@ -28,7 +28,6 @@ pair \fIdn\fR and \fIrdn\fR. .SH OPTIONS .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad @@ -40,7 +39,6 @@ modifications. The default is to exit after reporting an error. .sp .ne 2 -.mk .na \fB\fB-D\fR\fI bindDN\fR\fR .ad @@ -51,7 +49,6 @@ Use the distinguished name \fIbinddn\fR to bind to the directory. .sp .ne 2 -.mk .na \fB\fB-d\fR\fI debuglevel\fR\fR .ad @@ -61,56 +58,46 @@ Set the LDAP debugging level. Useful values of \fIdebuglevel\fR for \fBldapmodrdn\fR are: .sp .ne 2 -.mk .na \fB\fB1\fR \fR .ad .RS 8n -.rt Trace .RE .sp .ne 2 -.mk .na \fB\fB2\fR \fR .ad .RS 8n -.rt Packets .RE .sp .ne 2 -.mk .na \fB\fB4\fR \fR .ad .RS 8n -.rt Arguments .RE .sp .ne 2 -.mk .na \fB\fB32\fR \fR .ad .RS 8n -.rt Filters .RE .sp .ne 2 -.mk .na \fB\fB128\fR \fR .ad .RS 8n -.rt Access control .RE @@ -121,7 +108,6 @@ example, to request trace and filter information, specify a \fIdebuglevel\fR of .sp .ne 2 -.mk .na \fB\fB-E\fR\fR .ad @@ -133,7 +119,6 @@ control. .sp .ne 2 -.mk .na \fB\fB-f\fR\fI file\fR\fR .ad @@ -145,7 +130,6 @@ standard input or the command-line. .sp .ne 2 -.mk .na \fB\fB-?\fR\fR .ad @@ -156,7 +140,6 @@ Display the usage help text that briefly describes all options. .sp .ne 2 -.mk .na \fB\fB-H\fR\fR .ad @@ -167,7 +150,6 @@ Display the usage help text that briefly describes all options. .sp .ne 2 -.mk .na \fB\fB-h\fR \fI ldaphost\fR\fR .ad @@ -178,7 +160,6 @@ Specify an alternate host on which the LDAP server is running. .sp .ne 2 -.mk .na \fB\fB-i\fR \fIlocale\fR\fR .ad @@ -192,7 +173,6 @@ the specified character set to UTF8, thus overriding the \fBLANG\fR setting. .sp .ne 2 -.mk .na \fB\fB-J\fR [:\fIcriticality\fR[:\fIvalue\fR|::\fIb64value\fR|\fIb64value\fR|:\ fIfileurl\fR]]\fR @@ -204,7 +184,6 @@ Criticality is a boolean value (default is \fBfalse\fR). .sp .ne 2 -.mk .na \fB\fB-j\fR \fIfilename\fR\fR .ad @@ -218,7 +197,6 @@ the \fB-w\fR and \fB-W\fR options. .sp .ne 2 -.mk .na \fB\fB-k\fR \fIpath\fR\fR .ad @@ -231,7 +209,6 @@ your directory server. This is for NLS support. .sp .ne 2 -.mk .na \fB\fB-M\fR\fR .ad @@ -244,7 +221,6 @@ referral. .sp .ne 2 -.mk .na \fB\fB-n\fR \fR .ad @@ -256,7 +232,6 @@ with \fB-v\fR and \fB-d\fR for debugging. .sp .ne 2 -.mk .na \fB\fB-N\fR \fIcertificate\fR\fR .ad @@ -268,7 +243,6 @@ authentication. For example: \fB-N\fR \fB"Directory-Cert"\fR. .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad @@ -280,7 +254,6 @@ conjunction with \fB-v\fR for debugging. .sp .ne 2 -.mk .na \fB\fB-o\fR \fIattributename\fR=\fIvalue\fR\fR .ad @@ -292,56 +265,46 @@ operation, authorization ID, authentication ID, and so forth. The different attribute names and their values are as follows: .sp .ne 2 -.mk .na \fB\fBsecProp\fR=\fI"number"\fR\fR .ad .RS 20n -.rt For defining SASL security properties. .RE .sp .ne 2 -.mk .na \fB\fBrealm\fR=\fI"value"\fR\fR .ad .RS 20n -.rt Specifies SASL realm (default is \fBrealm=none\fR). .RE .sp .ne 2 -.mk .na \fB\fBauthzid\fR=\fI"value"\fR\fR .ad .RS 20n -.rt Specify the authorization ID name for SASL bind. .RE .sp .ne 2 -.mk .na \fB\fBauthid\fR=\fI"value"\fR\fR .ad .RS 20n -.rt Specify the authentication ID for SASL bind. .RE .sp .ne 2 -.mk .na \fB\fBmech\fR=\fI"value"\fR\fR .ad .RS 20n -.rt Specifies the various SASL mechanisms. .RE @@ -349,7 +312,6 @@ Specifies the various SASL mechanisms. .sp .ne 2 -.mk .na \fB\fB-O\fR \fIhopLimit\fR\fR .ad @@ -361,7 +323,6 @@ modify. By default, there is no limit. .sp .ne 2 -.mk .na \fB\fB-P\fR \fIpath\fR\fR .ad @@ -390,7 +351,6 @@ Use the \fB-P\fR option alone to specify server authentication only. .sp .ne 2 -.mk .na \fB\fB-p\fR\fI ldapport\fR\fR .ad @@ -401,7 +361,6 @@ Specify an alternate TCP port where the secure LAPD server is listening. .sp .ne 2 -.mk .na \fB\fB-R\fR\fR .ad @@ -412,7 +371,6 @@ Do not automatically follow referrals returned while searching. .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad @@ -423,7 +381,6 @@ Remove old RDN values from the entry. By default, old values are kept. .sp .ne 2 -.mk .na \fB\fB-V\fR \fIversion\fR\fR .ad @@ -436,7 +393,6 @@ servers that do not support v3. .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad @@ -447,7 +403,6 @@ Use verbose mode, with diagnostics written to standard output. .sp .ne 2 -.mk .na \fB\fB-W\fR \fIpassword\fR\fR .ad @@ -463,7 +418,6 @@ mutually exclusive of \fB-j\fR. .sp .ne 2 -.mk .na \fB\fB-w\fR\fI passwd\fR\fR .ad @@ -480,7 +434,6 @@ the password will not be visible to other users. .sp .ne 2 -.mk .na \fB\fB-Y\fR \fIproxyid\fR\fR .ad @@ -492,7 +445,6 @@ operation, usually in double quotes ("") for the shell. .sp .ne 2 -.mk .na \fB\fB-Z\fR\fR .ad @@ -560,12 +512,11 @@ See \fBattributes\fR(5) for a description of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE -Stability LevelEvolving +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE +Stability Level Evolving .TE .SH SEE ALSO diff --git a/usr/src/man/man1/ldapsearch.1 b/usr/src/man/man1/ldapsearch.1 index 2029dd14be..b7856ceb3b 100644 --- a/usr/src/man/man1/ldapsearch.1 +++ b/usr/src/man/man1/ldapsearch.1 @@ -4,20 +4,20 @@ .\" 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 ldapsearch 1 "6 Jan 2006" "SunOS 5.11" "User Commands" +.TH LDAPSEARCH 1 "Jan 6, 2006" .SH NAME ldapsearch \- ldap search tool .SH SYNOPSIS .LP .nf -\fBldapsearch\fR [\fB-n\fR] [\fB-u\fR] [\fB-v\fR] [\fB-t\fR] [\fB-A\fR] [\fB-B\fR] [\fB-L\fR] [\fB-R\fR] [\fB-H\fR] - [\fB-?\fR] [\fB-t\fR] [\fB-T\fR] [\fB-B\fR] [\fB-E\fR] [\fB-J\fR] [\fB-e\fR] [\fB-l\fR] [\fB-Z\fR] [\fB-r\fR] - [\fB-M\fR] [\fB-d\fR \fIdebuglevel\fR] [\fB-F\fR \fIsep\fR] [\fB-f\fR \fIfile\fR] [\fB-D\fR \fIbindDN\fR] - [\fB-j\fR \fIfilename\fR] [\fB-V\fR \fIversion\fR] [\fB-Y\fR \fIproxyDN\fR] [\fB-O\fR \fIhopLimit\fR] - [\fB-i\fR \fIlocale\fR] [\fB-k\fR \fIpath\fR] [\fB-S\fR [\fB-\fR] \fIattribute\fR] [\fB-C\fR \fIpattern\fR] - [\fB-c\fR \fIauthzid\fR] [\fB-P\fR \fIpath\fR] [\fB-N\fR \fIcertificate\fR] [\fB-w\fR \fIpasswd\fR] - [\fB-h\fR \fIldaphost\fR] [\fB-p\fR \fIldapport\fR] [\fB-o\fR \fIattributename\fR=\fIvalue\fR] - [\fB-b\fR \fIsearchbase\fR] [\fB-s\fR \fIscope\fR] [\fB-a\fR \fIderef\fR] [\fB-l\fR \fItimelimit\fR] +\fBldapsearch\fR [\fB-n\fR] [\fB-u\fR] [\fB-v\fR] [\fB-t\fR] [\fB-A\fR] [\fB-B\fR] [\fB-L\fR] [\fB-R\fR] [\fB-H\fR] + [\fB-?\fR] [\fB-t\fR] [\fB-T\fR] [\fB-B\fR] [\fB-E\fR] [\fB-J\fR] [\fB-e\fR] [\fB-l\fR] [\fB-Z\fR] [\fB-r\fR] + [\fB-M\fR] [\fB-d\fR \fIdebuglevel\fR] [\fB-F\fR \fIsep\fR] [\fB-f\fR \fIfile\fR] [\fB-D\fR \fIbindDN\fR] + [\fB-j\fR \fIfilename\fR] [\fB-V\fR \fIversion\fR] [\fB-Y\fR \fIproxyDN\fR] [\fB-O\fR \fIhopLimit\fR] + [\fB-i\fR \fIlocale\fR] [\fB-k\fR \fIpath\fR] [\fB-S\fR [\fB-\fR] \fIattribute\fR] [\fB-C\fR \fIpattern\fR] + [\fB-c\fR \fIauthzid\fR] [\fB-P\fR \fIpath\fR] [\fB-N\fR \fIcertificate\fR] [\fB-w\fR \fIpasswd\fR] + [\fB-h\fR \fIldaphost\fR] [\fB-p\fR \fIldapport\fR] [\fB-o\fR \fIattributename\fR=\fIvalue\fR] + [\fB-b\fR \fIsearchbase\fR] [\fB-s\fR \fIscope\fR] [\fB-a\fR \fIderef\fR] [\fB-l\fR \fItimelimit\fR] [\fB-z\fR \fIsizelimit\fR] \fIfilter\fR [\fIattrs\fR]... .fi @@ -61,7 +61,6 @@ is given, only the "attributename" is returned and not the attribute value. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-A\fR\fR .ad @@ -74,7 +73,6 @@ specific value. .sp .ne 2 -.mk .na \fB\fB-a\fR \fIderef\fR\fR .ad @@ -89,7 +87,6 @@ for the search. The default is to never dereference aliases. .sp .ne 2 -.mk .na \fB\fB-B\fR\fR .ad @@ -101,7 +98,6 @@ the default \fB-L\fR option. .sp .ne 2 -.mk .na \fB\fB-b\fR \fIsearchbase\fR\fR .ad @@ -113,7 +109,6 @@ default. .sp .ne 2 -.mk .na \fB\fB-C\fR \fIpattern\fR\fR .ad @@ -136,7 +131,6 @@ ps:changeType[:changesOnly[:entryChangeControls]] .sp .ne 2 -.mk .na \fB\fB-c\fR \fIauthzid\fR\fR .ad @@ -155,7 +149,6 @@ dn:uid=bjensen,dc=example,dc=com .sp .ne 2 -.mk .na \fB\fB-D\fR \fIbindDN\fR\fR .ad @@ -166,7 +159,6 @@ Use the distinguished name \fIbindDN\fR to bind to the directory. .sp .ne 2 -.mk .na \fB\fB-d\fR \fIdebuglevel\fR\fR .ad @@ -176,56 +168,46 @@ Set the \fBLDAP\fR debugging level. Useful levels of debugging for \fBldapsearch\fR are: .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 7n -.rt Trace .RE .sp .ne 2 -.mk .na \fB\fB2\fR\fR .ad .RS 7n -.rt Packets .RE .sp .ne 2 -.mk .na \fB\fB4\fR\fR .ad .RS 7n -.rt Arguments .RE .sp .ne 2 -.mk .na \fB\fB32\fR\fR .ad .RS 7n -.rt Filters .RE .sp .ne 2 -.mk .na \fB\fB128\fR\fR .ad .RS 7n -.rt Access control .RE @@ -235,7 +217,6 @@ example, to request trace and filter information, specify a debuglevel of 33. .sp .ne 2 -.mk .na \fB\fB-E\fR\fR .ad @@ -247,7 +228,6 @@ control. .sp .ne 2 -.mk .na \fB\fB-e\fR\fR .ad @@ -258,7 +238,6 @@ Minimize base-64 encoding of values. .sp .ne 2 -.mk .na \fB\fB-F\fR \fIsep\fR\fR .ad @@ -270,7 +249,6 @@ this option has been specified, the \fB-L\fR option is ignored. .sp .ne 2 -.mk .na \fB\fB-f\fR \fIfile\fR\fR .ad @@ -285,7 +263,6 @@ are read from standard input. .sp .ne 2 -.mk .na \fB\fB-G\fR \fIpattern\fR\fR .ad @@ -299,7 +276,6 @@ before and after the target. This option always requires the \fB-S\fR and .sp .ne 2 -.mk .na \fB\fB-?\fR\fR .ad @@ -310,7 +286,6 @@ Display the usage help text that briefly describes all options. .sp .ne 2 -.mk .na \fB\fB-H\fR\fR .ad @@ -321,7 +296,6 @@ Display the usage help text that briefly describes all options. .sp .ne 2 -.mk .na \fB\fB-h\fR \fIldaphost\fR\fR .ad @@ -332,7 +306,6 @@ Specify an alternate host on which the secure LDAP server is running. .sp .ne 2 -.mk .na \fB\fB-i\fR \fIlocale\fR\fR .ad @@ -353,7 +326,6 @@ does not convert the data in the file. .sp .ne 2 -.mk .na \fB\fB-j\fR \fIfilename\fR\fR .ad @@ -367,7 +339,6 @@ the \fB-w\fR and \fB-W\fR options. .sp .ne 2 -.mk .na \fB\fB-J\fR [:\fIcriticality\fR[:\fIvalue\fR|::\fIb64value\fR|\fIb64value\fR|:\ fIfileurl\fR]]\fR @@ -379,7 +350,6 @@ Criticality is a boolean value (default is \fBfalse\fR). .sp .ne 2 -.mk .na \fB\fB-k\fR \fIpath\fR\fR .ad @@ -392,7 +362,6 @@ your directory server. This is for NLS support. .sp .ne 2 -.mk .na \fB\fB-L\fR\fR .ad @@ -404,7 +373,6 @@ option. This behavior is the default. .sp .ne 2 -.mk .na \fB\fB-l\fR \fItimelimit\fR\fR .ad @@ -415,7 +383,6 @@ Wait at most \fItimelimit\fR seconds for a search to complete. .sp .ne 2 -.mk .na \fB\fB-M\fR\fR .ad @@ -428,7 +395,6 @@ referral. .sp .ne 2 -.mk .na \fB\fB-N\fR \fIcertificate\fR\fR .ad @@ -440,7 +406,6 @@ authentication. For example: \fB-N\fR \fB"Directory-Cert"\fR\&. .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad @@ -452,7 +417,6 @@ conjunction with \fB-v\fR and \fB-d\fR for debugging. .sp .ne 2 -.mk .na \fB\fB-O\fR \fIhopLimit\fR\fR .ad @@ -464,7 +428,6 @@ modify. By default, there is no limit. .sp .ne 2 -.mk .na \fB\fB-o\fR \fIattributename\fR=\fIvalue\fR\fR .ad @@ -476,56 +439,46 @@ operation, authorization ID, authentication ID, and so forth. The different attribute names and their values are as follows: .sp .ne 2 -.mk .na \fB\fBsecProp\fR=\fI"number"\fR\fR .ad .RS 20n -.rt For defining SASL security properties. .RE .sp .ne 2 -.mk .na \fB\fBrealm\fR=\fI"value"\fR\fR .ad .RS 20n -.rt Specifies SASL realm (default is \fBrealm=none\fR). .RE .sp .ne 2 -.mk .na \fB\fBauthzid\fR=\fI"value"\fR\fR .ad .RS 20n -.rt Specify the authorization ID name for SASL bind. .RE .sp .ne 2 -.mk .na \fB\fBauthid\fR=\fI"value"\fR\fR .ad .RS 20n -.rt Specify the authentication ID for SASL bind. .RE .sp .ne 2 -.mk .na \fB\fBmech\fR=\fI"value"\fR\fR .ad .RS 20n -.rt Specifies the various SASL mechanisms. .RE @@ -533,7 +486,6 @@ Specifies the various SASL mechanisms. .sp .ne 2 -.mk .na \fB\fB-P\fR \fIpath\fR\fR .ad @@ -564,7 +516,6 @@ Use the \fB-P\fR option alone to specify server authentication only. .sp .ne 2 -.mk .na \fB\fB-p\fR \fIldapport\fR\fR .ad @@ -575,7 +526,6 @@ Specify an alternate TCP port where the secure LAPD server is listening. .sp .ne 2 -.mk .na \fB\fB-R\fR\fR .ad @@ -586,7 +536,6 @@ Do not automatically follow referrals returned while searching. .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad @@ -597,7 +546,6 @@ Display the output of the \fBldapsearch\fR command in the old format. .sp .ne 2 -.mk .na \fB\fB-S\fR [-]\fIattribute\fR\fR .ad @@ -621,7 +569,6 @@ server-side sorting. .sp .ne 2 -.mk .na \fB\fB-s\fR \fIscope\fR\fR .ad @@ -634,7 +581,6 @@ one-level, or subtree search. The default is \fBsub\fR. .sp .ne 2 -.mk .na \fB\fB-T\fR\fR .ad @@ -646,7 +592,6 @@ individual attribute values. .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad @@ -658,7 +603,6 @@ with non-ASCII values such as jpegPhoto or audio. .sp .ne 2 -.mk .na \fB\fB-U\fR\fR .ad @@ -679,7 +623,6 @@ jpegPhoto:< file:/tmp/ldapsearch-jpegPhoto-YzaOMh .sp .ne 2 -.mk .na \fB\fB-u\fR\fR .ad @@ -690,7 +633,6 @@ Include the user-friendly form of the Distinguished Name (DN) in the output. .sp .ne 2 -.mk .na \fB\fB-V\fR \fIversion\fR\fR .ad @@ -703,7 +645,6 @@ servers that do not support v3. .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad @@ -714,7 +655,6 @@ Run in verbose mode, with diagnostics written to standard output. .sp .ne 2 -.mk .na \fB\fB-W\fR \fIpassword\fR\fR .ad @@ -730,7 +670,6 @@ mutually exclusive of \fB-j\fR. .sp .ne 2 -.mk .na \fB\fB-w\fR \fIpasswd\fR\fR .ad @@ -747,7 +686,6 @@ the password is not visible to other users. .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad @@ -762,7 +700,6 @@ supported, rather than on the client. .sp .ne 2 -.mk .na \fB\fB-Y\fR \fIproxyDN\fR\fR .ad @@ -774,7 +711,6 @@ operation, usually in double quotes (" ") for the shell. .sp .ne 2 -.mk .na \fB\fB-Z\fR\fR .ad @@ -787,7 +723,6 @@ options needed to identify the certificate and the key database. .sp .ne 2 -.mk .na \fB\fB-z\fR \fIsizelimit\fR\fR .ad @@ -932,23 +867,19 @@ example% ldapsearch -u -h '['fec0::111:a00:20ff:fea3:edcf']' \e The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB>\fB0\fR\fR .ad .RS 6n -.rt An error occurred. A diagnostic message is written to standard error. .RE @@ -960,12 +891,11 @@ See \fBattributes\fR(5) for a description of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE -Stability LevelEvolving +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE +Stability Level Evolving .TE .SH SEE ALSO diff --git a/usr/src/man/man1/ldd.1 b/usr/src/man/man1/ldd.1 index bfdd18db7c..ff612c494f 100644 --- a/usr/src/man/man1/ldd.1 +++ b/usr/src/man/man1/ldd.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 ldd 1 "3 Jun 2008" "SunOS 5.11" "User Commands" +.TH LDD 1 "Jun 3, 2008" .SH NAME ldd \- list dynamic dependencies of executable files or shared objects .SH SYNOPSIS @@ -65,23 +65,19 @@ warnings for any unresolved symbol references that would occur when \fIfilename\fR is loaded. .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad .RS 6n -.rt Check \fBimmediate\fR references. .RE .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 6n -.rt Check both \fBimmediate\fR references and \fBlazy\fR references. .RE @@ -107,24 +103,20 @@ references can be reported with the following options. These options are only useful when combined with either the \fB-d\fR or the \fB-r\fR options. .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 6n -.rt Expose any unresolved symbol errors to explicit \fBparent\fR and \fBexternal\fR references. .RE .sp .ne 2 -.mk .na \fB\fB-w\fR\fR .ad .RS 6n -.rt Expose any unresolved \fBweak\fR symbol references. .RE @@ -171,12 +163,10 @@ Search paths that are not used to satisfy any dependencies cause unnecessary file system processing. .sp .ne 2 -.mk .na \fB\fB-U\fR\fR .ad .RS 6n -.rt Displays any unreferenced, or unused dependencies. If an unreferenced dependency is not bound to by other objects loaded with \fIfilename\fR, the dependency is also flagged as unused. Cyclic dependencies that are not bound to @@ -187,12 +177,10 @@ This option also displays any unused search paths. .sp .ne 2 -.mk .na \fB\fB-u\fR\fR .ad .RS 6n -.rt Displays any unused objects. .RE @@ -227,12 +215,10 @@ obtain the dependencies of this object, and hence will look unused to The following additional options are supported: .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad .RS 12n -.rt Disables any configuration file use. Configuration files can be employed to alter default search paths, and provide alternative object dependencies. See \fBcrle\fR(1). @@ -240,12 +226,10 @@ alter default search paths, and provide alternative object dependencies. See .sp .ne 2 -.mk .na \fB\fB-e\fR \fIenvar\fR\fR .ad .RS 12n -.rt Sets the environment variable \fIenvar\fR. .sp This option is useful for experimenting with environment variables that are @@ -259,12 +243,10 @@ and \fBlari\fR(1). .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 12n -.rt Forces \fBldd\fR to check for an executable file that is not secure. When \fBldd\fR is invoked by a superuser, by default \fBldd\fR does not process any executable that is not secure. An executable is not considered secure if the @@ -275,12 +257,10 @@ if the interpreter cannot be determined. See \fBSecurity\fR under USAGE. .sp .ne 2 -.mk .na \fB\fB-i\fR\fR .ad .RS 12n -.rt Displays the order of execution of initialization sections. The order that is discovered can be affected by use of the \fB-d\fR or \fB-r\fR options. See \fBInitialization Order\fR under USAGE. @@ -288,12 +268,10 @@ discovered can be affected by use of the \fB-d\fR or \fB-r\fR options. See .sp .ne 2 -.mk .na \fB\fB-L\fR\fR .ad .RS 12n -.rt Enables lazy loading. Lazy loading is the default mode of operation when the object under inspection is loaded as part of a process. In this case, any lazy dependencies, or filters, are only loaded into the process when reference is @@ -304,12 +282,10 @@ dependencies, and their order of loading as would occur in a running process. .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 12n -.rt Forces the immediate processing of any filters so that all filtees, and their dependencies, are listed. The immediate processing of filters is now the default mode of operation for \fBldd\fR. However, under this default any @@ -319,23 +295,19 @@ option, missing auxiliary filtees generate an error message. .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 12n -.rt Displays the search path used to locate shared object dependencies. .RE .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 12n -.rt Displays all dependency relationships incurred when processing \fIfilename\fR. This option also displays any dependency version requirements. See \fBpvs\fR(1). @@ -372,7 +344,7 @@ object: .sp .in +2 .nf -example% \fBldd main\fR +example% \fBldd main\fR libelf.so.1 => /lib/libelf.so.1 libnsl.so.1 => /lib/libnsl.so.1 libc.so.1 => /lib/libc.so.1 @@ -391,10 +363,10 @@ immediate, and lazy references respectively: .sp .in +2 .nf -example% \fBldd\fR \fB-L\fR \fBmain\fR -example% \fBldd\fR \fB-d\fR \fBmain\fR - libc.so.1 => /lib/libc.so.1 -example% \fBldd\fR \fB-r\fR \fBmain\fR +example% \fBldd\fR \fB-L\fR \fBmain\fR +example% \fBldd\fR \fB-d\fR \fBmain\fR + libc.so.1 => /lib/libc.so.1 +example% \fBldd\fR \fB-r\fR \fBmain\fR libc.so.1 => /lib/libc.so.1 libelf.so.1 => /lib/libelf.so.1 .fi @@ -422,7 +394,7 @@ the options used. For example, a simple application might reveal: .sp .in +2 .nf -example% \fBldd -i main\fR +example% \fBldd -i main\fR libA.so.1 => ./libA.so.1 libc.so.1 => /lib/libc.so.1 libB.so.1 => ./libB.so.1 @@ -440,7 +412,7 @@ whereas, when relocations are applied, the initialization section order is: .sp .in +2 .nf -example% \fBldd -ir main\fR +example% \fBldd -ir main\fR ......... init object=/lib/libc.so.1 @@ -475,23 +447,19 @@ dependencies using tools such as \fBdump\fR(1) and \fBelfdump\fR(1). .SH FILES .sp .ne 2 -.mk .na \fB\fB/usr/lib/lddstub\fR\fR .ad .RS 23n -.rt Fake 32-bit executable loaded to check the dependencies of shared objects. .RE .sp .ne 2 -.mk .na \fB\fB/usr/lib/64/lddstub\fR\fR .ad .RS 23n -.rt Fake 64-bit executable loaded to check the dependencies of shared objects. .RE diff --git a/usr/src/man/man1/let.1 b/usr/src/man/man1/let.1 index 10f3b59825..6b46143c65 100644 --- a/usr/src/man/man1/let.1 +++ b/usr/src/man/man1/let.1 @@ -1,11 +1,11 @@ '\" te .\" Copyright (c) 2007 Sun Microsystems, Inc. - All Rights Reserved. -.\" Copyright 1989 AT&T +.\" Copyright 1989 AT&T .\" Portions Copyright (c) 1982-2007 AT&T Knowledge Ventures .\" 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 let 1 "2 Nov 2007" "SunOS 5.11" "User Commands" +.TH LET 1 "Nov 2, 2007" .SH NAME let \- shell built-in function to evaluate one or more arithmetic expressions .SH SYNOPSIS @@ -42,23 +42,19 @@ command arguments. \fBksh\fR returns the following exit values: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt The value of the last expression is \fBnon-zero\fR. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt The value of the last expression is zero. .RE @@ -68,23 +64,19 @@ The value of the last expression is zero. \fBksh93\fR returns the following exit values: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt The last \fIexpr\fR evaluates to a \fBnon-zero\fR value. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt The last \fIexpr\fR evaluates to \fB0\fR or an error occurred. .RE diff --git a/usr/src/man/man1/lex.1 b/usr/src/man/man1/lex.1 index 438df0fa3c..f12f22a3f8 100644 --- a/usr/src/man/man1/lex.1 +++ b/usr/src/man/man1/lex.1 @@ -1,13 +1,13 @@ '\" te .\" Copyright (c) 1992, X/Open Company Limited All Rights Reserved Portions Copyright (c) 1997, Sun Microsystems, Inc. All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 lex 1 "22 Aug 1997" "SunOS 5.11" "User Commands" +.TH LEX 1 "Aug 22, 1997" .SH NAME lex \- generate programs for lexical tasks .SH SYNOPSIS @@ -32,35 +32,29 @@ description of the \fBlex\fR input language. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-c\fR \fR .ad .RS 12n -.rt Indicates C-language action (default option). .RE .sp .ne 2 -.mk .na \fB\fB-e\fR \fR .ad .RS 12n -.rt Generates a program that can handle \fBEUC\fR characters (cannot be used with the \fB-w\fR option). \fByytext[\|]\fR is of type \fBunsigned char[\|]\fR. .RE .sp .ne 2 -.mk .na \fB\fB-n\fR \fR .ad .RS 12n -.rt Suppresses the summary of statistics usually written with the \fB-v\fR option. If no table sizes are specified in the \fBlex\fR source code and the \fB-v\fR option is not specified, then \fB-n\fR is implied. @@ -68,23 +62,19 @@ option is not specified, then \fB-n\fR is implied. .sp .ne 2 -.mk .na \fB\fB-t\fR \fR .ad .RS 12n -.rt Writes the resulting program to standard output instead of \fBlex.yy.c\fR. .RE .sp .ne 2 -.mk .na \fB\fB-v\fR \fR .ad .RS 12n -.rt Writes a summary of \fBlex\fR statistics to the standard error. (See the discussion of \fBlex\fR table sizes under the heading \fBDefinitions in lex\fR.) If table sizes are specified in the \fBlex\fR source code, and if the @@ -93,12 +83,10 @@ lex\fR.) If table sizes are specified in the \fBlex\fR source code, and if the .sp .ne 2 -.mk .na \fB\fB-w\fR \fR .ad .RS 12n -.rt Generates a program that can handle \fBEUC\fR characters (cannot be used with the \fB-e\fR option). Unlike the \fB-e\fR option, \fByytext[\|]\fR is of type \fBwchar_t[\|]\fR. @@ -106,23 +94,19 @@ the \fB-e\fR option). Unlike the \fB-e\fR option, \fByytext[\|]\fR is of type .sp .ne 2 -.mk .na \fB\fB-V\fR \fR .ad .RS 12n -.rt Prints out version information on standard error. .RE .sp .ne 2 -.mk .na \fB\fB\fR\fB-Q\fR\fB[y|n]\fR \fR .ad .RS 12n -.rt Prints out version information to output file \fBlex.yy.c\fR by using \fB-Qy\fR. The \fB-Qn\fR option does not print out version information and is the default. @@ -134,12 +118,10 @@ the default. The following operand is supported: .sp .ne 2 -.mk .na \fB\fIfile\fR \fR .ad .RS 9n -.rt A pathname of an input file. If more than one such \fIfile\fR is specified, all files will be concatenated to produce a single \fBlex\fR program. If no \fIfile\fR operands are specified, or if a \fIfile\fR operand is \fB\(mi\fR, @@ -312,23 +294,19 @@ Implementations accept either of the following two mutually exclusive declarations in the \fBDefinitions\fR \fBin\fR \fBlex\fR section: .sp .ne 2 -.mk .na \fB\fB%array\fR \fR .ad .RS 13n -.rt Declare the type of \fIyytext\fR to be a null-terminated character array. .RE .sp .ne 2 -.mk .na \fB\fB%pointer\fR \fR .ad .RS 13n -.rt Declare the type of \fIyytext\fR to be a pointer to a null-terminated character string. .RE @@ -364,18 +342,17 @@ following table. .sp .TS -tab() box; -cw(1.28i) cw(2.94i) cw(1.28i) -lw(1.28i) lw(2.94i) lw(1.28i) -. -\fBDeclaration\fR\fBDescription\fR\fBDefault\fR +box; +c c c +l l l . +\fBDeclaration\fR \fBDescription\fR \fBDefault\fR _ -\fB%p\fR\fIn\fRNumber of positions2500 -\fB%n\fR\fIn\fRNumber of states500 -\fB%a\fR\fI n\fRNumber of transitions2000 -\fB%e\fR\fIn\fRNumber of parse tree nodes1000 -\fB%k\fR\fIn\fRNumber of packed character classes10000 -\fB%o\fR\fIn\fRSize of the output array3000 +\fB%p\fR\fIn\fR Number of positions 2500 +\fB%n\fR\fIn\fR Number of states 500 +\fB%a\fR\fI n\fR Number of transitions 2000 +\fB%e\fR\fIn\fR Number of parse tree nodes 1000 +\fB%k\fR\fIn\fR Number of packed character classes 10000 +\fB%o\fR\fIn\fR Size of the output array 3000 .TE .sp @@ -455,12 +432,10 @@ described on \fBregex\fR(5) with the following additions and exceptions to the syntax: .sp .ne 2 -.mk .na \fB\fB\|.\|.\|.\fR \fR .ad .RS 14n -.rt Any string enclosed in double-quotes will represent the characters within the double-quotes as themselves, except that backslash escapes (which appear in the following table) are recognized. Any backslash-escape sequence is terminated by @@ -473,7 +448,6 @@ octal value 1 followed by the character 1. \fI<\fR\fIstate\fR\fI>\fR\fIr\fR .sp .ne 2 -.mk .na \fB<\fIstate1\fR, \fIstate2\fR, \|.\|.\|.\|>\fIr\fR\fR .ad @@ -490,7 +464,6 @@ at the beginning of a regular expression. .sp .ne 2 -.mk .na \fB\fIr\fR/\fIx\fR \fR .ad @@ -511,7 +484,6 @@ grouped within parentheses. .sp .ne 2 -.mk .na \fB\fB{\fR\fIname\fR\fB}\fR \fR .ad @@ -543,29 +515,28 @@ character cannot be matched by a period operator. .sp .TS -tab() box; -cw(1.22i) cw(2.92i) cw(1.36i) -cw(1.22i) cw(2.92i) cw(1.36i) -. +box; +c c c +c c c . Escape Sequences in lex _ -Escape SequenceDescription Meaning +Escape Sequence Description Meaning _ -\e\fIdigits\fRT{ +\e\fIdigits\fR T{ A backslash character followed by the longest sequence of one, two or three octal-digit characters (01234567). Ifall of the digits are 0, (that is, representation of the NUL character), the behavior is undefined. -T}T{ +T} T{ The character whose encoding is represented by the one-, two- or three-digit octal integer. Multi-byte characters require multiple, concatenated escape sequences of this type, including the leading \e for each byte. T} _ -\e\fBx\fR\fIdigits\fRT{ +\e\fBx\fR\fIdigits\fR T{ A backslash character followed by the longest sequence of hexadecimal-digit characters (01234567abcdefABCDEF). If all of the digits are 0, (that is, representation of the NUL character), the behavior is undefined. -T}T{ +T} T{ The character whose encoding is represented by the hexadecimal integer. T} _ -\e\fIc\fRT{ +\e\fIc\fR T{ A backslash character followed by any character not described in this table. (\e\e, \ea, \eb, \ef, \een, \er, \et, \ev). -T}The character c, unchanged. +T} The character c, unchanged. .TE .sp @@ -574,12 +545,10 @@ The order of precedence given to extended regular expressions for \fBlex\fR is as shown in the following table, from high to low. .sp .ne 2 -.mk .na \fB\fBNote\fR: \fR .ad .RS 10n -.rt The escaped characters entry is not meant to imply that these are operators, but they are included in the table to show their relationships to the true operators. The start condition, trailing context and anchoring notations have @@ -591,22 +560,21 @@ this section; they can only appear at the beginning or ending of an \fBERE.\fR .sp .TS -tab() box; -cw(2.75i) cw(2.75i) -lw(2.75i) lw(2.75i) -. +box; +c c +l l . ERE Precedence in lex _ -\fIcollation-related bracket symbols\fR\fB[= =] [: :] [. .]\fR -\fIescaped characters\fR\fB\e<\fR\fIspecial character\fR> -\fIbracket expression\fR\fB[ ]\fR -\fIquoting\fR\fB".\|.\|."\fR -\fIgrouping\fR\fB()\fR -\fIdefinition\fR\fB{\fR\fIname\fR} -\fIsingle-character RE duplication\fR\fB* + ?\fR -\fIconcatenation\fR -\fIinterval expression\fR\fB{\fR\fIm\fR,\fIn\fR} -\fIalternation\fR\fB|\fR +\fIcollation-related bracket symbols\fR \fB[= =] [: :] [. .]\fR +\fIescaped characters\fR \fB\e<\fR\fIspecial character\fR> +\fIbracket expression\fR \fB[ ]\fR +\fIquoting\fR \fB".\|.\|."\fR +\fIgrouping\fR \fB()\fR +\fIdefinition\fR \fB{\fR\fIname\fR} +\fIsingle-character RE duplication\fR \fB* + ?\fR +\fIconcatenation\fR +\fIinterval expression\fR \fB{\fR\fIm\fR,\fIn\fR} +\fIalternation\fR \fB|\fR .TE .sp @@ -711,12 +679,10 @@ Four special actions are available: .sp .ne 2 -.mk .na \fB|\fR .ad .RS 12n -.rt The action | means that the action for the next rule is the action for this rule. Unlike the other three actions, | cannot be enclosed in braces or be semicolon-terminated. It must be specified alone, with no other actions. @@ -724,23 +690,19 @@ semicolon-terminated. It must be specified alone, with no other actions. .sp .ne 2 -.mk .na \fB\fBECHO;\fR \fR .ad .RS 12n -.rt Writes the contents of the string \fIyytext\fR on the output. .RE .sp .ne 2 -.mk .na \fB\fBREJECT;\fR \fR .ad .RS 12n -.rt Usually only a single expression is matched by a given string in the input. \fBREJECT\fR means "continue to the next expression that matches the current input," and causes whatever rule was the second choice after the current rule @@ -758,12 +720,10 @@ scanners. .sp .ne 2 -.mk .na \fB\fBBEGIN\fR \fR .ad .RS 12n -.rt The action: .sp \fBBEGIN\fR \fInewstate\fR\fB;\fR @@ -782,12 +742,10 @@ of \fBlex\fR, or are accessible only through the \fB\fR\fB-l\fR\fB l\fR operand to \fBc89\fR or \fBcc\fR (the \fBlex\fR library). .sp .ne 2 -.mk .na \fB\fBint\fR \fByylex(void)\fR \fR .ad .RS 21n -.rt Performs lexical analysis on the input; this is the primary function generated by the \fBlex\fR utility. The function returns zero when the end of input is reached; otherwise it returns non-zero values (tokens) determined by the @@ -796,12 +754,10 @@ actions that are selected. .sp .ne 2 -.mk .na \fB\fBint\fR \fByymore(void)\fR \fR .ad .RS 21n -.rt When called, indicates that when the next input string is recognized, it is to be appended to the current value of \fIyytext\fR rather than replacing it; the value in \fIyyleng\fR is adjusted accordingly. @@ -809,12 +765,10 @@ value in \fIyyleng\fR is adjusted accordingly. .sp .ne 2 -.mk .na \fB\fBint\fR\fIyyless(int\fR\fB n\fR\fI)\fR \fR .ad .RS 21n -.rt Retains \fIn\fR initial characters in \fIyytext\fR, NUL-terminated, and treats the remaining characters as if they had not been read; the value in \fIyyleng\fR is adjusted accordingly. @@ -822,12 +776,10 @@ the remaining characters as if they had not been read; the value in .sp .ne 2 -.mk .na \fB\fBint\fR \fBinput(void)\fR \fR .ad .RS 21n -.rt Returns the next character from the input, or zero on end-of-file. It obtains input from the stream pointer \fIyyin\fR, although possibly via an intermediate buffer. Thus, once scanning has begun, the effect of altering the value of @@ -837,12 +789,10 @@ the scanner without any processing by the scanner. .sp .ne 2 -.mk .na \fB\fBint\fR \fBunput(int\fR \fB\fIc\fR\fR\fB)\fR \fR .ad .RS 21n -.rt Returns the character \fIc\fR to the input; \fIyytext\fR and \fIyyleng\fR are undefined until the next expression is matched. The result of using \fIunput\fR for more characters than have been input is unspecified. @@ -855,7 +805,6 @@ the \fB\fR\fB-l\fR\fB l\fR operand; they can therefore be redefined by a portable application: .sp .ne 2 -.mk .na \fB\fBint\fR \fByywrap(void)\fR \fR .ad @@ -870,7 +819,6 @@ another source of input, then the application can include a function .sp .ne 2 -.mk .na \fB\fBint\fR \fBmain(int\fR \fB\fIargc\fR,\fR \fBchar\fR \fB*\fIargv\fR[\|])\fR \fR @@ -987,23 +935,19 @@ that affect the execution of \fBlex\fR: \fBLANG\fR, \fBLC_ALL\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR \fR .ad .RS 7n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR \fR .ad .RS 7n -.rt An error occurred. .RE @@ -1015,13 +959,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO @@ -1032,7 +975,7 @@ Interface StabilityStandard .SH NOTES .sp .LP -If routines such as \fByyback()\fR, \fByywrap()\fR, and \fByylock()\fR +If routines such as \fByyback()\fR, \fByywrap()\fR, and \fByylock()\fR in \fB\|.l\fR (ell) files are to be external C functions, the command line to compile a C++ program must define the \fB__EXTERN_C__\fR macro. For example: .sp diff --git a/usr/src/man/man1/lgrpinfo.1 b/usr/src/man/man1/lgrpinfo.1 index d303879c3e..294db80a0e 100644 --- a/usr/src/man/man1/lgrpinfo.1 +++ b/usr/src/man/man1/lgrpinfo.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 lgrpinfo 1 "11 Sep 2006" "SunOS 5.11" "User Commands" +.TH LGRPINFO 1 "Sep 11, 2006" .SH NAME lgrpinfo \- display information about locality groups .SH SYNOPSIS @@ -91,12 +91,10 @@ lgrpinfo -c -e -l -m -r -t all The following options are supported: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 12n -.rt Print topology, CPU, memory, load and latency information. .sp This option is a shorthand for @@ -114,12 +112,10 @@ option is not included. .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad .RS 12n -.rt Print CPU information. .sp This is the default. @@ -127,12 +123,10 @@ This is the default. .sp .ne 2 -.mk .na \fB\fB-C\fR\fR .ad .RS 12n -.rt Replace each lgroup in the list with its children. .sp This option cannot be used with the \fB-P\fR or the \fB-T\fR option. When no @@ -142,12 +136,10 @@ default. .sp .ne 2 -.mk .na \fB\fB-e\fR\fR .ad .RS 12n -.rt Print lgroup load average. The lgroup load averages are only displayed for leaf lgroups. .sp @@ -156,12 +148,10 @@ This is the default. .sp .ne 2 -.mk .na \fB\fB-G\fR\fR .ad .RS 12n -.rt Print OS view of lgroup hierarchy. .sp By default, the caller's view of the lgroup hierarchy is displayed which only @@ -172,23 +162,19 @@ and the caller's view. .sp .ne 2 -.mk .na \fB\fB-h\fR\fR .ad .RS 12n -.rt Print short help message and exit. .RE .sp .ne 2 -.mk .na \fB\fB-I\fR\fR .ad .RS 12n -.rt Print matching IDs only. .sp This option is intended for scripts and can be used with \fB-c\fR, \fB-G\fR, @@ -202,12 +188,10 @@ displayed, which, by default is all lgroups. .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 12n -.rt Print information about lgroup latencies. .sp The latency value specified for each lgroup is defined by the operating system @@ -218,24 +202,20 @@ latency between hardware devices and might not be applicable across platforms. .sp .ne 2 -.mk .na \fB\fB-L\fR\fR .ad .RS 12n -.rt Print the lgroup latency table. The lgroup latency table displays the relative latency from each lgroup to each of the other lgroups including itself. .RE .sp .ne 2 -.mk .na \fB\fB-m\fR\fR .ad .RS 12n -.rt Print memory information. .sp Memory sizes are scaled to the unit of measure that yields an integer from @@ -249,12 +229,10 @@ This is the default. .sp .ne 2 -.mk .na \fB\fB-P\fR\fR .ad .RS 12n -.rt Replace each lgroup in the list with its parents. .sp This option cannot be used with the \fB-C\fR or \fB-T\fR option. When no @@ -264,12 +242,10 @@ which, by default is all lgroups. .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 12n -.rt Print information about lgroup resources. .sp The resources are represented by a set of lgroups in which each member lgroup @@ -279,12 +255,10 @@ only information about resources of the intermediate lgroups is displayed. .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad .RS 12n -.rt Print information about lgroup topology. .sp This is the default. @@ -292,12 +266,10 @@ This is the default. .sp .ne 2 -.mk .na \fB\fB-T\fR\fR .ad .RS 12n -.rt Print the lgroup topology of a system graphically as a tree. This option can only be used with the \fB-a\fR, \fB-c\fR, \fB-e\fR, \fB-G\fR, \fB-l\fR,\fB-L\fR, \fB-m\fR, \fB-r\fR, and \fB-u\fR options. It only prints @@ -308,12 +280,10 @@ is printed for the \fBroot\fR lgroup unless it is the only lgroup. .sp .ne 2 -.mk .na \fB\fB-u\fR \fIunits\fR\fR .ad .RS 12n -.rt Specify memory units. Units should be b, k, m, g, t, p, or e for bytes, kilobytes, megabytes, gigabytes, terabytes, petabytes, or exabytes respectively. The fractional part of the number is only displayed for values @@ -327,22 +297,18 @@ less than 10. This behavior is similiar to using the \fB-h\fR option of The following operands are supported: .sp .ne 2 -.mk .na \fB\fIlgrp\fR\fR .ad .RS 8n -.rt lgroups can be specified on the command line as lgroup ID, by using one of the following keywords: .sp .ne 2 -.mk .na \fBall\fR .ad .RS 16n -.rt All lgroups. .sp This is the default. @@ -350,36 +316,30 @@ This is the default. .sp .ne 2 -.mk .na \fBintermediate\fR .ad .RS 16n -.rt All intermediate lgroups. An intermediate lgroup is an lgroup that has a parent and children. .RE .sp .ne 2 -.mk .na \fBleaves\fR .ad .RS 16n -.rt All leaf lgroups. A leaf lgroup is an lgroup that has no children in the lgroup hierarchy. .RE .sp .ne 2 -.mk .na \fBroot\fR .ad .RS 16n -.rt Root lgroup. Root lgroup contains all the resources in the domain within the largest latency and has no parent lgroup. .RE @@ -549,45 +509,37 @@ The following example prints information about lgroup latencies: The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt Unable to get lgroup information from the system. .RE .sp .ne 2 -.mk .na \fB\fB2\fR\fR .ad .RS 5n -.rt All lgroups specified are invalid. .RE .sp .ne 2 -.mk .na \fB\fB3\fR\fR .ad .RS 5n -.rt Invalid syntax. .RE @@ -599,13 +551,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilitySee below. +Interface Stability See below. .TE .sp diff --git a/usr/src/man/man1/limit.1 b/usr/src/man/man1/limit.1 index 5a86860e8a..d0e9d4db18 100644 --- a/usr/src/man/man1/limit.1 +++ b/usr/src/man/man1/limit.1 @@ -2,14 +2,14 @@ .\" Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved .\" Portions Copyright (c) 1982-2007 AT&T Knowledge Ventures .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 limit 1 "2 Nov 2007" "SunOS 5.11" "User Commands" +.TH LIMIT 1 "Nov 2, 2007" .SH NAME limit, ulimit, unlimit \- set or get limitations on the system resources available to the current shell and its descendents @@ -88,78 +88,64 @@ The following options specify the resource whose limits are to be printed or set. If no option is specified, the file size limit is printed or set. .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad .RS 6n -.rt Maximum core file size (in 512-byte blocks) .RE .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad .RS 6n -.rt Maximum size of data segment or heap (in Kbytes) .RE .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 6n -.rt Maximum file size (in 512-byte blocks) .RE .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 6n -.rt Maximum file descriptor plus 1 .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 6n -.rt Maximum size of stack segment (in Kbytes) .RE .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad .RS 6n -.rt Maximum CPU time (in seconds) .RE .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 6n -.rt Maximum size of virtual memory (in Kbytes) .RE @@ -173,12 +159,10 @@ limit, if any, be removed. If \fIlimit\fR is omitted, prints the current limit. If \fIresource\fR is omitted, displays all limits. .sp .ne 2 -.mk .na \fB\fB-h\fR\fR .ad .RS 6n -.rt Use hard limits instead of the current limits. Hard limits impose a ceiling on the values of the current limits. Only the privileged user can raise the hard limits. @@ -189,69 +173,57 @@ limits. \fIresource\fR is one of: .sp .ne 2 -.mk .na \fB\fBcputime\fR\fR .ad .RS 16n -.rt Maximum \fBCPU\fR seconds per process. .RE .sp .ne 2 -.mk .na \fB\fBfilesize\fR\fR .ad .RS 16n -.rt Largest single file allowed. Limited to the size of the filesystem (see \fBdf\fR(1M)). .RE .sp .ne 2 -.mk .na \fB\fBdatasize\fR\fR .ad .RS 16n -.rt The maximum size of a process's heap in kilobytes. .RE .sp .ne 2 -.mk .na \fB\fBstacksize\fR\fR .ad .RS 16n -.rt Maximum stack size for the process. The default stack size is 2^64. .RE .sp .ne 2 -.mk .na \fB\fBcoredumpsize\fR\fR .ad .RS 16n -.rt Maximum size of a core dump (file). This is limited to the size of the filesystem. .RE .sp .ne 2 -.mk .na \fB\fBdescriptors\fR\fR .ad .RS 16n -.rt Maximum number of file descriptors. Run the \fBsysdef\fR(1M) command to obtain the maximum possible limits for your system. The values reported are in hexadecimal, but can be translated into decimal numbers using the \fBbc\fR(1) @@ -260,12 +232,10 @@ command. .sp .ne 2 -.mk .na \fB\fBmemorysize\fR\fR .ad .RS 16n -.rt Maximum size of virtual memory. .RE @@ -274,45 +244,37 @@ Maximum size of virtual memory. \fIlimit\fR is a number, with an optional scaling factor, as follows: .sp .ne 2 -.mk .na \fB\fIn\fR\fBh\fR\fR .ad .RS 9n -.rt Hours (for \fBcputime\fR). .RE .sp .ne 2 -.mk .na \fB\fIn\fR\fBk\fR\fR .ad .RS 9n -.rt \fIn\fR kilobytes. This is the default for all but \fBcputime\fR. .RE .sp .ne 2 -.mk .na \fB\fIn\fR\fBm\fR\fR .ad .RS 9n -.rt \fIn\fR megabytes or minutes (for \fBcputime\fR). .RE .sp .ne 2 -.mk .na \fB\fImm\fR\fB:\fR\fIss\fR\fR .ad .RS 9n -.rt Minutes and seconds (for \fBcputime\fR). .RE @@ -323,12 +285,10 @@ specified, then all resource limitations are removed. See the description of the \fBlimit\fR command for the list of resource names. .sp .ne 2 -.mk .na \fB\fB-h\fR\fR .ad .RS 6n -.rt Remove corresponding hard limits. Only the privileged user can do this. .RE @@ -351,90 +311,74 @@ than one resource is specified, then the limit name and unit is printed before the value. .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 6n -.rt Lists all of the current resource limits. .RE .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad .RS 6n -.rt The number of 512-byte blocks on the size of core dumps. .RE .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad .RS 6n -.rt The number of K-bytes on the size of the data area. .RE .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 6n -.rt The number of 512-byte blocks on files written by child processes (files of any size can be read). .RE .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 6n -.rt The number of file descriptors plus 1. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 6n -.rt The number of K-bytes on the size of the stack area. .RE .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad .RS 6n -.rt The number of seconds (CPU time) to be used by each process. .RE .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 6n -.rt The number of K-bytes for virtual memory. .RE @@ -481,18 +425,15 @@ If you do not specify any resource, the default is \fB-f.\fR The following options are available for \fBulimit\fR in \fBksh93\fR: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 13n -.rt Displays all current resource limits. .RE .sp .ne 2 -.mk .na \fB\fB-b\fR\fR .ad @@ -501,13 +442,11 @@ Displays all current resource limits. \fB\fB--sbsize\fR\fR .ad .RS 13n -.rt Specifies the socket buffer size in bytes. .RE .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad @@ -516,13 +455,11 @@ Specifies the socket buffer size in bytes. \fB\fB--core\fR\fR .ad .RS 13n -.rt Specifies the core file size in blocks. .RE .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad @@ -531,13 +468,11 @@ Specifies the core file size in blocks. \fB\fB--data\fR\fR .ad .RS 13n -.rt Specifies the data size in kbytes. .RE .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad @@ -546,24 +481,20 @@ Specifies the data size in kbytes. \fB\fB--fsize\fR\fR .ad .RS 13n -.rt Specifies the file size in blocks. .RE .sp .ne 2 -.mk .na \fB\fB-H\fR\fR .ad .RS 13n -.rt Displays or sets a hard limit. .RE .sp .ne 2 -.mk .na \fB\fB-L\fR\fR .ad @@ -572,13 +503,11 @@ Displays or sets a hard limit. \fB\fB--locks\fR\fR .ad .RS 13n -.rt Specifies the number of file locks. .RE .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad @@ -587,13 +516,11 @@ Specifies the number of file locks. \fB\fB--memlock\fR\fR .ad .RS 13n -.rt Specifies the locked address space in Kbytes. .RE .sp .ne 2 -.mk .na \fB\fB-M\fR\fR .ad @@ -602,13 +529,11 @@ Specifies the locked address space in Kbytes. \fB\fB--as\fR\fR .ad .RS 13n -.rt Specifies the address space limit in Kbytes. .RE .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad @@ -617,13 +542,11 @@ Specifies the address space limit in Kbytes. \fB\fB--nofile\fR\fR .ad .RS 13n -.rt Specifies the number of open files. .RE .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad @@ -632,13 +555,11 @@ Specifies the number of open files. \fB\fB--pipe\fR\fR .ad .RS 13n -.rt Specifies the pipe buffer size in bytes. .RE .sp .ne 2 -.mk .na \fB\fB-m\fR\fR .ad @@ -647,24 +568,20 @@ Specifies the pipe buffer size in bytes. \fB\fB--rss\fR\fR .ad .RS 13n -.rt Specifies the resident set size in Kbytes .RE .sp .ne 2 -.mk .na \fB\fB-S\fR\fR .ad .RS 13n -.rt Displays or sets a soft limit. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad @@ -673,13 +590,11 @@ Displays or sets a soft limit. \fB\fB--stack\fR\fR .ad .RS 13n -.rt Specifies the stack size in Kbytes. .RE .sp .ne 2 -.mk .na \fB\fB-T\fR\fR .ad @@ -688,13 +603,11 @@ Specifies the stack size in Kbytes. \fB\fB--threads\fR\fR .ad .RS 13n -.rt Specifies the number of threads. .RE .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad @@ -703,13 +616,11 @@ Specifies the number of threads. \fB\fB--cpu\fR\fR .ad .RS 13n -.rt Specifies the CPU time in seconds. .RE .sp .ne 2 -.mk .na \fB\fB-u\fR\fR .ad @@ -718,13 +629,11 @@ Specifies the CPU time in seconds. \fB\fB--nproc\fR\fR .ad .RS 13n -.rt Specifies the number of processes. .RE .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad @@ -733,7 +642,6 @@ Specifies the number of processes. \fB\fB--vmem\fR\fR .ad .RS 13n -.rt Specifies the process size in Kbytes. .RE @@ -743,12 +651,10 @@ Specifies the process size in Kbytes. The following option is supported by \fB/usr/bin/ulimit\fR: .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 6n -.rt Sets (or reports, if no \fIblocks\fR operand is present), the file size limit in blocks. The \fB-f\fR option is also the default case. .RE @@ -759,12 +665,10 @@ in blocks. The \fB-f\fR option is also the default case. The following operand is supported by \fB/usr/bin/ulimit\fR: .sp .ne 2 -.mk .na \fB\fIblocks\fR\fR .ad .RS 10n -.rt The number of 512-byte blocks to use as the new file size limit. .RE @@ -872,23 +776,19 @@ that affect the execution of \fBulimit\fR: \fBLANG\fR, \fBLC_ALL\fR, The following exit values are returned by \fBulimit\fR: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt A request for a higher limit was rejected or an error occurred. .RE @@ -901,15 +801,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .SS "ksh93" @@ -917,13 +816,12 @@ StandardSee \fBstandards\fR(5). .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityUncommitted +Interface Stability Uncommitted .TE .SH SEE ALSO diff --git a/usr/src/man/man1/line.1 b/usr/src/man/man1/line.1 index 79450ea09a..bd577ace71 100644 --- a/usr/src/man/man1/line.1 +++ b/usr/src/man/man1/line.1 @@ -1,19 +1,19 @@ '\" te .\" Copyright 1989 AT&T Copyright (c) 1995, Sun Microsystems, Inc. All Rights Reserved Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 line 1 "1 Feb 1995" "SunOS 5.11" "User Commands" +.TH LINE 1 "Feb 1, 1995" .SH NAME line \- read one line .SH SYNOPSIS .LP .nf -\fBline\fR +\fBline\fR .fi .SH DESCRIPTION @@ -29,23 +29,19 @@ is often used within shell files to read from the user's terminal. Exit status is: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt End-of-file on input. .RE diff --git a/usr/src/man/man1/list_devices.1 b/usr/src/man/man1/list_devices.1 index 43561c0045..d86c86fd2d 100644 --- a/usr/src/man/man1/list_devices.1 +++ b/usr/src/man/man1/list_devices.1 @@ -3,13 +3,13 @@ .\" 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 list_devices 1 "30 Apr 2008" "SunOS 5.11" "User Commands" +.TH LIST_DEVICES 1 "Apr 30, 2008" .SH NAME list_devices \- list allocatable devices .SH SYNOPSIS .LP .nf -\fBlist_devices\fR [\fB-s\fR] [\fB-U\fR \fIuid\fR] [\fB-z\fR \fIzonename\fR] [\fB-a\fR [\fB-w\fR]] +\fBlist_devices\fR [\fB-s\fR] [\fB-U\fR \fIuid\fR] [\fB-z\fR \fIzonename\fR] [\fB-a\fR [\fB-w\fR]] \fB-l\fR | \fB-n\fR | \fB-u\fR [\fIdevice\fR] | [\fB-l\fR | \fB-n\fR | \fB-u\fR] \fB-c\fR \fIdev-class\fR .fi @@ -35,12 +35,10 @@ specified \fIdev-class\fR are listed. There is no default \fIdev-class\fR. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-l\fR [\fB-c\fR \fIdev-class\fR | \fIdevice\fR]\fR .ad .RS 30n -.rt Lists the pathnames of the device special files associated with the \fIdevice\fR that are allocatable to the current process. .sp @@ -53,12 +51,10 @@ specified device. .sp .ne 2 -.mk .na \fB\fB-n\fR [\fB-c\fR \fIdev-class\fR | \fIdevice\fR]\fR .ad .RS 30n -.rt Lists the pathnames of the device special files associated with the device that are allocatable to the current process but are not currently allocated. .sp @@ -71,23 +67,19 @@ specified device. .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 30n -.rt Silent. Suppresses any diagnostic output. .RE .sp .ne 2 -.mk .na \fB\fB-u\fR [\fB-c\fR \fIdev-class\fR | \fIdevice\fR]\fR .ad .RS 30n -.rt Lists the pathnames of device special files associated with the device that are allocated to the owner of the current process. .sp @@ -100,12 +92,10 @@ specified device. .sp .ne 2 -.mk .na \fB\fB-U\fR \fIuid\fR\fR .ad .RS 30n -.rt Uses the user \fBID\fR \fIuid\fR instead of the real user \fBID\fR of the current process when performing the \fBlist_devices\fR operation. Only a user with the \fBsolaris.device.revoke\fR authorization can use this option. @@ -117,12 +107,10 @@ The following options are supported when the system is configured with Trusted Extensions: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 15n -.rt Lists attributes like authorizations, cleaning programs and labels associated with a device. .sp @@ -148,60 +136,50 @@ format. The \fB-a\fR output has the following keys: .sp .ne 2 -.mk .na \fB\fBauths\fR\fR .ad .RS 10n -.rt Specifies the list of authorizations. The value is \fBauths\fR is described in \fBdevice_allocate\fR(4). .RE .sp .ne 2 -.mk .na \fB\fBclean\fR\fR .ad .RS 10n -.rt Specifies the device cleaning script. The value is \fBdevice-exec\fR as described in \fBdevice_allocate\fR(4). .RE .sp .ne 2 -.mk .na \fB\fBdevice\fR\fR .ad .RS 10n -.rt Specifies the device name. The value is \fBdevice-name\fR as described in \fBdevice_allocate\fR(4). .RE .sp .ne 2 -.mk .na \fB\fBfiles\fR\fR .ad .RS 10n -.rt Specifies the device file paths. The value is \fBdevice-list\fR as described in \fBdevice_maps\fR(4). .RE .sp .ne 2 -.mk .na \fB\fBtype\fR\fR .ad .RS 10n -.rt Specifies the device type. The value is \fBdevice-type\fR as described in \fBdevice_allocate\fR(4). .RE @@ -210,12 +188,10 @@ Specifies the device type. The value is \fBdevice-type\fR as described in .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad .RS 15n -.rt Displays the system-supplied default attributes for the device types managed by device allocation. If \fIdev-type\fR is specified, it lists the default attributes for only that device type. @@ -223,12 +199,10 @@ attributes for only that device type. .sp .ne 2 -.mk .na \fB\fB-w\fR\fR .ad .RS 15n -.rt This option can be used with \fB-a\fR to list the current owner of the device as the key value pair \fIowner\fR\fB=\fR\fIvalue\fR. \fIvalue\fR is the \fBuid\fR of the current owner of the device. If the device is unallocated, @@ -238,12 +212,10 @@ This option also suppresses any diagnostic output. .sp .ne 2 -.mk .na \fB\fB-z\fR \fIzonename\fR\fR .ad .RS 15n -.rt When specified with the \fB-l\fR option, lists only those non-allocated devices whose label range includes the label of the zonename, and of the allocated devices, only those that are allocated at the same label as that of @@ -319,34 +291,28 @@ files=/dev/audio2 /dev/audio2ctl /dev/sound/2 /dev/sound/2ctl The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 15n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB20\fR\fR .ad .RS 15n -.rt No entry for the specified device. .RE .sp .ne 2 -.mk .na \fB\fIother value\fR\fR .ad .RS 15n -.rt An error occurred. .RE @@ -371,13 +337,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilitySee below. +Interface Stability See below. .TE .sp diff --git a/usr/src/man/man1/listusers.1 b/usr/src/man/man1/listusers.1 index faf9b48fc6..2112ebefb0 100644 --- a/usr/src/man/man1/listusers.1 +++ b/usr/src/man/man1/listusers.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 listusers 1 "18 Mar 1994" "SunOS 5.11" "User Commands" +.TH LISTUSERS 1 "Mar 18, 1994" .SH NAME listusers \- list user login information .SH SYNOPSIS @@ -24,24 +24,20 @@ the system's password database as specified by \fB/etc/nsswitch.conf\fR. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-g\fR\fI groups\fR\fR .ad .RS 13n -.rt Lists all user logins belonging to \fBgroup\fR, sorted by login. Multiple groups can be specified as a comma-separated list. .RE .sp .ne 2 -.mk .na \fB\fB-l\fR\fI logins\fR\fR .ad .RS 13n -.rt Lists the user login or logins specified by \fBlogins\fR, sorted by login. Multiple logins can be specified as a comma-separated list. .RE diff --git a/usr/src/man/man1/ln.1 b/usr/src/man/man1/ln.1 index 926a9c76ab..bb11e286e9 100644 --- a/usr/src/man/man1/ln.1 +++ b/usr/src/man/man1/ln.1 @@ -2,14 +2,14 @@ .\" Copyright 1989 AT&T .\" Copyright (c) 2004, Sun Microsystems, Inc. All Rights Reserved .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 1 "25 Mar 2004" "SunOS 5.11" "User Commands" +.TH LN 1 "Mar 25, 2004" .SH NAME ln \- make hard or symbolic links to files .SH SYNOPSIS @@ -96,24 +96,20 @@ The following options are supported for both \fB/usr/bin/ln\fR and \fB/usr/xpg4/bin/ln\fR: .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 6n -.rt Links files without questioning the user, even if the mode of \fItarget\fR forbids writing. This is the default if the standard input is not a terminal. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 6n -.rt Creates a symbolic link. .sp If the \fB-s\fR option is used with two arguments, \fItarget\fR may be an @@ -141,12 +137,10 @@ different file systems. The following option is supported for \fB/usr/bin/ln\fR only: .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 6n -.rt If \fItarget\fR is an existing file, writes a diagnostic message to stderr and goes on to any remaining \fIsource_file\fRs. The \fB-f\fR option overrides this option. This is the default behavior for \fB/usr/bin/ln\fR and @@ -159,12 +153,10 @@ option. This is the default behavior for \fB/usr/bin/ln\fR and The following operands are supported: .sp .ne 2 -.mk .na \fB\fIsource_file\fR\fR .ad .RS 15n -.rt A path name of a file to be linked. This can be either a regular or special file. If the \fB-s\fR option is specified, \fIsource_file\fR can also be a directory. @@ -172,12 +164,10 @@ directory. .sp .ne 2 -.mk .na \fB\fItarget\fR\fR .ad .RS 15n -.rt The path name of the new directory entry to be created, or of an existing directory in which the new directory entries are to be created. .RE @@ -199,23 +189,19 @@ that affect the execution of \fBln\fR: \fBLANG\fR, \fBLC_ALL\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt All the specified files were linked successfully .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -228,13 +214,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled .TE .SS "/usr/xpg4/bin/ln" @@ -242,15 +227,14 @@ CSIEnabled .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man1/loadkeys.1 b/usr/src/man/man1/loadkeys.1 index 5e808534ec..9fee3e44bb 100644 --- a/usr/src/man/man1/loadkeys.1 +++ b/usr/src/man/man1/loadkeys.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 loadkeys 1 "20 Apr 1998" "SunOS 5.11" "User Commands" +.TH LOADKEYS 1 "Apr 20, 1998" .SH NAME loadkeys, dumpkeys \- load and dump keyboard translation tables .SH SYNOPSIS @@ -14,7 +14,7 @@ loadkeys, dumpkeys \- load and dump keyboard translation tables .LP .nf -\fBdumpkeys\fR +\fBdumpkeys\fR .fi .SH DESCRIPTION @@ -38,7 +38,6 @@ standard output. .SH FILES .sp .ne 2 -.mk .na \fB\fB/usr/share/lib/keytables/layout_\fR\fBdd\fR\fR .ad @@ -55,13 +54,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -lw(2.75i) |lw(2.75i) -lw(2.75i) |lw(2.75i) -. -\fBATTRIBUTE TYPE\fR\fBATTRIBUTE VALUE\fR +box; +l | l +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityEvolving +Interface Stability Evolving .TE .SH SEE ALSO diff --git a/usr/src/man/man1/locale.1 b/usr/src/man/man1/locale.1 index 3b3816f12c..3230020206 100644 --- a/usr/src/man/man1/locale.1 +++ b/usr/src/man/man1/locale.1 @@ -1,13 +1,13 @@ '\" te .\" Copyright (c) 1992, X/Open Company Limited All Rights Reserved Portions Copyright (c) 1995, Sun Microsystems, Inc. All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 locale 1 "20 Dec 1996" "SunOS 5.11" "User Commands" +.TH LOCALE 1 "Dec 20, 1996" .SH NAME locale \- get locale-specific information .SH SYNOPSIS @@ -57,24 +57,20 @@ category. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 6n -.rt Writes information about all available public locales. The available locales include \fBPOSIX\fR, representing the POSIX locale. .RE .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad .RS 6n -.rt Writes the names of selected locale categories. The \fB-c\fR option increases readability when more than one category is selected (for example, via more than one keyword name or via a category name). It is valid both with and without the @@ -83,24 +79,20 @@ one keyword name or via a category name). It is valid both with and without the .sp .ne 2 -.mk .na \fB\fB-k\fR\fR .ad .RS 6n -.rt Writes the names and values of selected keywords. The implementation may omit values for some keywords; see OPERANDS. .RE .sp .ne 2 -.mk .na \fB\fB-m\fR\fR .ad .RS 6n -.rt Writes names of available charmaps; see \fBlocaledef\fR(1). .RE @@ -110,12 +102,10 @@ Writes names of available charmaps; see \fBlocaledef\fR(1). The following operand is supported: .sp .ne 2 -.mk .na \fB\fIname\fR\fR .ad .RS 8n -.rt The name of a locale category, the name of a keyword in a locale category, or the reserved name \fBcharmap\fR. The named category or keyword will be selected for output. If a single \fIname\fR represents both a locale category name and a @@ -219,23 +209,19 @@ variables will be used if the \fB-a\fR option is not specified. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt All the requested information was found and output successfully. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -247,15 +233,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man1/localedef.1 b/usr/src/man/man1/localedef.1 index 41242263e6..cc11cf825c 100644 --- a/usr/src/man/man1/localedef.1 +++ b/usr/src/man/man1/localedef.1 @@ -1,21 +1,21 @@ '\" te .\" Copyright (c) 1992, X/Open Company Limited All Rights Reserved .\" Portions Copyright (c) 2003, Sun Microsystems, Inc. All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 localedef 1 "11 Oct 2004" "SunOS 5.11" "User Commands" +.TH LOCALEDEF 1 "Oct 11, 2004" .SH NAME localedef \- define locale environment .SH SYNOPSIS .LP .nf -\fBlocaledef\fR [\fB-c\fR] [\fB-C\fR \fIcompiler_options\fR] [\fB-f\fR \fIcharmap\fR] - [\fB-i\fR \fIsourcefile\fR] [\fB-L\fR \fIlinker_options\fR] [\fB-m\fR \fImodel\fR] +\fBlocaledef\fR [\fB-c\fR] [\fB-C\fR \fIcompiler_options\fR] [\fB-f\fR \fIcharmap\fR] + [\fB-i\fR \fIsourcefile\fR] [\fB-L\fR \fIlinker_options\fR] [\fB-m\fR \fImodel\fR] [\fB-u\fR \fIcode_set_name\fR] [\fB-W\fR cc, \fIarg\fR] [\fB-x\fR \fIextensions_file\fR] \fIlocalename\fR .fi @@ -38,68 +38,56 @@ variable name and terminated by an \fBEND\fR \fIcategory-name\fR statement. The following categories are supported. .sp .ne 2 -.mk .na \fB\fBLC_CTYPE\fR\fR .ad .RS 15n -.rt Defines character classification and case conversion. .RE .sp .ne 2 -.mk .na \fB\fBLC_COLLATE\fR\fR .ad .RS 15n -.rt Defines collation rules. .RE .sp .ne 2 -.mk .na \fB\fBLC_MONETARY\fR\fR .ad .RS 15n -.rt Defines the format and symbols used in formatting of monetary information. .RE .sp .ne 2 -.mk .na \fB\fBLC_NUMERIC\fR\fR .ad .RS 15n -.rt Defines the decimal delimiter, grouping and grouping symbol for non-monetary numeric editing. .RE .sp .ne 2 -.mk .na \fB\fBLC_TIME\fR\fR .ad .RS 15n -.rt Defines the format and content of date and time information. .RE .sp .ne 2 -.mk .na \fB\fBLC_MESSAGES\fR\fR .ad .RS 15n -.rt Defines the format and values of affirmative and negative responses. .RE @@ -109,23 +97,19 @@ Defines the format and values of affirmative and negative responses. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad .RS 23n -.rt Creates permanent output even if warning messages have been issued. .RE .sp .ne 2 -.mk .na \fB\fB-C\fR \fIcompiler_options\fR\fR .ad .RS 23n -.rt Passes the \fIcompiler_options\fR to the C compiler (\fBcc\fR). If more than one option is specified, then the options must be enclosed in quotes (\fB"\|"\fR). @@ -135,12 +119,10 @@ This is an old option. Use the \fB-W\fR \fBcc\fR,\fIarg\fR option instead. .sp .ne 2 -.mk .na \fB\fB-f\fR \fIcharmap\fR\fR .ad .RS 23n -.rt Specifies the pathname of a file containing a mapping of character symbols and collating element symbols to actual character encodings. This option must be specified if symbolic names (other than collating symbols defined in a @@ -150,24 +132,20 @@ present, the default character mapping will be used. .sp .ne 2 -.mk .na \fB\fB-i\fR \fIsourcefile\fR\fR .ad .RS 23n -.rt The path name of a file containing the source definitions. If this option is not present, source definitions will be read from standard input. .RE .sp .ne 2 -.mk .na \fB\fB-L\fR \fIlinker_options\fR\fR .ad .RS 23n -.rt Passes the \fIlinker_options\fR to the C compiler (\fBcc\fR) that follows the C source filename. If more than one option is specified, then the options must be enclosed in quotes (\fB"\|"\fR). @@ -177,12 +155,10 @@ This is an old option. Use the \fB-W\fR \fBcc\fR,\fIarg\fR option instead. .sp .ne 2 -.mk .na \fB\fB-m\fR \fImodel\fR\fR .ad .RS 23n -.rt Specifies whether \fBlocaledef\fR will generate a 64-bit or a 32-bit locale object. .sp @@ -196,12 +172,10 @@ additionally generates a 64-bit locale object. .sp .ne 2 -.mk .na \fB\fB-u\fR \fIcode_set_name\fR\fR .ad .RS 23n -.rt Specifies the name of a codeset used as the target mapping of character symbols and collating element symbols whose encoding values are defined in terms of the ISO/IEC 10646-1: 2000 standard position constant values. See NOTES. @@ -209,12 +183,10 @@ ISO/IEC 10646-1: 2000 standard position constant values. See NOTES. .sp .ne 2 -.mk .na \fB\fB-W\fR \fBcc\fR,\fIarg\fR\fR .ad .RS 23n -.rt Passes \fIarg\fR options to the C compiler. Each argument must be separated from the preceding by only a comma. A comma can be part of an argument by escaping it withan immediately preceding backslash character; the backslash is @@ -225,12 +197,10 @@ Use this option instead of the \fB-C\fR and \fB-L\fR options. .sp .ne 2 -.mk .na \fB\fB-x\fR \fIextensions_file\fR\fR .ad .RS 23n -.rt Specifies the name of an extension file where various \fBlocaledef\fR options are listed. See \fBlocale\fR(5). .RE @@ -241,12 +211,10 @@ are listed. See \fBlocale\fR(5). The following operand is supported: .sp .ne 2 -.mk .na \fB\fIlocalename\fR\fR .ad .RS 14n -.rt Identifies the locale. If the name contains one or more slash characters, \fIlocalename\fR will be interpreted as a path name where the created locale definitions will be stored. This capability may be restricted to users with @@ -342,34 +310,28 @@ that affect the execution of \fBlocaledef\fR: \fBLANG\fR, \fBLC_ALL\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt No errors occurred and the locales were successfully created. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 6n -.rt Warnings occurred and the locales were successfully created. .RE .sp .ne 2 -.mk .na \fB\fB2\fR\fR .ad .RS 6n -.rt The locale specification exceeded implementation limits or the coded character set or sets used were not supported by the implementation, and no locale was created. @@ -377,23 +339,19 @@ created. .sp .ne 2 -.mk .na \fB\fB3\fR\fR .ad .RS 6n -.rt The capability to create new locales is not supported by the implementation. .RE .sp .ne 2 -.mk .na \fB\fB>3\fR\fR .ad .RS 6n -.rt Warnings or errors occurred and no output was created. .RE @@ -403,7 +361,6 @@ If an error is detected, no permanent output will be created. .SH FILES .sp .ne 2 -.mk .na \fB\fB/usr/lib/localedef/extensions/generic_eucbc.x\fR\fR .ad @@ -415,7 +372,6 @@ by default. .sp .ne 2 -.mk .na \fB\fB/usr/lib/localedef/extensions/single_byte.x\fR\fR .ad @@ -426,7 +382,6 @@ Describes a generic single-byte file used in the system. .sp .ne 2 -.mk .na \fB\fB/usr/lib/locale/\fIlocalename\fR/\fIlocalename\fR.so.\fIversion_number\fR \fR\fR @@ -438,7 +393,6 @@ The shared object for the 32-bit environment. .sp .ne 2 -.mk .na \fB\fB/usr/lib/locale/\fIlocalename\fR/sparcv9/\fIlocalename\fR.so.\fIversion_n umber\fR\fR\fR @@ -450,7 +404,6 @@ The shared object for the 64-bit environment on SPARC. .sp .ne 2 -.mk .na \fB\fB/usr/lib/locale/\fI<localename>\fR/amd64/\fI<localename>\fR\&.so.\fI<vers ion_number>\fR\fR\fR @@ -468,13 +421,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO @@ -515,9 +467,9 @@ codeset that is supported by the \fBiconv_open\fR(3C) function on the system. .sp .LP When conflicts occur between the charmap specification of \fIcode_set_name\fR, -\fImb_cur_max\fR, or \fImb_cur_min\fR and the corresponding value for the +\fImb_cur_max\fR, or \fImb_cur_min\fR and the corresponding value for the codeset represented by the \fB-u\fR option-argument \fIcode_set_name\fR, the -\fBlocaledef\fR utility fails as an error. +\fBlocaledef\fR utility fails as an error. .sp .LP When conflicts occur between the charmap encoding values specified for symbolic diff --git a/usr/src/man/man1/logger.1 b/usr/src/man/man1/logger.1 index 842ede7950..edb9868ba0 100644 --- a/usr/src/man/man1/logger.1 +++ b/usr/src/man/man1/logger.1 @@ -1,13 +1,13 @@ '\" te .\" Copyright (c) 1983 Regents of the University of California. Copyright (c) 1995, Sun Microsystems, Inc. All Rights Reserved Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved All rights reserved. The Berkeley software License Agreement specifies the terms and conditions for redistribution. -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 logger 1 "1 Feb 1995" "SunOS 5.11" "User Commands" +.TH LOGGER 1 "Feb 1, 1995" .SH NAME logger \- add entries to the system log .SH SYNOPSIS @@ -32,34 +32,28 @@ and logs messages on a line-by-line basis from the standard input. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-f\fR\fIfile\fR\fR .ad .RS 14n -.rt Uses the contents of \fIfile\fR as the message to log. .RE .sp .ne 2 -.mk .na \fB\fB-i\fR\fR .ad .RS 14n -.rt Logs the process \fBID\fR of the \fBlogger\fR process with each line. .RE .sp .ne 2 -.mk .na \fB\fB-p\fR\fIpriority\fR\fR .ad .RS 14n -.rt Enters the message with the specified \fIpriority\fR. The message priority can be specified numerically, or as a \fIfacility\fR\fB\&.\fR\fIlevel\fR pair. For example, `\fB\fR\fB-p\fR\fB local3.info\fR' assigns the message priority to the @@ -69,12 +63,10 @@ example, `\fB\fR\fB-p\fR\fB local3.info\fR' assigns the message priority to the .sp .ne 2 -.mk .na \fB\fB-t\fR\fItag\fR\fR .ad .RS 14n -.rt Marks each line added to the log with the specified \fItag\fR. .RE @@ -84,12 +76,10 @@ Marks each line added to the log with the specified \fItag\fR. The following operand is supported: .sp .ne 2 -.mk .na \fB\fImessage\fR\fR .ad .RS 11n -.rt One of the string arguments whose contents are concatenated together, in the order specified, separated by single space characters. .RE @@ -145,23 +135,19 @@ that affect the execution of \fBlogger\fR: \fBLANG\fR, \fBLC_ALL\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -173,13 +159,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man1/login.1 b/usr/src/man/man1/login.1 index d38d2ba3df..20cc1516e7 100644 --- a/usr/src/man/man1/login.1 +++ b/usr/src/man/man1/login.1 @@ -4,15 +4,15 @@ .\" 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 login 1 "7 Jan 2008" "SunOS 5.11" "User Commands" +.TH LOGIN 1 "Jan 7, 2008" .SH NAME login \- sign on to the system .SH SYNOPSIS .LP .nf -\fBlogin\fR [\fB-p\fR] [\fB-d\fR \fIdevice\fR] [\fB-R\fR \fIrepository\fR] [\fB-s\fR \fIservice\fR] - [\fB-t\fR \fIterminal\fR] [\fB-u\fR \fIidentity\fR] [\fB-U\fR \fIruser\fR] - [\fB-h\fR \fIhostname\fR \fI[terminal]\fR | \fB-r\fR \fIhostname\fR] +\fBlogin\fR [\fB-p\fR] [\fB-d\fR \fIdevice\fR] [\fB-R\fR \fIrepository\fR] [\fB-s\fR \fIservice\fR] + [\fB-t\fR \fIterminal\fR] [\fB-u\fR \fIidentity\fR] [\fB-U\fR \fIruser\fR] + [\fB-h\fR \fIhostname\fR \fI[terminal]\fR | \fB-r\fR \fIhostname\fR] [\fIname\fR [\fIenviron\fR]...] .fi @@ -259,12 +259,10 @@ name used by \fBPAM\fR is \fBrlogin\fR or \fBtelnet\fR, respectively. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-d\fR \fIdevice\fR\fR .ad .RS 26n -.rt \fBlogin\fR accepts a device option, \fIdevice\fR. \fIdevice\fR is taken to be the path name of the \fBTTY\fR port \fBlogin\fR is to operate on. The use of the device option can be expected to improve \fBlogin\fR performance, since @@ -275,12 +273,10 @@ other attempt to use \fB-d\fR causes \fBlogin\fR to quietly exit. .sp .ne 2 -.mk .na \fB\fB-h\fR \fIhostname\fR [\fIterminal\fR]\fR .ad .RS 26n -.rt Used by \fBin.telnetd\fR(1M) to pass information about the remote host and terminal type. .sp @@ -290,34 +286,28 @@ a hyphen (\fB-\fR). .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 26n -.rt Used to pass environment variables to the login shell. .RE .sp .ne 2 -.mk .na \fB\fB-r\fR \fIhostname\fR\fR .ad .RS 26n -.rt Used by \fBin.rlogind\fR(1M) to pass information about the remote host. .RE .sp .ne 2 -.mk .na \fB\fB-R\fR \fIrepository\fR\fR .ad .RS 26n -.rt Used to specify the \fBPAM\fR repository that should be used to tell \fBPAM\fR about the "\fBidentity\fR" (see option \fB-u\fR below). If no "\fBidentity\fR" information is passed, the repository is not used. @@ -325,12 +315,10 @@ information is passed, the repository is not used. .sp .ne 2 -.mk .na \fB\fB-s\fR \fIservice\fR\fR .ad .RS 26n -.rt Indicates the \fBPAM\fR service name that should be used. Normally, this argument is not necessary and is used only for specifying alternative \fBPAM\fR service names. For example: "\fBktelnet\fR" for the Kerberized telnet process. @@ -338,12 +326,10 @@ service names. For example: "\fBktelnet\fR" for the Kerberized telnet process. .sp .ne 2 -.mk .na \fB\fB-u\fR \fIidentity\fR\fR .ad .RS 26n -.rt Specifies the "\fBidentity\fR" string associated with the user who is being authenticated. This usually is \fBnot\fR be the same as that user's Unix login name. For Kerberized login sessions, this is the Kerberos principal name @@ -352,12 +338,10 @@ associated with the user. .sp .ne 2 -.mk .na \fB\fB-U\fR \fIruser\fR\fR .ad .RS 26n -.rt Indicates the name of the person attempting to login on the remote side of the rlogin connection. When \fBin.rlogind\fR(1M) is operating in Kerberized mode, that daemon processes the terminal and remote user name information prior to @@ -372,312 +356,256 @@ line parameter. Normally (non-Kerberos authenticated \fBrlogin\fR), the The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 12n -.rt Successful operation. .RE .sp .ne 2 -.mk .na \fBnon-zero\fR .ad .RS 12n -.rt Error. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB$HOME/.cshrc\fR\fR .ad .RS 23n -.rt Initial commands for each \fBcsh\fR. .RE .sp .ne 2 -.mk .na \fB\fB$HOME/.hushlogin\fR\fR .ad .RS 23n -.rt Suppresses login messages. .RE .sp .ne 2 -.mk .na \fB\fB$HOME/.kshrc\fR\fR .ad .RS 23n -.rt User's commands for interactive \fBksh93\fR, if \fB$ENV\fR is unset; executes after \fB/etc/ksh.kshrc\fR. .RE .sp .ne 2 -.mk .na \fB\fB$HOME/.login\fR\fR .ad .RS 23n -.rt User's login commands for \fBcsh\fR. .RE .sp .ne 2 -.mk .na \fB\fB$HOME/.profile\fR\fR .ad .RS 23n -.rt User's login commands for \fBsh\fR, \fBksh\fR, and \fBksh93\fR. .RE .sp .ne 2 -.mk .na \fB\fB$HOME/.rhosts\fR\fR .ad .RS 23n -.rt Private list of trusted hostname/username combinations. .RE .sp .ne 2 -.mk .na \fB\fB/etc/.login\fR\fR .ad .RS 23n -.rt System-wide \fBcsh\fR login commands. .RE .sp .ne 2 -.mk .na \fB\fB/etc/issue\fR\fR .ad .RS 23n -.rt Issue or project identification. .RE .sp .ne 2 -.mk .na \fB\fB/etc/ksh.kshrc\fR\fR .ad .RS 23n -.rt System-wide commands for interactive \fBksh93\fR. .RE .sp .ne 2 -.mk .na \fB\fB/etc/logindevperm\fR\fR .ad .RS 23n -.rt Login-based device permissions. .RE .sp .ne 2 -.mk .na \fB\fB/etc/motd\fR\fR .ad .RS 23n -.rt Message-of-the-day. .RE .sp .ne 2 -.mk .na \fB\fB/etc/nologin\fR\fR .ad .RS 23n -.rt Message displayed to users attempting to login during machine shutdown. .RE .sp .ne 2 -.mk .na \fB\fB/etc/passwd\fR\fR .ad .RS 23n -.rt Password file. .RE .sp .ne 2 -.mk .na \fB\fB/etc/profile\fR\fR .ad .RS 23n -.rt System-wide \fBsh\fR, \fBksh\fR, and \fBksh93\fR login commands. .RE .sp .ne 2 -.mk .na \fB\fB/etc/shadow\fR\fR .ad .RS 23n -.rt List of users' encrypted passwords. .RE .sp .ne 2 -.mk .na \fB\fB/usr/bin/sh\fR\fR .ad .RS 23n -.rt User's default command interpreter. .RE .sp .ne 2 -.mk .na \fB\fB/var/adm/lastlog\fR\fR .ad .RS 23n -.rt Time of last login. .RE .sp .ne 2 -.mk .na \fB\fB/var/adm/loginlog\fR\fR .ad .RS 23n -.rt Record of failed login attempts. .RE .sp .ne 2 -.mk .na \fB\fB/var/adm/utmpx\fR\fR .ad .RS 23n -.rt Accounting. .RE .sp .ne 2 -.mk .na \fB\fB/var/adm/wtmpx\fR\fR .ad .RS 23n -.rt Accounting. .RE .sp .ne 2 -.mk .na \fB\fB/var/mail/\fR\fIyour-name\fR\fR .ad .RS 23n -.rt Mailbox for user \fIyour-name\fR. .RE .sp .ne 2 -.mk .na \fB\fB/etc/default/login\fR\fR .ad .RS 23n -.rt Default value can be set for the following flags in \fB/etc/default/login\fR. Default values are specified as comments in the \fB/etc/default/login\fR file, for example, \fBTIMEZONE=EST5EDT\fR. .sp .ne 2 -.mk .na \fB\fBTIMEZONE\fR\fR .ad .RS 24n -.rt Sets the \fBTZ\fR environment variable of the shell (see \fBenviron\fR(5)). .RE .sp .ne 2 -.mk .na \fB\fBHZ\fR\fR .ad .RS 24n -.rt Sets the \fBHZ\fR environment variable of the shell. .RE .sp .ne 2 -.mk .na \fB\fBULIMIT\fR\fR .ad .RS 24n -.rt Sets the file size limit for the login. Units are disk blocks. Default is zero (no limit). .RE .sp .ne 2 -.mk .na \fB\fBCONSOLE\fR\fR .ad .RS 24n -.rt If set, root can login on that device only. This does not prevent execution of remote commands with \fBrsh\fR(1). Comment out this line to allow login by root. @@ -685,79 +613,65 @@ root. .sp .ne 2 -.mk .na \fB\fBPASSREQ\fR\fR .ad .RS 24n -.rt Determines if login requires a non-null password. .RE .sp .ne 2 -.mk .na \fB\fBALTSHELL\fR\fR .ad .RS 24n -.rt Determines if login should set the \fBSHELL\fR environment variable. .RE .sp .ne 2 -.mk .na \fB\fBPATH\fR\fR .ad .RS 24n -.rt Sets the initial shell \fBPATH\fR variable. .RE .sp .ne 2 -.mk .na \fB\fBSUPATH\fR\fR .ad .RS 24n -.rt Sets the initial shell \fBPATH\fR variable for root. .RE .sp .ne 2 -.mk .na \fB\fBTIMEOUT\fR\fR .ad .RS 24n -.rt Sets the number of seconds (between \fB0\fR and \fB900\fR) to wait before abandoning a login session. .RE .sp .ne 2 -.mk .na \fB\fBUMASK\fR\fR .ad .RS 24n -.rt Sets the initial shell file creation mode mask. See \fBumask\fR(1). .RE .sp .ne 2 -.mk .na \fB\fBSYSLOG\fR\fR .ad .RS 24n -.rt Determines whether the \fBsyslog\fR(3C) \fBLOG_AUTH\fR facility should be used to log all root logins at level \fBLOG_NOTICE\fR and multiple failed login attempts at\fBLOG_CRIT\fR. @@ -765,12 +679,10 @@ attempts at\fBLOG_CRIT\fR. .sp .ne 2 -.mk .na \fB\fBDISABLETIME\fR\fR .ad .RS 24n -.rt If present, and greater than zero, the number of seconds that \fBlogin\fR waits after \fBRETRIES\fR failed attempts or the \fBPAM \fRframework returns \fBPAM_ABORT\fR. Default is \fB20\fR seconds. Minimum is \fB0\fR seconds. No @@ -779,12 +691,10 @@ maximum is imposed. .sp .ne 2 -.mk .na \fB\fBSLEEPTIME\fR\fR .ad .RS 24n -.rt If present, sets the number of seconds to wait before the login failure message is printed to the screen. This is for any login failure other than \fBPAM_ABORT\fR. Another login attempt is allowed, providing \fBRETRIES\fR has @@ -798,12 +708,10 @@ Both \fBsu\fR(1M) and \fBsulogin\fR(1M) are affected by the value of .sp .ne 2 -.mk .na \fB\fBRETRIES\fR\fR .ad .RS 24n -.rt Sets the number of retries for logging in (see \fBpam\fR(3PAM)). The default is 5. The maximum number of retries is 15. For accounts configured with automatic locking (see \fBSECURITY\fR above), the account is locked and \fBlogin\fR @@ -813,12 +721,10 @@ locking the account. .sp .ne 2 -.mk .na \fB\fBSYSLOG_FAILED_LOGINS\fR\fR .ad .RS 24n -.rt Used to determine how many failed login attempts are allowed by the system before a failed login message is logged, using the \fBsyslog\fR(3C) \fBLOG_NOTICE\fR facility. For example, if the variable is set to \fB0\fR, @@ -835,13 +741,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed .TE .SH SEE ALSO @@ -865,7 +770,6 @@ Interface StabilityCommitted .SH DIAGNOSTICS .sp .ne 2 -.mk .na \fB\fBLogin incorrect\fR\fR .ad @@ -876,7 +780,6 @@ The user name or the password cannot be matched. .sp .ne 2 -.mk .na \fB\fBNot on system console\fR\fR .ad @@ -887,7 +790,6 @@ Root login denied. Check the \fBCONSOLE\fR setting in \fB/etc/default/login\fR. .sp .ne 2 -.mk .na \fB\fBNo directory! Logging in with home=/\fR\fR .ad @@ -899,7 +801,6 @@ or has the wrong permissions. Contact your system administrator. .sp .ne 2 -.mk .na \fB\fBNo shell\fR\fR .ad @@ -911,7 +812,6 @@ system administrator. .sp .ne 2 -.mk .na \fB\fBNO LOGINS: System going down in\fR \fIN\fR \fBminutes\fR\fR .ad diff --git a/usr/src/man/man1/logname.1 b/usr/src/man/man1/logname.1 index 8eb3e380c6..82a5137c0b 100644 --- a/usr/src/man/man1/logname.1 +++ b/usr/src/man/man1/logname.1 @@ -10,13 +10,13 @@ .\" 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 logname 1 "11 Aug 2009" "SunOS 5.11" "User Commands" +.TH LOGNAME 1 "Aug 11, 2009" .SH NAME logname \- return user's login name .SH SYNOPSIS .LP .nf -\fB/usr/bin/logname\fR +\fB/usr/bin/logname\fR .fi .SS "ksh93" @@ -51,46 +51,38 @@ that affect the execution of \fBlogname\fR: \fBLANG\fR, \fBLC_ALL\fR, The following error values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB/etc/profile\fR\fR .ad .RS 18n -.rt environment for user at login time .RE .sp .ne 2 -.mk .na \fB\fB/var/adm/utmpx\fR\fR .ad .RS 18n -.rt user and accounting information .RE @@ -102,15 +94,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .SH SEE ALSO diff --git a/usr/src/man/man1/logout.1 b/usr/src/man/man1/logout.1 index 2aafca1a2e..c31ae78271 100644 --- a/usr/src/man/man1/logout.1 +++ b/usr/src/man/man1/logout.1 @@ -3,14 +3,14 @@ .\" 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 logout 1 "15 Apr 1994" "SunOS 5.11" "User Commands" +.TH LOGOUT 1 "Apr 15, 1994" .SH NAME logout \- shell built-in function to exit from a login session .SH SYNOPSIS .SS "csh" .LP .nf -\fBlogout\fR +\fBlogout\fR .fi .SH DESCRIPTION diff --git a/usr/src/man/man1/look.1 b/usr/src/man/man1/look.1 index 7eb63cac08..5925621494 100644 --- a/usr/src/man/man1/look.1 +++ b/usr/src/man/man1/look.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 look 1 "29 Mar 1994" "SunOS 5.11" "User Commands" +.TH LOOK 1 "Mar 29, 1994" .SH NAME look \- find words in the system dictionary or lines in a sorted list .SH SYNOPSIS @@ -27,36 +27,30 @@ If no \fIfilename\fR is specified, \fBlook\fR uses .SH OPTIONS .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad .RS 7n -.rt Dictionary order. Only letters, digits, \fBTAB\fR and \fBSPACE\fR characters are used in comparisons. .RE .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 7n -.rt Fold case. Upper case letters are not distinguished from lower case in comparisons. .RE .sp .ne 2 -.mk .na \fB\fB-t\fR\fIc\fR\fR .ad .RS 7n -.rt Set termination character. All characters to the right of \fIc\fR in \fIstring\fR are ignored. .RE @@ -64,12 +58,10 @@ Set termination character. All characters to the right of \fIc\fR in .SH FILES .sp .ne 2 -.mk .na \fB\fB/usr/share/lib/dict/words\fR\fR .ad .RS 29n -.rt spelling list .RE diff --git a/usr/src/man/man1/lookbib.1 b/usr/src/man/man1/lookbib.1 index fedfdaa217..63b6e08734 100644 --- a/usr/src/man/man1/lookbib.1 +++ b/usr/src/man/man1/lookbib.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 lookbib 1 "14 Sep 1992" "SunOS 5.11" "User Commands" +.TH LOOKBIB 1 "Sep 14, 1992" .SH NAME lookbib \- find references in a bibliographic database .SH SYNOPSIS @@ -42,45 +42,37 @@ does not allow the use of multiple reference files. .SH FILES .sp .ne 2 -.mk .na \fB\fB\fIx\fR.ia\fR\fR .ad .RS 8n -.rt .RE .sp .ne 2 -.mk .na \fB\fB\fIx\fR.ib\fR\fR .ad .RS 8n -.rt .RE .sp .ne 2 -.mk .na \fB\fB\fIx\fR.ic\fR\fR .ad .RS 8n -.rt index files .RE .sp .ne 2 -.mk .na \fB\fB\fIx\fR.ig\fR\fR .ad .RS 8n -.rt reference file .RE diff --git a/usr/src/man/man1/lorder.1 b/usr/src/man/man1/lorder.1 index 97820c85d5..806e19403b 100644 --- a/usr/src/man/man1/lorder.1 +++ b/usr/src/man/man1/lorder.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 lorder 1 "29 Oct 1991" "SunOS 5.11" "User Commands" +.TH LORDER 1 "Oct 29, 1991" .SH NAME lorder \- find ordering relation for an object or library archive .SH SYNOPSIS @@ -35,34 +35,28 @@ The following example builds a new library from existing \fB\&.o\fR files. .SH FILES .sp .ne 2 -.mk .na \fB\fBTMPDIR/*symref\fR\fR .ad .RS 18n -.rt temporary files .RE .sp .ne 2 -.mk .na \fB\fBTMPDIR/*symdef\fR\fR .ad .RS 18n -.rt temporary files .RE .sp .ne 2 -.mk .na \fB\fBTMPDIR\fR\fR .ad .RS 18n -.rt usually \fB/var/tmp\fR but can be redefined by setting the environment variable \fBTMPDIR\fR (see \fBtempnam\fR() in \fBtmpnam\fR(3C)) .RE diff --git a/usr/src/man/man1/lp.1 b/usr/src/man/man1/lp.1 index e7de797532..d24e3b07a0 100644 --- a/usr/src/man/man1/lp.1 +++ b/usr/src/man/man1/lp.1 @@ -2,32 +2,32 @@ .\" Copyright 1989 AT&T .\" Copyright (c) 2006, Sun Microsystems, Inc. All Rights Reserved .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 lp 1 "31 May 2006" "SunOS 5.11" "User Commands" +.TH LP 1 "May 31, 2006" .SH NAME lp \- submit print request .SH SYNOPSIS .LP .nf -\fBlp\fR [\fB-c\fR] [\fB-m\fR] [\fB-p\fR] [\fB-s\fR] [\fB-w\fR] [\fB-d\fR \fIdestination\fR] [\fB-f\fR \fIform-name\fR] - [\fB-H\fR \fIspecial-handling\fR] [\fB-n\fR \fInumber\fR] [\fB-o\fR \fIoption\fR] - [\fB-P\fR \fIpage-list\fR] [\fB-q\fR \fIpriority-level\fR] - [\fB-S\fR \fIcharacter-set\fR | \fIprint-wheel\fR] [\fB-t\fR \fItitle\fR] +\fBlp\fR [\fB-c\fR] [\fB-m\fR] [\fB-p\fR] [\fB-s\fR] [\fB-w\fR] [\fB-d\fR \fIdestination\fR] [\fB-f\fR \fIform-name\fR] + [\fB-H\fR \fIspecial-handling\fR] [\fB-n\fR \fInumber\fR] [\fB-o\fR \fIoption\fR] + [\fB-P\fR \fIpage-list\fR] [\fB-q\fR \fIpriority-level\fR] + [\fB-S\fR \fIcharacter-set\fR | \fIprint-wheel\fR] [\fB-t\fR \fItitle\fR] [\fB-T\fR \fIcontent-type\fR [\fB-r\fR]] [\fB-y\fR \fImode-list\fR] [\fIfile\fR]... .fi .LP .nf -\fBlp\fR \fB-i\fR \fIrequest-ID\fR... [\fB-c\fR] [\fB-m\fR] [\fB-p\fR] [\fB-s\fR] [\fB-w\fR] - [\fB-d\fR \fIdestination\fR] [\fB-f\fR \fIform-name\fR] [\fB-H\fR \fIspecial-handling\fR] - [\fB-n\fR \fInumber\fR] [\fB-o\fR \fIoption\fR] [\fB-P\fR \fIpage-list\fR] - [\fB-q\fR \fIpriority-level\fR] [\fB-S\fR \fIcharacter-set\fR | \fIprint-wheel\fR] +\fBlp\fR \fB-i\fR \fIrequest-ID\fR... [\fB-c\fR] [\fB-m\fR] [\fB-p\fR] [\fB-s\fR] [\fB-w\fR] + [\fB-d\fR \fIdestination\fR] [\fB-f\fR \fIform-name\fR] [\fB-H\fR \fIspecial-handling\fR] + [\fB-n\fR \fInumber\fR] [\fB-o\fR \fIoption\fR] [\fB-P\fR \fIpage-list\fR] + [\fB-q\fR \fIpriority-level\fR] [\fB-S\fR \fIcharacter-set\fR | \fIprint-wheel\fR] [\fB-t\fR \fItitle\fR] [\fB-T\fR \fIcontent-type\fR [\fB-r\fR]] [\fB-y\fR \fImode-list\fR] .fi @@ -75,12 +75,10 @@ requests sent to such destinations differently (see NOTES). The following options are supported: .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad .RS 23n -.rt Copies \fIfile\fR before printing. .sp Unless \fB-c\fR is specified, users should not remove any \fIfile\fR before the @@ -91,12 +89,10 @@ printed output. \fIfile\fR is linked (as opposed to copied). .sp .ne 2 -.mk .na \fB\fB-d\fR \fIdestination\fR\fR .ad .RS 23n -.rt Prints \fIfile\fR on a specific destination. The \fB-d\fR option is used to set the destination only when the job is first created. (\fBNote:\fR To move existing jobs to a different destination, see \fBlpmove\fR(1M).) @@ -109,12 +105,10 @@ more information. .sp .ne 2 -.mk .na \fB\fB-f\fR \fIform-name\fR\fR .ad .RS 23n -.rt Prints \fIfile\fR on \fIform-name\fR. The \fBLP\fR print service ensures that the form is mounted on the printer. The print request is rejected if the printer does not support \fIform-name\fR, if \fIform-name\fR is not defined for @@ -124,22 +118,18 @@ the system, or if the user is not allowed to use \fIform-name\fR (see .sp .ne 2 -.mk .na \fB\fB-H\fR \fIspecial-handling\fR\fR .ad .RS 23n -.rt Prints the print request according to the value of \fIspecial-handling\fR. The following \fIspecial-handling\fR values are acceptable: .sp .ne 2 -.mk .na \fB\fBhold\fR\fR .ad .RS 13n -.rt Do not print the print request until notified. If printing has already begun, stop it. Other print requests are placed ahead of a request that has been put on hold (\fIheld print request\fR) until the print request is resumed. @@ -147,12 +137,10 @@ on hold (\fIheld print request\fR) until the print request is resumed. .sp .ne 2 -.mk .na \fB\fBresume\fR\fR .ad .RS 13n -.rt Resume a held print request. If the print request had begun to print when held, it is the next print request printed, unless it is superseded by an \fIimmediate\fR print request. @@ -160,12 +148,10 @@ it is the next print request printed, unless it is superseded by an .sp .ne 2 -.mk .na \fB\fBimmediate\fR\fR .ad .RS 13n -.rt Print the print request next. If more than one print request is assigned, the most recent print request is printed next. If a print request is currently printing on the desired printer, a \fBhold\fR request must be issued to allow @@ -177,12 +163,10 @@ to \fBLP\fR administrators. .sp .ne 2 -.mk .na \fB\fB-i\fR \fIrequest-ID\fR\fR .ad .RS 23n -.rt Changes options for the print request identified by \fIrequest-ID\fR. There must be a space between \fB-i\fR and \fIrequest-ID\fR. .sp @@ -193,36 +177,30 @@ job modification. .sp .ne 2 -.mk .na \fB\fB-m\fR\fR .ad .RS 23n -.rt 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-n\fR \fInumber\fR\fR .ad .RS 23n -.rt Prints a specific number of copies of \fIfile\fR. Specify \fInumber\fR as a digit. The default for \fInumber\fR is \fB1\fR. .RE .sp .ne 2 -.mk .na \fB\fB-o\fR \fIoption\fR\fR .ad .RS 23n -.rt Specifies printer-dependent \fIoptions\fR. Specify several options by specifying \fB-o\fR \fIoption\fR multiple times (\fB-o\fR \fIoption\fR \fB-o\fR \fIoption\fR \fB-o\fR \fIoption\fR ). Printer-dependent options can also be @@ -232,12 +210,10 @@ enclosed in double quotes (\fB-o\fR"\fIoption\fR \fIoption option\fR"). \fIoption\fRs take the following forms: .sp .ne 2 -.mk .na \fB\fIkey\fR\fB=\fR\fIvalue\fR\fR .ad .RS 13n -.rt Associates information with the request for use by the backend print service. The keys and values that can be used are specific to the backend print service and queue configuration. @@ -245,12 +221,10 @@ and queue configuration. .sp .ne 2 -.mk .na \fB\fB[no]key\fR\fR .ad .RS 13n -.rt Associates boolean information with the request for use by the backend print service. The keys that can be used are specific to the backend print service and queue configuration. @@ -259,7 +233,6 @@ and queue configuration. The following options are commonly used with the LP print service: .sp .ne 2 -.mk .na \fB\fBnobanner\fR\fR .ad @@ -274,7 +247,6 @@ requires the \fBsolaris.print.nobanner\fR authorization. .sp .ne 2 -.mk .na \fB\fBnofilebreak\fR\fR .ad @@ -285,7 +257,6 @@ Prints multiple files without inserting a form feed between them. .sp .ne 2 -.mk .na \fB\fBnolabels\fR\fR .ad @@ -298,7 +269,6 @@ of page header and footer labels. Use of this option requires the .sp .ne 2 -.mk .na \fB\fBlength=\fR\fInumber\fR\fBi\fR | \fInumber\fR\fBc\fR | \fInumber\fR\fR .ad @@ -316,7 +286,6 @@ This option can not be used with the \fB-f\fR option. .sp .ne 2 -.mk .na \fB\fBwidth=\fR\fInumber\fR\fBi\fR | \fInumber\fR\fBc\fR | \fInumber\fR\fR .ad @@ -334,7 +303,6 @@ This option can not be used with the \fB-f\fR option. .sp .ne 2 -.mk .na \fB\fBlpi=\fR\fInumber\fR\fR .ad @@ -348,7 +316,6 @@ This option can not be used with the \fB-f\fR option. .sp .ne 2 -.mk .na \fB\fBcpi=\fR\fIn\fR|\fBpica\fR|\fBelite\fR|\fBcompressed\fR\fR .ad @@ -367,7 +334,6 @@ default character pitch for your printer. This option can not be used with the .sp .ne 2 -.mk .na \fB\fBstty=\fR\fIstty-option-list\fR\fR .ad @@ -382,12 +348,10 @@ blanks. .sp .ne 2 -.mk .na \fB\fB-P\fR \fIpage-list\fR\fR .ad .RS 23n -.rt Prints the pages specified in \fIpage-list\fR in ascending order. Specify \fIpage-list\fR as a of range of numbers, single page number, or a combination of both. @@ -398,24 +362,20 @@ it; otherwise, the print request is rejected. .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 23n -.rt Enables notification on completion of the print request. Delivery of the notification is dependent on additional software. .RE .sp .ne 2 -.mk .na \fB\fB-q\fR \fIpriority-level\fR\fR .ad .RS 23n -.rt Assigns the print request a priority in the print queue. Specify \fIpriority-level\fR as an integer between from \fB0\fR and \fB39\fR. Use \fB0\fR to indicate the highest priority; \fB39\fR to indicate the lowest @@ -426,18 +386,15 @@ assign a default priority to individual users. .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 23n -.rt Suppresses the display of messages sent from \fBlp\fR. .RE .sp .ne 2 -.mk .na \fB\fB-S\fR \fIcharacter-set\fR \fB|\fR\fR .ad @@ -446,7 +403,6 @@ Suppresses the display of messages sent from \fBlp\fR. \fB\fB-S\fR \fIprint-wheel\fR\fR .ad .RS 23n -.rt Prints the request using the \fIcharacter-set\fR or \fIprint-wheel\fR. If a form was requested and requires a character set or print wheel other than the one specified with the \fB-S\fR option, the request is rejected. Printers using @@ -467,12 +423,10 @@ administrator, the request is rejected. .sp .ne 2 -.mk .na \fB\fB-t\fR \fItitle\fR\fR .ad .RS 23n -.rt Prints a title on the banner page of the output. Enclose \fItitle\fR in quotes if it contains blanks. If \fItitle\fR is not not specified, the name of the file is printed on the banner page. @@ -480,12 +434,10 @@ file is printed on the banner page. .sp .ne 2 -.mk .na \fB\fB\fR\fB-T\fR\fIcontent-type\fR [\fB-r\fR]\fR .ad .RS 23n -.rt Prints the request on a printer that can support the specified \fIcontent-type\fR. If no printer accepts this type directly, a filter is used to convert the content into an acceptable type. If the \fB-r\fR option is @@ -497,24 +449,20 @@ filter, the request is rejected. .sp .ne 2 -.mk .na \fB\fB-w\fR\fR .ad .RS 23n -.rt Writes a message on the user's terminal after the \fIfile\fRs have been printed. If the user is not logged in, then mail is sent instead. .RE .sp .ne 2 -.mk .na \fB\fB-y\fR \fImode-list\fR\fR .ad .RS 23n -.rt Prints the request according to the printing modes listed in \fImode-list\fR. The allowed values for \fImode-list\fR are locally defined. .sp @@ -528,12 +476,10 @@ otherwise, the print request is rejected. 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 or as a hyphen (\fB\(mi\fR) to indicate the standard input. If \fIfile\fR is not specified, \fBlp\fR uses the standard input. @@ -552,24 +498,20 @@ that affect the execution of \fBlp\fR: \fBLANG\fR, \fBLC_ALL\fR, \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, \fBNLSPATH\fR, and \fBPATH\fR. .sp .ne 2 -.mk .na \fB\fBLC_TIME\fR\fR .ad .RS 11n -.rt Determine the format and contents of date and time strings displayed in the \fBlp\fR banner page, if any. .RE .sp .ne 2 -.mk .na \fB\fBLPDEST\fR\fR .ad .RS 11n -.rt Determine the destination. If the \fBLPDEST\fR environment variable is not set, the \fBPRINTER\fR environment variable shall be used. The \fB-d\fR \fIdest\fR option takes precedence over \fBLPDEST\fR. Results are undefined when \fB-d\fR @@ -579,12 +521,10 @@ destination name. .sp .ne 2 -.mk .na \fB\fBPRINTER\fR\fR .ad .RS 11n -.rt Determine the output device or destination. If the \fBLPDEST\fR and \fBPRINTER\fR environment variables are not set, an unspecified output device is used. The \fB-d\fR \fIdest\fR option and the \fBLPDEST\fR environment @@ -595,12 +535,10 @@ value that is not a valid device or destination name. .sp .ne 2 -.mk .na \fB\fBTZ\fR\fR .ad .RS 11n -.rt Determine the timezone used to calculate date and time strings displayed in the \fBlp\fR banner page, if any. If \fBTZ\fR is unset or null, an unspecified default timezone shall be used. @@ -612,79 +550,65 @@ default timezone shall be used. 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 \fBNIS\fR version of \fB/etc/printers.conf\fR .RE .sp .ne 2 -.mk .na \fB\fBprinters.org_dir\fR\fR .ad .RS 24n -.rt \fBNIS+\fR version of \fB/etc/printers.conf\fR .RE @@ -696,15 +620,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled. See \fBNOTES\fR. +CSI Enabled. See \fBNOTES\fR. _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man1/lpstat.1 b/usr/src/man/man1/lpstat.1 index 36c086b859..b5473114a0 100644 --- a/usr/src/man/man1/lpstat.1 +++ b/usr/src/man/man1/lpstat.1 @@ -10,14 +10,14 @@ .\" 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 lpstat 1 "3 Aug 2009" "SunOS 5.11" "User Commands" +.TH LPSTAT 1 "Aug 3, 2009" .SH NAME lpstat \- print information about the status of the print service .SH SYNOPSIS .LP .nf -\fBlpstat\fR [\fB-d\fR] [\fB-r\fR] [\fB-R\fR] [\fB-s\fR] [\fB-t\fR] [\fB-a\fR [\fIlist\fR]] [\fB-c\fR [\fIlist\fR]] - [\fB-f\fR [\fIlist\fR]] [\fB-o\fR [\fIlist\fR]] [\fB-p\fR [\fIlist\fR] [\fB-D\fR]] [\fB-S\fR [\fIlist\fR]] +\fBlpstat\fR [\fB-d\fR] [\fB-r\fR] [\fB-R\fR] [\fB-s\fR] [\fB-t\fR] [\fB-a\fR [\fIlist\fR]] [\fB-c\fR [\fIlist\fR]] + [\fB-f\fR [\fIlist\fR]] [\fB-o\fR [\fIlist\fR]] [\fB-p\fR [\fIlist\fR] [\fB-D\fR]] [\fB-S\fR [\fIlist\fR]] [\fB-u\fR [\fIlogin-\fR \fIID\fR \fI-list\fR]] [\fB-v\fR [\fIlist\fR]] [\fB-l\fR \fIlevel\fR] .fi @@ -86,12 +86,10 @@ database in the name service switch. See \fBnsswitch.conf\fR(4), The following options are supported: .sp .ne 2 -.mk .na \fB\fB-a\fR [\fIlist\fR]\fR .ad .RS 22n -.rt Reports whether print destinations are accepting requests. \fIlist\fR is a list of intermixed printer names and class names. .sp @@ -104,12 +102,10 @@ information. .sp .ne 2 -.mk .na \fB\fB-c\fR [\fIlist\fR]\fR .ad .RS 22n -.rt Prints name of all classes and their members. \fIlist\fR is a list of class names. .sp @@ -122,23 +118,19 @@ information. .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad .RS 22n -.rt Prints the default destination for output requests. .RE .sp .ne 2 -.mk .na \fB\fB\fR\fB-f\fR[\fIlist\fR] [\fB-l\fR]\fR .ad .RS 22n -.rt Prints a verification that the forms in \fIlist\fR are recognized by the \fBLP\fR print service. \fIlist\fR is a list of forms; the default is \fBall\fR. The \fB-l\fR option lists the form descriptions. @@ -152,12 +144,10 @@ information. .sp .ne 2 -.mk .na \fB\fB-l\fR [\fIlevel\fR]\fR .ad .RS 22n -.rt Specifies the verbosity level for extended reporting of printer or job objects (\fB-o\fR, \fB-p\fR, \fB-r\fR, \fB-u\fR). Without this option, a level of \fB0\fR is used, which reports summary information. When no level is specified, @@ -173,12 +163,10 @@ information. .sp .ne 2 -.mk .na \fB\fB-o\fR [\fIlist\fR]\fR .ad .RS 22n -.rt Prints the status of output requests. \fIlist\fR is a list of intermixed printer names, class names, and request-IDs. The key letter \fB-o\fR can be omitted. @@ -190,12 +178,10 @@ POSIX-style (\fIserver\fR\fB:\fR\fIdestination\fR) names. See .sp .ne 2 -.mk .na \fB\fB-p\fR [\fIlist\fR] [\fB-D\fR]\fR .ad .RS 22n -.rt Prints the status of printers. \fIlist\fR is a list of printer names. If the \fB-D\fR option is given, a brief description is printed for each printer in \fIlist\fR. If the \fB-l\fR option is given and the printer is on the local @@ -212,34 +198,28 @@ status. .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 22n -.rt Prints the status of the \fBLP\fR request scheduler. .RE .sp .ne 2 -.mk .na \fB\fB-R\fR\fR .ad .RS 22n -.rt Prints a number showing the position of each request in the print queue. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 22n -.rt Prints a status summary, including the status of the \fBLP\fR scheduler, the default destination, a list of printers and their associated devices, a list of the machines sharing print services, a list of all forms currently mounted, and @@ -248,12 +228,10 @@ a list of all recognized character sets and print wheels. .sp .ne 2 -.mk .na \fB\fB-S\fR [\fIlist\fR]\fR .ad .RS 22n -.rt Prints a verification that the character sets or the print wheels specified in \fIlist\fR are recognized by the \fBLP\fR print service. Items in \fIlist\fR can be character sets or print wheels; the default for the list is \fBall\fR. @@ -271,78 +249,64 @@ information. .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad .RS 22n -.rt Prints all status information. This includes all the information obtained with the \fB-s\fR option, plus the acceptance and idle/busy status of all printers. .RE .sp .ne 2 -.mk .na \fB\fB-u\fR [\fIlogin-ID-list\fR]\fR .ad .RS 22n -.rt Prints the status of output requests for users. The \fIlogin-ID-list\fR argument can include any or all of the following constructs: .sp .ne 2 -.mk .na \fB\fIlogin-ID\fR\fR .ad .RS 24n -.rt a user on any system .RE .sp .ne 2 -.mk .na \fB\fIsystem_name\fR\fB!\fR\fIlogin-ID\fR\fR .ad .RS 24n -.rt a user on system \fIsystem_name\fR .RE .sp .ne 2 -.mk .na \fB\fIsystem_name\fR\fB!all\fR\fR .ad .RS 24n -.rt all users on system \fIsystem_name\fR .RE .sp .ne 2 -.mk .na \fB\fBall!\fR\fIlogin-ID\fR\fR .ad .RS 24n -.rt a user on all systems .RE .sp .ne 2 -.mk .na \fB\fBall\fR\fR .ad .RS 24n -.rt all users on all systems .RE @@ -350,12 +314,10 @@ all users on all systems .sp .ne 2 -.mk .na \fB\fB-v\fR [\fIlist\fR]\fR .ad .RS 22n -.rt Prints the names of printers and the path names of the devices associated with them or remote system names for network printers. \fIlist\fR is a list of printer names. @@ -367,79 +329,65 @@ printer names. 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 \fBNIS\fR version of \fB/etc/printers.conf\fR .RE .sp .ne 2 -.mk .na \fB\fBprinters.org_dir\fR\fR .ad .RS 24n -.rt \fBNIS+\fR version of \fB/etc/printers.conf\fR .RE @@ -451,13 +399,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man1/ls.1 b/usr/src/man/man1/ls.1 index ebf1e60946..8327abc700 100644 --- a/usr/src/man/man1/ls.1 +++ b/usr/src/man/man1/ls.1 @@ -10,31 +10,31 @@ .\" 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 ls 1 "3 Jun 2009" "SunOS 5.11" "User Commands" +.TH LS 1 "Jun 3, 2009" .SH NAME ls \- list contents of directory .SH SYNOPSIS .LP .nf -\fB/usr/bin/ls\fR [\fB-aAbcCdeEfFghHiklLmnopqrRsStuUwvVx1@\fR] +\fB/usr/bin/ls\fR [\fB-aAbcCdeEfFghHiklLmnopqrRsStuUwvVx1@\fR] [\fB-/ c\fR | \fBv\fR] [\fB-% atime | crtime | ctime | mtime | all\fR] - [--block-size size] [--color[=\fIwhen\fR]] [--file-type] + [--block-size size] [--color[=\fIwhen\fR]] [--file-type] [--si] [--time-style \fIstyle\fR] [\fIfile\fR]... .fi .LP .nf -\fB/usr/xpg4/bin/ls\fR [\fB-aAbcCdeEfFghHiklLmnopqrRsStuUwvVx1@\fR] +\fB/usr/xpg4/bin/ls\fR [\fB-aAbcCdeEfFghHiklLmnopqrRsStuUwvVx1@\fR] [\fB-/ c\fR | \fBv\fR] [\fB-% atime | crtime | ctime | mtime | all\fR] - [--block-size size] [--color[=\fIwhen\fR]] [--file-type] + [--block-size size] [--color[=\fIwhen\fR]] [--file-type] [--si] [--time-style \fIstyle\fR] [\fIfile\fR]... .fi .LP .nf -\fB/usr/xpg6/bin/ls\fR [\fB-aAbcCdeEfFghHiklLmnopqrRsStuUwvVx1@\fR] +\fB/usr/xpg6/bin/ls\fR [\fB-aAbcCdeEfFghHiklLmnopqrRsStuUwvVx1@\fR] [\fB-/ c\fR | \fBv\fR] [\fB-% atime | crtime | ctime | mtime | all\fR] - [--block-size size] [--color[=\fIwhen\fR]] [--file-type] + [--block-size size] [--color[=\fIwhen\fR]] [--file-type] [--si] [--time-style \fIstyle\fR] [\fIfile\fR]... .fi @@ -66,7 +66,6 @@ The mode printed when the \fB-e\fR, \fB-E\fR, \fB-g\fR, \fB-l\fR, \fB-n\fR, eleven characters. The first character can be one of the following: .sp .ne 2 -.mk .na \fB\fBd\fR\fR .ad @@ -77,7 +76,6 @@ The entry is a directory. .sp .ne 2 -.mk .na \fB\fBD\fR\fR .ad @@ -88,7 +86,6 @@ The entry is a door. .sp .ne 2 -.mk .na \fB\fBl\fR\fR .ad @@ -99,7 +96,6 @@ The entry is a symbolic link. .sp .ne 2 -.mk .na \fB\fBb\fR\fR .ad @@ -110,7 +106,6 @@ The entry is a block special file. .sp .ne 2 -.mk .na \fB\fBc\fR\fR .ad @@ -121,7 +116,6 @@ The entry is a character special file. .sp .ne 2 -.mk .na \fB\fBp\fR\fR .ad @@ -132,7 +126,6 @@ The entry is a \fBFIFO\fR (or "named pipe") special file. .sp .ne 2 -.mk .na \fB\fBP\fR\fR .ad @@ -143,7 +136,6 @@ The entry is an event port. .sp .ne 2 -.mk .na \fB\fBs\fR\fR .ad @@ -154,7 +146,6 @@ The entry is an \fBAF_UNIX\fR address family socket. .sp .ne 2 -.mk .na \fB\fB\(mi\fR\fR .ad @@ -184,7 +175,7 @@ looks as follows: .sp .in +2 .nf -$ls -/ c file +$ls -/ c file -rw-r--r-- 1 root root 0 May 10 14:17 file {AHRSadim-u} @@ -243,7 +234,6 @@ execution permissions. The permissions are indicated as follows: .sp .ne 2 -.mk .na \fB\fBr\fR\fR .ad @@ -254,7 +244,6 @@ The file is readable. .sp .ne 2 -.mk .na \fB\fBw\fR\fR .ad @@ -265,7 +254,6 @@ The file is writable. .sp .ne 2 -.mk .na \fB\fBx\fR\fR .ad @@ -276,7 +264,6 @@ The file is executable. .sp .ne 2 -.mk .na \fB\fB\(mi\fR\fR .ad @@ -287,7 +274,6 @@ The indicated permission is \fInot\fR granted. .sp .ne 2 -.mk .na \fB\fBs\fR\fR .ad @@ -299,7 +285,6 @@ user or group execution bit is also on. .sp .ne 2 -.mk .na \fB\fBS\fR\fR .ad @@ -312,7 +297,6 @@ non-regular files. .sp .ne 2 -.mk .na \fB\fBt\fR\fR .ad @@ -324,7 +308,6 @@ is on. .sp .ne 2 -.mk .na \fB\fBT\fR\fR .ad @@ -336,7 +319,6 @@ The 1000 bit is turned on, and execution is off (undefined bit-state). .SS "/usr/bin/ls" .sp .ne 2 -.mk .na \fB\fBl\fR\fR .ad @@ -349,7 +331,6 @@ is on and the group execution bit is off). .SS "/usr/xpg4/bin/ls and /usr/xpg6/bin/ls" .sp .ne 2 -.mk .na \fB\fBL\fR\fR .ad @@ -399,7 +380,6 @@ specification is of the format or \fB*.Z\fR, or one of the following file types: .sp .ne 2 -.mk .na \fB\fBno\fR\fR .ad @@ -410,7 +390,6 @@ Normal file .sp .ne 2 -.mk .na \fB\fBfi\fR\fR .ad @@ -421,7 +400,6 @@ Regular file .sp .ne 2 -.mk .na \fB\fBdi\fR\fR .ad @@ -432,7 +410,6 @@ Directory .sp .ne 2 -.mk .na \fB\fBln\fR\fR .ad @@ -443,7 +420,6 @@ Symbolic link .sp .ne 2 -.mk .na \fB\fBpi\fR\fR .ad @@ -454,7 +430,6 @@ FIFO or named pipe .sp .ne 2 -.mk .na \fB\fBso\fR\fR .ad @@ -465,7 +440,6 @@ Socket .sp .ne 2 -.mk .na \fB\fBdo\fR\fR .ad @@ -476,7 +450,6 @@ Door file .sp .ne 2 -.mk .na \fB\fBbd\fR\fR .ad @@ -487,7 +460,6 @@ Block device .sp .ne 2 -.mk .na \fB\fBcd\fR\fR .ad @@ -498,7 +470,6 @@ Character device .sp .ne 2 -.mk .na \fB\fBex\fR\fR .ad @@ -509,7 +480,6 @@ Execute bit (either \fBuser\fR, \fBgroup\fR, or \fBother\fR) set .sp .ne 2 -.mk .na \fB\fBpo\fR\fR .ad @@ -520,7 +490,6 @@ Event port .sp .ne 2 -.mk .na \fB\fBst\fR\fR .ad @@ -531,7 +500,6 @@ Sticky bit set .sp .ne 2 -.mk .na \fB\fBor\fR\fR .ad @@ -542,7 +510,6 @@ Orphaned symlink .sp .ne 2 -.mk .na \fB\fBsg\fR\fR .ad @@ -553,7 +520,6 @@ Orphaned symlink .sp .ne 2 -.mk .na \fB\fBsu\fR\fR .ad @@ -564,7 +530,6 @@ Orphaned symlink .sp .ne 2 -.mk .na \fB\fBow\fR\fR .ad @@ -575,7 +540,6 @@ Orphaned symlink .sp .ne 2 -.mk .na \fB\fBtw\fR\fR .ad @@ -591,7 +555,6 @@ are combined to determine the final output color. Any combination of \fIattr\fR values can be specified. Possible \fIattr\fR values are: .sp .ne 2 -.mk .na \fB\fB00\fR\fR .ad @@ -602,7 +565,6 @@ All attributes off (default terminal color) .sp .ne 2 -.mk .na \fB\fB01\fR\fR .ad @@ -613,7 +575,6 @@ Display text in bold .sp .ne 2 -.mk .na \fB\fB04\fR\fR .ad @@ -624,7 +585,6 @@ Display text with an underscore .sp .ne 2 -.mk .na \fB\fB05\fR\fR .ad @@ -635,7 +595,6 @@ Display text in bold .sp .ne 2 -.mk .na \fB\fB07\fR\fR .ad @@ -646,7 +605,6 @@ Display text with foreground and background colors reversed .sp .ne 2 -.mk .na \fB\fB08\fR\fR .ad @@ -661,7 +619,6 @@ One of the following values can be chosen. If multiple values are specified, the last specified value is used. .sp .ne 2 -.mk .na \fB\fB30\fR\fR .ad @@ -672,7 +629,6 @@ Set foreground to \fBblack\fR. .sp .ne 2 -.mk .na \fB\fB31\fR\fR .ad @@ -683,7 +639,6 @@ Set foreground to \fBred\fR. .sp .ne 2 -.mk .na \fB\fB32\fR\fR .ad @@ -694,7 +649,6 @@ Set foreground to \fBgreen\fR. .sp .ne 2 -.mk .na \fB\fB33\fR\fR .ad @@ -705,7 +659,6 @@ Set foreground to \fByellow\fR. .sp .ne 2 -.mk .na \fB\fB34\fR\fR .ad @@ -716,7 +669,6 @@ Set foreground to \fBblue\fR. .sp .ne 2 -.mk .na \fB\fB35\fR\fR .ad @@ -729,7 +681,6 @@ Set foreground to \fB\fR. .sp .ne 2 -.mk .na \fB\fB36\fR\fR .ad @@ -740,7 +691,6 @@ Set foreground to \fBcyan\fR. .sp .ne 2 -.mk .na \fB\fB37\fR\fR .ad @@ -751,7 +701,6 @@ Set foreground to \fBwhite\fR. .sp .ne 2 -.mk .na \fB\fB39\fR\fR .ad @@ -766,7 +715,6 @@ One of the following can be specified. If multiple values are specified, the last value specified is used. .sp .ne 2 -.mk .na \fB\fB40\fR\fR .ad @@ -777,7 +725,6 @@ Set foreground to \fBblack\fR. .sp .ne 2 -.mk .na \fB\fB41\fR\fR .ad @@ -788,7 +735,6 @@ Set foreground to \fBred\fR. .sp .ne 2 -.mk .na \fB\fB42\fR\fR .ad @@ -799,7 +745,6 @@ Set foreground to \fBgreen\fR. .sp .ne 2 -.mk .na \fB\fB43\fR\fR .ad @@ -810,7 +755,6 @@ Set foreground to \fByellow\fR. .sp .ne 2 -.mk .na \fB\fB44\fR\fR .ad @@ -821,7 +765,6 @@ Set foreground to \fBblue\fR. .sp .ne 2 -.mk .na \fB\fB45\fR\fR .ad @@ -832,7 +775,6 @@ Set foreground to \fBmagenta\fR (\fBpurple\fR). .sp .ne 2 -.mk .na \fB\fB46\fR\fR .ad @@ -843,7 +785,6 @@ Set foreground to \fBcyan\fR. .sp .ne 2 -.mk .na \fB\fB47\fR\fR .ad @@ -854,7 +795,6 @@ Set foreground to \fBwhite\fR. .sp .ne 2 -.mk .na \fB\fB49\fR\fR .ad @@ -886,7 +826,6 @@ The following options are supported: The following options are supported for all three versions: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad @@ -902,7 +841,6 @@ normally not listed. .sp .ne 2 -.mk .na \fB\fB-A\fR\fR .ad @@ -919,7 +857,6 @@ exception of the working directory (\fB\&.\fR) and the parent directory .sp .ne 2 -.mk .na \fB\fB-b\fR\fR .ad @@ -935,7 +872,6 @@ Forces printing of non-printable characters to be in the octal .sp .ne 2 -.mk .na \fB\fB-B\fR\fR .ad @@ -950,7 +886,6 @@ Do not display any files ending with a tilde (\fB~\fR). .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad @@ -962,7 +897,6 @@ so forth) for sorting (\fB-t\fR) or printing (\fB-l\fR or \fB-n\fR). .sp .ne 2 -.mk .na \fB\fB-C\fR\fR .ad @@ -974,7 +908,6 @@ output format. .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad @@ -986,7 +919,6 @@ used with \fB-l\fR to get the status of a directory. .sp .ne 2 -.mk .na \fB\fB-e\fR\fR .ad @@ -998,7 +930,6 @@ for all files regardless of age: \fImmm dd hh:mm:ss yyyy\fR. .sp .ne 2 -.mk .na \fB\fB-E\fR\fR .ad @@ -1017,7 +948,6 @@ timezone. .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad @@ -1031,7 +961,6 @@ in the directory. .sp .ne 2 -.mk .na \fB\fB-F\fR\fR .ad @@ -1045,7 +974,6 @@ Append a symbol after certain types of files to indicate the file type. The following symbols are used: .sp .ne 2 -.mk .na \fB\fB/\fR\fR .ad @@ -1056,7 +984,6 @@ Directory .sp .ne 2 -.mk .na \fB\fB>\fR\fR .ad @@ -1067,7 +994,6 @@ Door file .sp .ne 2 -.mk .na \fB\fB|\fR\fR .ad @@ -1078,7 +1004,6 @@ Named pipe (\fBFIFO\fR) .sp .ne 2 -.mk .na \fB\fB@\fR\fR .ad @@ -1089,7 +1014,6 @@ Symbolic link .sp .ne 2 -.mk .na \fB\fB=\fR\fR .ad @@ -1100,7 +1024,6 @@ Socket .sp .ne 2 -.mk .na \fB\fB*\fR\fR .ad @@ -1113,7 +1036,6 @@ Executable .sp .ne 2 -.mk .na \fB\fB-g\fR\fR .ad @@ -1124,7 +1046,6 @@ The same as \fB-l\fR, except that the owner is not printed. .sp .ne 2 -.mk .na \fB\fB-h\fR\fR .ad @@ -1141,7 +1062,6 @@ by \fB1024\fR. The last --si or -h option determines the divisor used. .sp .ne 2 -.mk .na \fB\fB-H\fR\fR .ad @@ -1159,7 +1079,6 @@ is displayed, rather than the referenced directory. .sp .ne 2 -.mk .na \fB\fB-i\fR\fR .ad @@ -1174,7 +1093,6 @@ For each file, prints the i-node number in the first column of the report. .sp .ne 2 -.mk .na \fB\fB-k\fR\fR .ad @@ -1185,7 +1103,6 @@ All sizes are printed in kbytes. Equivalent to --block-size=1024. .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad @@ -1204,7 +1121,6 @@ printed followed by "\fB\(->\fR" and the path name of the referenced file. .sp .ne 2 -.mk .na \fB\fB-L\fR\fR .ad @@ -1222,7 +1138,6 @@ than the referenced file or directory. .sp .ne 2 -.mk .na \fB\fB-m\fR\fR .ad @@ -1233,7 +1148,6 @@ Streams output format. Files are listed across the page, separated by commas. .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad @@ -1249,7 +1163,6 @@ numbers are printed, rather than the associated character strings. .sp .ne 2 -.mk .na \fB\fB-o\fR\fR .ad @@ -1264,7 +1177,6 @@ The same as \fB-l\fR, except that the group is not printed. .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad @@ -1275,7 +1187,6 @@ Puts a slash (\fB/\fR) after each filename if the file is a directory. .sp .ne 2 -.mk .na \fB\fB-q\fR\fR .ad @@ -1291,7 +1202,6 @@ question mark (\fB?\fR). .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad @@ -1307,7 +1217,6 @@ file size first as appropriate. .sp .ne 2 -.mk .na \fB\fB-R\fR\fR .ad @@ -1322,7 +1231,6 @@ Recursively lists subdirectories encountered. .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad @@ -1338,7 +1246,6 @@ displayed. .sp .ne 2 -.mk .na \fB\fB-S\fR\fR .ad @@ -1350,7 +1257,6 @@ file name (in increasing alphabetic order) instead of just by name. .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad @@ -1362,7 +1268,6 @@ modification time. See \fB-c\fR, \fB-u\fR and \fB-%\fR. .sp .ne 2 -.mk .na \fB\fB-u\fR\fR .ad @@ -1374,7 +1279,6 @@ Uses time of last access instead of last modification for sorting (with the .sp .ne 2 -.mk .na \fB\fB-U\fR\fR .ad @@ -1385,7 +1289,6 @@ Output is unsorted. .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad @@ -1398,7 +1301,6 @@ directory doesn't have an ACL. .sp .ne 2 -.mk .na \fB\fB-V\fR\fR .ad @@ -1422,7 +1324,6 @@ The format of the displayed ACL is as follows: \fIentry_type\fR is displayed as one of the following: .sp .ne 2 -.mk .na \fBuser:\fIusername\fR\fR .ad @@ -1433,7 +1334,6 @@ Additional user access for \fIusername\fR. .sp .ne 2 -.mk .na \fBgroup:\fIgroupname\fR\fR .ad @@ -1444,7 +1344,6 @@ Additional group access for group \fIgroupname\fR. .sp .ne 2 -.mk .na \fBowner@\fR .ad @@ -1455,7 +1354,6 @@ File owner. .sp .ne 2 -.mk .na \fBgroup@\fR .ad @@ -1466,7 +1364,6 @@ File group owner. .sp .ne 2 -.mk .na \fBeveryone@\fR .ad @@ -1480,7 +1377,6 @@ The following permissions, supported by the NFSv4 ACL model, are displayed by using the \fB-v\fR or \fB-V\fR options: .sp .ne 2 -.mk .na \fBread_data (\fBr\fR)\fR .ad @@ -1491,7 +1387,6 @@ Permission to read the data of a file. .sp .ne 2 -.mk .na \fBlist_directory (\fBr\fR)\fR .ad @@ -1502,7 +1397,6 @@ Permission to list the contents of a directory. .sp .ne 2 -.mk .na \fBwrite_data (\fBw\fR)\fR .ad @@ -1513,7 +1407,6 @@ Permission to modify a file's data. anywhere in the file's offset range. .sp .ne 2 -.mk .na \fBadd_file (\fBw\fR)\fR .ad @@ -1524,7 +1417,6 @@ Permission to add a new file to a directory. .sp .ne 2 -.mk .na \fBappend_data (\fBp\fR)\fR .ad @@ -1535,7 +1427,6 @@ The ability to modify a file's data, but only starting at EOF. .sp .ne 2 -.mk .na \fBadd_subdirectory (\fBp\fR)\fR .ad @@ -1546,7 +1437,6 @@ Permission to create a subdirectory to a directory. .sp .ne 2 -.mk .na \fBread_xattr (\fBR\fR)\fR .ad @@ -1557,7 +1447,6 @@ Ability to read the extended attributes of a file. .sp .ne 2 -.mk .na \fBwrite_xattr (\fBW\fR)\fR .ad @@ -1569,7 +1458,6 @@ directory. .sp .ne 2 -.mk .na \fBexecute (\fBx\fR)\fR .ad @@ -1580,7 +1468,6 @@ Permission to execute a file. .sp .ne 2 -.mk .na \fBread_attributes (\fBa\fR)\fR .ad @@ -1591,7 +1478,6 @@ The ability to read basic attributes (non-ACLs) of a file. .sp .ne 2 -.mk .na \fBwrite_attributes (\fBA\fR)\fR .ad @@ -1603,7 +1489,6 @@ arbitrary value. .sp .ne 2 -.mk .na \fBdelete (\fBd\fR)\fR .ad @@ -1614,7 +1499,6 @@ Permission to delete a file. .sp .ne 2 -.mk .na \fBdelete_child (\fBD\fR)\fR .ad @@ -1625,7 +1509,6 @@ Permission to delete a file within a directory. .sp .ne 2 -.mk .na \fBread_acl (\fBc\fR)\fR .ad @@ -1636,7 +1519,6 @@ Permission to read the ACL of a file. .sp .ne 2 -.mk .na \fBwrite_acl (\fBC\fR)\fR .ad @@ -1647,7 +1529,6 @@ Permission to write the ACL of a file. .sp .ne 2 -.mk .na \fBwrite_owner (\fBo\fR)\fR .ad @@ -1658,7 +1539,6 @@ Permission to change the owner of a file. .sp .ne 2 -.mk .na \fBsynchronize (\fBs\fR)\fR .ad @@ -1669,7 +1549,6 @@ Permission to access file locally at server with synchronize reads and writes. .sp .ne 2 -.mk .na \fB\fB-\fR\fR .ad @@ -1682,7 +1561,6 @@ The following inheritance flags, supported by the NFSv4 ACL model, are displayed by using the \fB-v\fR or \fB-V\fR options: .sp .ne 2 -.mk .na \fBfile_inherit (\fBf\fR)\fR .ad @@ -1693,7 +1571,6 @@ Inherit to all newly created files. .sp .ne 2 -.mk .na \fBdir_inherit (\fBd\fR)\fR .ad @@ -1704,7 +1581,6 @@ Inherit to all newly created directories. .sp .ne 2 -.mk .na \fBinherit_only (\fBi\fR)\fR .ad @@ -1717,7 +1593,6 @@ created files and directories. This flag requires that either .sp .ne 2 -.mk .na \fBno_propagate (\fBn\fR)\fR .ad @@ -1730,7 +1605,6 @@ either \fBfile_inherit\fR and or \fBdir_inherit\fR also being specified. .sp .ne 2 -.mk .na \fBsuccessful_access (\fBS\fR)\fR .ad @@ -1742,7 +1616,6 @@ accesses. Used with audit/alarm ACE types. .sp .ne 2 -.mk .na \fBfailed_access (\fBF\fR)\fR .ad @@ -1754,7 +1627,6 @@ Used with audit/alarm ACE types. .sp .ne 2 -.mk .na \fBinherited (\fBI\fR)\fR .ad @@ -1765,7 +1637,6 @@ ACE was inherited. .sp .ne 2 -.mk .na \fB\fB-\fR\fR .ad @@ -1777,45 +1648,37 @@ No permission granted. \fIaccess_type\fR is displayed as one of the following types: .sp .ne 2 -.mk .na \fBalarm\fR .ad .RS 9n -.rt Permission field that specifies permissions that should trigger an alarm. .RE .sp .ne 2 -.mk .na \fBallow\fR .ad .RS 9n -.rt Permission field that specifies allow permissions. .RE .sp .ne 2 -.mk .na \fBaudit\fR .ad .RS 9n -.rt Permission field that specifies permissions that should be audited. .RE .sp .ne 2 -.mk .na \fBdeny\fR .ad .RS 9n -.rt Permission field that specifies deny permissions. .RE @@ -1832,7 +1695,7 @@ $ ls -dV /sandbox/dir.1 group@:r-x-----------:-------:allow everyone@:-w-p---A-W-Co-:-------:deny everyone@:r-x---a-R-c--s:-------:allow -$ +$ ||||||||||||||||:||||||+ inherited access ||||||||||||||:||||||+ failed access ||||||||||||||:|||||+--success access @@ -1863,7 +1726,6 @@ $ .sp .ne 2 -.mk .na \fB\fB-w\fR \fIcols\fR\fR .ad @@ -1878,7 +1740,6 @@ Multi-column output where the column width is forced to \fIcols\fR. .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad @@ -1889,7 +1750,6 @@ Multi-column output with entries sorted across rather than down the page. .sp .ne 2 -.mk .na \fB\fB-1\fR\fR .ad @@ -1900,7 +1760,6 @@ Prints one entry per line of output. .sp .ne 2 -.mk .na \fB\fB-@\fR\fR .ad @@ -1913,7 +1772,6 @@ for files that have extended attributes. .sp .ne 2 -.mk .na \fB\fB-c\fR | \fB-v\fR\fR .ad @@ -1925,7 +1783,6 @@ the underlying file system. The option \fB-/\fR supports two option arguments \fBc\fR (compact mode) and \fBv\fR (verbose mode). .sp .ne 2 -.mk .na \fB\fBappendonly\fR\fR .ad @@ -1937,7 +1794,6 @@ file at a location other than \fBEOF\fR fails with \fBEPERM\fR. .sp .ne 2 -.mk .na \fB\fBarchive\fR\fR .ad @@ -1950,7 +1806,6 @@ attribute is set. .sp .ne 2 -.mk .na \fB\fBav_modified\fR\fR .ad @@ -1962,7 +1817,6 @@ changes or when the file is renamed. .sp .ne 2 -.mk .na \fB\fBav_quarantined\fR\fR .ad @@ -1973,7 +1827,6 @@ Anti-virus software sets to mark a file as quarantined. .sp .ne 2 -.mk .na \fB\fBcrtime\fR\fR .ad @@ -1984,7 +1837,6 @@ Timestamp when a file is created. .sp .ne 2 -.mk .na \fB\fBhidden\fR\fR .ad @@ -1995,7 +1847,6 @@ Marks a file as hidden. .sp .ne 2 -.mk .na \fB\fBimmutable\fR\fR .ad @@ -2012,7 +1863,6 @@ fails with \fBEPERM\fR. .sp .ne 2 -.mk .na \fB\fBnodump\fR\fR .ad @@ -2023,7 +1873,6 @@ Solaris systems have no special semantics for this attribute. .sp .ne 2 -.mk .na \fB\fBnounlink\fR\fR .ad @@ -2038,7 +1887,6 @@ when attempting to unlink or rename files and directories that are marked as .sp .ne 2 -.mk .na \fB\fBreadonly\fR\fR .ad @@ -2051,7 +1899,6 @@ still be modified. .sp .ne 2 -.mk .na \fB\fBsystem\fR\fR .ad @@ -2112,7 +1959,7 @@ The display positions are as follows: |||+------- S (system) ||+-------- R (readonly) |+--------- H (hidden) - +---------- A (archive) + +---------- A (archive) .fi .in -2 .sp @@ -2120,14 +1967,13 @@ The display positions are as follows: .sp .in +2 .nf --% atime | crtime | ctime | mtime | all +-% atime | crtime | ctime | mtime | all .fi .in -2 .sp .sp .ne 2 -.mk .na \fB\fBatime\fR\fR .ad @@ -2138,7 +1984,6 @@ Equivalent to \fB-u\fR. .sp .ne 2 -.mk .na \fB\fBcrtime\fR\fR .ad @@ -2149,7 +1994,6 @@ Uses the creation time of the file for sorting or printing. .sp .ne 2 -.mk .na \fB\fBctime\fR\fR .ad @@ -2160,7 +2004,6 @@ Equivalent to \fB-c\fR. .sp .ne 2 -.mk .na \fB\fBmtime\fR\fR .ad @@ -2183,7 +2026,6 @@ The option \fB-% all\fR does not effect which timestamp is displayed in long format and does not affect sorting. .sp .ne 2 -.mk .na \fB\fB--block-size\fR \fIsize\fR\fR .ad @@ -2198,7 +2040,6 @@ indicate powers of 10 instead of 2. For example, . \fB10mB\fR means blocks of .sp .ne 2 -.mk .na \fB\fB--color\fR \fB[=\fR\fIwhen\fR\fB]\fR\fR .ad @@ -2214,7 +2055,6 @@ optional argument that determines when to display color output. Possible values for \fIwhen\fR are: .sp .ne 2 -.mk .na \fB\fBalways\fR\fR .ad @@ -2233,7 +2073,6 @@ Always use color. .sp .ne 2 -.mk .na \fB\fBauto\fR\fR .ad @@ -2252,7 +2091,6 @@ Use color if a terminal is present. .sp .ne 2 -.mk .na \fB\fBno\fR\fR .ad @@ -2274,7 +2112,6 @@ See \fBCOLOR OUTPUT\fR for information on how to control the output colors. .sp .ne 2 -.mk .na \fB\fB--file-type\fR\fR .ad @@ -2286,7 +2123,6 @@ option, except \fB*\fR is not appended to executable files. .sp .ne 2 -.mk .na \fB\fB-si\fR\fR .ad @@ -2303,7 +2139,6 @@ repeatedly divided by 1000 instead of 1024. The last option \fB--si\fR or .sp .ne 2 -.mk .na \fB\fB--time-style\fR style\fR .ad @@ -2315,7 +2150,6 @@ displayed for extended attributes (\fB-%\fR). Possible values for \fIstyle\fR are: .sp .ne 2 -.mk .na \fB\fBfull-iso\fR\fR .ad @@ -2326,7 +2160,6 @@ Equivalent to \fB-E\fR. .sp .ne 2 -.mk .na \fB\fBlong-iso\fR\fR .ad @@ -2337,7 +2170,6 @@ Display in \fIYYYY-MM-DD HH:MM\fR for all files. .sp .ne 2 -.mk .na \fB\fBiso\fR\fR .ad @@ -2349,7 +2181,6 @@ HH:MM\fR. .sp .ne 2 -.mk .na \fB\fBlocale\fR\fR .ad @@ -2360,7 +2191,6 @@ Use the default locale format for old and new files. This is the default. .sp .ne 2 -.mk .na \fB\fB+FORMAT\fR\fR .ad @@ -2377,7 +2207,6 @@ all files. .SS "/usr/bin/ls" .sp .ne 2 -.mk .na \fB\fB-F\fR\fR .ad @@ -2393,7 +2222,6 @@ operands. .sp .ne 2 -.mk .na \fB\fB--file-type\fR\fR .ad @@ -2421,7 +2249,6 @@ option \fB-t\fR, \fB-S\fR, or \fB-U\fR determines the sorting behavior. .SS "/usr/xpg4/bin/ls" .sp .ne 2 -.mk .na \fB\fB-F\fR\fR .ad @@ -2436,7 +2263,6 @@ with a trailing equals sign (\fB=\fR). Follows symlinks named as operands. .sp .ne 2 -.mk .na \fB\fB--file-type\fR\fR .ad @@ -2460,7 +2286,6 @@ used for sorting or in long format listings. The last \fB-t\fR, \fB-S\fR, or .SS "/usr/xpg6/bin/ls" .sp .ne 2 -.mk .na \fB\fB-F\fR\fR .ad @@ -2476,7 +2301,6 @@ operands unless the \fB-H\fR or \fB-L\fR option is specified. .sp .ne 2 -.mk .na \fB\fB--file-type\fR\fR .ad @@ -2504,7 +2328,6 @@ for sorting or in long format listings. The last \fB-t\fR, \fB-S\fR, or The following operand is supported: .sp .ne 2 -.mk .na \fB\fIfile\fR\fR .ad @@ -2530,7 +2353,7 @@ The following example shows how to display detailed information about a file. .in +2 .nf % ls -l file.1 --rw-r--r-- 1 gozer staff 206663 Mar 14 10:15 file.1 +-rw-r--r-- 1 gozer staff 206663 Mar 14 10:15 file.1 .fi .in -2 .sp @@ -2550,7 +2373,7 @@ directory. .in +2 .nf % ls -ld test.dir -drwxr-xr-x 2 gozer staff 2 Mar 14 10:17 test.dir +drwxr-xr-x 2 gozer staff 2 Mar 14 10:17 test.dir .fi .in -2 .sp @@ -2693,7 +2516,7 @@ including indirect blocks, is printed. .in +2 .nf example% ls -/ c file (extended system attribute in compact mode) --rw-r--r-- 1 root root 0 May 10 14:17 file +-rw-r--r-- 1 root root 0 May 10 14:17 file {AHRSadim-u} .fi .in -2 @@ -2715,7 +2538,7 @@ example% ls -/ v file (no extended system attribute) -rw-r--r-- 1 root staff 0 May 16 14:48 file {} -example% ls -/ c file (extended system attribute +example% ls -/ c file (extended system attribute supported file system) -rw-r--r-- 1 root staff 3 Jun 4 22:04 file @@ -2773,7 +2596,6 @@ that affect the execution of \fBls\fR: \fBLANG\fR, \fBLC_ALL\fR, \fBNLSPATH\fR, and \fBTZ\fR. .sp .ne 2 -.mk .na \fB\fBCOLUMNS\fR\fR .ad @@ -2790,7 +2612,6 @@ the multiple text-column output. .sp .ne 2 -.mk .na \fB\fBLS_COLORS\fR\fR .ad @@ -2803,7 +2624,6 @@ color output is used. .sp .ne 2 -.mk .na \fB\fBTERM\fR\fR .ad @@ -2816,30 +2636,25 @@ is generated regardless of the value of the --color option. .SH EXIT STATUS .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt All information was written successfully. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB/etc/group\fR\fR .ad @@ -2850,7 +2665,6 @@ group IDs for \fBls\fR \fB-l\fR and \fBls\fR \fB-g\fR .sp .ne 2 -.mk .na \fB\fB/etc/passwd\fR\fR .ad @@ -2861,7 +2675,6 @@ user IDs for \fBls\fR \fB-l\fR and \fBls\fR \fB-o\fR .sp .ne 2 -.mk .na \fB\fB/usr/share/lib/terminfo/?/*\fR\fR .ad @@ -2879,17 +2692,16 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityCommitted +Interface Stability Committed _ -StandardSee below. +Standard See below. .TE .sp @@ -2907,17 +2719,16 @@ For all options except \fB-A\fR, \fB-b\fR, \fB-e\fR, \fB-E,\fR \fB-h\fR, .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityCommitted +Interface Stability Committed _ -StandardSee below. +Standard See below. .TE .sp @@ -2935,17 +2746,16 @@ For all options except \fB-A\fR, \fB-b\fR, \fB-e\fR, \fB-E,\fR \fB-h\fR, .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityCommitted +Interface Stability Committed _ -StandardSee below. +Standard See below. .TE .sp diff --git a/usr/src/man/man1/m4.1 b/usr/src/man/man1/m4.1 index 98f7e8b79f..c7ae9e1bde 100644 --- a/usr/src/man/man1/m4.1 +++ b/usr/src/man/man1/m4.1 @@ -1,25 +1,25 @@ '\" te .\" Copyright 1989 AT&T Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 m4 1 "3 Jul 2007" "SunOS 5.11" "User Commands" +.TH M4 1 "Jul 3, 2007" .SH NAME m4 \- macro processor .SH SYNOPSIS .LP .nf -\fB/usr/bin/m4\fR [\fB-e\fR] [\fB-s\fR] [\fB-B\fR \fIint\fR] [\fB-H\fR \fIint\fR] [\fB-S\fR \fIint\fR] +\fB/usr/bin/m4\fR [\fB-e\fR] [\fB-s\fR] [\fB-B\fR \fIint\fR] [\fB-H\fR \fIint\fR] [\fB-S\fR \fIint\fR] [\fB-T\fR \fIint\fR] [\fB-D\fR\fIname\fR [\fI=val\fR]] ... [\fB-U\fR \fIname\fR] ... [\fIfile\fR]... .fi .LP .nf -\fB/usr/xpg4/bin/m4\fR [\fB-e\fR] [\fB-s\fR] [\fB-B\fR \fIint\fR] [\fB-H\fR \fIint\fR] [\fB-S\fR \fIint\fR] +\fB/usr/xpg4/bin/m4\fR [\fB-e\fR] [\fB-s\fR] [\fB-B\fR \fIint\fR] [\fB-H\fR \fIint\fR] [\fB-S\fR \fIint\fR] [\fB-T\fR \fIint\fR] [\fB-D\fR\fIname\fR [...\fI=val\fR]] [\fB-U\fR \fIname\fR] ... [\fIfile\fR]... .fi @@ -73,70 +73,58 @@ rescanned. The options and their effects are as follows: .sp .ne 2 -.mk .na \fB\fB-B\fR\fIint\fR\fR .ad .RS 9n -.rt Changes the size of the push-back and argument collection buffers from the default of \fB4,096\fR. .RE .sp .ne 2 -.mk .na \fB\fB-e\fR\fR .ad .RS 9n -.rt Operates interactively. Interrupts are ignored and the output is unbuffered. .RE .sp .ne 2 -.mk .na \fB\fB-H\fR\fIint\fR\fR .ad .RS 9n -.rt Changes the size of the symbol table hash array from the default of \fB199\fR. The size should be prime. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 9n -.rt Enables line sync output for the C preprocessor (\fB#\fRline .\|.\|.\|) .RE .sp .ne 2 -.mk .na \fB\fB-S\fR\fIint\fR\fR .ad .RS 9n -.rt Changes the size of the call stack from the default of \fB100\fRslots. Macros take three slots, and non-macro arguments take one. .RE .sp .ne 2 -.mk .na \fB\fB-T\fR\fIint\fR\fR .ad .RS 9n -.rt Changes the size of the token buffer from the default of \fB512\fRbytes. .RE @@ -146,23 +134,19 @@ To be effective, the above flags must appear before any file names and before any \fB-D\fR or \fB-U\fR flags: .sp .ne 2 -.mk .na \fB\fB-D\fR \fIname\fR[\fB=\fR\fBval\fR]\fR .ad .RS 17n -.rt Defines \fIname\fR to \fBval\fR or to \fINULL\fR in \fBval\fR's absence. .RE .sp .ne 2 -.mk .na \fB\fB-U\fR\fIname\fR\fR .ad .RS 17n -.rt Undefines \fIname\fR. .RE @@ -172,12 +156,10 @@ Undefines \fIname\fR. The following operand is supported: .sp .ne 2 -.mk .na \fB\fIfile\fR\fR .ad .RS 8n -.rt A path name of a text file to be processed. If no \fIfile\fR is given, or if it is \(mi, the standard input is read. .RE @@ -190,12 +172,10 @@ macros can be redefined, but once this is done the original meaning is lost. Their values are \fINULL\fR unless otherwise stated. .sp .ne 2 -.mk .na \fB\fBchangequote\fR\fR .ad .RS 15n -.rt Change quote symbols to the first and second arguments. The symbols can be up to five characters long. \fBchangequote\fR without arguments restores the original values (that is, \fB`\|'\fR). @@ -203,12 +183,10 @@ original values (that is, \fB`\|'\fR). .sp .ne 2 -.mk .na \fB\fBchangecom\fR\fR .ad .RS 15n -.rt Change left and right comment markers from the default \fB#\fR and \fBNEWLINE\fR. With no arguments, the comment mechanism is effectively disabled. With one argument, the left marker becomes the argument and the right @@ -218,23 +196,19 @@ Comment markers can be up to five characters long. .sp .ne 2 -.mk .na \fB\fBdecr\fR\fR .ad .RS 15n -.rt Returns the value of its argument decremented by 1. .RE .sp .ne 2 -.mk .na \fB\fBdefine\fR\fR .ad .RS 15n -.rt The second argument is installed as the value of the macro whose name is the first argument. Each occurrence of \fB$\fR\fIn\fR in the replacement text, where \fIn\fR is a digit, is replaced by the \fIn\fR-th argument. Argument 0 is @@ -246,24 +220,20 @@ argument is quoted (with the current quotes). .sp .ne 2 -.mk .na \fB\fBdefn\fR\fR .ad .RS 15n -.rt Returns the quoted definition of its argument(s). It is useful for renaming macros, especially built-ins. .RE .sp .ne 2 -.mk .na \fB\fBdivert\fR\fR .ad .RS 15n -.rt \fBm4\fR maintains 10 output streams, numbered 0-9. The final output is the concatenation of the streams in numerical order. Initially stream 0 is the current stream. The \fBdivert\fR macro changes the current output stream to its @@ -273,57 +243,47 @@ discarded. .sp .ne 2 -.mk .na \fB\fBdivnum\fR\fR .ad .RS 15n -.rt Returns the value of the current output stream. .RE .sp .ne 2 -.mk .na \fB\fBdnl\fR\fR .ad .RS 15n -.rt Reads and discards characters up to and including the next \fBNEWLINE\fR. .RE .sp .ne 2 -.mk .na \fB\fBdumpdef\fR\fR .ad .RS 15n -.rt Prints current names and definitions, for the named items, or for all if no arguments are given. .RE .sp .ne 2 -.mk .na \fB\fBerrprint\fR\fR .ad .RS 15n -.rt Prints its argument on the diagnostic output file. .RE .sp .ne 2 -.mk .na \fB\fBifdef\fR\fR .ad .RS 15n -.rt If the first argument is defined, the value is the second argument, otherwise the third. If there is no third argument, the value is \fINULL\fR. The word \fBunix\fR is predefined. @@ -331,12 +291,10 @@ the third. If there is no third argument, the value is \fINULL\fR. The word .sp .ne 2 -.mk .na \fB\fBifelse\fR\fR .ad .RS 15n -.rt This macro has three or more arguments. If the first argument is the same string as the second, then the value is the third argument. If not, and if there are more than four arguments, the process is repeated with arguments 4, @@ -346,117 +304,97 @@ present, \fINULL\fR. .sp .ne 2 -.mk .na \fB\fBinclude\fR\fR .ad .RS 15n -.rt Returns the contents of the file named in the argument. .RE .sp .ne 2 -.mk .na \fB\fBincr\fR\fR .ad .RS 15n -.rt Returns the value of its argument incremented by 1. The value of the argument is calculated by interpreting an initial digit-string as a decimal number. .RE .sp .ne 2 -.mk .na \fB\fBindex\fR\fR .ad .RS 15n -.rt Returns the position in its first argument where the second argument begins (zero origin), or \(mi1 if the second argument does not occur. .RE .sp .ne 2 -.mk .na \fB\fBlen\fR\fR .ad .RS 15n -.rt Returns the number of characters in its argument. .RE .sp .ne 2 -.mk .na \fB\fBm4exit\fR\fR .ad .RS 15n -.rt This macro causes immediate exit from \fBm4\fR. Argument 1, if given, is the exit code; the default is \fB0\fR. .RE .sp .ne 2 -.mk .na \fB\fBm4wrap\fR\fR .ad .RS 15n -.rt Argument 1 is pushed back at final \fBEOF\fR. Example: \fBm4wrap(`cleanup(\|)')\fR .RE .sp .ne 2 -.mk .na \fB\fBmaketemp\fR\fR .ad .RS 15n -.rt Fills in a string of "\fBX\fR" characters in its argument with the current process \fBID\fR. .RE .sp .ne 2 -.mk .na \fB\fBpopdef\fR\fR .ad .RS 15n -.rt Removes current definition of its argument(s), exposing the previous one, if any. .RE .sp .ne 2 -.mk .na \fB\fBpushdef\fR\fR .ad .RS 15n -.rt Like \fBdefine\fR, but saves any previous definition. .RE .sp .ne 2 -.mk .na \fB\fBshift\fR\fR .ad .RS 15n -.rt Returns all but its first argument. The other arguments are quoted and pushed back with commas in between. The quoting nullifies the effect of the extra scan that is subsequently be performed. @@ -464,24 +402,20 @@ that is subsequently be performed. .sp .ne 2 -.mk .na \fB\fBsinclude\fR\fR .ad .RS 15n -.rt This macro is identical to \fBinclude\fR, except that it says nothing if the file is inaccessible. .RE .sp .ne 2 -.mk .na \fB\fBsubstr\fR\fR .ad .RS 15n -.rt Returns a substring of its first argument. The second argument is a zero origin number selecting the first character; the third argument indicates the length of the substring. A missing third argument is taken to be large enough to @@ -490,81 +424,67 @@ extend to the end of the first string. .sp .ne 2 -.mk .na \fB\fBsyscmd\fR\fR .ad .RS 15n -.rt This macro executes the command given in the first argument. No value is returned. .RE .sp .ne 2 -.mk .na \fB\fBsysval\fR\fR .ad .RS 15n -.rt This macro is the return code from the last call to \fBsyscmd\fR. .RE .sp .ne 2 -.mk .na \fB\fBtranslit\fR\fR .ad .RS 15n -.rt Transliterates the characters in its first argument from the set given by the second argument to the set given by the third. No abbreviations are permitted. .RE .sp .ne 2 -.mk .na \fB\fBtraceon\fR\fR .ad .RS 15n -.rt This macro with no arguments, turns on tracing for all macros (including built-ins). Otherwise, turns on tracing for named macros. .RE .sp .ne 2 -.mk .na \fB\fBtraceoff\fR\fR .ad .RS 15n -.rt Turns off trace globally and for any macros specified. .RE .sp .ne 2 -.mk .na \fB\fBundefine\fR\fR .ad .RS 15n -.rt Removes the definition of the macro named in its argument. .RE .sp .ne 2 -.mk .na \fB\fBundivert\fR\fR .ad .RS 15n -.rt This macro causes immediate output of text from diversions named as arguments, or all diversions if no argument. Text can be undiverted into another diversion. Undiverting discards the diverted text. @@ -573,12 +493,10 @@ diversion. Undiverting discards the diverted text. .SS "/usr/bin/m4" .sp .ne 2 -.mk .na \fB\fBeval\fR\fR .ad .RS 8n -.rt Evaluates its argument as an arithmetic expression, using 32-bit signed-integer arithmetic. The following operators are supported: parentheses, unary -, unary +, !, ~, *, /, %, +, -, relationals, bitwise &, |, &&, and ||. Octal and hex @@ -590,12 +508,10 @@ minimum number of digits in the result. .SS "/usr/xpg4/bin/m4" .sp .ne 2 -.mk .na \fB\fBeval\fR\fR .ad .RS 8n -.rt Evaluates its argument as an arithmetic expression, using 32-bit signed-integer arithmetic. The following operators are supported: parentheses, unary -, unary +, !, ~, *, /, %, +, -, <<, >>, relationals, bitwise &, |, &&, @@ -760,23 +676,19 @@ that affect the execution of \fBm4\fR: \fBLANG\fR, \fBLC_ALL\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred .RE @@ -794,13 +706,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man1/mac.1 b/usr/src/man/man1/mac.1 index 50fd46ef8b..e15ba72384 100644 --- a/usr/src/man/man1/mac.1 +++ b/usr/src/man/man1/mac.1 @@ -1,9 +1,9 @@ '\" te -.\" Copyright 2007, Sun Microsystems, Inc. All Rights Reserved +.\" Copyright 2007, 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 mac 1 "21 Mar 2007" "SunOS 5.11" "User Commands" +.TH MAC 1 "Mar 21, 2007" .SH NAME mac \- calculate message authentication codes of the input .SH SYNOPSIS @@ -33,12 +33,10 @@ single file. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-a\fR \fIalgorithm\fR\fR .ad .RS 17n -.rt Specifies the name of the algorithm to use during the encryption or decryption process. See USAGE, \fBAlgorithms\fR for details. \fBNote:\fR Algorithms for producing general length \fBMAC\fRs are not supported. @@ -46,12 +44,10 @@ producing general length \fBMAC\fRs are not supported. .sp .ne 2 -.mk .na \fB\fB-k\fR \fIkeyfile\fR\fR .ad .RS 17n -.rt Specifies the file containing the key value for the encryption algorithm. Each algorithm has specific key material requirements, as stated in the PKCS#11 specification. If \fB-k\fR is not specified, \fBmac\fR prompts for key @@ -63,23 +59,19 @@ the \fISystem Administration Guide: Security Services\fR. .sp .ne 2 -.mk .na \fB\fB-K\fR \fIkey_label\fR\fR .ad .RS 17n -.rt Specify the label of a symmetric token key in a PKCS#11 token. .RE .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 17n -.rt Displays the list of algorithms available on the system. This list can change depending on the configuration of the cryptographic framework. The keysizes are displayed in bits. @@ -87,12 +79,10 @@ displayed in bits. .sp .ne 2 -.mk .na \fB\fB-T\fR \fItoken_spec\fR\fR .ad .RS 17n -.rt Specify a PKCS#11 token other than the default soft token object store when the \fB-K\fR is specified. .sp @@ -117,12 +107,10 @@ token label and the manufacturer. .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 17n -.rt Provides verbose information. .RE @@ -207,23 +195,19 @@ Enter pin for Sun Software PKCS#11 softtoken: The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -235,13 +219,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityEvolving +Interface Stability Evolving .TE .SH SEE ALSO diff --git a/usr/src/man/man1/mach.1 b/usr/src/man/man1/mach.1 index 8373f1e138..d24998646b 100644 --- a/usr/src/man/man1/mach.1 +++ b/usr/src/man/man1/mach.1 @@ -3,13 +3,13 @@ .\" 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 mach 1 "18 Jan 1996" "SunOS 5.11" "User Commands" +.TH MACH 1 "Jan 18, 1996" .SH NAME mach \- display the processor type of the current host .SH SYNOPSIS .LP .nf -\fBmach\fR +\fBmach\fR .fi .SH DESCRIPTION diff --git a/usr/src/man/man1/machid.1 b/usr/src/man/man1/machid.1 index 687cc67fe3..3fdedaf019 100644 --- a/usr/src/man/man1/machid.1 +++ b/usr/src/man/man1/machid.1 @@ -5,64 +5,64 @@ .\" 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 machid 1 "5 Jul 1990" "SunOS 5.11" "User Commands" +.TH MACHID 1 "Jul 5, 1990" .SH NAME machid, sun, iAPX286, i286, i386, i486, i860, pdp11, sparc, u3b, u3b2, u3b5, u3b15, vax, u370 \- get processor type truth value .SH SYNOPSIS .LP .nf -\fBsun\fR +\fBsun\fR .fi .LP .nf -\fBiAPX286\fR +\fBiAPX286\fR .fi .LP .nf -\fBi386\fR +\fBi386\fR .fi .LP .nf -\fBpdp11\fR +\fBpdp11\fR .fi .LP .nf -\fBsparc\fR +\fBsparc\fR .fi .LP .nf -\fBu3b\fR +\fBu3b\fR .fi .LP .nf -\fBu3b2\fR +\fBu3b2\fR .fi .LP .nf -\fBu3b5\fR +\fBu3b5\fR .fi .LP .nf -\fBu3b15\fR +\fBu3b15\fR .fi .LP .nf -\fBvax\fR +\fBvax\fR .fi .LP .nf -\fBu370\fR +\fBu370\fR .fi .SH DESCRIPTION @@ -72,122 +72,100 @@ The following commands will return a true value (exit code of 0) if you are using an instruction set that the command name indicates. .sp .ne 2 -.mk .na \fB\fBsun\fR\fR .ad .RS 11n -.rt True if you are on a Sun system. .RE .sp .ne 2 -.mk .na \fB\fBiAPX286\fR\fR .ad .RS 11n -.rt True if you are on a computer using an iAPX286 processor. .RE .sp .ne 2 -.mk .na \fB\fBi386\fR\fR .ad .RS 11n -.rt True if you are on a computer using an iAPX386 processor. .RE .sp .ne 2 -.mk .na \fB\fBpdp11\fR\fR .ad .RS 11n -.rt True if you are on a PDP-11/45\(tm or PDP-11/70\(tm. .RE .sp .ne 2 -.mk .na \fB\fBsparc\fR\fR .ad .RS 11n -.rt True if you are on a computer using a SPARC-family processor. .RE .sp .ne 2 -.mk .na \fB\fBu3b\fR\fR .ad .RS 11n -.rt True if you are on a 3B20 computer. .RE .sp .ne 2 -.mk .na \fB\fBu3b2\fR\fR .ad .RS 11n -.rt True if you are on a 3B2 computer. .RE .sp .ne 2 -.mk .na \fB\fBu3b5\fR\fR .ad .RS 11n -.rt True if you are on a 3B5 computer. .RE .sp .ne 2 -.mk .na \fB\fBu3b15\fR\fR .ad .RS 11n -.rt True if you are on a 3B15 computer. .RE .sp .ne 2 -.mk .na \fB\fBvax\fR\fR .ad .RS 11n -.rt True if you are on a VAX-11/750\(tm or VAX-11/780\(tm. .RE .sp .ne 2 -.mk .na \fB\fBu370\fR\fR .ad .RS 11n -.rt True if you are on an IBM\(rg System/370\(tm computer. .RE diff --git a/usr/src/man/man1/madv.so.1.1 b/usr/src/man/man1/madv.so.1.1 index 3df578d27e..bd2b437299 100644 --- a/usr/src/man/man1/madv.so.1.1 +++ b/usr/src/man/man1/madv.so.1.1 @@ -3,13 +3,13 @@ .\" 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 madv.so.1 1 "15 Feb 2002" "SunOS 5.11" "User Commands" +.TH MADV.SO.1 1 "Feb 15, 2002" .SH NAME madv.so.1 \- madv library .SH SYNOPSIS .LP .nf -\fB/usr/lib/madv.so.1\fR +\fB/usr/lib/madv.so.1\fR .fi .SH DESCRIPTION @@ -36,12 +36,10 @@ the following environment variables are read by the \fBmadv\fR shared object to determine to which created process(es) to apply the specified advice. .sp .ne 2 -.mk .na \fB\fBMADV\fR=\fIadvice\fR \fR .ad .RS 27n -.rt \fBMADV\fR specifies the VM advice to use for all heap, shared memory, and mmap regions in the process address space. This advice is applied to all created processes. @@ -76,12 +74,10 @@ access_default .sp .ne 2 -.mk .na \fB\fBMADVCFGFILE\fR=\fIconfig-file\fR\fR .ad .RS 27n -.rt \fIconfig-file\fR is a text file which contains one or more \fBmadv\fR configuration entries of the form: .sp @@ -111,31 +107,26 @@ within the arguments to \fIexec-name\fR. memory region(s): .sp .ne 2 -.mk .na \fB\fBmadv\fR=\fIadvice\fR\fR .ad .RS 21n -.rt Applies to all heap, shared memory, and mmap regions in the process address space. .RE .sp .ne 2 -.mk .na \fB\fBheap\fR=\fIadvice\fR\fR .ad .RS 21n -.rt The heap is defined to be the brk area (see \fBbrk\fR(2)). Applies to the existing heap and for any additional heap memory allocated in the future. .RE .sp .ne 2 -.mk .na \fB\fBshm\fR=\fIadvice\fR\fR .ad @@ -148,7 +139,6 @@ existing heap and for any additional heap memory allocated in the future. \fB\fBdism\fR=\fIadvice\fR\fR .ad .RS 21n -.rt Shared memory segments (see \fBshmat\fR(2)) attached using any flags, flag \fBSHM_SHARE_MMU\fR, or flag \fBSHM_PAGEABLE\fR respectively. Options \fBism\fR and \fBdism\fR take precedence over option \fBshm\fR. @@ -156,7 +146,6 @@ Shared memory segments (see \fBshmat\fR(2)) attached using any flags, flag .sp .ne 2 -.mk .na \fB\fBmap\fR=\fIadvice\fR\fR .ad @@ -173,7 +162,6 @@ Shared memory segments (see \fBshmat\fR(2)) attached using any flags, flag \fB\fBmapanon\fR=\fIadvice\fR\fR .ad .RS 21n -.rt Mappings established through \fBmmap\fR(2) using any flags, flag \fBMAP_SHARED\fR, flag \fBMAP_PRIVATE\fR, or flag \fBMAP_ANON\fR, respectively. Options \fBmapshared\fR, \fBmapprivate\fR, and \fBmapanon\fR take precedence @@ -185,12 +173,10 @@ over option \fBmap\fR. Option \fBmapanon\fR takes precedence over .sp .ne 2 -.mk .na \fB\fBMADVERRFILE\fR=\fIpathname\fR\fR .ad .RS 27n -.rt By default, error messages are logged via \fBsyslog\fR(3C) using level \fBLOG_ERR\fR and facility \fBLOG_USER\fR. If \fBMADVERRFILE\fR contains a valid \fIpathname\fR (such as \fB/dev/stderr\fR), error messages will be logged @@ -301,12 +287,10 @@ example$ \fBcat $MADVCFGFILE\fR .SH FILES .sp .ne 2 -.mk .na \fB\fB/etc/madv.conf\fR \fR .ad .RS 19n -.rt Configuration file .RE diff --git a/usr/src/man/man1/mail.1 b/usr/src/man/man1/mail.1 index ac96b5d19c..b7fc3718c9 100644 --- a/usr/src/man/man1/mail.1 +++ b/usr/src/man/man1/mail.1 @@ -2,14 +2,14 @@ .\" Copyright 1989 AT&T .\" Copyright (c) 2008, Sun Microsystems, Inc. All Rights Reserved .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 1 "24 Jul 2008" "SunOS 5.11" "User Commands" +.TH MAIL 1 "Jul 24, 2008" .SH NAME mail, rmail \- read mail or send mail to users .SH SYNOPSIS @@ -89,36 +89,30 @@ continued on the following line if that line starts with white space. The following command-line arguments affect sending mail: .sp .ne 2 -.mk .na \fB\fB-m\fR \fImessage_type\fR\fR .ad .RS 19n -.rt A \fBMessage-Type:\fR line is added to the message header with the value of \fImessage_type\fR. .RE .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad .RS 19n -.rt A \fBTo:\fR line is added to the message header for each of the intended \fIrecipient\fRs. .RE .sp .ne 2 -.mk .na \fB\fB-w\fR\fR .ad .RS 19n -.rt A letter is sent to a remote recipient without waiting for the completion of the remote transfer program. .RE @@ -148,12 +142,10 @@ to the local system. The two most prevalent addressing schemes are Domain-style and UUCP-style. .sp .ne 2 -.mk .na \fBDomain-style addressing\fR .ad .RS 27n -.rt Remote recipients are specified by appending an `\fB@\fR' and domain (and possibly sub-domain) information to the recipient name (such as \fBuser@sf.att.com\fR). (The local system administrator should be consulted for @@ -162,12 +154,10 @@ details on which addressing conventions are available on the local system.) .sp .ne 2 -.mk .na \fBUUCP-style addressing\fR .ad .RS 27n -.rt Remote recipients are specified by prefixing the recipient name with the remote system name and an exclamation point, such as \fBsysa!user.\fR If \fBcsh\fR(1) is the default shell, \fBsysa\e!user\fR should be used. A series of system @@ -182,12 +172,10 @@ extended network (such as \fBsysa!sysb!sysc!user\fR or The following command-line arguments affect reading mail: .sp .ne 2 -.mk .na \fB\fB-e\fR\fR .ad .RS 11n -.rt Test for the presence of mail. \fBmail\fR prints nothing. .sp An exit status of \fB0\fR is returned if the user has mail. Otherwise, an exit @@ -196,12 +184,10 @@ status of \fB1\fR is returned. .sp .ne 2 -.mk .na \fB\fB-E\fR\fR .ad .RS 11n -.rt Similar to \fB-e\fR, but tests only for the presence of \fBnew\fR mail. .sp An exit status of \fB0\fR is returned if the user has new mail @@ -212,70 +198,58 @@ which has already been read. .sp .ne 2 -.mk .na \fB\fB-h\fR\fR .ad .RS 11n -.rt A window of headers are initially displayed rather than the latest message. The display is followed by the \fB?\fR prompt. .RE .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 11n -.rt All messages are printed without prompting for disposition. .RE .sp .ne 2 -.mk .na \fB\fB-P\fR\fR .ad .RS 11n -.rt All messages are printed with \fIall\fR header lines displayed, rather than the default selective header line display. .RE .sp .ne 2 -.mk .na \fB\fB-q\fR\fR .ad .RS 11n -.rt \fBmail\fR terminates after interrupts. Normally an interrupt causes only the termination of the message being printed. .RE .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 11n -.rt Messages are printed in first-in, first-out order. .RE .sp .ne 2 -.mk .na \fB\fB-f\fR \fIfile\fR\fR .ad .RS 11n -.rt \fBmail\fR uses \fIfile\fR (such as \fBmbox\fR) instead of the default \fImailfile\fR. .RE @@ -300,269 +274,221 @@ the standard input. The following commands are available to determine the disposition of the message: .sp .ne 2 -.mk .na \fB\fB#\fR\fR .ad .RS 22n -.rt Print the number of the current message. .RE .sp .ne 2 -.mk .na \fB\fB\(mi\fR\fR .ad .RS 22n -.rt Print previous message. .RE .sp .ne 2 -.mk .na \fB<new-line>,\fB+\fR, or \fBn\fR\fR .ad .RS 22n -.rt Print the next message. .RE .sp .ne 2 -.mk .na \fB\fB!\fR\fIcommand\fR\fR .ad .RS 22n -.rt Escape to the shell to do \fIcommand\fR. .RE .sp .ne 2 -.mk .na \fB\fBa\fR\fR .ad .RS 22n -.rt Print message that arrived during the \fBmail\fR session. .RE .sp .ne 2 -.mk .na \fB\fBd\fR, or \fBdp\fR\fR .ad .RS 22n -.rt Delete the current message and print the next message. .RE .sp .ne 2 -.mk .na \fB\fBd\fR \fIn\fR\fR .ad .RS 22n -.rt Delete message number \fIn\fR. Do not go on to next message. .RE .sp .ne 2 -.mk .na \fB\fBdq\fR\fR .ad .RS 22n -.rt Delete message and quit \fBmail\fR. .RE .sp .ne 2 -.mk .na \fB\fBh\fR\fR .ad .RS 22n -.rt Display a window of headers around current message. .RE .sp .ne 2 -.mk .na \fB\fBh\fR\fIn\fR\fR .ad .RS 22n -.rt Display a window of headers around message number \fIn\fR. .RE .sp .ne 2 -.mk .na \fB\fBh a\fR\fR .ad .RS 22n -.rt Display headers of all messages in the user's \fImailfile\fR. .RE .sp .ne 2 -.mk .na \fB\fBh d\fR\fR .ad .RS 22n -.rt Display headers of messages scheduled for deletion. .RE .sp .ne 2 -.mk .na \fB\fBm\fR [ \fIpersons\fR ]\fR .ad .RS 22n -.rt Mail (and delete) the current message to the named \fIpersons\fR. .RE .sp .ne 2 -.mk .na \fB\fIn\fR\fR .ad .RS 22n -.rt Print message number \fIn\fR. .RE .sp .ne 2 -.mk .na \fB\fBp\fR\fR .ad .RS 22n -.rt Print current message again, overriding any indications of binary (that is, unprintable) content. .RE .sp .ne 2 -.mk .na \fB\fBP\fR\fR .ad .RS 22n -.rt Override default brief mode and print current message again, displaying all header lines. .RE .sp .ne 2 -.mk .na \fB\fBq\fR, or Control-d\fR .ad .RS 22n -.rt Put undeleted mail back in the \fImailfile\fR and quit \fBmail\fR. .RE .sp .ne 2 -.mk .na \fB\fBr\fR [ \fIusers\fR ]\fR .ad .RS 22n -.rt Reply to the sender, and other \fIusers\fR, then delete the message. .RE .sp .ne 2 -.mk .na \fB\fBs\fR [ \fIfiles\fR ]\fR .ad .RS 22n -.rt Save message in the named \fIfiles\fR (\fBmbox\fR is default) and delete the message. .RE .sp .ne 2 -.mk .na \fB\fBu\fR [ \fIn\fR ]\fR .ad .RS 22n -.rt Undelete message number \fIn\fR (default is last read). .RE .sp .ne 2 -.mk .na \fB\fBw\fR [ \fIfiles\fR ]\fR .ad .RS 22n -.rt Save message contents, without any header lines, in the named \fIfiles\fR (\fBmbox\fR is default) and delete the message. .RE .sp .ne 2 -.mk .na \fB\fBx\fR\fR .ad .RS 22n -.rt Put all mail back in the \fImailfile\fR unchanged and exit \fBmail\fR. .RE .sp .ne 2 -.mk .na \fB\fBy\fR [ \fIfiles\fR ]\fR .ad .RS 22n -.rt Same as \fB-w\fR option. .RE .sp .ne 2 -.mk .na \fB\fB?\fR\fR .ad .RS 22n -.rt Print a command summary. .RE @@ -590,12 +516,10 @@ The following command-line arguments cause \fBmail\fR to provide debugging information: .sp .ne 2 -.mk .na \fB\fB-x\fR \fIdebug_level\fR\fR .ad .RS 18n -.rt \fBmail\fR creates a trace file containing debugging information. .RE @@ -631,58 +555,48 @@ following lines in the message header. Where the "/\fIoptions\fR" can be one or more of the following: .sp .ne 2 -.mk .na \fB\fB/delivery\fR\fR .ad .RS 15n -.rt Inform the sender that the message was successfully delivered to the \fIrecipient\fR's mailbox. .RE .sp .ne 2 -.mk .na \fB\fB/nodelivery\fR\fR .ad .RS 15n -.rt Do not inform the sender of successful deliveries. .RE .sp .ne 2 -.mk .na \fB\fB/ignore\fR\fR .ad .RS 15n -.rt Do not inform the sender of failed deliveries. .RE .sp .ne 2 -.mk .na \fB\fB/return\fR\fR .ad .RS 15n -.rt Inform the sender if mail delivery fails. Return the failed message to the sender. .RE .sp .ne 2 -.mk .na \fB\fB/report\fR\fR .ad .RS 15n -.rt Same as \fB/return\fR except that the original message is not returned. .RE @@ -696,12 +610,10 @@ first is recognized and later, conflicting, terms are ignored. The following operand is supported for sending mail: .sp .ne 2 -.mk .na \fB\fIrecipient\fR\fR .ad .RS 13n -.rt A domain style address ("\fIuser\fR@\fImachine\fR") or user login name recognized by \fBlogin\fR(1). .RE @@ -720,12 +632,10 @@ that affect the execution of \fBmail\fR: \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and \fBNLSPATH\fR. .sp .ne 2 -.mk .na \fB\fBTZ\fR\fR .ad .RS 6n -.rt Determine the timezone used with date and time strings. .RE @@ -735,135 +645,111 @@ Determine the timezone used with date and time strings. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion when the user had mail. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 6n -.rt The user had no mail or an initialization error occurred. .RE .sp .ne 2 -.mk .na \fB\fB>1\fR\fR .ad .RS 6n -.rt An error occurred after initialization. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fBdead.letter\fR\fR .ad .RS 20n -.rt unmailable text .RE .sp .ne 2 -.mk .na \fB\fB/etc/passwd\fR\fR .ad .RS 20n -.rt to identify sender and locate \fIrecipient\fRs .RE .sp .ne 2 -.mk .na \fB\fB$HOME/mbox\fR\fR .ad .RS 20n -.rt saved mail .RE .sp .ne 2 -.mk .na \fB\fB$MAIL\fR\fR .ad .RS 20n -.rt variable containing path name of \fImailfile\fR .RE .sp .ne 2 -.mk .na \fB\fB/tmp/MLDBG\fR*\fR .ad .RS 20n -.rt debug trace file .RE .sp .ne 2 -.mk .na \fB\fB/var/mail/*.lock\fR\fR .ad .RS 20n -.rt lock for mail directory .RE .sp .ne 2 -.mk .na \fB\fB/var/mail/:saved\fR\fR .ad .RS 20n -.rt directory for holding temp files to prevent loss of data in the event of a system crash .RE .sp .ne 2 -.mk .na \fB\fB/var/mail/\fIuser\fR\fR\fR .ad .RS 20n -.rt incoming mail for \fIuser\fR; that is, the \fImailfile\fR .RE .sp .ne 2 -.mk .na \fB\fBvar/tmp/ma\fR*\fR .ad .RS 20n -.rt temporary file .RE diff --git a/usr/src/man/man1/mailcompat.1 b/usr/src/man/man1/mailcompat.1 index f097ef4ca8..f27569af75 100644 --- a/usr/src/man/man1/mailcompat.1 +++ b/usr/src/man/man1/mailcompat.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 mailcompat 1 "4 Aug 1994" "SunOS 5.11" "User Commands" +.TH MAILCOMPAT 1 "Aug 4, 1994" .SH NAME mailcompat \- provide SunOS compatibility for Solaris mailbox format .SH DESCRIPTION @@ -73,12 +73,10 @@ example% .SH FILES .sp .ne 2 -.mk .na \fB\fB~/.forward\fR\fR .ad .RS 14n -.rt list of recipients for forwarding messages .RE diff --git a/usr/src/man/man1/mailq.1 b/usr/src/man/man1/mailq.1 index feaa326984..e750117ec6 100644 --- a/usr/src/man/man1/mailq.1 +++ b/usr/src/man/man1/mailq.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 mailq 1 "10 Jul 2002" "SunOS 5.11" "User Commands" +.TH MAILQ 1 "Jul 10, 2002" .SH NAME mailq \- print the mail queue .SH SYNOPSIS @@ -39,12 +39,10 @@ by modifying the Basic Solaris User entry in \fBprof_attr\fR(4). The following options are supported: .sp .ne 2 -.mk .na \fB\fB-Ac\fR\fR .ad .RS 17n -.rt Like \fBsendmail\fR(1M), this flag tells \fBmailq\fR to use \fBsubmit.cf\fR rather than \fBsendmail.cf\fR even if the operation mode does not indicate an initial mail submission. This will result in the client queue @@ -54,12 +52,10 @@ queue \fB/var/spool/mqueue\fR. .sp .ne 2 -.mk .na \fB\fB-q\fR\fBp\fR[\fItime\fR] \fR .ad .RS 17n -.rt Similar to \fB-q\fR\fItime\fR, except that instead of periodically forking a child to process the queue, \fBsendmail\fR forks a single persistent child for each queue that alternates between processing the queue and sleeping. The sleep @@ -70,71 +66,59 @@ previous queue run. .sp .ne 2 -.mk .na \fB\fB-q\fR\fBf\fR\fR .ad .RS 17n -.rt Processes saved messages in the queue once and does not \fBfork()\fR, but runs in the foreground. .RE .sp .ne 2 -.mk .na \fB\fB-q\fR\fBG\fR \fIname\fR\fR .ad .RS 17n -.rt Processes jobs in the queue group called \fIname\fR only. .RE .sp .ne 2 -.mk .na \fB\fB-q\fR[\fB!\fR]\fBI\fR \fIsubstr\fR\fR .ad .RS 17n -.rt Limits processed jobs to those containing \fIsubstr\fR as a substring of the queue id, or not when \fB!\fR is specified. .RE .sp .ne 2 -.mk .na \fB\fB-q\fR[\fB!\fR]\fBR\fR \fIsubstr\fR\fR .ad .RS 17n -.rt Limits processed jobs to those containing \fIsubstr\fR as a substring of one of the recipients, or not when \fB!\fR is specified. .RE .sp .ne 2 -.mk .na \fB\fB-q\fR[\fB!\fR]\fBS\fR \fIsubstr\fR\fR .ad .RS 17n -.rt Limits processed jobs to those containing \fIsubstr\fR as a substring of the sender, or not when \fB!\fR is specified. .RE .sp .ne 2 -.mk .na \fB\fB-v\fR \fR .ad .RS 17n -.rt Prints verbose information. This adds the priority of the message and a single character indicator (\fB+\fR or blank) indicating whether a warning message has been sent on the first line of the message. Additionally, extra lines may @@ -147,57 +131,47 @@ any. .SH EXIT STATUS .sp .ne 2 -.mk .na \fB\fB0\fR \fR .ad .RS 7n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR \fR .ad .RS 7n -.rt An error occurred. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB/etc/security/prof_attr\fR\fR .ad .RS 27n -.rt local source for execution profile attributes .RE .sp .ne 2 -.mk .na \fB\fB/var/spool/mqueue\fR\fR .ad .RS 27n -.rt default server queue .RE .sp .ne 2 -.mk .na \fB\fB/var/spool/clientmqueue\fR\fR .ad .RS 27n -.rt client queue .RE diff --git a/usr/src/man/man1/mailstats.1 b/usr/src/man/man1/mailstats.1 index 3615d2d6a6..fed9e8f6bb 100644 --- a/usr/src/man/man1/mailstats.1 +++ b/usr/src/man/man1/mailstats.1 @@ -3,13 +3,13 @@ .\" 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 mailstats 1 "24 Jun 2004" "SunOS 5.11" "User Commands" +.TH MAILSTATS 1 "Jun 24, 2004" .SH NAME mailstats \- print statistics collected by sendmail .SH SYNOPSIS .LP .nf -\fBmailstats\fR [\fB-o\fR] [\fB-c\fR ] [\fB-C\fR \fIconfigfile\fR] [\fB-f\fR \fIstatisticsfile\fR] +\fBmailstats\fR [\fB-o\fR] [\fB-c\fR ] [\fB-C\fR \fIconfigfile\fR] [\fB-f\fR \fIstatisticsfile\fR] [\fB-p\fR] [\fB-P\fR] .fi @@ -33,100 +33,82 @@ displayed on a single line, each with the following whitespace-separated fields: .sp .ne 2 -.mk .na \fBM\fR .ad .RS 14n -.rt The mailer number. .RE .sp .ne 2 -.mk .na \fBmsgsfr\fR .ad .RS 14n -.rt Number of messages from the mailer. .RE .sp .ne 2 -.mk .na \fBbytes_from\fR .ad .RS 14n -.rt Kbytes from the mailer. .RE .sp .ne 2 -.mk .na \fBmsgsto\fR .ad .RS 14n -.rt Number of messages to the mailer. .RE .sp .ne 2 -.mk .na \fBbytes_to\fR .ad .RS 14n -.rt Kbytes to the mailer. .RE .sp .ne 2 -.mk .na \fBmsgsrej\fR .ad .RS 14n -.rt Number of messages rejected by the mailer. .RE .sp .ne 2 -.mk .na \fBmsgsdis\fR .ad .RS 14n -.rt Number of messages discarded by the mailer. .RE .sp .ne 2 -.mk .na \fBmsgsqur\fR .ad .RS 14n -.rt Number of messages quarantined by the mailer. .RE .sp .ne 2 -.mk .na \fBMailer\fR .ad .RS 14n -.rt The name of the mailer. .RE @@ -155,68 +137,56 @@ mailstats -p > /dev/null The following options are supported: .sp .ne 2 -.mk .na \fB\fB-c\fR \fR .ad .RS 21n -.rt Try to use \fBsubmit.cf\fR instead of the default \fBsendmail\fR configuration file. .RE .sp .ne 2 -.mk .na \fB\fB-C\fR \fIconfigfile\fR\fR .ad .RS 21n -.rt Specify a \fBsendmail\fR configuration file. .RE .sp .ne 2 -.mk .na \fB\fB-f\fR \fIstatisticsfile\fR\fR .ad .RS 21n -.rt Specify a \fBsendmail\fR statistics file. .RE .sp .ne 2 -.mk .na \fB\fB-o\fR\fR .ad .RS 21n -.rt Do not display the name of the mailer in the output. .RE .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 21n -.rt Output information in program-readable mode and clear statistics. .RE .sp .ne 2 -.mk .na \fB\fB-P\fR\fR .ad .RS 21n -.rt Output information in program-readable mode without clearing statistics. .RE @@ -228,34 +198,28 @@ when encountering files greater than or equal to 2 Gbyte ( 2^31 bytes). .SH FILES .sp .ne 2 -.mk .na \fB\fB/dev/null\fR\fR .ad .RS 25n -.rt Zero-lined file .RE .sp .ne 2 -.mk .na \fB\fB/etc/mail/statistics\fR\fR .ad .RS 25n -.rt Default \fBsendmail\fR statistics file .RE .sp .ne 2 -.mk .na \fB\fB/etc/mail/sendmail.cf\fR\fR .ad .RS 25n -.rt Default \fBsendmail\fR configuration file .RE @@ -267,13 +231,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Output StabilityUnstable +Output Stability Unstable .TE .SH SEE ALSO diff --git a/usr/src/man/man1/mailx.1 b/usr/src/man/man1/mailx.1 index 1d04d670f8..671f628c66 100644 --- a/usr/src/man/man1/mailx.1 +++ b/usr/src/man/man1/mailx.1 @@ -2,26 +2,26 @@ .\" Copyright 1989 AT&T .\" Copyright (c) 2001, Sun Microsystems, Inc. All Rights Reserved .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 mailx 1 "19 Sep 2001" "SunOS 5.11" "User Commands" +.TH MAILX 1 "Sep 19, 2001" .SH NAME mailx \- interactive message processing system .SH SYNOPSIS .LP .nf -\fBmailx\fR [\fB-BdeHiInNURvV~\fR] [\fB-f\fR [\fIfile\fR | \fI+folder\fR]] [\fB-T\fR \fIfile\fR] +\fBmailx\fR [\fB-BdeHiInNURvV~\fR] [\fB-f\fR [\fIfile\fR | \fI+folder\fR]] [\fB-T\fR \fIfile\fR] [\fB-u\fR \fIuser\fR] .fi .LP .nf -\fBmailx\fR [\fB-BdFintUv~\fR] [\fB-b\fR \fIbcc\fR] [\fB-c\fR \fIcc\fR] [\fB-h\fR \fInumber\fR] +\fBmailx\fR [\fB-BdFintUv~\fR] [\fB-b\fR \fIbcc\fR] [\fB-c\fR \fIcc\fR] [\fB-h\fR \fInumber\fR] [\fB-r\fR \fIaddress\fR] [\fB-s\fR \fIsubject\fR] \fIrecipient\fR... .fi @@ -71,117 +71,97 @@ taken to be destinations (recipients). If no recipients are specified, \fBmailx\fR attempts to read messages from the \fBmailbox\fR. .sp .ne 2 -.mk .na \fB\fB-B\fR\fR .ad .RS 17n -.rt Do not buffer standard input or standard output. .RE .sp .ne 2 -.mk .na \fB\fB-b\fR \fIbcc\fR\fR .ad .RS 17n -.rt Set the blind carbon copy list to \fIbcc\fR. \fIbcc\fR should be enclosed in quotes if it contains more than one name. .RE .sp .ne 2 -.mk .na \fB\fB-c\fR \fIcc\fR\fR .ad .RS 17n -.rt Set the carbon copy list to \fIcc\fR. \fIcc\fR should be enclosed in quotes if it contains more than one name. .RE .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad .RS 17n -.rt Turn on debugging output. (Neither particularly interesting nor recommended.) .RE .sp .ne 2 -.mk .na \fB\fB-e\fR\fR .ad .RS 17n -.rt Test for the presence of mail. \fBmailx\fR prints nothing and exits with a successful return code if there is mail to read. .RE .sp .ne 2 -.mk .na \fB\fB-F\fR\fR .ad .RS 17n -.rt Record the message in a file named after the first recipient. Overrides the \fBrecord\fR variable, if set (see \fBInternal Variables\fR). .RE .sp .ne 2 -.mk .na \fB\fB\fR\fB-f\fR\fB [\fR\fIfile\fR\fB]\fR\fR .ad .RS 17n -.rt Read messages from \fIfile\fR instead of \fBmailbox\fR. If no \fIfile\fR is specified, the \fBmbox\fR is used. .RE .sp .ne 2 -.mk .na \fB\fB\fR\fB-f\fR\fB [ \fR\fB+\fR\fIfolder\fR\fB]\fR\fR .ad .RS 17n -.rt Use the file \fIfolder\fR in the folder directory (same as the \fBfold\fRer command). The name of this directory is listed in the \fBfolder\fR variable. .RE .sp .ne 2 -.mk .na \fB\fB-H\fR\fR .ad .RS 17n -.rt Print header summary only. .RE .sp .ne 2 -.mk .na \fB\fB-h\fR \fInumber\fR\fR .ad .RS 17n -.rt The number of network "hops" made so far. This is provided for network software to avoid infinite delivery loops. This option and its argument are passed to the delivery program. @@ -189,58 +169,48 @@ the delivery program. .sp .ne 2 -.mk .na \fB\fB-I\fR\fR .ad .RS 17n -.rt Include the newsgroup and article-id header lines when printing mail messages. This option requires the \fB-f\fR option to be specified. .RE .sp .ne 2 -.mk .na \fB\fB-i\fR\fR .ad .RS 17n -.rt Ignore interrupts. See also \fBignore\fR in \fBInternal Variables\fR. .RE .sp .ne 2 -.mk .na \fB\fB-N\fR\fR .ad .RS 17n -.rt Do not print initial header summary. .RE .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 17n -.rt Do not initialize from the system default \fBmailx.rc\fR or \fBMail.rc\fR file. See USAGE. .RE .sp .ne 2 -.mk .na \fB\fB-r\fR \fIaddress\fR\fR .ad .RS 17n -.rt Use \fIaddress\fR as the return address when invoking the delivery program. All tilde commands are disabled. This option and its argument is passed to the delivery program. @@ -248,94 +218,78 @@ delivery program. .sp .ne 2 -.mk .na \fB\fB-s\fR \fIsubject\fR\fR .ad .RS 17n -.rt Set the Subject header field to \fIsubject\fR. \fIsubject\fR should be enclosed in quotes if it contains embedded white space. .RE .sp .ne 2 -.mk .na \fB\fB-T\fR \fIfile\fR\fR .ad .RS 17n -.rt Message-id and article-id header lines are recorded in \fIfile\fR after the message is read. This option also sets the \fB-I\fR option. .RE .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad .RS 17n -.rt Scan the input for \fBTo:\fR, \fBCc:\fR, and \fBBcc:\fR fields. Any recipients on the command line will be ignored. .RE .sp .ne 2 -.mk .na \fB\fB-U\fR\fR .ad .RS 17n -.rt Convert \fBUUCP-style\fR addresses to internet standards. Overrides the \fBconv\fR environment variable. .RE .sp .ne 2 -.mk .na \fB\fB-u\fR \fIuser\fR\fR .ad .RS 17n -.rt Read \fIuser\fR's \fBmailbox\fR. This is only effective if \fIuser\fR's \fBmailbox\fR is not read protected. .RE .sp .ne 2 -.mk .na \fB\fB-V\fR\fR .ad .RS 17n -.rt Print the \fBmailx\fR version number and exit. .RE .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 17n -.rt Pass the \fB-v\fR flag to \fBsendmail\fR(1M). .RE .sp .ne 2 -.mk .na \fB\fB-~\fR\fR .ad .RS 17n -.rt Interpret tilde escapes in the input even if not reading from a tty. .RE @@ -345,12 +299,10 @@ Interpret tilde escapes in the input even if not reading from a tty. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIrecipient\fR\fR .ad .RS 13n -.rt Addressee of message. .RE @@ -441,175 +393,143 @@ The default for \fImessage-list\fR is the current message. A \fImessage-list\fR is a list of message identifiers separated by spaces, which may include: .sp .ne 2 -.mk .na \fB\fIn\fR\fR .ad .RS 11n -.rt Message number \fIn\fR. .RE .sp .ne 2 -.mk .na \fB\fB\&.\fR\fR .ad .RS 11n -.rt The current message. .RE .sp .ne 2 -.mk .na \fB\fB^\fR\fR .ad .RS 11n -.rt The first undeleted message. .RE .sp .ne 2 -.mk .na \fB\fB$\fR\fR .ad .RS 11n -.rt The last message. .RE .sp .ne 2 -.mk .na \fB\fB*\fR\fR .ad .RS 11n -.rt All messages. .RE .sp .ne 2 -.mk .na \fB\fB+\fR\fR .ad .RS 11n -.rt The next undeleted message. .RE .sp .ne 2 -.mk .na \fB\fB\(mi\fR\fR .ad .RS 11n -.rt The previous undeleted message. .RE .sp .ne 2 -.mk .na \fB\fIn\fR\fB\(mi\fR\fIm\fR\fR .ad .RS 11n -.rt An inclusive range of message numbers. .RE .sp .ne 2 -.mk .na \fB\fIuser\fR\fR .ad .RS 11n -.rt All messages from \fIuser\fR. .RE .sp .ne 2 -.mk .na \fB\fI/string\fR\fR .ad .RS 11n -.rt All messages with \fIstring\fR in the Subject line (case ignored). .RE .sp .ne 2 -.mk .na \fB\fB:\fR\fIc\fR\fR .ad .RS 11n -.rt All messages of type \fIc\fR, where \fIc\fR is one of: .sp .ne 2 -.mk .na \fB\fBd\fR\fR .ad .RS 5n -.rt deleted messages .RE .sp .ne 2 -.mk .na \fB\fBn\fR\fR .ad .RS 5n -.rt new messages .RE .sp .ne 2 -.mk .na \fB\fBo\fR\fR .ad .RS 5n -.rt old messages .RE .sp .ne 2 -.mk .na \fB\fBr\fR\fR .ad .RS 5n -.rt read messages .RE .sp .ne 2 -.mk .na \fB\fBu\fR\fR .ad .RS 5n -.rt unread messages .RE @@ -668,7 +588,6 @@ message. If no command is specified in \fIcommand mode\fR, \fBn\fRext is assumed. The following is a complete list of \fBmailx\fR commands: .sp .ne 2 -.mk .na \fB\fB!\fR\fIshell-command\fR\fR .ad @@ -679,7 +598,6 @@ Escape to the shell. See \fBSHELL\fR in ENVIRONMENT VARIABLES. .sp .ne 2 -.mk .na \fB\fB#\fR \fIcomment\fR\fR .ad @@ -690,7 +608,6 @@ Escape to the shell. See \fBSHELL\fR in ENVIRONMENT VARIABLES. .sp .ne 2 -.mk .na \fB\fB=\fR\fR .ad @@ -701,7 +618,6 @@ Print the current message number. .sp .ne 2 -.mk .na \fB\fB?\fR\fR .ad @@ -712,7 +628,6 @@ Prints a summary of commands. .sp .ne 2 -.mk .na \fB\fBa\fRlias \fIalias name\fR .\|.\|.\fR .ad @@ -729,7 +644,6 @@ arguments, the command displays the list of defined aliases. .sp .ne 2 -.mk .na \fB\fBalt\fRernates \fIname .\|.\|.\fR\fR .ad @@ -743,7 +657,6 @@ arguments, print the current list of alternate names. See also \fBallnet\fR in .sp .ne 2 -.mk .na \fB\fBcd\fR [\fIdirectory\fR]\fR .ad @@ -758,7 +671,6 @@ Change directory. If \fIdirectory\fR is not specified, \fB$HOME\fR is used. .sp .ne 2 -.mk .na \fB\fBc\fRopy [\fIfile\fR]\fR .ad @@ -774,7 +686,6 @@ equivalent to the \fBs\fRave command. .sp .ne 2 -.mk .na \fB\fBC\fRopy [\fImessage-list\fR]\fR .ad @@ -787,7 +698,6 @@ equivalent to the \fBS\fRave command. .sp .ne 2 -.mk .na \fB\fBd\fRelete [\fImessage-list\fR]\fR .ad @@ -799,7 +709,6 @@ message after the last one deleted is printed (see \fBInternal Variables\fR). .sp .ne 2 -.mk .na \fB\fBdi\fRscard [\fIheader-field\fR.\|.\|.\|]\fR .ad @@ -820,7 +729,6 @@ current list of header fields being ignored is printed. See also the .sp .ne 2 -.mk .na \fB\fBdp\fR [\fImessage-list\fR]\fR .ad @@ -837,7 +745,6 @@ followed by a \fBp\fRrint command. .sp .ne 2 -.mk .na \fB\fBec\fRho \fIstring \fR.\|.\|.\fR .ad @@ -848,7 +755,6 @@ Echo the given strings (like \fBecho\fR(1)). .sp .ne 2 -.mk .na \fB\fBe\fRdit [\fImessage-list\fR]\fR .ad @@ -861,7 +767,6 @@ ENVIRONMENT VARIABLES). Default editor is \fBed\fR(1). .sp .ne 2 -.mk .na \fB\fBex\fRit\fR .ad @@ -877,7 +782,6 @@ saved in the \fBmbox\fR (see also \fBq\fRuit). .sp .ne 2 -.mk .na \fB\fBfie\fRld [\fImessage-list\fR] header-file\fR .ad @@ -888,7 +792,6 @@ Display the value of the header field in the specified message. .sp .ne 2 -.mk .na \fB\fBfi\fRle [\fIfile\fR]\fR .ad @@ -902,56 +805,46 @@ Quit from the current file of messages and read in the specified file. Several special characters are recognized when used as file names: .sp .ne 2 -.mk .na \fB\fB%\fR\fR .ad .RS 9n -.rt the current \fBmailbox\fR. .RE .sp .ne 2 -.mk .na \fB\fB%\fR\fIuser\fR\fR .ad .RS 9n -.rt the \fBmailbox\fR for \fIuser\fR. .RE .sp .ne 2 -.mk .na \fB\fB#\fR\fR .ad .RS 9n -.rt the previous mail file. .RE .sp .ne 2 -.mk .na \fB\fB&\fR\fR .ad .RS 9n -.rt the current \fBmbox\fR. .RE .sp .ne 2 -.mk .na \fB\fB+\fR\fIfile\fR\fR .ad .RS 9n -.rt The named file in the \fIfolder\fR directory (listed in the \fBfolder\fR variable). .RE @@ -962,7 +855,6 @@ messages and characters it contains. .sp .ne 2 -.mk .na \fB\fBfolders\fR\fR .ad @@ -974,7 +866,6 @@ Print the names of the files in the directory set by the \fBfolder\fR variable .sp .ne 2 -.mk .na \fB\fBFo\fRllowup [\fImessage\fR]\fR .ad @@ -990,7 +881,6 @@ the \fBreplyall\fR variable is set, the actions of \fBFo\fRllowup and .sp .ne 2 -.mk .na \fB\fBf\fRollowup [\fImessage-list\fR]\fR .ad @@ -1007,7 +897,6 @@ the \fBFo\fRllowup, \fBS\fRave, and \fBC\fRopy commands and \fBoutfolder\fR in .sp .ne 2 -.mk .na \fB\fBf\fRrom [\fImessage-list\fR]\fR .ad @@ -1019,7 +908,6 @@ specified, print the header summary for the current message. .sp .ne 2 -.mk .na \fB\fBg\fRroup \fIalias name \fR.\|.\|.\fR .ad @@ -1035,7 +923,6 @@ Declare an alias for the given names. The names are substituted when .sp .ne 2 -.mk .na \fB\fBh\fReaders [\fImessage\fR]\fR .ad @@ -1048,7 +935,6 @@ Variables\fR). See also the \fBz\fR command. .sp .ne 2 -.mk .na \fB\fBhel\fRp\fR .ad @@ -1059,7 +945,6 @@ Print a summary of commands. .sp .ne 2 -.mk .na \fB\fBho\fRld [\fImessage-list\fR]\fR .ad @@ -1074,7 +959,6 @@ Hold the specified messages in the \fBmailbox\fR. .sp .ne 2 -.mk .na \fB\fBi\fRf \fBs\fR | \fBr\fR | \fBt\fR\fR .ad @@ -1113,7 +997,6 @@ being run from a terminal. Useful in the \fBmailrc\fR file. .sp .ne 2 -.mk .na \fB\fBinc\fR\fR .ad @@ -1127,7 +1010,6 @@ messages are not renumbered. .sp .ne 2 -.mk .na \fB\fBig\fRnore [\fIheader-field \fR.\|.\|.\|]\fR .ad @@ -1147,7 +1029,6 @@ the \fBundi\fRscard and \fBunig\fRnore commands. .sp .ne 2 -.mk .na \fB\fBl\fRist\fR .ad @@ -1158,7 +1039,6 @@ Print all commands available. No explanation is given. .sp .ne 2 -.mk .na \fB\fBlo\fRad\fR .ad @@ -1171,7 +1051,6 @@ headers (as saved by the \fBs\fRave command). .sp .ne 2 -.mk .na \fB\fBm\fRail \fIrecipient \fR.\|.\|.\fR .ad @@ -1182,7 +1061,6 @@ Mail a message to the specified recipients. .sp .ne 2 -.mk .na \fB\fBM\fRail \fIrecipient\fR\fR .ad @@ -1196,7 +1074,6 @@ if set. See also the \fBSave\fR and \fBCopy\fR commands and \fBoutfolder\fR in .sp .ne 2 -.mk .na \fB\fBmb\fRox [\fImessage-list\fR]\fR .ad @@ -1210,7 +1087,6 @@ commands. .sp .ne 2 -.mk .na \fB\fBmo\fRre [\fImessage-list\fR]\fR .ad @@ -1230,7 +1106,6 @@ command specified by the \fBPAGER\fR variable. The default command is .sp .ne 2 -.mk .na \fB\fBMo\fRre [\fImessage-list\fR]\fR .ad @@ -1247,7 +1122,6 @@ Overrides suppression of fields by the \fBig\fRnore command. Same as the .sp .ne 2 -.mk .na \fB\fBne\fRw [\fImessage-list\fR]\fR .ad @@ -1271,7 +1145,6 @@ having been read. .sp .ne 2 -.mk .na \fB\fBn\fRext [\fImessage\fR]\fR .ad @@ -1288,7 +1161,6 @@ description of possible message specifications. .sp .ne 2 -.mk .na \fB\fBpi\fRpe [\fImessage-list\fR] [\fIshell-command\fR]\fR .ad @@ -1307,7 +1179,6 @@ message (see \fBInternal Variables\fR). .sp .ne 2 -.mk .na \fB\fBpre\fRserve [\fImessage-list\fR]\fR .ad @@ -1322,7 +1193,6 @@ Preserve the specified messages in the \fBmailbox\fR. .sp .ne 2 -.mk .na \fB\fBp\fRrint [\fImessage-list\fR]\fR .ad @@ -1342,7 +1212,6 @@ commands. .sp .ne 2 -.mk .na \fB\fBP\fRrint [\fImessage-list\fR]\fR .ad @@ -1359,7 +1228,6 @@ Overrides suppression of fields by the \fBig\fRnore command. Same as the .sp .ne 2 -.mk .na \fB\fBpu\fRt [\fIfile\fR]\fR .ad @@ -1375,7 +1243,6 @@ Save the specified message in the given file. Use the same conventions as the .sp .ne 2 -.mk .na \fB\fBPu\fRt [\fIfile\fR]\fR .ad @@ -1391,7 +1258,6 @@ by the \fBig\fRnore command. .sp .ne 2 -.mk .na \fB\fBq\fRuit\fR .ad @@ -1404,7 +1270,6 @@ file are deleted unless the \fBkeepsave\fR variable is set. .sp .ne 2 -.mk .na \fB\fBr\fReply [\fImessage-list\fR]\fR .ad @@ -1429,7 +1294,6 @@ message. See the \fBStarting Mail\fR section in USAGE above. .sp .ne 2 -.mk .na \fB\fBR\fReply [\fImessage\fR]\fR .ad @@ -1454,7 +1318,6 @@ Mail\fR section in USAGE above. .sp .ne 2 -.mk .na \fB\fBret\fRain\fR .ad @@ -1471,7 +1334,6 @@ arguments, it lists the current set of retained fields. .sp .ne 2 -.mk .na \fB\fBS\fRave [\fImessage-list\fR]\fR .ad @@ -1485,7 +1347,6 @@ and \fBF\fRollowup commands and \fBoutfolder\fR in \fBInternal Variables\fR. .sp .ne 2 -.mk .na \fB\fBs\fRave [\fIfile\fR]\fR .ad @@ -1503,7 +1364,6 @@ also \fBInternal Variables\fR and the \fBex\fRit and \fBq\fRuit commands). .sp .ne 2 -.mk .na \fB\fBse\fRt\fR .ad @@ -1534,7 +1394,6 @@ might have. See \fBInternal Variables\fR for a description of all predefined .sp .ne 2 -.mk .na \fB\fBsh\fRell\fR .ad @@ -1545,7 +1404,6 @@ Invoke an interactive shell. See also \fBSHELL\fR in ENVIRONMENT VARIABLES. .sp .ne 2 -.mk .na \fB\fBsi\fRze [\fImessage-list\fR]\fR .ad @@ -1556,7 +1414,6 @@ Print the size in characters of the specified messages. .sp .ne 2 -.mk .na \fB\fBso\fRurce \fIfile\fR\fR .ad @@ -1567,7 +1424,6 @@ Read commands from the given file and return to command mode. .sp .ne 2 -.mk .na \fB\fBto\fRp [\fImessage-list\fR]\fR .ad @@ -1580,7 +1436,6 @@ Variables\fR). The default is 5. .sp .ne 2 -.mk .na \fB\fBtou\fRch [\fImessage-list\fR]\fR .ad @@ -1594,7 +1449,6 @@ specified in the \fBMBOX\fR environment variable, upon normal termination. See .sp .ne 2 -.mk .na \fB\fBT\fRype [\fImessage-list\fR]\fR .ad @@ -1610,7 +1464,6 @@ Overrides suppression of fields by the \fBig\fRnore command. .sp .ne 2 -.mk .na \fB\fBt\fRype [\fImessage-list\fR]\fR .ad @@ -1628,7 +1481,6 @@ command specified by the \fBPAGER\fR variable. The default command is .sp .ne 2 -.mk .na \fB\fBuna\fRlias [\fBalias\fR] .\|.\|.\fR .ad @@ -1643,7 +1495,6 @@ Remove the definitions of the specified aliases. .sp .ne 2 -.mk .na \fB\fBu\fRndelete [\fImessage-list\fR]\fR .ad @@ -1656,7 +1507,6 @@ restored is printed (see \fBInternal Variables\fR). .sp .ne 2 -.mk .na \fB\fBundi\fRscard [\fIheader-field\fR\|.\|.\|.]\fR .ad @@ -1673,7 +1523,6 @@ ignored. .sp .ne 2 -.mk .na \fB\fBunret\fRain [\fIheader-field\fR\|.\|.\|.]\fR .ad @@ -1686,7 +1535,6 @@ retained. .sp .ne 2 -.mk .na \fB\fBunr\fRead [\fImessage-list\fR]\fR .ad @@ -1701,7 +1549,6 @@ retained. .sp .ne 2 -.mk .na \fB\fBuns\fRet \fIvariable\fR\|.\|.\|.\fR .ad @@ -1714,7 +1561,6 @@ cannot be unset from within \fBmailx\fR. .sp .ne 2 -.mk .na \fB\fBve\fRrsion\fR .ad @@ -1725,7 +1571,6 @@ Print the current version and release date of the \fBmailx\fR utility. .sp .ne 2 -.mk .na \fB\fBv\fRisual [\fImessage-list\fR]\fR .ad @@ -1739,7 +1584,6 @@ edit it (see ENVIRONMENT VARIABLES). Notice that the default visual editor is .sp .ne 2 -.mk .na \fB\fBw\fRrite [\fImessage-list\fR] \fBfile\fR\fR .ad @@ -1751,7 +1595,6 @@ blank line. Otherwise equivalent to the \fBs\fRave command. .sp .ne 2 -.mk .na \fB\fBx\fRit\fR .ad @@ -1767,7 +1610,6 @@ saved in the \fBmbox\fR (see also \fBq\fRuit). .sp .ne 2 -.mk .na \fB\fBz\fR[\fB+\fR\||\|\fB\(mi\fR]\fR .ad @@ -1788,29 +1630,24 @@ changing this special character. The escape character can be entered as text by typing it twice. .sp .ne 2 -.mk .na \fB\fB~\|!\fR\fIshell-command\fR\fR .ad .RS 23n -.rt Escape to the shell. If present, run \fIshell-command\fR. .RE .sp .ne 2 -.mk .na \fB\fB~.\fR\fR .ad .RS 23n -.rt Simulate end of file (terminate message input). .RE .sp .ne 2 -.mk .na \fB\fB~\|:\fR\fImail-command\fR\fR .ad @@ -1819,54 +1656,45 @@ Simulate end of file (terminate message input). \fB\fB~_\|\fR\fImail-command\fR\fR .ad .RS 23n -.rt Perform the command-level request. Valid only when sending a message while reading mail. .RE .sp .ne 2 -.mk .na \fB\fB~?\fR\fR .ad .RS 23n -.rt Print a summary of tilde escapes. .RE .sp .ne 2 -.mk .na \fB\fB~A\fR\fR .ad .RS 23n -.rt Insert the autograph string \fBSign\fR into the message (see \fBInternal Variables\fR). .RE .sp .ne 2 -.mk .na \fB\fB~a\fR\fR .ad .RS 23n -.rt Insert the autograph string \fBsign\fR into the message (see \fBInternal Variables\fR). .RE .sp .ne 2 -.mk .na \fB\fB~b\fR\fI name \|.\|.\|.\fR\fR .ad .RS 23n -.rt Add the \fIname\fRs to the blind carbon copy (\fBBcc\fR) list. This is like the carbon copy (\fBCc\fR) list, except that the names in the \fBBcc\fR list are not shown in the header of the mail message. @@ -1874,47 +1702,39 @@ not shown in the header of the mail message. .sp .ne 2 -.mk .na \fB\fB~c\fR\fI name \|.\|.\|.\fR\fR .ad .RS 23n -.rt Add the \fIname\fRs to the carbon copy (\fBCc\fR) list. .RE .sp .ne 2 -.mk .na \fB\fB~d\fR\fR .ad .RS 23n -.rt Read in the \fBdead-letter\fR file. See \fBDEAD\fR in ENVIRONMENT VARIABLES for a description of this file. .RE .sp .ne 2 -.mk .na \fB\fB~e\fR\fR .ad .RS 23n -.rt Invoke the editor on the partial message. See also \fBEDITOR\fR in ENVIRONMENT VARIABLES. .RE .sp .ne 2 -.mk .na \fB\fB~f\fR [\fImessage-list\fR]\fR .ad .RS 23n -.rt Forward the specified message, or the current message being read. Valid only when sending a message while reading mail. The messages are inserted into the message without alteration (as opposed to the \fB~m\fR escape). @@ -1922,24 +1742,20 @@ message without alteration (as opposed to the \fB~m\fR escape). .sp .ne 2 -.mk .na \fB\fB~F\fR [\fImessage-list\fR]\fR .ad .RS 23n -.rt Forward the specified message, or the current message being read, including all header fields. Overrides the suppression of fields by the \fBig\fRnore command. .RE .sp .ne 2 -.mk .na \fB\fB~h\fR\fR .ad .RS 23n -.rt Prompt for \fBSubject\fR line and \fBTo\fR, \fBCc\fR, and \fBBcc\fR lists. If the field is displayed with an initial value, it may be edited as if you had just typed it. @@ -1947,12 +1763,10 @@ just typed it. .sp .ne 2 -.mk .na \fB\fB~i\fR \fIvariable\fR\fR .ad .RS 23n -.rt Insert the value of the named variable into the text of the message. For example, \fB~A\fR is equivalent to `\fB~i Sign\fR.' Environment variables set and exported in the shell are also accessible by \fB~i\fR. @@ -1960,12 +1774,10 @@ and exported in the shell are also accessible by \fB~i\fR. .sp .ne 2 -.mk .na \fB\fB~m\fR [\fImessage-list\fR]\fR .ad .RS 23n -.rt Insert the listed messages, or the current message being read into the letter. Valid only when sending a message while reading mail. The text of the message is shifted to the right, and the string contained in the \fBindentprefix\fR @@ -1975,12 +1787,10 @@ variable is inserted as the leftmost characters of each line. If .sp .ne 2 -.mk .na \fB\fB~M\fR [\fImessage-list\fR]\fR .ad .RS 23n -.rt Insert the listed messages, or the current message being read, including the header fields, into the letter. Valid only when sending a message while reading mail. The text of the message is shifted to the right, and the string contained @@ -1991,23 +1801,19 @@ each line. Overrides the suppression of fields by the \fBig\fRnore command. .sp .ne 2 -.mk .na \fB\fB~p\fR\fR .ad .RS 23n -.rt Print the message being entered. .RE .sp .ne 2 -.mk .na \fB\fB~q\fR\fR .ad .RS 23n -.rt Quit from input mode by simulating an interrupt. If the body of the message is not null, the partial message is saved in \fBdead-letter\fR. See \fBDEAD\fR in ENVIRONMENT VARIABLES for a description of this file. @@ -2015,18 +1821,15 @@ ENVIRONMENT VARIABLES for a description of this file. .sp .ne 2 -.mk .na \fB\fB~R\fR\fR .ad .RS 23n -.rt Mark message for return receipt. .RE .sp .ne 2 -.mk .na \fB\fB~r\fR \fIfile\fR\fR .ad @@ -2039,7 +1842,6 @@ Mark message for return receipt. \fB\fB~< ! \fR\fIshell-command\fR\fR .ad .RS 23n -.rt Read in the specified file. If the argument begins with an exclamation point (!), the rest of the string is taken as an arbitrary shell command and is executed, with the standard output inserted into the message. @@ -2047,68 +1849,56 @@ executed, with the standard output inserted into the message. .sp .ne 2 -.mk .na \fB\fB~s\fR \fIstring \|.\|.\|.\fR\fR .ad .RS 23n -.rt Set the subject line to \fIstring\fR. .RE .sp .ne 2 -.mk .na \fB\fB~t\fR \fIname \|.\|.\|.\fR\fR .ad .RS 23n -.rt Add the given \fIname\fRs to the To list. .RE .sp .ne 2 -.mk .na \fB\fB~v\fR\fR .ad .RS 23n -.rt Invoke a preferred screen editor on the partial message. The default visual editor is \fBvi\fR(1). See also \fBVISUAL\fR in ENVIRONMENT VARIABLES. .RE .sp .ne 2 -.mk .na \fB\fB~w\fR \fIfile\fR\fR .ad .RS 23n -.rt Write the message into the given file, without the header. .RE .sp .ne 2 -.mk .na \fB\fB~x\fR\fR .ad .RS 23n -.rt Exit as with \fB~q\fR except the message is not saved in \fBdead-letter\fR. .RE .sp .ne 2 -.mk .na \fB\fB~|\fR \fIshell-command\fR\fR .ad .RS 23n -.rt Pipe the body of the message through the given \fIshell-command\fR. If the \fIshell-command\fR returns a successful exit status, the output of the command replaces the message. @@ -2122,12 +1912,10 @@ execution environment or set using the \fBse\fRt command at any time. The \fBuns\fRet command may be used to erase variables. .sp .ne 2 -.mk .na \fB\fBallnet\fR\fR .ad .RS 26n -.rt All network names whose last component (login name) match are treated as identical. This causes the \fImessage-list\fR message specifications to behave similarly. Disabled by default. See also the \fBalt\fRernates command and the @@ -2136,12 +1924,10 @@ similarly. Disabled by default. See also the \fBalt\fRernates command and the .sp .ne 2 -.mk .na \fB\fBalwaysignore\fR\fR .ad .RS 26n -.rt Ignore header fields with \fBig\fRnore everywhere, not just during \fBp\fRrint or \fBt\fRype. Affects the \fBs\fRave, \fBS\fRave, \fBc\fRopy, \fBC\fRopy, \fBto\fRp, \fBpi\fRpe, and \fBw\fRrite commands, and the \fB~m\fR and \fB~f\fR @@ -2150,12 +1936,10 @@ tilde escapes. Enabled by default. .sp .ne 2 -.mk .na \fB\fBappend\fR\fR .ad .RS 26n -.rt Upon termination, append messages to the end of the \fBmbox\fR file instead of prepending them. Although disabled by default, \fBappend\fR is set in the system startup file (which can be suppressed with the \fB-n\fR command line @@ -2164,12 +1948,10 @@ option). .sp .ne 2 -.mk .na \fB\fBappenddeadletter\fR\fR .ad .RS 26n -.rt Append to the deadletter file rather than overwrite it. Although disabled by default, \fBappenddeadletter\fR is frequently set in the system startup file. See \fBStarting Mail\fR in USAGE above. @@ -2177,48 +1959,40 @@ See \fBStarting Mail\fR in USAGE above. .sp .ne 2 -.mk .na \fB\fBaskbcc\fR\fR .ad .RS 26n -.rt Prompt for the \fBBcc\fR list after the \fBSubject\fR is entered if it is not specified on the command line with the \fB-b\fR option. Disabled by default. .RE .sp .ne 2 -.mk .na \fB\fBaskcc\fR\fR .ad .RS 26n -.rt Prompt for the \fBCc\fR list after the \fBSubject\fR is entered if it is not specified on the command line with the \fB-c\fR option. Disabled by default. .RE .sp .ne 2 -.mk .na \fB\fBasksub\fR\fR .ad .RS 26n -.rt Prompt for subject if it is not specified on the command line with the \fB-s\fR option. Enabled by default. .RE .sp .ne 2 -.mk .na \fB\fBautoinc\fR\fR .ad .RS 26n -.rt Automatically incorporate new messages into the current session as they arrive. This has an affect similar to issuing the \fBinc\fR command every time the command prompt is displayed. Disabled by default, but \fBautoinc\fR is set in @@ -2228,36 +2002,30 @@ the default system startup file for \fBmailx\fR; it is not set for .sp .ne 2 -.mk .na \fB\fBautoprint\fR\fR .ad .RS 26n -.rt Enable automatic printing of messages after \fBd\fRelete and \fBu\fRndelete commands. Disabled by default. .RE .sp .ne 2 -.mk .na \fB\fBbang\fR\fR .ad .RS 26n -.rt Enable the special-casing of exclamation points (!) in shell escape command lines as in \fBvi\fR(1). Disabled by default. .RE .sp .ne 2 -.mk .na \fB\fBbsdcompat\fR\fR .ad .RS 26n -.rt Set automatically if \fBmailx\fR is invoked as \fBmail\fR or \fBMail\fR. Causes \fBmailx\fR to use \fB/etc/mail/Mail.rc\fR as the system startup file. Changes the default pager to \fBmore\fR(1). @@ -2265,45 +2033,37 @@ the default pager to \fBmore\fR(1). .sp .ne 2 -.mk .na \fB\fBcmd=\fR\fIshell-command\fR\fR .ad .RS 26n -.rt Set the default command for the \fBpi\fRpe command. No default value. .RE .sp .ne 2 -.mk .na \fB\fBconv=\fR\fIconversion\fR\fR .ad .RS 26n -.rt Convert \fBuucp\fR addresses to the specified address style, which can be either: .sp .ne 2 -.mk .na \fB\fBinternet\fR\fR .ad .RS 12n -.rt This requires a mail delivery program conforming to the \fBRFC822\fR standard for electronic mail addressing. .RE .sp .ne 2 -.mk .na \fB\fBoptimize\fR\fR .ad .RS 12n -.rt Remove loops in \fBuucp\fR(1C) address paths (typically generated by the \fBr\fReply command). No rerouting is performed; \fBmail\fR has no knowledge of \fBUUCP\fR routes or connections. @@ -2315,12 +2075,10 @@ command-line option. .sp .ne 2 -.mk .na \fB\fBcrt\fR[\fB=\fR\fInumber\fR]\fR .ad .RS 26n -.rt Pipe messages having more than \fInumber\fR lines through the command specified by the value of the \fBPAGER\fR variable ( \fBpg\fR(1) or \fBmore\fR(1) by default). If \fInumber\fR is not specified, the current window size is used. @@ -2329,24 +2087,20 @@ Disabled by default. .sp .ne 2 -.mk .na \fB\fBdebug\fR\fR .ad .RS 26n -.rt Enable verbose diagnostics for debugging. Messages are not delivered. Disabled by default. .RE .sp .ne 2 -.mk .na \fB\fBdot\fR\fR .ad .RS 26n -.rt Take a period on a line by itself, or \fBEOF\fR during input from a terminal as end-of-file. Disabled by default, but \fBdot\fR is set in the system startup file (which can be suppressed with the \fB-n\fR command line option). @@ -2354,12 +2108,10 @@ file (which can be suppressed with the \fB-n\fR command line option). .sp .ne 2 -.mk .na \fB\fBfcc\fR\fR .ad .RS 26n -.rt By default, \fBmailx\fR will treat any address containing a slash ("/") character as a local "send to file" address. By unsetting this option, this behavior is disabled. Enabled by default. @@ -2367,12 +2119,10 @@ behavior is disabled. Enabled by default. .sp .ne 2 -.mk .na \fB\fBflipr\fR\fR .ad .RS 26n -.rt Reverse the effect of the \fBfo\fRllowup/\fBFo\fRllowup and \fBr\fReply/\fBR\fReply command pairs. If both \fBflipr\fR and \fBreplyall\fR are set, the effect is as if neither was set. @@ -2380,24 +2130,20 @@ are set, the effect is as if neither was set. .sp .ne 2 -.mk .na \fB\fBfrom\fR\fR .ad .RS 26n -.rt Extract the author listed in the header summary from the \fBFrom:\fR header instead of the UNIX \fBFrom\fR line. Enabled by default. .RE .sp .ne 2 -.mk .na \fB\fBfuzzymatch\fR\fR .ad .RS 26n -.rt The \fBfrom\fR command searches for messages from the indicated sender. By default, the full sender address must be specified. By setting this option, only a sub-string of the sender address need be specified. Disabled by default. @@ -2405,24 +2151,20 @@ only a sub-string of the sender address need be specified. Disabled by default. .sp .ne 2 -.mk .na \fB\fBescape=\fR\fIc\fR\fR .ad .RS 26n -.rt Substitute \fIc\fR for the ~ escape character. Takes effect with next message sent. .RE .sp .ne 2 -.mk .na \fB\fBfolder=\fR\fIdirectory\fR\fR .ad .RS 26n -.rt The directory for saving standard mail files. User-specified file names beginning with a plus (+) are expanded by preceding the file name with this directory name to obtain the real file name. If \fIdirectory\fR does not start @@ -2432,48 +2174,40 @@ with a slash (/), \fB$HOME\fR is prepended to it. There is no default for the .sp .ne 2 -.mk .na \fB\fBheader\fR\fR .ad .RS 26n -.rt Enable printing of the header summary when entering \fBmailx\fR. Enabled by default. .RE .sp .ne 2 -.mk .na \fB\fBhold\fR\fR .ad .RS 26n -.rt Preserve all messages that are read in the \fBmailbox\fR instead of putting them in the standard \fBmbox\fR save file. Disabled by default. .RE .sp .ne 2 -.mk .na \fB\fBignore\fR\fR .ad .RS 26n -.rt Ignore interrupts while entering messages. Handy for noisy dial-up lines. Disabled by default. .RE .sp .ne 2 -.mk .na \fB\fBignoreeof\fR\fR .ad .RS 26n -.rt Ignore end-of-file during message input. Input must be terminated by a period (.) on a line by itself or by the \fB~.\fR command. See also \fBdot\fR above. Disabled by default. @@ -2481,60 +2215,50 @@ Disabled by default. .sp .ne 2 -.mk .na \fB\fBindentprefix=\fR\fIstring\fR\fR .ad .RS 26n -.rt When \fBindentprefix\fR is set, \fIstring\fR is used to mark indented lines from messages included with \fB~m\fR. The default is a TAB character. .RE .sp .ne 2 -.mk .na \fB\fBkeep\fR\fR .ad .RS 26n -.rt When the \fBmailbox\fR is empty, truncate it to zero length instead of removing it. Disabled by default. .RE .sp .ne 2 -.mk .na \fB\fBiprompt=\fR\fIstring\fR\fR .ad .RS 26n -.rt The specified prompt string is displayed before each line on input is requested when sending a message. .RE .sp .ne 2 -.mk .na \fB\fBkeepsave\fR\fR .ad .RS 26n -.rt Keep messages that have been saved in other files in the \fBmailbox\fR instead of deleting them. Disabled by default. .RE .sp .ne 2 -.mk .na \fB\fBmakeremote\fR\fR .ad .RS 26n -.rt When replying to all recipients of a message, if an address does not include a machine name, it is assumed to be relative to the sender of the message. Normally not needed when dealing with hosts that support RFC822. @@ -2542,35 +2266,29 @@ Normally not needed when dealing with hosts that support RFC822. .sp .ne 2 -.mk .na \fB\fBmetoo\fR\fR .ad .RS 26n -.rt If your login appears as a recipient, do not delete it from the list. Disabled by default. .RE .sp .ne 2 -.mk .na \fB\fBmustbang\fR\fR .ad .RS 26n -.rt Force all mail addresses to be in bang format. .RE .sp .ne 2 -.mk .na \fB\fBonehop\fR\fR .ad .RS 26n -.rt When responding to a message that was originally sent to several recipients, the other recipient addresses are normally forced to be relative to the originating author's machine for the response. This flag disables alteration of @@ -2581,12 +2299,10 @@ default. .sp .ne 2 -.mk .na \fB\fBoutfolder\fR\fR .ad .RS 26n -.rt Locate the files used to record outgoing messages in the directory specified by the \fBfolder\fR variable unless the path name is absolute. Disabled by default. See \fBfolder\fR above and the \fBS\fRave, \fBC\fRopy, \fBfo\fRllowup, @@ -2595,24 +2311,20 @@ and \fBF\fRollowup commands. .sp .ne 2 -.mk .na \fB\fBpage\fR\fR .ad .RS 26n -.rt Used with the \fBpi\fRpe command to insert a form feed after each message sent through the pipe. Disabled by default. .RE .sp .ne 2 -.mk .na \fB\fBpipeignore\fR\fR .ad .RS 26n -.rt Omit ignored header when outputting to the \fBpipe\fR command. Although disabled by default, \fBpipeignore\fR is frequently set in the system startup file. See \fBStarting Mail\fR in USAGE above. @@ -2620,12 +2332,10 @@ file. See \fBStarting Mail\fR in USAGE above. .sp .ne 2 -.mk .na \fB\fBpostmark\fR\fR .ad .RS 26n -.rt Your "real name" to be included in the From line of messages you send. By default this is derived from the comment field in your \fBpasswd\fR(4) file entry. @@ -2633,48 +2343,40 @@ entry. .sp .ne 2 -.mk .na \fB\fBprompt=\fR\fIstring\fR\fR .ad .RS 26n -.rt Set the \fIcommand mode\fR prompt to \fIstring\fR. Default is "\fB? \fR", unless the \fBbsdcompat\fR variable is set, then the default is "\fB&\fR". .RE .sp .ne 2 -.mk .na \fB\fBquiet\fR\fR .ad .RS 26n -.rt Refrain from printing the opening message and version when entering \fBmailx\fR. Disabled by default. .RE .sp .ne 2 -.mk .na \fB\fBrecord=\fR\fIfile\fR\fR .ad .RS 26n -.rt Record all outgoing mail in \fIfile\fR. Disabled by default. See also \fBoutfolder\fR above. .RE .sp .ne 2 -.mk .na \fB\fBreplyall\fR\fR .ad .RS 26n -.rt Reverse the effect of the \fBr\fReply and \fBR\fReply and \fBfo\fRllowup and \fBFo\fRllowup commands. Although set by default, \fBreplayall\fR is frequently unset in the system startup file. See \fBflipr\fR and \fBStarting @@ -2683,36 +2385,30 @@ Mail\fR in USAGE above. .sp .ne 2 -.mk .na \fB\fBreturnaddr=\fR\fIstring\fR\fR .ad .RS 26n -.rt The default sender address is that of the current user. This variable can be used to set the sender address to any arbitrary value. Set with caution. .RE .sp .ne 2 -.mk .na \fB\fBsave\fR\fR .ad .RS 26n -.rt Enable saving of messages in \fBdead-letter\fR on interrupt or delivery error. See \fBDEAD\fR for a description of this file. Enabled by default. .RE .sp .ne 2 -.mk .na \fB\fBscreen=\fR\fInumber\fR\fR .ad .RS 26n -.rt Sets the number of lines in a screen-full of headers for the \fBh\fReaders command. \fInumber\fR must be a positive number. .sp @@ -2725,12 +2421,10 @@ defaults to the default window size minus 4. Otherwise, the default is .sp .ne 2 -.mk .na \fB\fBsendmail=\fR\fIshell-command\fR\fR .ad .RS 26n -.rt Alternate command for delivering messages. \fBNote:\fR In addition to the expected list of recipients, \fBmail\fR also passes the \fB-i\fR and \fB-m\fR, flags to the command. Since these flags are not appropriate to other commands, @@ -2740,23 +2434,19 @@ before invoking the desired command. Default is \fB/usr/bin/rmail\fR. .sp .ne 2 -.mk .na \fB\fBsendwait\fR\fR .ad .RS 26n -.rt Wait for background mailer to finish before returning. Disabled by default. .RE .sp .ne 2 -.mk .na \fB\fBshowname\fR\fR .ad .RS 26n -.rt Causes the message header display to show the sender's real name (if known) rather than their mail address. Disabled by default, but \fBshowname\fR is set in the \fB/etc/mail/mailx.rc\fR system startup file for \fBmailx\fR. @@ -2764,24 +2454,20 @@ in the \fB/etc/mail/mailx.rc\fR system startup file for \fBmailx\fR. .sp .ne 2 -.mk .na \fB\fBshowto\fR\fR .ad .RS 26n -.rt When displaying the header summary and the message is from you, print the recipient's name instead of the author's name. .RE .sp .ne 2 -.mk .na \fB\fBsign=\fR\fIstring\fR\fR .ad .RS 26n -.rt The variable inserted into the text of a message when the \fB~a\fR (autograph) command is given. No default (see also \fB~i\fR in \fBTilde Escapes\fR). .sp @@ -2790,47 +2476,39 @@ command is given. No default (see also \fB~i\fR in \fBTilde Escapes\fR). .sp .ne 2 -.mk .na \fB\fBSign=\fR\fIstring\fR\fR .ad .RS 26n -.rt The variable inserted into the text of a message when the \fB~A\fR command is given. No default (see also \fB~i\fR in \fBTilde Escapes\fR). .RE .sp .ne 2 -.mk .na \fB\fBtoplines=\fR\fInumber\fR\fR .ad .RS 26n -.rt The number of lines of header to print with the \fBto\fRp command. Default is \fB5\fR. .RE .sp .ne 2 -.mk .na \fB\fBverbose\fR\fR .ad .RS 26n -.rt Invoke \fBsendmail\fR(1M) with the \fB-v\fR flag. .RE .sp .ne 2 -.mk .na \fB\fBtranslate\fR\fR .ad .RS 26n -.rt The name of a program to translate mail addresses. The program receives mail addresses as arguments. The program produces, on the standard output, lines containing the following data, in this order: @@ -2874,95 +2552,79 @@ that affect the execution of \fBmailx\fR: \fBHOME\fR, \fBLANG\fR, \fBTERM\fR. .sp .ne 2 -.mk .na \fB\fBDEAD\fR\fR .ad .RS 14n -.rt The name of the file in which to save partial letters in case of untimely interrupt. Default is \fB$HOME/dead.letter\fR. .RE .sp .ne 2 -.mk .na \fB\fBEDITOR\fR\fR .ad .RS 14n -.rt The command to run when the \fBe\fRdit or \fB~e\fR command is used. Default is \fBed\fR(1). .RE .sp .ne 2 -.mk .na \fB\fBLISTER\fR\fR .ad .RS 14n -.rt The command (and options) to use when listing the contents of the \fBfolder\fR directory. The default is \fBls\fR(1). .RE .sp .ne 2 -.mk .na \fB\fBMAIL\fR\fR .ad .RS 14n -.rt The name of the initial mailbox file to read (in lieu of the standard system mailbox). The default is \fB/var/mail/\fIusername\fR .\fR .RE .sp .ne 2 -.mk .na \fB\fBMAILRC\fR\fR .ad .RS 14n -.rt The name of the startup file. Default is \fB$HOME/.mailrc\fR. .RE .sp .ne 2 -.mk .na \fB\fBMAILX_HEAD\fR\fR .ad .RS 14n -.rt The specified string is included at the beginning of the body of each message that is sent. .RE .sp .ne 2 -.mk .na \fB\fBMAILX_TAIL\fR\fR .ad .RS 14n -.rt The specified string is included at the end of the body of each message that is sent. .RE .sp .ne 2 -.mk .na \fB\fBMBOX\fR\fR .ad .RS 14n -.rt The name of the file to save messages which have been read. The \fBex\fRit command overrides this function, as does saving the message explicitly in another file. Default is \fB$HOME/mbox\fR. @@ -2970,12 +2632,10 @@ another file. Default is \fB$HOME/mbox\fR. .sp .ne 2 -.mk .na \fB\fBPAGER\fR\fR .ad .RS 14n -.rt The command to use as a filter for paginating output. This can also be used to specify the options to be used. Default is \fBpg\fR(1), or if the \fBbsdcompat\fR variable is set, the default is \fBmore\fR(1). See \fBInternal @@ -2984,23 +2644,19 @@ Variables\fR. .sp .ne 2 -.mk .na \fB\fBSHELL\fR\fR .ad .RS 14n -.rt The name of a preferred command interpreter. Default is \fBsh\fR(1). .RE .sp .ne 2 -.mk .na \fB\fBVISUAL\fR\fR .ad .RS 14n -.rt The name of a preferred screen editor. Default is \fBvi\fR(1). .RE @@ -3010,23 +2666,19 @@ The name of a preferred screen editor. Default is \fBvi\fR(1). When the \fB-e\fR option is specified, the following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Mail was found. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt Mail was not found or an error occurred. .RE @@ -3035,12 +2687,10 @@ Mail was not found or an error occurred. Otherwise, the following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. Notice that this status implies that all messages were \fBsent\fR, but it gives no assurances that any of them were actually \fBdelivered\fR. @@ -3048,19 +2698,16 @@ Successful completion. Notice that this status implies that all messages were .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB$HOME/.mailrc\fR\fR .ad @@ -3071,7 +2718,6 @@ An error occurred .sp .ne 2 -.mk .na \fB\fB$HOME/mbox\fR\fR .ad @@ -3082,7 +2728,6 @@ secondary storage file .sp .ne 2 -.mk .na \fB\fB$HOME/.Maillock\fR\fR .ad @@ -3093,7 +2738,6 @@ lock file to prevent multiple writers of system mailbox .sp .ne 2 -.mk .na \fB\fB/etc/mail/mailx.rc\fR\fR .ad @@ -3104,7 +2748,6 @@ optional system startup file for \fBmailx\fR only .sp .ne 2 -.mk .na \fB\fB/etc/mail/Mail.rc\fR\fR .ad @@ -3116,7 +2759,6 @@ BSD compatibility system-wide startup file for \fB/usr/ucb/mail\fR and .sp .ne 2 -.mk .na \fB\fB/tmp/R[emqsx]*\fR\fR .ad @@ -3127,7 +2769,6 @@ temporary files .sp .ne 2 -.mk .na \fB\fB/usr/share/lib/mailx/mailx.help*\fR\fR .ad @@ -3138,7 +2779,6 @@ help message files .sp .ne 2 -.mk .na \fB\fB/var/mail/*\fR\fR .ad @@ -3155,13 +2795,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man1/makekey.1 b/usr/src/man/man1/makekey.1 index 8b790dfb43..d7d30b2e03 100644 --- a/usr/src/man/man1/makekey.1 +++ b/usr/src/man/man1/makekey.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 makekey 1 "3 Mar 2008" "SunOS 5.11" "User Commands" +.TH MAKEKEY 1 "Mar 3, 2008" .SH NAME makekey \- generate encryption key .SH SYNOPSIS diff --git a/usr/src/man/man1/man.1 b/usr/src/man/man1/man.1 index 8b63971549..ca20dd7b3b 100644 --- a/usr/src/man/man1/man.1 +++ b/usr/src/man/man1/man.1 @@ -1,7 +1,7 @@ '\" te .\" Copyright (c) 2008, Sun Microsystems, Inc. All Rights Reserved. .\" Copyright (c) 1980 Regents of the University of California. The Berkeley software License Agreement specifies the terms and conditions for redistribution. -.TH man 1 "8 May 2008" "SunOS 5.11" "User Commands" +.TH MAN 1 "May 8, 2008" .SH NAME man \- find and display reference manual pages .SH SYNOPSIS @@ -67,36 +67,30 @@ output through \fBmore\fR(1) to handle paging and underlining on the screen. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 20n -.rt Shows all manual pages matching \fIname\fR within the \fBMANPATH\fR search path. Manual pages are displayed in the order found. .RE .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad .RS 20n -.rt Debugs. Displays what a section-specifier evaluates to, method used for searching, and paths searched by \fBman\fR. .RE .sp .ne 2 -.mk .na \fB\fB-f\fR \fIfile ...\fR\fR .ad .RS 20n -.rt \fBman\fR attempts to locate manual pages related to any of the given \fIfile\fRs. It strips the leading path name components from each \fIfile\fR, and then prints one-line summaries containing the resulting basename or names. @@ -105,12 +99,10 @@ This option also uses the \fBwindex\fR database. .sp .ne 2 -.mk .na \fB\fB-F\fR\fR .ad .RS 20n -.rt Forces \fBman\fR to search all directories specified by \fBMANPATH\fR or the \fBman.cf\fR file, rather than using the \fBwindex\fR lookup database. This option is useful if the database is not up to date and it has been made the @@ -120,12 +112,10 @@ to be invoked and is documented here for reference only. .sp .ne 2 -.mk .na \fB\fB-k\fR \fIkeyword ...\fR\fR .ad .RS 20n -.rt Prints out one-line summaries from the \fBwindex\fR database (table of contents) that contain any of the given \fIkeyword\fRs. The \fBwindex\fR database is created using \fBcatman\fR(1M). @@ -133,23 +123,19 @@ database is created using \fBcatman\fR(1M). .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 20n -.rt Lists all manual pages found matching \fIname\fR within the search path. .RE .sp .ne 2 -.mk .na \fB\fB-M\fR \fIpath\fR\fR .ad .RS 20n -.rt Specifies an alternate search path for manual pages. \fIpath\fR is a colon-separated list of directories that contain manual page directory subtrees. For example, if \fIpath\fR is \fB/usr/share/man:/usr/local/man\fR, @@ -162,24 +148,20 @@ section. This option overrides the \fBMANPATH\fR environment variable. .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 20n -.rt Reformats the manual page, but does not display it. This replaces the \fBman\fR \fB-\fR \fB-t\fR \fIname\fR combination. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR \fIsection ...\fR\fR .ad .RS 20n -.rt Specifies sections of the manual for \fBman\fR to search. The directories searched for \fIname\fR are limited to those specified by \fIsection\fR. \fIsection\fR can be a numerical digit, perhaps followed by one or more letters @@ -193,12 +175,10 @@ below for an explanation of how \fBman\fR conducts its search. .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad .RS 20n -.rt \fBman\fR arranges for the specified manual pages to be \fBtroff\fRed to a suitable raster output device (see \fBtroff\fR(1)). If both the \fB-\fR and \fB-t\fR flags are given, \fBman\fR updates the \fBtroff\fRed versions of each @@ -207,12 +187,10 @@ named \fIname\fR (if necessary), but does not display them. .sp .ne 2 -.mk .na \fB\fB-T\fR \fImacro-package\fR\fR .ad .RS 20n -.rt Formats manual pages using \fImacro-package\fR rather than the standard \fB-man\fR macros defined in \fB/usr/share/lib/tmac/an\fR. See \fBSearch Path\fR under USAGE for a complete explanation of the default search path @@ -225,12 +203,10 @@ order. The following operand is supported: .sp .ne 2 -.mk .na \fB\fIname\fR\fR .ad .RS 8n -.rt The name of a standard utility or a keyword. .RE @@ -298,7 +274,7 @@ The \fBman.cf\fR file has the following format: .sp .in +2 .nf -MANSECTS=\fIsection\fR[,\fIsection\fR]... +MANSECTS=\fIsection\fR[,\fIsection\fR]... .fi .in -2 .sp @@ -337,45 +313,37 @@ any combination of characters in the following list, \fBman\fR pipes its input to \fBtroff\fR(1) or \fBnroff\fR(1) through the corresponding preprocessors. .sp .ne 2 -.mk .na \fB\fBe\fR\fR .ad .RS 5n -.rt \fBeqn\fR(1), or \fBneqn\fR for \fBnroff\fR .RE .sp .ne 2 -.mk .na \fB\fBr\fR\fR .ad .RS 5n -.rt \fBrefer\fR(1) .RE .sp .ne 2 -.mk .na \fB\fBt\fR\fR .ad .RS 5n -.rt \fBtbl\fR(1) .RE .sp .ne 2 -.mk .na \fB\fBv\fR\fR .ad .RS 5n -.rt \fBvgrind\fR(1) .RE @@ -424,12 +392,10 @@ that affect the execution of \fBman\fR: \fBLANG\fR, \fBLC_ALL\fR, \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and \fBNLSPATH\fR. .sp .ne 2 -.mk .na \fB\fBMANPATH\fR\fR .ad .RS 11n -.rt A colon-separated list of directories; each directory can be followed by a comma-separated list of sections. If set, its value overrides \fB/usr/share/man\fR as the default directory search path, and the \fBman.cf\fR @@ -439,35 +405,29 @@ turn, override these values.) .sp .ne 2 -.mk .na \fB\fBPAGER\fR\fR .ad .RS 11n -.rt A program to use for interactively delivering \fBman\fR's output to the screen. If not set, `\fBmore\fR \fB-s\fR' is used. See \fBmore\fR(1). .RE .sp .ne 2 -.mk .na \fB\fBTCAT\fR\fR .ad .RS 11n -.rt The name of the program to use to display \fBtroff\fRed manual pages. .RE .sp .ne 2 -.mk .na \fB\fBTROFF\fR\fR .ad .RS 11n -.rt The name of the formatter to use when the \fB-t\fR flag is given. If not set, \fBtroff\fR(1) is used. .RE @@ -519,30 +479,25 @@ the default printer, if the user wants a text file version of the man page. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB/usr/share/man\fR\fR .ad @@ -553,7 +508,6 @@ Root of the standard manual page directory subtree .sp .ne 2 -.mk .na \fB\fB/usr/share/man/man?/*\fR\fR .ad @@ -564,7 +518,6 @@ Unformatted nroff manual entries .sp .ne 2 -.mk .na \fB\fB/usr/share/man/sman?/*\fR\fR .ad @@ -575,7 +528,6 @@ Unformatted \fBSGML\fR manual entries .sp .ne 2 -.mk .na \fB\fB/usr/share/man/cat?/*\fR\fR .ad @@ -586,7 +538,6 @@ Unformatted \fBSGML\fR manual entries .sp .ne 2 -.mk .na \fB\fB/usr/share/man/fmt?/*\fR\fR .ad @@ -597,7 +548,6 @@ Unformatted \fBSGML\fR manual entries .sp .ne 2 -.mk .na \fB\fB/usr/share/man/windex\fR\fR .ad @@ -608,7 +558,6 @@ Table of contents and keyword database .sp .ne 2 -.mk .na \fB\fB/usr/share/lib/tmac/an\fR\fR .ad @@ -619,7 +568,6 @@ Standard \fB-man\fR macro package .sp .ne 2 -.mk .na \fB\fB/usr/share/lib/sgml/locale/C/dtd/*\fR\fR .ad @@ -630,7 +578,6 @@ Standard \fB-man\fR macro package .sp .ne 2 -.mk .na \fB\fB/usr/share/lib/sgml/locale/C/solbook/*\fR\fR .ad @@ -641,7 +588,6 @@ Standard \fB-man\fR macro package .sp .ne 2 -.mk .na \fB\fB/usr/share/lib/pub/eqnchar\fR\fR .ad @@ -652,7 +598,6 @@ Standard definitions for \fBeqn\fR and \fBneqn\fR .sp .ne 2 -.mk .na \fB\fBman.cf\fR\fR .ad @@ -669,17 +614,16 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled, see \fBNOTES\fR. +CSI Enabled, see \fBNOTES\fR. _ -Interface StabilityCommitted +Interface Stability Committed _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .SH SEE ALSO diff --git a/usr/src/man/man1/mconnect.1 b/usr/src/man/man1/mconnect.1 index 2e0741e9fd..3e9a1eedf5 100644 --- a/usr/src/man/man1/mconnect.1 +++ b/usr/src/man/man1/mconnect.1 @@ -1,9 +1,9 @@ '\" te -.\" Copyright (C) 2008, Sun Microsystems, Inc. All Rights Reserved +.\" Copyright (C) 2008, 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 mconnect 1 "28 Jan 2008" "SunOS 5.11" "User Commands" +.TH MCONNECT 1 "Jan 28, 2008" .SH NAME mconnect \- connect to SMTP mail server socket .SH SYNOPSIS @@ -27,24 +27,20 @@ server. An interrupt closes the connection immediately and exits. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-p\fR\fIport\fR\fR .ad .RS 10n -.rt Specify the port number instead of the default \fBSMTP\fR port (number 25) as the next argument. .RE .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 10n -.rt \fBRaw\fR mode: disable the default line buffering and input handling. This produces an effect similar to \fBtelnet\fR(1) to port number 25. .RE @@ -55,12 +51,10 @@ produces an effect similar to \fBtelnet\fR(1) to port number 25. The following operand is supported: .sp .ne 2 -.mk .na \fB\fIhostname\fR\fR .ad .RS 12n -.rt The name of a given host. .RE @@ -71,12 +65,10 @@ The \fBmconnect\fR command is IPv6-enabled. See \fBip6\fR(7P). .SH FILES .sp .ne 2 -.mk .na \fB\fB/etc/mail/sendmail.hf\fR\fR .ad .RS 25n -.rt Help file for \fBSMTP\fR commands .RE diff --git a/usr/src/man/man1/mcs.1 b/usr/src/man/man1/mcs.1 index 7aba774098..a5505c2340 100644 --- a/usr/src/man/man1/mcs.1 +++ b/usr/src/man/man1/mcs.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 mcs 1 "5 Oct 2007" "SunOS 5.11" "User Commands" +.TH MCS 1 "Oct 5, 2007" .SH NAME mcs \- manipulate the comment section of an object file .SH SYNOPSIS @@ -44,24 +44,20 @@ that name before performing the specified operation. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-a\fR \fIstring\fR\fR .ad .RS 13n -.rt Appends \fIstring\fR to the comment section of the \fBELF\fR object files. If \fIstring\fR contains embedded blanks, it must be enclosed in quotation marks. .RE .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad .RS 13n -.rt Compresses the contents of the comment section of the \fBELF\fR object files. All duplicate entries are removed. The ordering of the remaining entries is not disturbed. @@ -69,24 +65,20 @@ disturbed. .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad .RS 13n -.rt Deletes the contents of the specified section from the \fBELF\fR object files. The section header for the comment section is also removed. .RE .sp .ne 2 -.mk .na \fB\fB-n\fR \fIname\fR\fR .ad .RS 13n -.rt Specifies the name of the section to access if other than \fB\&.comment\fR. By default, \fBmcs\fR deals with the section named \fB\&.comment\fR. This option can be used to specify another section. \fBmcs\fR can take multiple \fB-n\fR @@ -95,12 +87,10 @@ options to allow for specification of multiple sections. .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 13n -.rt Prints the contents of the comment section on the standard output. Each section printed is tagged by the name of the file from which it was extracted, using the format \fIfile\fR\fB[\fR\fImember_name\fR\fB]:\fR for archive files and @@ -109,23 +99,19 @@ the format \fIfile\fR\fB[\fR\fImember_name\fR\fB]:\fR for archive files and .sp .ne 2 -.mk .na \fB\fB-V\fR\fR .ad .RS 13n -.rt Prints on standard error the version number of \fBmcs\fR. .RE .sp .ne 2 -.mk .na \fB\fB-z\fR\fR .ad .RS 13n -.rt Replaces any \fBSHT_PROGBITS\fR sections with zeros while retaining the original attributes of the sections. .RE @@ -191,12 +177,10 @@ removes the section named \fB\&.annotate\fR from the file \fBelf.file\fR. .SH FILES .sp .ne 2 -.mk .na \fB\fB/tmp/mcs*\fR\fR .ad .RS 13n -.rt temporary files .RE @@ -208,13 +192,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStable +Interface Stability Stable .TE .SH SEE ALSO diff --git a/usr/src/man/man1/mdb.1 b/usr/src/man/man1/mdb.1 index 380c868add..a64d145527 100644 --- a/usr/src/man/man1/mdb.1 +++ b/usr/src/man/man1/mdb.1 @@ -3,14 +3,14 @@ .\" 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 "30 Nov 2005" "SunOS 5.11" "User Commands" +.TH MDB 1 "Nov 30, 2005" .SH NAME mdb \- modular debugger .SH SYNOPSIS .LP .nf -\fBmdb\fR [\fB-fkmuwyAFKMSUW\fR] [\(+-o \fIoption\fR] [\fB-p\fR \fIpid\fR] [\fB-s\fR \fIdistance\fR] - [\fB-I\fR \fIpath\fR] [\fB-L\fR \fIpath\fR] [\fB-P\fR \fIprompt\fR] [\fB-R\fR \fIroot\fR] +\fBmdb\fR [\fB-fkmuwyAFKMSUW\fR] [\(+-o \fIoption\fR] [\fB-p\fR \fIpid\fR] [\fB-s\fR \fIdistance\fR] + [\fB-I\fR \fIpath\fR] [\fB-L\fR \fIpath\fR] [\fB-P\fR \fIprompt\fR] [\fB-R\fR \fIroot\fR] [\fB-V\fR \fIdis-version\fR] [object [core] | core | suffix] .fi @@ -107,7 +107,7 @@ A \fImetacharacter\fR is one of the following characters: .sp .in +2 .nf -[ ] | ! / \e ? = > $ : ; +[ ] | ! / \e ? = > $ : ; \fINEWLINE\fR \fISPACE\fR \fITAB\fR .fi .in -2 @@ -169,7 +169,6 @@ described under \fBArithmetic Expansion\fR below. A \fIcommand\fR is one of the following: .sp .ne 2 -.mk .na \fB\fIpipeline\fR [\fB!\fR \fIword\fR .\|.\|.] [ \fB;\fR ]\fR .ad @@ -185,7 +184,6 @@ details, refer to \fBShell Escapes\fR below. .sp .ne 2 -.mk .na \fB\fIexpression\fR \fI pipeline\fR [\fB!\fR \fIword\fR .\|.\|.] [ \fB;\fR ]\fR .ad @@ -198,7 +196,6 @@ execution of the pipeline, the value of dot (the variable denoted by .sp .ne 2 -.mk .na \fB\fIexpression\fR\fB ,\fR \fIexpression\fR \fIpipeline \fR [\fB!\fR \fIword\fR .\|.\|.] [ \fB;\fR ]\fR @@ -214,7 +211,6 @@ The repeat count only applies to the first dcmd in the pipeline. .sp .ne 2 -.mk .na \fB\fB,\fR \fIexpression\fR \fIpipeline\fR [\fB!\fR \fIword\fR .\|.\|.] [ \fB;\fR ]\fR @@ -227,7 +223,6 @@ the pipeline is repeated according to the value of the expression. .sp .ne 2 -.mk .na \fB\fIexpression\fR [\fB!\fR \fIword\fR .\|.\|.] [ \fB;\fR ]\fR .ad @@ -240,7 +235,6 @@ and arguments are executed using the new value of dot. .sp .ne 2 -.mk .na \fB\fIexpression\fR\fB,\fR \fIexpression\fR [\fB!\fR \fI word\fR .\|.\|.] [ \fB;\fR ]\fR @@ -255,7 +249,6 @@ the second expression. .sp .ne 2 -.mk .na \fB\fB,\fR \fIexpression \fR [\fB!\fR \fIword\fR .\|.\|.] [ \fB;\fR ]\fR .ad @@ -268,7 +261,6 @@ value of the count expression. .sp .ne 2 -.mk .na \fB\fB!\fR \fIword\fR .\|.\|. [ \fB;\fR ]\fR .ad @@ -298,12 +290,10 @@ and is replaced by the value of the expression. Expressions can contain any of the following special words: .sp .ne 2 -.mk .na \fB\fIinteger\fR\fR .ad .RS 22n -.rt The specified integer value. Integer values can be prefixed with \fB0i\fR or \fB0I\fR to indicate binary values, \fB0o\fR or \fB0O\fR to indicate octal values, \fB0t\fR or \fB0T\fR to indicate decimal values, and \fB0x\fR or @@ -312,24 +302,20 @@ values, \fB0t\fR or \fB0T\fR to indicate decimal values, and \fB0x\fR or .sp .ne 2 -.mk .na \fB0[tT][0-9]+.[0-9]+\fR .ad .RS 22n -.rt The specified decimal floating point value, converted to its \fBIEEE\fR double-precision floating point representation. .RE .sp .ne 2 -.mk .na \fB\&'\fIcccccccc\fR'\fR .ad .RS 22n -.rt The integer value computed by converting each character to a byte equal to its \fBASCII\fR value. Up to eight characters can be specified in a character constant. Characters are packed into the integer in reverse order @@ -338,78 +324,64 @@ constant. Characters are packed into the integer in reverse order .sp .ne 2 -.mk .na \fB<\fIidentifier\fR\fR .ad .RS 22n -.rt The value of the variable named by \fIidentifier\fR. .RE .sp .ne 2 -.mk .na \fB\fIidentifier\fR\fR .ad .RS 22n -.rt The value of the symbol named by \fIidentifier\fR. .RE .sp .ne 2 -.mk .na \fB(\fIexpression\fR)\fR .ad .RS 22n -.rt The value of \fIexpression\fR. .RE .sp .ne 2 -.mk .na \fB\&.\fR .ad .RS 22n -.rt The value of dot. .RE .sp .ne 2 -.mk .na \fB&\fR .ad .RS 22n -.rt The most recent value of dot used to execute a dcmd. .RE .sp .ne 2 -.mk .na \fB+\fR .ad .RS 22n -.rt The value of dot incremented by the current increment. .RE .sp .ne 2 -.mk .na \fB^\fR .ad .RS 22n -.rt The value of dot decremented by the current increment. .RE @@ -424,57 +396,47 @@ Unary operators are right associative and have higher precedence than binary operators. The unary operators are: .sp .ne 2 -.mk .na \fB#\fIexpression\fR\fR .ad .RS 23n -.rt Logical negation. .RE .sp .ne 2 -.mk .na \fB~\fIexpression\fR\fR .ad .RS 23n -.rt Bitwise complement. .RE .sp .ne 2 -.mk .na \fB-\fIexpression\fR\fR .ad .RS 23n -.rt Integer negation. .RE .sp .ne 2 -.mk .na \fB%\fIexpression\fR\fR .ad .RS 23n -.rt The value of a pointer-sized quantity at the object file location corresponding to virtual address \fIexpression\fR in the target's virtual address space. .RE .sp .ne 2 -.mk .na \fB%/[csil]/\fIexpression\fR\fR .ad .RS 23n -.rt The value of a char, short, int, or long-sized quantity at the object file location corresponding to virtual address \fIexpression\fR in the target's virtual address space. @@ -482,12 +444,10 @@ virtual address space. .sp .ne 2 -.mk .na \fB%/[1248]/\fIexpression\fR\fR .ad .RS 23n -.rt The value of a one, two, four, or eight-byte quantity at the object file location corresponding to virtual address \fIexpression\fR in the target's virtual address space. @@ -495,36 +455,30 @@ virtual address space. .sp .ne 2 -.mk .na \fB*\fIexpression\fR\fR .ad .RS 23n -.rt The value of a pointer-sized quantity at virtual address \fIexpression\fR in the target's virtual address space. .RE .sp .ne 2 -.mk .na \fB*/[csil]/\fIexpression\fR\fR .ad .RS 23n -.rt The value of a char, short, int, or long-sized quantity at virtual address \fIexpression\fR in the target's virtual address space. .RE .sp .ne 2 -.mk .na \fB*/[1248]/\fIexpression\fR\fR .ad .RS 23n -.rt The value of a one, two, four, or eight-byte quantity at virtual address \fIexpression\fR in the target's virtual address space. .RE @@ -536,133 +490,109 @@ operators. The binary operators, in order of precedence from highest to lowest, are: .sp .ne 2 -.mk .na \fB\fB*\fR\fR .ad .RS 6n -.rt Integer multiplication. .RE .sp .ne 2 -.mk .na \fB\fB%\fR\fR .ad .RS 6n -.rt Integer division. .RE .sp .ne 2 -.mk .na \fB\fB#\fR\fR .ad .RS 6n -.rt Left-hand side rounded up to next multiple of right-hand side. .RE .sp .ne 2 -.mk .na \fB\fB+\fR\fR .ad .RS 6n -.rt Integer addition. .RE .sp .ne 2 -.mk .na \fB\fB-\fR\fR .ad .RS 6n -.rt Integer subtraction. .RE .sp .ne 2 -.mk .na \fB\fB<<\fR\fR .ad .RS 6n -.rt Bitwise shift left. .RE .sp .ne 2 -.mk .na \fB\fB>>\fR\fR .ad .RS 6n -.rt Bitwise shift right. .RE .sp .ne 2 -.mk .na \fB\fB==\fR\fR .ad .RS 6n -.rt Logical equality. .RE .sp .ne 2 -.mk .na \fB\fB!=\fR\fR .ad .RS 6n -.rt Logical inequality. .RE .sp .ne 2 -.mk .na \fB\fB&\fR\fR .ad .RS 6n -.rt Bitwise AND. .RE .sp .ne 2 -.mk .na \fB\fB\fR^\fR .ad .RS 6n -.rt Bitwise exclusive OR. .RE .sp .ne 2 -.mk .na \fB\fB|\fR\fR .ad .RS 6n -.rt Bitwise inclusive OR. .RE @@ -705,103 +635,85 @@ tagged (user-defined indicator). The following variables are defined as persistent: .sp .ne 2 -.mk .na \fB0\fR .ad .RS 10n -.rt The most recent value printed using the \fB/\fR, \fB\e\fR, \fB?\fR, or \fB=\fR dcmd. .RE .sp .ne 2 -.mk .na \fB9\fR .ad .RS 10n -.rt The most recent count used with the \fB$<\fR dcmd. .RE .sp .ne 2 -.mk .na \fBb\fR .ad .RS 10n -.rt The virtual address of the base of the data section. .RE .sp .ne 2 -.mk .na \fBd\fR .ad .RS 10n -.rt The size of the data section in bytes. .RE .sp .ne 2 -.mk .na \fBe\fR .ad .RS 10n -.rt The virtual address of the entry point. .RE .sp .ne 2 -.mk .na \fBm\fR .ad .RS 10n -.rt The initial bytes (magic number) of the target's primary object file, or zero if no object file has been read yet. .RE .sp .ne 2 -.mk .na \fBt\fR .ad .RS 10n -.rt The size of the text section in bytes. .RE .sp .ne 2 -.mk .na \fBhits\fR .ad .RS 10n -.rt The count of the number of times the matched software event specifier has been matched. See \fBEvent Callbacks\fR, below. .RE .sp .ne 2 -.mk .na \fBthread\fR .ad .RS 10n -.rt The thread identifier of the current representative thread. The value of the identifier depends on the threading model used by the current target. See \fBThread Support\fR, below. @@ -943,34 +855,28 @@ For example, if dmods \fBm1\fR and \fBm2\fR each provide a dcmd \fBd\fR, and \fBm1\fR is loaded prior to \fBm2\fR, then: .sp .ne 2 -.mk .na \fB\fB::d\fR\fR .ad .RS 10n -.rt Executes \fBm1\fR's definition of \fBd\fR. .RE .sp .ne 2 -.mk .na \fB\fB::m1`d\fR\fR .ad .RS 10n -.rt Executes \fBm1\fR's definition of \fBd\fR. .RE .sp .ne 2 -.mk .na \fB\fB::m2`d\fR\fR .ad .RS 10n -.rt Executes \fBm2'\fRs definition of \fBd\fR. .RE @@ -1054,158 +960,130 @@ committed and executed using \fIRETURN\fR or \fINEWLINE\fR. The edit commands are: .sp .ne 2 -.mk .na \fB^F\fR .ad .RS 14n -.rt Move cursor forward (right) one character. .RE .sp .ne 2 -.mk .na \fBM-f\fR .ad .RS 14n -.rt Move cursor forward one word. .RE .sp .ne 2 -.mk .na \fB^B\fR .ad .RS 14n -.rt Move cursor backward (left) one character. .RE .sp .ne 2 -.mk .na \fBM-b\fR .ad .RS 14n -.rt Move cursor backward one word. .RE .sp .ne 2 -.mk .na \fB^A\fR .ad .RS 14n -.rt Move cursor to start of line. .RE .sp .ne 2 -.mk .na \fB^E\fR .ad .RS 14n -.rt Move cursor to end of line. .RE .sp .ne 2 -.mk .na \fB^D\fR .ad .RS 14n -.rt Delete current character, if the current line is not empty. If the current line is empty, \fB^D\fR denotes \fBEOF\fR and the debugger exits. .RE .sp .ne 2 -.mk .na \fBM-^H\fR .ad .RS 14n -.rt (Meta-backspace) Delete previous word. .RE .sp .ne 2 -.mk .na \fB^K\fR .ad .RS 14n -.rt Delete from the cursor to the end of the line. .RE .sp .ne 2 -.mk .na \fB^L\fR .ad .RS 14n -.rt Clear the screen and reprint the current line. .RE .sp .ne 2 -.mk .na \fB^T\fR .ad .RS 14n -.rt Transpose current character with next character. .RE .sp .ne 2 -.mk .na \fB^N\fR .ad .RS 14n -.rt Fetch the next command from the history. Each time \fB^N\fR is entered, the next command forward in time is retrieved. .RE .sp .ne 2 -.mk .na \fB^P\fR .ad .RS 14n -.rt Fetch the previous command from the history. Each time \fB^P\fR is entered, the next command backward in time is retrieved. .RE .sp .ne 2 -.mk .na \fB^R[\fIstring\fR]\fR .ad .RS 14n -.rt Search backward in the history for a previous command line containing \fIstring\fR. The string should be terminated by a \fIRETURN\fR or \fINEWLINE\fR. If \fIstring\fR is omitted, the previous history element @@ -1219,70 +1097,58 @@ editing commands. User defined sequences can be read or modified using the \fBstty\fR(1) command. .sp .ne 2 -.mk .na \fBerase\fR .ad .RS 11n -.rt User defined erase character (usually \fB^H\fR or \fB^?\fR). Delete previous character. .RE .sp .ne 2 -.mk .na \fBintr\fR .ad .RS 11n -.rt User defined interrupt character (usually \fB^C\fR). Abort the current command and print a new prompt. .RE .sp .ne 2 -.mk .na \fBkill\fR .ad .RS 11n -.rt User defined kill character (usually \fB^U\fR). Kill the entire current command line. .RE .sp .ne 2 -.mk .na \fBquit\fR .ad .RS 11n -.rt User defined quit character (usually \fB^\e\fR). Quit the debugger. .RE .sp .ne 2 -.mk .na \fBsuspend\fR .ad .RS 11n -.rt User defined suspend character (usually \fB^Z\fR). Suspend the debugger. .RE .sp .ne 2 -.mk .na \fBwerase\fR .ad .RS 11n -.rt User defined word erase character (usually \fB^W\fR). Erase the preceding word. .RE @@ -1292,45 +1158,37 @@ On keyboards that support an extended keypad with arrow keys, \fBmdb\fR interprets these keystrokes as editing commands: .sp .ne 2 -.mk .na \fBup-arrow\fR .ad .RS 15n -.rt Fetch the previous command from the history (same as \fB^P\fR). .RE .sp .ne 2 -.mk .na \fBdown-arrow\fR .ad .RS 15n -.rt Fetch the next command from the history (same as \fB^N\fR). .RE .sp .ne 2 -.mk .na \fBleft-arrow\fR .ad .RS 15n -.rt Move cursor backward one character (same as \fB^B\fR). .RE .sp .ne 2 -.mk .na \fBright-arrow\fR .ad .RS 15n -.rt Move cursor forward one character (same as \fB^F\fR). .RE @@ -1354,57 +1212,47 @@ displays a pager prompt: The following key sequences are recognized by the pager: .sp .ne 2 -.mk .na \fB\fISPACE\fR\fR .ad .RS 25n -.rt Display the next screenful of output. .RE .sp .ne 2 -.mk .na \fBa, A\fR .ad .RS 25n -.rt Abort the current top-level command and return to the prompt. .RE .sp .ne 2 -.mk .na \fBc, C\fR .ad .RS 25n -.rt Continue displaying output without pausing at each screenful until the current top-level command is complete. .RE .sp .ne 2 -.mk .na \fBn, N, \fINEWLINE\fR, \fIRETURN\fR\fR .ad .RS 25n -.rt Display the next line of output. .RE .sp .ne 2 -.mk .na \fBq, Q, ^C, ^\e\fR .ad .RS 25n -.rt Quit (abort) the current dcmd only. .RE @@ -1426,48 +1274,40 @@ sign (\fB$[ ]\fR). A string argument must be enclosed in double-quotes (\fB" The formatting dcmds are: .sp .ne 2 -.mk .na \fB\fB/\fR\fR .ad .RS 6n -.rt Display data from the target's virtual address space starting at the virtual address specified by dot. .RE .sp .ne 2 -.mk .na \fB\fB\e\fR\fR .ad .RS 6n -.rt Display data from the target's physical address space starting at the physical address specified by dot. .RE .sp .ne 2 -.mk .na \fB\fB?\fR\fR .ad .RS 6n -.rt Display data from the target's primary object file starting at the object file location corresponding to the virtual address specified by dot. .RE .sp .ne 2 -.mk .na \fB\fB=\fR\fR .ad .RS 6n -.rt Display the value of dot itself in each of the specified data formats. The \fB=\fR dcmd is therefore useful for converting between bases and performing arithmetic. @@ -1494,69 +1334,67 @@ table of format characters can be displayed from within \fBmdb\fR using the .sp .TS -tab(); -lw(.69i) lw(4.81i) -lw(.69i) lw(4.81i) -. -\fB+\fRT{ +l l +l l . +\fB+\fR T{ increment dot by the count (variable size) T} -\fB-\fRT{ +\fB-\fR T{ decrement dot by the count (variable size) T} -Bhexadecimal int (1 byte) -CT{ +B hexadecimal int (1 byte) +C T{ character using C character notation (1 byte) T} -Ddecimal signed int (4 bytes) -Edecimal unsigned long long (8 bytes) -Fdouble (8 bytes) -Goctal unsigned long long (8 bytes) -Hswap bytes and shorts (4 bytes) -IT{ +D decimal signed int (4 bytes) +E decimal unsigned long long (8 bytes) +F double (8 bytes) +G octal unsigned long long (8 bytes) +H swap bytes and shorts (4 bytes) +I T{ address and disassembled instruction (variable size) T} -Jhexadecimal long long (8 bytes) -Khexadecimal uintptr_t (4 or 8 bytes) -Nnewline -Ooctal unsigned int (4 bytes) -Psymbol (4 or 8 bytes) -Qoctal signed int (4 bytes) -Rbinary int (8 bytes) -ST{ +J hexadecimal long long (8 bytes) +K hexadecimal uintptr_t (4 or 8 bytes) +N newline +O octal unsigned int (4 bytes) +P symbol (4 or 8 bytes) +Q octal signed int (4 bytes) +R binary int (8 bytes) +S T{ string using C string notation (variable size) T} -Thorizontal tab -Udecimal unsigned int (4 bytes) -Vdecimal unsigned int (1 byte) -Wdefault radix unsigned int (4 bytes) -Xhexadecimal int (4 bytes) -Ydecoded time32_t (4 bytes) -Zhexadecimal long long (8 bytes) -^T{ +T horizontal tab +U decimal unsigned int (4 bytes) +V decimal unsigned int (1 byte) +W default radix unsigned int (4 bytes) +X hexadecimal int (4 bytes) +Y decoded time32_t (4 bytes) +Z hexadecimal long long (8 bytes) +^ T{ decrement dot by increment * count (variable size) T} -adot as symbol+offset -boctal unsigned int (1 byte) -ccharacter (1 byte) -ddecimal signed short (2 bytes) -edecimal signed long long (8 bytes) -ffloat (4 bytes) -goctal signed long long (8 bytes) -hswap bytes (2 bytes) -idisassembled instruction (variable size) -nnewline -ooctal unsigned short (2 bytes) -psymbol (4 or 8 bytes) -qoctal signed short (2 bytes) -rwhitespace -sraw string (variable size) -thorizontal tab -udecimal unsigned short (2 bytes) -vdecimal signed int (1 byte) -wdefault radix unsigned short (2 bytes) -xhexadecimal short (2 bytes) -ydecoded time64_t (8 bytes) +a dot as symbol+offset +b octal unsigned int (1 byte) +c character (1 byte) +d decimal signed short (2 bytes) +e decimal signed long long (8 bytes) +f float (4 bytes) +g octal signed long long (8 bytes) +h swap bytes (2 bytes) +i disassembled instruction (variable size) +n newline +o octal unsigned short (2 bytes) +p symbol (4 or 8 bytes) +q octal signed short (2 bytes) +r whitespace +s raw string (variable size) +t horizontal tab +u decimal unsigned short (2 bytes) +v decimal signed int (1 byte) +w default radix unsigned short (2 bytes) +x hexadecimal short (2 bytes) +y decoded time64_t (8 bytes) .TE .sp @@ -1571,48 +1409,40 @@ enclosed in square brackets preceded by a dollar sign (\fB$[ ]\fR). The write modifiers are: .sp .ne 2 -.mk .na \fB\fBv\fR\fR .ad .RS 5n -.rt Write the lowest byte of the value of each expression to the target beginning at the location specified by dot. .RE .sp .ne 2 -.mk .na \fB\fBw\fR\fR .ad .RS 5n -.rt Write the lowest two bytes of the value of each expression to the target beginning at the location specified by dot. .RE .sp .ne 2 -.mk .na \fB\fBW\fR\fR .ad .RS 5n -.rt Write the lowest 4 bytes of the value of each expression to the target beginning at the location specified by dot. .RE .sp .ne 2 -.mk .na \fB\fBZ\fR\fR .ad .RS 5n -.rt Write the complete 8 bytes of the value of each expression to the target beginning at the location specified by dot. .RE @@ -1638,13 +1468,11 @@ The search modifiers are: .sp .TS -tab(); -lw(.69i) lw(4.81i) -lw(.69i) lw(4.81i) -. -lSearch for the specified 2-byte value. -LSearch for the specified 4-byte value. -MSearch for the specified 8-byte value. +l l +l l . +l Search for the specified 2-byte value. +L Search for the specified 4-byte value. +M Search for the specified 8-byte value. .TE .sp @@ -1778,7 +1606,6 @@ shown in alphabetical order. If a \fB$\fR or \fB:\fR form has a form. The built-in dcmds are: .sp .ne 2 -.mk .na \fB> \fIvariable-name\fR\fR .ad @@ -1794,45 +1621,37 @@ character surrounded by \fB/ /\fR, then the value is modified as part of the assignment. The modifier characters are: .sp .ne 2 -.mk .na \fB\fBc\fR\fR .ad .RS 5n -.rt unsigned char quantity (1-byte) .RE .sp .ne 2 -.mk .na \fB\fBs\fR\fR .ad .RS 5n -.rt unsigned short quantity (2-byte) .RE .sp .ne 2 -.mk .na \fB\fBi\fR\fR .ad .RS 5n -.rt unsigned int quantity (4-byte) .RE .sp .ne 2 -.mk .na \fB\fBl\fR\fR .ad .RS 5n -.rt unsigned long quantity (4-byte in 32-bit, 8-byte in 64-bit) .RE @@ -1845,7 +1664,6 @@ syntax should be used instead. .sp .ne 2 -.mk .na \fB\fB$<\fR \fImacro-name\fR\fR .ad @@ -1860,7 +1678,6 @@ file is closed and replaced with the new file. .sp .ne 2 -.mk .na \fB\fB$<<\fR \fImacro-name\fR\fR .ad @@ -1872,7 +1689,6 @@ do not close the current open macro file. .sp .ne 2 -.mk .na \fB\fB$?\fR\fR .ad @@ -1885,7 +1701,6 @@ representative thread. .sp .ne 2 -.mk .na \fB[ \fIaddress\fR ] \fB$C\fR [ \fIcount\fR ]\fR .ad @@ -1901,7 +1716,6 @@ output. .sp .ne 2 -.mk .na \fB[ \fIbase\fR ] \fB$d\fR\fR .ad @@ -1915,7 +1729,6 @@ the current radix is printed in base 10 (decimal). The default radix is base 16 .sp .ne 2 -.mk .na \fB\fB$e\fR\fR .ad @@ -1930,7 +1743,6 @@ tables. .sp .ne 2 -.mk .na \fB\fB$P\fR \fIprompt-string\fR\fR .ad @@ -1943,7 +1755,6 @@ is '\fB>\fR '. The prompt can also be set using \fB::set\fR \fB-P\fR or the .sp .ne 2 -.mk .na \fB\fIdistance\fR \fB$s\fR\fR .ad @@ -1958,7 +1769,6 @@ specified, the current setting is displayed. .sp .ne 2 -.mk .na \fB\fB$v\fR\fR .ad @@ -1970,7 +1780,6 @@ dcmd provides other options for listing variables. .sp .ne 2 -.mk .na \fB\fIwidth\fR \fB$w\fR\fR .ad @@ -1983,7 +1792,6 @@ resize events. .sp .ne 2 -.mk .na \fB\fB$W\fR\fR .ad @@ -1996,7 +1804,6 @@ Re-open the target for writing, as if \fBmdb\fR had been executed with the .sp .ne 2 -.mk .na \fB[ \fIpid\fR ] \fB::attach \fR [ \fIcore\fR | \fIpid\fR ]\fR .ad @@ -2017,7 +1824,6 @@ as expressions. .sp .ne 2 -.mk .na \fB[\fIaddress\fR] \fB::bp\fR [\fB-/\fR\fB-dDesT\fR] [\fB-c\fR \fIcmd\fR] [\fB-n\fR \fIcount\fR] \fIsym\fR ...\fR @@ -2054,7 +1860,6 @@ this string contains meta-characters, it must be quoted. .sp .ne 2 -.mk .na \fB\fB::cat\fR \fIfilename\fR ...\fR .ad @@ -2069,7 +1874,6 @@ addresses stored in an external file. .sp .ne 2 -.mk .na \fB\fB::cont\fR [ \fISIG\fR ]\fR .ad @@ -2095,7 +1899,6 @@ running, \fB::cont\fR starts a new program running as if by \fB::run\fR. .sp .ne 2 -.mk .na \fB\fIaddress\fR \fB::context\fR\fR .ad @@ -2127,7 +1930,6 @@ by executing \fB0::context\fR. .sp .ne 2 -.mk .na \fB\fB::dcmds\fR\fR .ad @@ -2138,7 +1940,6 @@ List the available dcmds and print a brief description for each one. .sp .ne 2 -.mk .na \fB[ \fIaddress\fR ] \fB::delete\fR [ \fIid\fR | \fBall\fR ]\fR .ad @@ -2159,7 +1960,6 @@ flag). The \fB::events\fR dcmd displays the current list of event specifiers. .sp .ne 2 -.mk .na \fB[ \fIaddress\fR ] \fB::dis\fR [ \fB-fw\fR ] [ \fB-n\fR \fIcount\fR ] [ \fIaddress\fR ]\fR @@ -2182,7 +1982,6 @@ the \fB-n\fR option. .sp .ne 2 -.mk .na \fB\fB::disasms\fR\fR .ad @@ -2195,7 +1994,6 @@ mode to any of the modes listed using the \fB::dismode\fR dcmd. .sp .ne 2 -.mk .na \fB\fB::dismode\fR [ \fImode\fR ]\fR .ad @@ -2213,7 +2011,6 @@ displayed using the \fB::disasms\fR dcmd. .sp .ne 2 -.mk .na \fB\fB::dmods\fR [ \fB-l\fR ] [ \fImodule-name\fR ]\fR .ad @@ -2227,7 +2024,6 @@ additional argument. .sp .ne 2 -.mk .na \fB[ \fIaddress\fR ] \fB::dump\fR [ \fB-eqrstu\fR ] [ \fB-f\fR|\fB-p\fR ]\fR .ad @@ -2244,24 +2040,20 @@ a number of iterations. The \fB::dump\fR dcmd also recognizes the following options: .sp .ne 2 -.mk .na \fB\fB-e\fR\fR .ad .RS 17n -.rt Adjusts for endian-ness. The \fB-e\fR option assumes 4-byte words. The \fB-g\fR option can be used to change the default word size. .RE .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 17n -.rt Reads data from the object file location corresponding to the given virtual address instead of from the target's virtual address space. The \fB-f\fR option is enabled by default if the debugger is not currently attached to a live @@ -2270,93 +2062,77 @@ process, core file, or crash dump. .sp .ne 2 -.mk .na \fB\fB-g\fR \fIbytes\fR\fR .ad .RS 17n -.rt Displays bytes in groups of \fIbytes\fR. The default group size is 4 bytes. The group size must be a power of two that divides the line width. .RE .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 17n -.rt Interprets \fIaddress\fR as a physical address location in the target's address space instead of a virtual address. .RE .sp .ne 2 -.mk .na \fB\fB-q\fR\fR .ad .RS 17n -.rt Does not print an ASCII decoding of the data. .RE .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 17n -.rt Numbers lines relative to the start address instead of with the explicit address of each line. This option implies the \fB-u\fR option. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 17n -.rt Elides repeated lines. .RE .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad .RS 17n -.rt Only reads from and displays the contents of the specified addresses, instead of reading and printing entire lines. .RE .sp .ne 2 -.mk .na \fB\fB-u\fR\fR .ad .RS 17n -.rt Unaligns output instead of aligning the output at a paragraph boundary. .RE .sp .ne 2 -.mk .na \fB\fB-w\fR \fIparagraphs\fR\fR .ad .RS 17n -.rt Displays paragraphs at 16-byte paragraphs per line. The default number of \fIparagraphs\fR is one. The maximum value accepted for \fB-w\fR is \fB16\fR. .RE @@ -2365,7 +2141,6 @@ Displays paragraphs at 16-byte paragraphs per line. The default number of .sp .ne 2 -.mk .na \fB\fB::echo\fR [ \fIstring\fR | \fIvalue\fR ...]\fR .ad @@ -2378,7 +2153,6 @@ and printed in the default base. .sp .ne 2 -.mk .na \fB\fB::eval\fR \fIcommand\fR\fR .ad @@ -2390,7 +2164,6 @@ metacharacters or whitespace, it should be enclosed in double or single quotes. .sp .ne 2 -.mk .na \fB\fB::events\fR [ \fB-av\fR ]\fR .ad @@ -2412,13 +2185,13 @@ any specifier inactivity, are shown. Here is some sample output: > ::events ID S TA HT LM Description Action ----- - -- -- -- -------------------------------- ------ -[ 1 ] - T 1 0 stop on SIGINT - -[ 2 ] - T 0 0 stop on SIGQUIT - -[ 3 ] - T 0 0 stop on SIGILL - +[ 1 ] - T 1 0 stop on SIGINT - +[ 2 ] - T 0 0 stop on SIGQUIT - +[ 3 ] - T 0 0 stop on SIGILL - ... -[ 11] - T 0 0 stop on SIGXCPU - -[ 12] - T 0 0 stop on SIGXFSZ - -[ 13] - 2 0 stop at libc`printf ::echo printf +[ 11] - T 0 0 stop on SIGXCPU - +[ 12] - T 0 0 stop on SIGXFSZ - +[ 13] - 2 0 stop at libc`printf ::echo printf > .fi .in -2 @@ -2428,12 +2201,10 @@ The following table explains the meaning of each column. A summary of this information is available using \fB::help\fR \fBevents\fR. .sp .ne 2 -.mk .na \fB\fBID\fR\fR .ad .RS 15n -.rt The event specifier identifier. The identifier is shown in square brackets \fB[ ]\fR if the specifier is enabled, in parentheses \fB( )\fR if the specifier is disabled, or in angle brackets \fB< >\fR if the target program is currently @@ -2442,21 +2213,17 @@ stopped on an event that matches the given specifier. .sp .ne 2 -.mk .na \fB\fBS\fR\fR .ad .RS 15n -.rt The event specifier state. The state is one of the following symbols: .sp .ne 2 -.mk .na \fB\fB-\fR\fR .ad .RS 5n -.rt The event specifier is idle. When no target program is running, all specifiers are idle. When the target program is running, a specifier can be idle if it cannot be evaluated (for example, a deferred breakpoint in a shared object that @@ -2465,24 +2232,20 @@ is not yet loaded). .sp .ne 2 -.mk .na \fB\fB+\fR\fR .ad .RS 5n -.rt The event specifier is active. When the target is continued, events of this type is detected by the debugger. .RE .sp .ne 2 -.mk .na \fB\fB*\fR\fR .ad .RS 5n -.rt The event specifier is armed. This state means that the target is currently running with instrumentation for this type of event. This state is only visible if the debugger is attached to a running program with the \fB-o\fR \fBnostop\fR @@ -2491,12 +2254,10 @@ option. .sp .ne 2 -.mk .na \fB\fB!\fR\fR .ad .RS 5n -.rt The event specifier was not armed due to an operating system error. The \fB::events\fR \fB-v\fR option can be used to display more information about the reason the instrumentation failed. @@ -2506,34 +2267,28 @@ the reason the instrumentation failed. .sp .ne 2 -.mk .na \fB\fBTA\fR\fR .ad .RS 15n -.rt The Temporary, Sticky, and Automatic event specifier properties. One or more of the following symbols can be shown: .sp .ne 2 -.mk .na \fB\fBt\fR\fR .ad .RS 5n -.rt The event specifier is temporary, and is deleted the next time the target stops, regardless of whether it is matched. .RE .sp .ne 2 -.mk .na \fB\fBT\fR\fR .ad .RS 5n -.rt The event specifier is sticky, and is not be deleted by \fB::delete\fR \fBall\fR or \fB:z\fR. The specifier can be deleted by explicitly specifying its id number to \fB::delete\fR. @@ -2541,36 +2296,30 @@ its id number to \fB::delete\fR. .sp .ne 2 -.mk .na \fB\fBd\fR\fR .ad .RS 5n -.rt The event specifier is automatically disabled when the hit count is equal to the hit limit. .RE .sp .ne 2 -.mk .na \fB\fBD\fR\fR .ad .RS 5n -.rt The event specifier is automatically deleted when the hit count is equal to the hit limit. .RE .sp .ne 2 -.mk .na \fB\fBs\fR\fR .ad .RS 5n -.rt The target automatically stops when the hit count is equal to the hit limit. .RE @@ -2578,12 +2327,10 @@ The target automatically stops when the hit count is equal to the hit limit. .sp .ne 2 -.mk .na \fB\fBHT\fR\fR .ad .RS 15n -.rt The current hit count. This column displays the number of times the corresponding software event has occurred in the target since the creation of this event specifier. @@ -2591,12 +2338,10 @@ this event specifier. .sp .ne 2 -.mk .na \fB\fBLM\fR\fR .ad .RS 15n -.rt The current hit limit. This column displays the limit on the hit count at which the auto-disable, auto-delete, or auto-stop behavior takes effect. These behaviors can be configured using the \fB::evset\fR dcmd, described below. @@ -2604,24 +2349,20 @@ behaviors can be configured using the \fB::evset\fR dcmd, described below. .sp .ne 2 -.mk .na \fB\fBDescription\fR\fR .ad .RS 15n -.rt A description of the type of software event that is matched by the given specifier. .RE .sp .ne 2 -.mk .na \fB\fBAction\fR\fR .ad .RS 15n -.rt The callback string to execute when the corresponding software event occurs. This callback is executed as if it had been typed at the command prompt. .RE @@ -2630,7 +2371,6 @@ This callback is executed as if it had been typed at the command prompt. .sp .ne 2 -.mk .na \fB[\fIid\fR] \fB::evset\fR [\fB-/\fR\fB-dDestT\fR] [\fB-c\fR \fIcmd\fR] [\fB-n\fR \fIcount\fR] \fIid\fR ...\fR @@ -2644,12 +2384,10 @@ interpreted as a list of decimal integers, unless an explicit radix is specified. The \fB::evset\fR dcmd recognizes the following options: .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad .RS 6n -.rt Disables the event specifier when the hit count reaches the hit limit. If the \fB-d\fR form of the option is given, this behavior is disabled. Once an event specifier is disabled, the debugger removes any corresponding instrumentation @@ -2660,12 +2398,10 @@ is disabled immediately. .sp .ne 2 -.mk .na \fB\fB-D\fR\fR .ad .RS 6n -.rt Deletes the event specifier when the hit count reaches the hit limit. If the \fB-D\fR form of the option is given, this behavior is disabled. The \fB-D\fR option takes precedence over the \fB-d\fR option. The hit limit can be @@ -2674,24 +2410,20 @@ configured using the \fB-n\fR option. .sp .ne 2 -.mk .na \fB\fB-e\fR\fR .ad .RS 6n -.rt Enables the event specifier. If the \fB-e\fR form of the option is given, the specifier is disabled. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 6n -.rt Stops the target program when the hit count reaches the hit limit. If the \fB-s\fR form of the option is given, this behavior is disabled. The \fB-s\fR behavior tells the debugger to act as if the \fB::cont\fR were issued following @@ -2702,12 +2434,10 @@ option takes precedence over both the \fB-D\fR option and the \fB-d\fR option. .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad .RS 6n -.rt Marks the event specifier as temporary. Temporary specifiers are automatically deleted the next time the target stops, regardless of whether it stopped as the result of a software event corresponding to the given specifier. If the @@ -2717,12 +2447,10 @@ result of a software event corresponding to the given specifier. If the .sp .ne 2 -.mk .na \fB\fB-T\fR\fR .ad .RS 6n -.rt Marks the event specifier as sticky. Sticky specifiers are not deleted by \fB::delete\fR \fBall\fR or \fB:z.\fR They can be deleted by specifying the corresponding specifier \fBID\fR as an explicit argument to \fB::delete\fR. If @@ -2732,12 +2460,10 @@ default set of event specifiers are all initially marked sticky. .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad .RS 6n -.rt Executes the specified \fIcmd\fR string each time the corresponding software event occurs in the target program. The current callback string can be displayed using \fB::events\fR. @@ -2745,12 +2471,10 @@ displayed using \fB::events\fR. .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 6n -.rt Sets the current value of the hit limit to \fIcount\fR. If no hit limit is currently set and the \fB-n\fR option does not accompany \fB-s\fR or D, the hit limit is set to one. @@ -2761,7 +2485,6 @@ A summary of this information is available using \fB::help\fR \fBevset\fR. .sp .ne 2 -.mk .na \fB\fB::files\fR\fR .ad @@ -2777,7 +2500,6 @@ in the various target symbol tables). .sp .ne 2 -.mk .na \fB[\fIflt\fR] \fB::fltbp\fR [\fB-/\fR\fB-dDestT\fR] [\fB-c\fR \fIcmd\fR] [\fB-n\fR \fIcount\fR] \fIflt\fR ...\fR @@ -2793,7 +2515,6 @@ meaning as they do for the \fB::evset\fR dcmd. .sp .ne 2 -.mk .na \fB[ \fB\fIthread\fR\fR ] \fB::fpregs\fR\fR .ad @@ -2811,7 +2532,6 @@ thread expression should be one of the thread identifiers described under .sp .ne 2 -.mk .na \fB\fB::formats\fR\fR .ad @@ -2824,7 +2544,6 @@ under \fBFormatting dcmds\fR, above. .sp .ne 2 -.mk .na \fB\fB::grep\fR \fIcommand\fR\fR .ad @@ -2838,7 +2557,6 @@ pipelines to filter a list of addresses. .sp .ne 2 -.mk .na \fB\fB::help\fR [ \fIdcmd-name\fR ]\fR .ad @@ -2851,7 +2569,6 @@ prints a usage summary for that dcmd. .sp .ne 2 -.mk .na \fB\fIsignal\fR \fB:i\fR\fR .ad @@ -2867,7 +2584,6 @@ of the set of signals that cause a process to dump core by default (see .sp .ne 2 -.mk .na \fB\fB$i\fR\fR .ad @@ -2880,7 +2596,6 @@ obtained using the \fB::events\fR dcmd. .sp .ne 2 -.mk .na \fB\fB::kill\fR\fR .ad @@ -2897,7 +2612,6 @@ using \fB::run\fR. .sp .ne 2 -.mk .na \fB\fB$l\fR\fR .ad @@ -2909,7 +2623,6 @@ process. .sp .ne 2 -.mk .na \fB\fB$L\fR\fR .ad @@ -2921,7 +2634,6 @@ process. .sp .ne 2 -.mk .na \fB[ \fIaddress\fR ] \fB::list\fR \fItype\fR \fImember\fR [ \fIvariable-name\fR ]\fR @@ -2947,7 +2659,6 @@ Information\fR, below for more information. .sp .ne 2 -.mk .na \fB\fB::load\fR [ \fB-s\fR ] \fImodule-name\fR\fR .ad @@ -2963,7 +2674,6 @@ issue any error messages if the module is not found or could not be loaded. .sp .ne 2 -.mk .na \fB\fB::log\fR [ \fB-d\fR | [ \fB-e\fR ] \fIfilename\fR ]\fR .ad @@ -2985,7 +2695,6 @@ appends any new log output to the file. .sp .ne 2 -.mk .na \fB\fB::map\fR \fIcommand\fR\fR .ad @@ -3000,7 +2709,6 @@ addresses. .sp .ne 2 -.mk .na \fB[ \fIaddress\fR ] \fB::mappings\fR [ \fIname\fR ]\fR .ad @@ -3019,7 +2727,6 @@ mapping matching that description. .sp .ne 2 -.mk .na \fB\fB::next\fR [ \fISIG\fR ]\fR .ad @@ -3038,7 +2745,6 @@ new program running as if by \fB::run\fR and stop at the first instruction. .sp .ne 2 -.mk .na \fB[ \fIaddress\fR ] \fB::nm\fR [ \fB-DPdghnopuvx\fR ] [ \fB-t\fR \fItypes\fR ]\fR @@ -3056,89 +2762,73 @@ specified, only the symbol table for this load object is displayed. The \fB::nm\fR dcmd also recognizes the following options: .sp .ne 2 -.mk .na \fB\fB-D\fR\fR .ad .RS 27n -.rt Prints \fB\&.dynsym\fR (dynamic symbol table) instead of \fB\&.symtab\fR. .RE .sp .ne 2 -.mk .na \fB\fB-P\fR\fR .ad .RS 27n -.rt Prints the private symbol table instead of \fB\&.symtab\fR. .RE .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad .RS 27n -.rt Prints value and size fields in decimal. .RE .sp .ne 2 -.mk .na \fB\fB-g\fR\fR .ad .RS 27n -.rt Prints only global symbols. .RE .sp .ne 2 -.mk .na \fB\fB-h\fR\fR .ad .RS 27n -.rt Suppresses the header line. .RE .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 27n -.rt Sorts symbols by name. .RE .sp .ne 2 -.mk .na \fB\fB-o\fR\fR .ad .RS 27n -.rt Prints value and size fields in octal. .RE .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 27n -.rt Prints symbols as a series of \fB::nmadd\fR commands. This option can be used with \fB-P\fR to produce a macro file that can be subsequently read into the debugger with \fB$<\fR. @@ -3146,132 +2836,108 @@ debugger with \fB$<\fR. .sp .ne 2 -.mk .na \fB\fB-u\fR\fR .ad .RS 27n -.rt Prints only undefined symbols. .RE .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 27n -.rt Sorts symbols by value. .RE .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad .RS 27n -.rt Prints value and size fields in hexadecimal. .RE .sp .ne 2 -.mk .na \fB\fB-t\fR \fItype\fR[,\fItype\fR ... ]\fR .ad .RS 27n -.rt Prints only symbols of the specified type(s). The valid \fItype\fR argument strings are: .sp .ne 2 -.mk .na \fB\fBnoty\fR\fR .ad .RS 8n -.rt \fISTT_NOTYPE\fR .RE .sp .ne 2 -.mk .na \fB\fBobjt\fR\fR .ad .RS 8n -.rt \fISTT_OBJECT\fR .RE .sp .ne 2 -.mk .na \fB\fBfunc\fR\fR .ad .RS 8n -.rt \fISTT_FUNC\fR .RE .sp .ne 2 -.mk .na \fB\fBsect\fR\fR .ad .RS 8n -.rt \fISTT_SECTION\fR .RE .sp .ne 2 -.mk .na \fB\fBfile\fR\fR .ad .RS 8n -.rt \fISTT_FILE\fR .RE .sp .ne 2 -.mk .na \fB\fBcomm\fR\fR .ad .RS 8n -.rt \fISTT_COMMON\fR .RE .sp .ne 2 -.mk .na \fB\fBtls\fR\fR .ad .RS 8n -.rt \fISTT_TLS\fR .RE .sp .ne 2 -.mk .na \fB\fBregi\fR\fR .ad .RS 8n -.rt \fISTT_SPARC_REGISTER\fR .RE @@ -3279,121 +2945,99 @@ strings are: .sp .ne 2 -.mk .na \fB\fB-f\fR \fIformat\fR[,\fIformat\fR ... ]\fR .ad .RS 27n -.rt Prints only the specified symbol information. The valid \fIformat\fR argument strings are: .sp .ne 2 -.mk .na \fB\fBndx\fR\fR .ad .RS 9n -.rt symbol table index .RE .sp .ne 2 -.mk .na \fB\fBval\fR\fR .ad .RS 9n -.rt symbol value .RE .sp .ne 2 -.mk .na \fB\fBsize\fR\fR .ad .RS 9n -.rt size in bytes .RE .sp .ne 2 -.mk .na \fB\fBtype\fR\fR .ad .RS 9n -.rt symbol type .RE .sp .ne 2 -.mk .na \fB\fBbind\fR\fR .ad .RS 9n -.rt binding .RE .sp .ne 2 -.mk .na \fB\fBoth\fR\fR .ad .RS 9n -.rt other .RE .sp .ne 2 -.mk .na \fB\fBshndx\fR\fR .ad .RS 9n -.rt section index .RE .sp .ne 2 -.mk .na \fB\fBname\fR\fR .ad .RS 9n -.rt symbol name .RE .sp .ne 2 -.mk .na \fB\fBctype\fR\fR .ad .RS 9n -.rt C type for symbol (if known) .RE .sp .ne 2 -.mk .na \fB\fBobj\fR\fR .ad .RS 9n -.rt object which defines symbol .RE @@ -3403,7 +3047,6 @@ object which defines symbol .sp .ne 2 -.mk .na \fB\fIvalue\fR \fB::nmadd\fR [ \fB-fo\fR ] [ \fB-e\fR \fIend\fR ] [ \fB-s\fR \fIsize\fR ] \fIname \fR\fR @@ -3416,45 +3059,37 @@ the target's symbol table, as described under \fBSymbol Name Resolution\fR above. The \fB::nmadd\fR dcmd also recognizes the following options: .sp .ne 2 -.mk .na \fB\fB-e\fR\fR .ad .RS 6n -.rt Sets the size of the symbol to \fIend\fR - \fIvalue\fR. .RE .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 6n -.rt Sets the type of the symbol to \fBSTT_FUNC\fR. .RE .sp .ne 2 -.mk .na \fB\fB-o\fR\fR .ad .RS 6n -.rt Sets the type of the symbol to \fBSTT_OBJECT\fR. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 6n -.rt Sets the size of the symbol to \fIsize\fR. .RE @@ -3462,7 +3097,6 @@ Sets the size of the symbol to \fIsize\fR. .sp .ne 2 -.mk .na \fB\fB::nmdel\fR \fIname\fR\fR .ad @@ -3473,7 +3107,6 @@ Delete the specified symbol \fIname\fR from the private symbol table. .sp .ne 2 -.mk .na \fB\fB::objects\fR [ \fB-v\fR ]\fR .ad @@ -3489,7 +3122,6 @@ the output for the \fB-v\fR option. .sp .ne 2 -.mk .na \fB\fB::offsetof\fR \fItype member\fR\fR .ad @@ -3508,7 +3140,6 @@ information. .sp .ne 2 -.mk .na \fB\fIaddress\fR \fB::print\fR [ \fB-aCdiLptx\fR ] [ \fB-c\fR \fIlim\fR ]\fR .ad @@ -3563,7 +3194,6 @@ addresses shown are byte offsets starting at zero. .sp .ne 2 -.mk .na \fB\fB::quit\fR\fR .ad @@ -3578,7 +3208,6 @@ Quit the debugger. .sp .ne 2 -.mk .na \fB[ \fIthread\fR ] \fB::regs\fR\fR .ad @@ -3596,7 +3225,6 @@ described under \fBThread Support\fR, above. .sp .ne 2 -.mk .na \fB\fB::release\fR [ \fB-a\fR ]\fR .ad @@ -3618,7 +3246,6 @@ dcmds. .sp .ne 2 -.mk .na \fB\fB::run\fR [ \fIargs\fR . . . ]\fR .ad @@ -3636,7 +3263,6 @@ examining a live running program, it first detaches from this program as if by .sp .ne 2 -.mk .na \fB\fB::set\fR [ \fB-wF\fR ] [ \fB-/\fR\fB-o\fR \fIoption\fR ] [ \fB-s\fR \fIdistance\fR ] [ \fB-I\fR \fIpath\fR ]\fR @@ -3652,24 +3278,20 @@ current set of debugger properties is displayed. The \fB::set\fR dcmd recognizes the following options: .sp .ne 2 -.mk .na \fB\fB-F\fR\fR .ad .RS 6n -.rt Forcibly takes over the next user process that \fB::attach\fR is applied to, as if \fBmdb\fR had been executed with the \fB-F\fR option on the command line. .RE .sp .ne 2 -.mk .na \fB\fB-I\fR\fR .ad .RS 6n -.rt Sets the default path for locating macro files. The path argument can contain any of the special tokens described for the \fB-I\fR command-line option under OPTIONS. @@ -3677,12 +3299,10 @@ OPTIONS. .sp .ne 2 -.mk .na \fB\fB-L\fR\fR .ad .RS 6n -.rt Sets the default path for locating debugger modules. The path argument can contain any of the special tokens described for the \fB-I\fR command-line option under OPTIONS. @@ -3690,12 +3310,10 @@ option under OPTIONS. .sp .ne 2 -.mk .na \fB\fB-o\fR\fR .ad .RS 6n -.rt Enables the specified debugger option. If the \fB-o\fR form is used, the option is disabled. The option strings are described along with the \fB-o\fR command-line option under OPTIONS. @@ -3703,23 +3321,19 @@ command-line option under OPTIONS. .sp .ne 2 -.mk .na \fB\fB-P\fR\fR .ad .RS 6n -.rt Sets the command prompt to the specified prompt string. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 6n -.rt Sets the symbol matching distance to the specified distance. Refer to the description of the \fB-s\fR command-line option under OPTIONS for more information. @@ -3727,12 +3341,10 @@ information. .sp .ne 2 -.mk .na \fB\fB-w\fR\fR .ad .RS 6n -.rt Re-opens the target for writing, as if \fBmdb\fR had been executed with the \fB-w\fR option on the command line. .RE @@ -3741,7 +3353,6 @@ Re-opens the target for writing, as if \fBmdb\fR had been executed with the .sp .ne 2 -.mk .na \fB\fB::showrev\fR [ \fB-pv\fR ]\fR .ad @@ -3759,7 +3370,6 @@ version of "\fBUnknown\fR" in the output for the \fB-v\fR option. .sp .ne 2 -.mk .na \fB[\fIsignal\fR] \fB::sigbp\fR [\fB-/\fR\fB-dDestT\fR] [\fB-c\fR \fIcmd\fR] [\fB-n\fR \fIcount\fR] \fISIG\fR ...\fR @@ -3782,7 +3392,6 @@ signals that cause the process to dump core by default (see .sp .ne 2 -.mk .na \fB\fB::sizeof\fR \fItype\fR \fR .ad @@ -3799,7 +3408,6 @@ Information\fR, below for more information. .sp .ne 2 -.mk .na \fB[ \fIaddress\fR ] \fB::stack \fR [ \fIcount\fR ]\fR .ad @@ -3818,7 +3426,6 @@ arguments are displayed for each stack frame in the output. .sp .ne 2 -.mk .na \fB\fB::status\fR\fR .ad @@ -3829,7 +3436,6 @@ Print a summary of information related to the current target. .sp .ne 2 -.mk .na \fB\fB::step\fR [ \fBover\fR | \fBout\fR ] [ \fISIG\fR ]\fR .ad @@ -3858,7 +3464,6 @@ program running as if by \fB::run\fR and stop at the first instruction. The .sp .ne 2 -.mk .na \fB[ \fIsyscall\fR ] \fB::sysbp\fR [ \fB-/\fR\fB-dDestT\fR ] [ \fB-io\fR ] [ \fB-c\fR \fIcmd\fR ]\fR @@ -3881,7 +3486,6 @@ specified, the event specifiers trigger on exit out from the kernel. The .sp .ne 2 -.mk .na \fB\fIthread\fR \fB::tls\fR \fIsymbol\fR\fR .ad @@ -3896,7 +3500,6 @@ described under \fBSymbol Name Resolution\fR, above. .sp .ne 2 -.mk .na \fB\fB::typeset\fR [ \fB-/\fR\fB-t\fR] \fIvariable-name\fR . . .\fR .ad @@ -3911,7 +3514,6 @@ specified, the list of variables and their values is printed. .sp .ne 2 -.mk .na \fB\fB::unload\fR \fImodule-name\fR\fR .ad @@ -3924,7 +3526,6 @@ Unload the specified dmod. The list of active dmods can be printed using the .sp .ne 2 -.mk .na \fB\fB::unset\fR \fIvariable-name\fR . . .\fR .ad @@ -3937,7 +3538,6 @@ unset by the user. .sp .ne 2 -.mk .na \fB\fB::vars\fR [ \fB-npt\fR] \fR .ad @@ -3954,7 +3554,6 @@ Variables can be tagged using the \fB-t\fR option of the \fB::typeset\fR dcmd. .sp .ne 2 -.mk .na \fB\fB::version\fR\fR .ad @@ -3965,7 +3564,6 @@ Print the debugger version number. .sp .ne 2 -.mk .na \fB\fIaddress\fR \fB::vtop\fR [\fB-a\fR \fIas\fR]\fR .ad @@ -3986,7 +3584,6 @@ kernel pages. .sp .ne 2 -.mk .na \fB[ \fIaddress\fR ] \fB::walk\fR \fIwalker-name\fR [ \fIvariable-name\fR ]\fR .ad @@ -4009,7 +3606,6 @@ specified variable is assigned the value returned at each step of the walk when .sp .ne 2 -.mk .na \fB\fB::walkers\fR\fR .ad @@ -4020,7 +3616,6 @@ List the available walkers and print a brief description for each one. .sp .ne 2 -.mk .na \fB\fB::whence\fR [ \fB-v\fR ] \fIname\fR . . .\fR .ad @@ -4040,7 +3635,6 @@ and walker in order of precedence. .sp .ne 2 -.mk .na \fB\fIaddr\fR [ ,\fIlen\fR ]\fB::wp\fR [ \fB-/\fR\fB-dDestT\fR ] [ \fB-rwx\fR ] [ \fB-c\fR \fIcmd\fR ]\fR @@ -4080,7 +3674,6 @@ contains meta-characters, it must be quoted. .sp .ne 2 -.mk .na \fB\fB::xdata\fR\fR .ad @@ -4095,7 +3688,6 @@ information, refer to the \fISolaris Modular Debugger Guide\fR. .sp .ne 2 -.mk .na \fB\fB:z\fR\fR .ad @@ -4111,12 +3703,10 @@ specifiers can also be deleted using \fB::delete\fR. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-A\fR\fR .ad .RS 15n -.rt Disables automatic loading of \fBmdb\fR modules. By default, \fBmdb\fR attempts to load debugger modules corresponding to the active shared libraries in a user process or core file, or to the loaded kernel modules in the live operating @@ -4125,12 +3715,10 @@ system or an operating system crash dump. .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 15n -.rt Forces raw file debugging mode. By default, \fBmdb\fR attempts to infer whether the object and core file operands refer to a user executable and core dump or to a pair of operating system crash dump files. If the file type cannot be @@ -4141,12 +3729,10 @@ files to examine. .sp .ne 2 -.mk .na \fB\fB-F\fR\fR .ad .RS 15n -.rt Forcibly takes over the specified user process, if necessary. By default, \fBmdb\fR refuses to attach to a user process that is already under the control of another debugging tool, such as \fBtruss\fR(1). With the \fB-F\fR option, @@ -4157,12 +3743,10 @@ process. .sp .ne 2 -.mk .na \fB\fB-I\fR \fIpath\fR\fR .ad .RS 15n -.rt Sets default path for locating macro files. Macro files are read using the \fB$<\fR or \fB$<<\fR dcmds. The path is a sequence of directory names delimited by colon (\fB:\fR) characters. The \fB-I\fR \fBinclude\fR path and @@ -4170,48 +3754,40 @@ delimited by colon (\fB:\fR) characters. The \fB-I\fR \fBinclude\fR path and tokens: .sp .ne 2 -.mk .na \fB%i\fR .ad .RS 6n -.rt Expands to the current instruction set architecture (\fBISA\fR) name ('sparc', 'sparcv9', or 'i386'). .RE .sp .ne 2 -.mk .na \fB%o\fR .ad .RS 6n -.rt Expands to the old value of the path being modified. This is useful for appending or prepending directories to an existing path. .RE .sp .ne 2 -.mk .na \fB%p\fR .ad .RS 6n -.rt Expands to the current platform string (either \fBuname\fR \fB-i\fR or the platform string stored in the process core file or crash dump). .RE .sp .ne 2 -.mk .na \fB%r\fR .ad .RS 6n -.rt Expands to the pathname of the root directory. An alternate root directory can be specified using the \fB-R\fR option. If no \fB-R\fR option is present, the root directory is derived dynamically from the path to the \fBmdb\fR executable @@ -4222,12 +3798,10 @@ be derived as \fB/net/hostname\fR. .sp .ne 2 -.mk .na \fB%t\fR .ad .RS 6n -.rt Expands to the name of the current target. This is either be the literal string '\fBproc\fR' (a user process or user process core file), '\fBkvm\fR' (a kernel crash dump or the live operating system), or '\fBraw\fR' (a raw file). @@ -4255,12 +3829,10 @@ The default include path for 64-bit \fBmdb\fR is: .sp .ne 2 -.mk .na \fB\fB-k\fR\fR .ad .RS 15n -.rt Forces kernel debugging mode. By default, \fBmdb\fR attempts to infer whether the object and core file operands refer to a user executable and core dump, or to a pair of operating system crash dump files. The \fB-k\fR option forces @@ -4273,12 +3845,10 @@ Write access requires ALL privileges. .sp .ne 2 -.mk .na \fB\fB-K\fR\fR .ad .RS 15n -.rt Load \fBkmdb\fR, stop the live running operating system kernel, and proceed to the \fBkmdb\fR debugger prompt. This option should only be used on the system console, as the subsequent \fBkmdb\fR prompt appears on the system console. @@ -4286,12 +3856,10 @@ console, as the subsequent \fBkmdb\fR prompt appears on the system console. .sp .ne 2 -.mk .na \fB\fB-L\fR \fIpath\fR\fR .ad .RS 15n -.rt Sets default path for locating debugger modules. Modules are loaded automatically on startup or using the \fB::load\fR dcmd. The path is a sequence of directory names delimited by colon (\fB:\fR) characters. The \fB-L\fR @@ -4300,12 +3868,10 @@ library path can also contain any of the tokens shown for \fB-I\fR above. .sp .ne 2 -.mk .na \fB\fB-m\fR\fR .ad .RS 15n -.rt Disables demand-loading of kernel module symbols. By default, \fBmdb\fR processes the list of loaded kernel modules and performs demand loading of per-module symbol tables. If the \fB-m\fR option is specified, \fBmdb\fR does @@ -4316,12 +3882,10 @@ are not loaded on startup. .sp .ne 2 -.mk .na \fB\fB-M\fR\fR .ad .RS 15n -.rt Preloads all kernel module symbols. By default, \fBmdb\fR performs demand-loading for kernel module symbols: the complete symbol table for a module is read when an address is that module's text or data section is @@ -4331,35 +3895,29 @@ of all kernel modules during startup. .sp .ne 2 -.mk .na \fB\fB-o\fR \fIoption\fR\fR .ad .RS 15n -.rt Enables the specified debugger option. If the \fB-o\fR form of the option is used, the specified \fIoption\fR is disabled. Unless noted below, each option is off by default. \fBmdb\fR recognizes the following \fIoption\fR arguments: .sp .ne 2 -.mk .na \fB\fBadb\fR\fR .ad .RS 25n -.rt Enables stricter \fBadb\fR(1) compatibility. The prompt is set to the empty string and many \fBmdb\fR features, such as the output pager, is disabled. .RE .sp .ne 2 -.mk .na \fB\fBarray_mem_limit=\fR\fIlimit\fR\fR .ad .RS 25n -.rt Sets the default limit on the number of array members that \fB::print\fR displays. If \fIlimit\fR is the special token \fBnone\fR, all array members are displayed by default. @@ -4367,12 +3925,10 @@ displayed by default. .sp .ne 2 -.mk .na \fB\fBarray_str_limit=\fR\fIlimit\fR\fR .ad .RS 25n -.rt Sets the default limit on the number of characters that \fB::print\fR attempts to display as an ASCII string when printing a char array. If \fIlimit\fR is the special token \fBnone\fR, the entire char array is displayed as a string by @@ -4381,22 +3937,18 @@ default. .sp .ne 2 -.mk .na \fB\fBfollow_exec_mode=\fR\fImode\fR\fR .ad .RS 25n -.rt Sets the debugger behavior for following an \fBexec\fR(2) system call. The \fImode\fR should be one of the following named constants: .sp .ne 2 -.mk .na \fB\fBask\fR\fR .ad .RS 10n -.rt If stdout is a terminal device, the debugger stops after the \fBexec\fR(2) system call has returned and then prompts the user to decide whether to follow the exec or stop. If stdout is not a terminal device, the \fBask\fR mode @@ -4405,12 +3957,10 @@ defaults to \fBstop\fR. .sp .ne 2 -.mk .na \fB\fBfollow\fR\fR .ad .RS 10n -.rt The debugger follows the exec by automatically continuing the target process and resetting all of its mappings and symbol tables based on the new executable. The \fBfollow\fR behavior is discussed in more detail under NOTES, @@ -4419,12 +3969,10 @@ executable. The \fBfollow\fR behavior is discussed in more detail under NOTES, .sp .ne 2 -.mk .na \fB\fBstop\fR\fR .ad .RS 10n -.rt The debugger stops following return from the exec system call. The \fBstop\fR behavior is discussed in more detail under NOTES, \fBInteraction with Exec\fR, below. @@ -4434,23 +3982,19 @@ below. .sp .ne 2 -.mk .na \fB\fBfollow_fork_mode=\fR\fImode\fR\fR .ad .RS 25n -.rt Sets the debugger behavior for following a \fBfork\fR(2), \fBfork1\fR(2), or \fBvfork\fR(2) system call. The \fImode\fR should be one of the following named constants: .sp .ne 2 -.mk .na \fB\fBask\fR\fR .ad .RS 10n -.rt If stdout is a terminal device, the debugger stops after the \fBfork\fR(2) system call has returned and then prompts the user to decide whether to follow the parent or child. If stdout is not a terminal device, the \fBask\fR mode @@ -4459,24 +4003,20 @@ defaults to \fBparent\fR. .sp .ne 2 -.mk .na \fB\fBparent\fR\fR .ad .RS 10n -.rt The debugger follows the parent process, and detaches from the child process and sets it running. .RE .sp .ne 2 -.mk .na \fB\fBchild\fR\fR .ad .RS 10n -.rt The debugger follows the child process, and detaches from the parent process and sets it running. .RE @@ -4485,24 +4025,20 @@ and sets it running. .sp .ne 2 -.mk .na \fB\fBignoreeof\fR\fR .ad .RS 25n -.rt The debugger does not exit when an \fBEOF\fR sequence (\fB^D\fR) is entered at the terminal. The \fB::quit\fR dcmd must be used to quit. .RE .sp .ne 2 -.mk .na \fB\fBnostop\fR\fR .ad .RS 25n -.rt Does not stop a user process when attaching to it when the \fB-p\fR option is specified or when the \fB::attach\fR or \fB:A\fR dcmds are applied. The \fBnostop\fR behavior is described in more detail under NOTES, \fBProcess @@ -4511,23 +4047,19 @@ Attach and Release\fR, below. .sp .ne 2 -.mk .na \fB\fBpager\fR\fR .ad .RS 25n -.rt Enables the output pager (default). .RE .sp .ne 2 -.mk .na \fB\fBrepeatlast\fR\fR .ad .RS 25n -.rt If a \fINEWLINE\fR is entered as the complete command at the terminal, \fBmdb\fR repeats the previous command with the current value of dot. This option is implied by \fB-o\fR \fBadb\fR. @@ -4535,12 +4067,10 @@ option is implied by \fB-o\fR \fBadb\fR. .sp .ne 2 -.mk .na \fB\fBshowlmid\fR\fR .ad .RS 25n -.rt \fBmdb\fR provides support for symbol naming and identification in user applications that make use of link maps other than \fILM_ID_BASE\fR and \fILM_ID_LDSO\fR, as described in \fBSymbol Name Resolution\fR, above. Symbols @@ -4558,35 +4088,29 @@ link-map \fBID\fRs according to the value of \fBshowlmid\fR above, including .sp .ne 2 -.mk .na \fB\fB-p\fR \fIpid\fR\fR .ad .RS 15n -.rt Attaches to and stops the specified process-id. \fBmdb\fR uses the \fB/proc/\fIpid\fR/object/a.out\fR file as the executable file pathname. .RE .sp .ne 2 -.mk .na \fB\fB-P\fR \fIprompt\fR\fR .ad .RS 15n -.rt Sets the command prompt. The default prompt is '\fB>\fR '. .RE .sp .ne 2 -.mk .na \fB\fB-R\fR \fIroot\fR\fR .ad .RS 15n -.rt Sets root directory for pathname expansion. By default, the root directory is derived from the pathname of the \fBmdb\fR executable itself. The root directory is substituted in place of the \fB%r\fR token during pathname @@ -4595,12 +4119,10 @@ expansion. .sp .ne 2 -.mk .na \fB\fB-s\fR \fIdistance\fR\fR .ad .RS 15n -.rt Sets the symbol matching distance for address-to-symbol-name conversions to the specified \fIdistance\fR. By default, \fBmdb\fR sets the distance to zero, which enables a smart-matching mode. Each \fBELF\fR symbol table entry includes @@ -4613,12 +4135,10 @@ absolute distance and the symbol size is ignored. .sp .ne 2 -.mk .na \fB\fB-S\fR\fR .ad .RS 15n -.rt Suppresses processing of the user's \fB~/.mdbrc\fR file. By default, \fBmdb\fR reads and processes the macro file \fB\&.mdbrc\fR if one is present in the user's home directory, as defined by $\fBHOME\fR. If the \fB-S\fR option is @@ -4627,12 +4147,10 @@ present, this file is not read. .sp .ne 2 -.mk .na \fB\fB-u\fR\fR .ad .RS 15n -.rt Forces user debugging mode. By default, \fBmdb\fR attempts to infer whether the object and core file operands refer to a user executable and core dump, or to a pair of operating system crash dump files. The \fB-u\fR option forces \fBmdb\fR @@ -4641,12 +4159,10 @@ to assume these files are not operating system crash dump files. .sp .ne 2 -.mk .na \fB\fB-U\fR\fR .ad .RS 15n -.rt Unload \fBkmdb\fR if it is loaded. You should unload \fBkmdb\fR when it is not in use to release the memory used by the kernel debugger back to the free memory available to the operating system. @@ -4654,12 +4170,10 @@ memory available to the operating system. .sp .ne 2 -.mk .na \fB\fB-V\fR \fIversion\fR\fR .ad .RS 15n -.rt Sets disassembler version. By default, \fBmdb\fR attempts to infer the appropriate disassembler version for the debug target. The disassembler can be set explicitly using the \fB-V\fR option. The \fB::disasms\fR dcmd lists the @@ -4668,23 +4182,19 @@ available disassembler versions. .sp .ne 2 -.mk .na \fB\fB-w\fR\fR .ad .RS 15n -.rt Opens the specified object and core files for writing. .RE .sp .ne 2 -.mk .na \fB\fB-W\fR\fR .ad .RS 15n -.rt Permit access to memory addresses that are mapped to I/O devices. By default, \fBmdb\fR does not allow such access because many devices do not provide hardware protection against invalid software manipulations. Use this option @@ -4693,12 +4203,10 @@ only when debugging device drivers and with caution. .sp .ne 2 -.mk .na \fB\fB-y\fR\fR .ad .RS 15n -.rt Sends explicit terminal initialization sequences for tty mode. Some terminals, such as \fBcmdtool\fR(1), require explicit initialization sequences to switch into a tty mode. Without this initialization sequence, terminal features such @@ -4711,12 +4219,10 @@ as standout mode can not be available to \fBmdb\fR. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIobject\fR\fR .ad .RS 10n -.rt Specifies an \fBELF\fR format object file to examine. \fBmdb\fR provides the ability to examine and edit \fBELF\fR format executables (\fBET_EXEC\fR), \fBELF\fR dynamic library files (\fBET_DYN\fR), \fBELF\fR relocatable object @@ -4725,12 +4231,10 @@ files (\fBET_REL\fR), and operating system unix.X symbol table files. .sp .ne 2 -.mk .na \fB\fIcore\fR\fR .ad .RS 10n -.rt Specifies an \fBELF\fR process core file (\fBET_CORE\fR), or an operating system crash dump vmcore.X file. If an \fBELF\fR core file operand is provided without a corresponding object file, \fBmdb\fR attempts to infer the name of @@ -4741,12 +4245,10 @@ information can be unavailable. .sp .ne 2 -.mk .na \fB\fIsuffix\fR\fR .ad .RS 10n -.rt Specifies the numerical suffix representing a pair of operating system crash dump files. For example, if the suffix is '\fB3\fR', \fBmdb\fR infers that it should examine the files '\fBunix.3\fR' and '\fBvmcore.3\fR'. The string of @@ -4767,58 +4269,48 @@ which are files greater than or equal to 2 Gbytes (2^31 bytes). The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt Debugger completed execution successfully. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt A fatal error occurred. .RE .sp .ne 2 -.mk .na \fB\fB2\fR\fR .ad .RS 5n -.rt Invalid command line options were specified. .RE .SH ENVIRONMENT VARIABLES .sp .ne 2 -.mk .na \fB\fBHISTSIZE\fR\fR .ad .RS 12n -.rt This variable is used to determine the maximum length of the command history list. If this variable is not present, the default length is \fB128\fR. .RE .sp .ne 2 -.mk .na \fB\fBHOME\fR\fR .ad .RS 12n -.rt This variable is used to determine the pathname of the user's home directory, where a \fB\&.mdbrc\fR file can reside. If this variable is not present, no \fB\&.mdbrc\fR processing occurs. @@ -4826,12 +4318,10 @@ where a \fB\&.mdbrc\fR file can reside. If this variable is not present, no .sp .ne 2 -.mk .na \fB\fBSHELL\fR\fR .ad .RS 12n -.rt This variable is used to determine the pathname of the shell used to process shell escapes requested using the \fB!\fR meta-character. If this variable is not present, \fB/bin/sh\fR is used. @@ -4840,7 +4330,6 @@ not present, \fB/bin/sh\fR is used. .SH FILES .sp .ne 2 -.mk .na \fB\fB$HOME/.mdbrc\fR\fR .ad @@ -4853,7 +4342,6 @@ auto-loading is performed or any commands have been read from standard input. .sp .ne 2 -.mk .na \fB\fB/dev/kmem\fR\fR .ad @@ -4865,7 +4353,6 @@ core file when examining the live operating system. .sp .ne 2 -.mk .na \fB\fB/dev/ksyms\fR\fR .ad @@ -4877,7 +4364,6 @@ when examining the live operating system. .sp .ne 2 -.mk .na \fB\fB/proc/\fIpid\fR/*\fR\fR .ad @@ -4889,7 +4375,6 @@ processes. .sp .ne 2 -.mk .na \fB\fB/usr/lib/adb\fR\fR .ad @@ -4907,7 +4392,6 @@ machine as if by \fBuname\fR \fB-i\fR (see \fBuname\fR(1)). .sp .ne 2 -.mk .na \fB\fB/usr/lib/mdb\fR\fR .ad @@ -4931,13 +4415,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityEvolving +Interface Stability Evolving .TE .SH SEE ALSO diff --git a/usr/src/man/man1/mesg.1 b/usr/src/man/man1/mesg.1 index 19aa331791..61ba1b214f 100644 --- a/usr/src/man/man1/mesg.1 +++ b/usr/src/man/man1/mesg.1 @@ -1,13 +1,13 @@ '\" te .\" Copyright 1989 AT&T Copyright (c) 1992, X/Open Company Limited All Rights Reserved Portions Copyright (c) 1995, Sun Microsystems, Inc. All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 mesg 1 "31 Oct 1997" "SunOS 5.11" "User Commands" +.TH MESG 1 "Oct 31, 1997" .SH NAME mesg \- permit or deny messages .SH SYNOPSIS @@ -32,24 +32,20 @@ may be able to send messages to the terminal independent of the current state. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-n\fR|\fBn\fR \fR .ad .RS 9n -.rt Denies permission to other users to send message to the terminal. See \fBwrite\fR(1). .RE .sp .ne 2 -.mk .na \fB\fB-y\fR|\fBy\fR \fR .ad .RS 9n -.rt Grants permission to other users to send messages to the terminal. .RE @@ -65,57 +61,47 @@ that affect the execution of \fBmesg\fR: \fBLANG\fR, \fBLC_ALL\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR \fR .ad .RS 6n -.rt if messages are receivable. .RE .sp .ne 2 -.mk .na \fB\fB1\fR \fR .ad .RS 6n -.rt if messages are not receivable. .RE .sp .ne 2 -.mk .na \fB\fB2\fR \fR .ad .RS 6n -.rt on error. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB/dev/tty*\fR \fR .ad .RS 15n -.rt terminal devices .RE .sp .ne 2 -.mk .na \fB\fB/dev/pts/*\fR \fR .ad .RS 15n -.rt terminal devices .RE @@ -127,13 +113,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man1/mkdir.1 b/usr/src/man/man1/mkdir.1 index 660f6061d7..4ce0e34037 100644 --- a/usr/src/man/man1/mkdir.1 +++ b/usr/src/man/man1/mkdir.1 @@ -1,16 +1,16 @@ '\" te .\" Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved -.\" Copyright 1989 AT&T +.\" Copyright 1989 AT&T .\" Portions Copyright (c) 1982-2007 AT&T Knowledge Ventures .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 mkdir 1 "2 Nov 2007" "SunOS 5.11" "User Commands" +.TH MKDIR 1 "Nov 2, 2007" .SH NAME mkdir \- make directories .SH SYNOPSIS @@ -67,24 +67,20 @@ in \fBumask\fR(1). The following options are supported by \fB/usr/bin/mkdir\fR: .sp .ne 2 -.mk .na \fB\fB-m\fR \fImode\fR\fR .ad .RS 11n -.rt This option allows users to specify the mode to be used for new directories. Choices for modes can be found in \fBchmod\fR(1). .RE .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 11n -.rt With this option, \fBmkdir\fR creates \fIdir\fR by creating all the non-existing parent directories first. The mode given to intermediate directories is the difference between \fB777\fR and the bits set in the file @@ -98,7 +94,6 @@ and execute permission for the user). The following options are supported by the \fBmkdir\fR built-in in \fBksh93\fR: .sp .ne 2 -.mk .na \fB\fB-m\fR \fImode\fR\fR .ad @@ -107,7 +102,6 @@ The following options are supported by the \fBmkdir\fR built-in in \fBksh93\fR: \fB\fB--mode=\fR\fImode\fR\fR .ad .RS 15n -.rt Set the mode of created directories to \fImode\fR. \fImode\fR is symbolic or octal mode as in \fBchmod\fR(1). Relative modes assume an initial mode of \fBa=rwx\fR. @@ -115,7 +109,6 @@ octal mode as in \fBchmod\fR(1). Relative modes assume an initial mode of .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad @@ -124,7 +117,6 @@ octal mode as in \fBchmod\fR(1). Relative modes assume an initial mode of \fB\fB--parents\fR\fR .ad .RS 15n -.rt Create any missing intermediate pathname components. For each dir operand that does not name an existing directory, effects equivalent to those caused by the following command shall occur: @@ -148,12 +140,10 @@ existing directory is ignored without error. The following operand is supported: .sp .ne 2 -.mk .na \fB\fIdir\fR\fR .ad .RS 7n -.rt A path name of a directory to be created. .RE @@ -193,24 +183,20 @@ that affect the execution of \fBmkdir\fR: \fBLANG\fR, \fBLC_ALL\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt All the specified directories were created successfully or the \fB-p\fR option was specified and all the specified directories now exist. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -223,17 +209,16 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityCommitted +Interface Stability Committed _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .SS "ksh93" @@ -241,15 +226,14 @@ StandardSee \fBstandards\fR(5). .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilitySee below. +Interface Stability See below. _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .sp diff --git a/usr/src/man/man1/mkmsgs.1 b/usr/src/man/man1/mkmsgs.1 index 29eb64ecba..dba369e8ec 100644 --- a/usr/src/man/man1/mkmsgs.1 +++ b/usr/src/man/man1/mkmsgs.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 mkmsgs 1 "26 Jul 1994" "SunOS 5.11" "User Commands" +.TH MKMSGS 1 "Jul 26, 1994" .SH NAME mkmsgs \- create message files for use by gettxt .SH SYNOPSIS @@ -54,23 +54,19 @@ software compatibility will be broken. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-o\fR \fR .ad .RS 14n -.rt Overwrite \fImsgfile\fR, if it exists. .RE .sp .ne 2 -.mk .na \fB\fB-i\fR\fI locale\fR \fR .ad .RS 14n -.rt Install \fImsgfile\fR in the \fB/usr/lib/\fIlocale\fR/\fR\fIlocale\fR/\fBLC_MESSAGES\fR directory. Only someone who is super user or a member of group \fBbin\fR can create or @@ -143,7 +139,6 @@ the beginning of the \fBDESCRIPTION\fR section. .SH FILES .sp .ne 2 -.mk .na \fB\fB/usr/lib/locale/\fR\fBlocale\fR\fB/\fR\fBLC_MESSAGES\fR\fB/* \fR\fR .ad diff --git a/usr/src/man/man1/mktemp.1 b/usr/src/man/man1/mktemp.1 index 5890a5e23f..f87583b952 100644 --- a/usr/src/man/man1/mktemp.1 +++ b/usr/src/man/man1/mktemp.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 mktemp 1 "10 Jan 2008" "SunOS 5.11" "User Commands" +.TH MKTEMP 1 "Jan 10, 2008" .SH NAME mktemp \- make temporary filename .SH SYNOPSIS @@ -44,23 +44,19 @@ instead. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad .RS 16n -.rt Make a directory instead of a file. .RE .sp .ne 2 -.mk .na \fB\fB-p\fR \fIdirectory\fR\fR .ad .RS 16n -.rt Use the specified directory as a prefix when generating the temporary filename. The directory is overridden by the user's TMPDIR environment variable if it is set. This option implies the \fB-t\fR flag. @@ -68,24 +64,20 @@ set. This option implies the \fB-t\fR flag. .sp .ne 2 -.mk .na \fB\fB-q\fR\fR .ad .RS 16n -.rt Fail silently if an error occurs. This is useful if a script does not want error output to go to standard error. .RE .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad .RS 16n -.rt Generate a path rooted in a temporary directory. This directory is chosen as follows: If the user's TMPDIR environment variable is set, the directory contained therein is used. Otherwise, if the \fB-p\fR flag was given the @@ -96,12 +88,10 @@ opposed to a full path) and thus should not contain any forward slashes. .sp .ne 2 -.mk .na \fB\fB-u\fR\fR .ad .RS 16n -.rt Operate in unsafe mode. The temp file is unlinked before \fBmktemp\fR exits. This is slightly better than \fBmktemp\fR(3C), but still introduces a race condition. Use of this option is discouraged. @@ -113,12 +103,10 @@ condition. Use of this option is discouraged. The following operands are supported: .sp .ne 2 -.mk .na \fB\fItemplate\fR\fR .ad .RS 12n -.rt \fItemplate\fR can be any filename with one or more \fBX\fRs appended to it, for example \fB/tmp/tfile.XXXXXX\fR. .sp @@ -254,23 +242,19 @@ that affect the execution of \fBmktemp\fR with the \fB-t\fR option: The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt An error occurred. .RE @@ -282,13 +266,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed .TE .SH SEE ALSO diff --git a/usr/src/man/man1/moe.1 b/usr/src/man/man1/moe.1 index 82f27a9d2a..994192b8a4 100644 --- a/usr/src/man/man1/moe.1 +++ b/usr/src/man/man1/moe.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 moe 1 "2 Feb 2005" "SunOS 5.11" "User Commands" +.TH MOE 1 "Feb 2, 2005" .SH NAME moe \- manifest the optimal expansion of a pathname .SH SYNOPSIS @@ -57,45 +57,37 @@ runtime linker, refer to the \fILinker and Libraries Guide\fR. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-32\fR\fR .ad .RS 7n -.rt Only analyze 32-bit objects. .RE .sp .ne 2 -.mk .na \fB\fB-64\fR\fR .ad .RS 7n -.rt Only analyze 64-bit objects. .RE .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad .RS 7n -.rt Prefix each pathname with the class of the object. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 7n -.rt Silent. No optimal name, or error diagnostics are displayed. Only an error return is made available. This option is only meaningful with the \fB-32\fR and \fB-64\fR options. The \fB-s\fR option can not be used with the \fB-v\fR @@ -104,12 +96,10 @@ option. .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 7n -.rt Verbose. If no optimal expansion name can be determined, an error diagnostic is written to standard error. The \fB-v\fR option can not be used with the \fB-s\fR option. @@ -121,12 +111,10 @@ written to standard error. The \fB-v\fR option can not be used with the The following operand is supported: .sp .ne 2 -.mk .na \fB\fIpath\fR\fR .ad .RS 8n -.rt The pathname to be expanded. .RE @@ -180,7 +168,7 @@ result in the following diagnostic being produced. .in +2 .nf % \fBmoe -c -v -32 '/opt/ISV/$ISALIST/isa.so.1'\fR -32-bit: /opt/ISV/sparcv9/isa.so.1: wrong ELF class: ELFCLASS64 +32-bit: /opt/ISV/sparcv9/isa.so.1: wrong ELF class: ELFCLASS64 .fi .in -2 .sp @@ -199,13 +187,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStable +Interface Stability Stable .TE .SH SEE ALSO diff --git a/usr/src/man/man1/more.1 b/usr/src/man/man1/more.1 index 34ab151bde..25522161b9 100644 --- a/usr/src/man/man1/more.1 +++ b/usr/src/man/man1/more.1 @@ -1,37 +1,37 @@ '\" te .\" Copyright 1989 AT&T Copyright (c) 2005, Sun Microsystems, Inc. All Rights Reserved Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 more 1 "4 Nov 2005" "SunOS 5.11" "User Commands" +.TH MORE 1 "Nov 4, 2005" .SH NAME more, page \- browse or page through a text file .SH SYNOPSIS .LP .nf -\fB/usr/bin/more\fR [\fB-cdflrsuw\fR] [\fB-lines\fR] [+ \fIlinenumber\fR] +\fB/usr/bin/more\fR [\fB-cdflrsuw\fR] [\fB-lines\fR] [+ \fIlinenumber\fR] [+/ \fIpattern\fR] [\fIfile\fR]... .fi .LP .nf -\fB/usr/bin/page\fR [\fB-cdflrsuw\fR] [\fB-lines\fR] [+ \fIlinenumber\fR] +\fB/usr/bin/page\fR [\fB-cdflrsuw\fR] [\fB-lines\fR] [+ \fIlinenumber\fR] [+/ \fIpattern\fR] [\fIfile\fR]... .fi .LP .nf -\fB/usr/xpg4/bin/more\fR [\fB-cdeisu\fR] [\fB-n\fR \fInumber\fR] [\fB-p\fR \fIcommand\fR] +\fB/usr/xpg4/bin/more\fR [\fB-cdeisu\fR] [\fB-n\fR \fInumber\fR] [\fB-p\fR \fIcommand\fR] [\fB-t\fR \fItagstring\fR] [\fIfile\fR]... .fi .LP .nf -\fB/usr/xpg4/bin/more\fR [\fB-cdeisu\fR] [\fB-n\fR \fInumber\fR] [+ \fIcommand\fR] +\fB/usr/xpg4/bin/more\fR [\fB-cdeisu\fR] [\fB-n\fR \fInumber\fR] [+ \fIcommand\fR] [\fB-t\fR \fItagstring\fR] [\fIfile\fR]... .fi @@ -74,12 +74,10 @@ The following options are supported for both \fB/usr/bin/more\fR and \fB/usr/xpg4/bin/more\fR: .sp .ne 2 -.mk .na \fB\fB-c\fR \fR .ad .RS 7n -.rt Clears before displaying. Redraws the screen instead of scrolling for faster displays. This option is ignored if the terminal does not have the ability to clear to the end of a line. @@ -87,24 +85,20 @@ clear to the end of a line. .sp .ne 2 -.mk .na \fB\fB-d\fR \fR .ad .RS 7n -.rt Displays error messages rather than ringing the terminal bell if an unrecognized command is used. This is helpful for inexperienced users. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR \fR .ad .RS 7n -.rt Squeeze. Replaces multiple blank lines with a single blank line. This is helpful when viewing \fBnroff\fR(1) output on the screen. .RE @@ -115,12 +109,10 @@ helpful when viewing \fBnroff\fR(1) output on the screen. The following options are supported for \fB/usr/bin/more\fR only: .sp .ne 2 -.mk .na \fB\fB-f\fR \fR .ad .RS 15n -.rt Does not fold long lines. This is useful when lines contain nonprinting characters or escape sequences, such as those generated when \fBnroff\fR(1) output is piped through \fBul\fR(1). @@ -128,12 +120,10 @@ output is piped through \fBul\fR(1). .sp .ne 2 -.mk .na \fB\fB-l\fR \fR .ad .RS 15n -.rt Does not treat \fBFORMFEED\fR characters (Control-l) as page breaks. If \fB-l\fR is not used, \fBmore\fR pauses to accept commands after any line containing a \fB^L\fR character (Control-l). Also, if a file begins with a @@ -142,12 +132,10 @@ containing a \fB^L\fR character (Control-l). Also, if a file begins with a .sp .ne 2 -.mk .na \fB\fB-r\fR \fR .ad .RS 15n -.rt Normally, \fBmore\fR ignores control characters that it does not interpret in some way. The \fB-r\fR option causes these to be displayed as \fB^\fR\fIC\fR where \fIC\fR stands for any such control character. @@ -155,12 +143,10 @@ where \fIC\fR stands for any such control character. .sp .ne 2 -.mk .na \fB\fB-u\fR \fR .ad .RS 15n -.rt Suppresses generation of underlining escape sequences. Normally, \fBmore\fR handles underlining, such as that produced by \fBnroff\fR(1), in a manner appropriate to the terminal. If the terminal can perform underlining or has a @@ -170,12 +156,10 @@ in the text file. .sp .ne 2 -.mk .na \fB\fB-w\fR \fR .ad .RS 15n -.rt Normally, \fBmore\fR exits when it comes to the end of its input. With \fB-w\fR, however, \fBmore\fR prompts and waits for any key to be struck before exiting. @@ -183,35 +167,29 @@ exiting. .sp .ne 2 -.mk .na \fB\fB-\fR\fIlines\fR\fR .ad .RS 15n -.rt Displays the indicated number of \fIlines\fR in each screenful, rather than the default (the number of lines in the terminal screen less two). .RE .sp .ne 2 -.mk .na \fB\fB+\fR\fIlinenumber\fR\fR .ad .RS 15n -.rt Start up at \fIlinenumber\fR. .RE .sp .ne 2 -.mk .na \fB\fB+/\fR\fIpattern\fR\fR .ad .RS 15n -.rt Start up two lines above the line containing the regular expression \fIpattern\fR. \fBNote:\fR Unlike editors, this construct should \fInot\fR end with a `\fB/\fR.' If it does, then the trailing slash is taken as a character @@ -224,35 +202,29 @@ in the search pattern. The following options are supported for \fB/usr/xpg4/bin/more\fR only: .sp .ne 2 -.mk .na \fB\fB-e\fR \fR .ad .RS 17n -.rt Exits immediately after writing the last line of the last file in the argument list. .RE .sp .ne 2 -.mk .na \fB\fB-i\fR \fR .ad .RS 17n -.rt Performs pattern matching in searches without regard to case. .RE .sp .ne 2 -.mk .na \fB\fB-n\fR \fInumber\fR \fR .ad .RS 17n -.rt Specifies the number of lines per screenful. The \fInumber\fR argument is a positive decimal integer. The \fB-n\fR option overrides any values obtained from the environment. @@ -260,7 +232,6 @@ from the environment. .sp .ne 2 -.mk .na \fB\fB-p\fR \fIcommand\fR \fR .ad @@ -269,7 +240,6 @@ from the environment. \fB\fB+\fR\fIcommand\fR \fR .ad .RS 17n -.rt For each file examined, initially executes the \fBmore\fR command in the \fIcommand\fR argument. If the command is a positioning command, such as a line number or a regular expression search, set the current position to represent @@ -278,7 +248,7 @@ file. For example, the two commands: .sp .in +2 .nf -\fBmore -p 1000j file +\fBmore -p 1000j file more -p 1000G file\fR .fi .in -2 @@ -292,24 +262,20 @@ unsuccessful, the first line in the file will be the current position. .sp .ne 2 -.mk .na \fB\fB-t\fR \fItagstring\fR \fR .ad .RS 17n -.rt Writes the screenful of the file containing the tag named by the \fItagstring\fR argument. See the \fBctags\fR(1) utility. .RE .sp .ne 2 -.mk .na \fB\fB-u\fR\fR .ad .RS 17n -.rt Treats a backspace character as a printable control character, displayed as a ^H (Control-h), suppressing backspacing and the special handling that produces underlined or standout-mode text on some terminal types. Also, does not ignore @@ -349,29 +315,24 @@ In the following commands, \fIi\fR is a numerical argument (\fB1\fR by default). .sp .ne 2 -.mk .na \fB\fIi\fRSPACE \fR .ad .RS 13n -.rt Display another screenful, or \fIi\fR more lines if \fIi\fR is specified. .RE .sp .ne 2 -.mk .na \fB\fIi\fRRETURN \fR .ad .RS 13n -.rt Display another line, or \fIi\fR more lines, if specified. .RE .sp .ne 2 -.mk .na \fB\fIi\fR\fBb\fR\fR .ad @@ -380,13 +341,11 @@ Display another line, or \fIi\fR more lines, if specified. \fB\fIi\fR\fB^B\fR\fR .ad .RS 13n -.rt (Control-b) Skip back \fIi\fR screenfuls and then print a screenful. .RE .sp .ne 2 -.mk .na \fB\fIi\fR\fBd\fR\fR .ad @@ -395,7 +354,6 @@ Display another line, or \fIi\fR more lines, if specified. \fB\fIi\fR\fB^D\fR\fR .ad .RS 13n -.rt (Control-d) Scroll forward one half screenful or \fIi\fR more lines. If \fIi\fR is specified, the count becomes the default for subsequent \fBd\fR and \fBu\fR commands. @@ -403,51 +361,42 @@ commands. .sp .ne 2 -.mk .na \fB\fIi\fR\fBf\fR\fR .ad .RS 13n -.rt Skip \fIi\fR screens full and then print a screenful. .RE .sp .ne 2 -.mk .na \fB\fBh\fR\fR .ad .RS 13n -.rt Help. Give a description of all the \fBmore\fR commands. .RE .sp .ne 2 -.mk .na \fB\fB^L\fR \fR .ad .RS 13n -.rt (Control-l) Refresh. .RE .sp .ne 2 -.mk .na \fB\fIi\fR\fBn\fR\fR .ad .RS 13n -.rt Search for the \fIi\|\fRth occurrence of the last \fIpattern\fR entered. .RE .sp .ne 2 -.mk .na \fB\fBq\fR \fR .ad @@ -456,63 +405,52 @@ Search for the \fIi\|\fRth occurrence of the last \fIpattern\fR entered. \fB\fBQ\fR \fR .ad .RS 13n -.rt Exit from \fBmore\fR. .RE .sp .ne 2 -.mk .na \fB\fIi\fR\fBs\fR\fR .ad .RS 13n -.rt Skip \fIi\fR lines and then print a screenful. .RE .sp .ne 2 -.mk .na \fB\fBv\fR\fR .ad .RS 13n -.rt Drop into the \fBvi\fR editor at the current line of the current file. .RE .sp .ne 2 -.mk .na \fB\fIi\fR\fBz\fR\fR .ad .RS 13n -.rt Same as SPACE, except that \fIi\fR, if present, becomes the new default number of lines per screenful. .RE .sp .ne 2 -.mk .na \fB\fB=\fR \fR .ad .RS 13n -.rt Display the current line number. .RE .sp .ne 2 -.mk .na \fB\fIi\fR\fB/\fR\fIpattern\fR\fR .ad .RS 13n -.rt Search forward for the \fIi\|\fRth occurrence of the regular expression \fIpattern\fR. Display the screenful starting two lines before the line that contains the \fIi\|\fRth match for the regular expression \fIpattern\fR, or the @@ -524,12 +462,10 @@ the first column cancels the search command. .sp .ne 2 -.mk .na \fB\fB!\fR\fIcommand\fR\fR .ad .RS 13n -.rt Invoke a shell to execute \fIcommand\|\fR. The characters \fB%\fR and \fB!\fR, when used within \fIcommand\fR are replaced with the current filename and the previous shell command, respectively. If there is no current filename, \fB%\fR @@ -538,35 +474,29 @@ is not expanded. Prepend a backslash to these characters to escape expansion. .sp .ne 2 -.mk .na \fB\fB:f\fR\fR .ad .RS 13n -.rt Display the current filename and line number. .RE .sp .ne 2 -.mk .na \fB\fIi\fR\fB:n\fR\fR .ad .RS 13n -.rt Skip to the \fIi\|\fRth next filename given in the command line, or to the last filename in the list if \fIi\fR is out of range. .RE .sp .ne 2 -.mk .na \fB\fIi\fR\fB:p\fR\fR .ad .RS 13n -.rt Skip to the \fIi\|\fRth previous filename given in the command line, or to the first filename if \fIi\fR is out of range. If given while \fBmore\fR is positioned within a file, go to the beginning of the file. If \fBmore\fR is @@ -575,7 +505,6 @@ reading from a pipe, \fBmore\fR simply rings the terminal bell. .sp .ne 2 -.mk .na \fB\fB:q\fR\fR .ad @@ -584,7 +513,6 @@ reading from a pipe, \fBmore\fR simply rings the terminal bell. \fB\fB:Q\fR\fR .ad .RS 13n -.rt Exit from \fBmore\fR (same as \fBq\fR or \fBQ\fR). .RE @@ -594,35 +522,29 @@ Exit from \fBmore\fR (same as \fBq\fR or \fBQ\fR). The following commands are available only in \fB/usr/bin/more\fR: .sp .ne 2 -.mk .na \fB\fB\&'\fR\fR .ad .RS 9n -.rt Single quote. Go to the point from which the last search started. If no search has been performed in the current file, go to the beginning of the file. .RE .sp .ne 2 -.mk .na \fB\fB\&.\fR\fR .ad .RS 9n -.rt Dot. Repeat the previous command. .RE .sp .ne 2 -.mk .na \fB\fB^\|\e\fR\fR .ad .RS 9n -.rt Halt a partial display of text. \fBmore\fR stops sending output, and displays the usual \fB--More--\fR prompt. Some output is lost as a result. .RE @@ -633,119 +555,98 @@ the usual \fB--More--\fR prompt. Some output is lost as a result. The following commands are available only in \fB/usr/xpg4/bin/more\fR: .sp .ne 2 -.mk .na \fB\fIi\fR\fB^F\fR\fR .ad .RS 17n -.rt (Control-f) Skip \fIi\fR screens full and print a screenful. (Same as \fIi\fR\fBf\fR.) .RE .sp .ne 2 -.mk .na \fB\fB^G\fR\fR .ad .RS 17n -.rt (Control-g) Display the current line number (same as \fB=\fR). .RE .sp .ne 2 -.mk .na \fB\fIi\fR\fBg\fR\fR .ad .RS 17n -.rt Go to line number \fIi\fR with the default of the first line in the file. .RE .sp .ne 2 -.mk .na \fB\fIi\fR\fBG\fR\fR .ad .RS 17n -.rt Go to line number \fIi\fR with the default of the Last line in the file. .RE .sp .ne 2 -.mk .na \fB\fIi\fR\fBj\fR\fR .ad .RS 17n -.rt Display another line, or \fIi\fR more lines, if specified. (Same as \fIi\fRRETURN.) .RE .sp .ne 2 -.mk .na \fB\fIi\fR\fBk\fR\fR .ad .RS 17n -.rt Scroll backwards one or \fIi\fR lines, if specified. .RE .sp .ne 2 -.mk .na \fB\fBm\fR\fIletter\fR \fR .ad .RS 17n -.rt Mark the current position with the name \fIletter\fR. .RE .sp .ne 2 -.mk .na \fB\fBN\fR \fR .ad .RS 17n -.rt Reverse direction of search. .RE .sp .ne 2 -.mk .na \fB\fBr\fR \fR .ad .RS 17n -.rt Refresh the screen. .RE .sp .ne 2 -.mk .na \fB\fBR\fR \fR .ad .RS 17n -.rt Refresh the screen, discarding any buffered input. .RE .sp .ne 2 -.mk .na \fB\fIi\fR\fBu\fR\fR .ad @@ -754,7 +655,6 @@ Refresh the screen, discarding any buffered input. \fB\fIi\fR\fB^U\fR\fR .ad .RS 17n -.rt (Control-u) Scroll backwards one half a screen of \fIi\fR lines, if specified. If \fIi\fR is specified, the count becomes the new default for subsequent \fBd\fR and \fBu\fR commands. @@ -762,35 +662,29 @@ If \fIi\fR is specified, the count becomes the new default for subsequent .sp .ne 2 -.mk .na \fB\fBZZ\fR \fR .ad .RS 17n -.rt Exit from \fBmore\fR (same as \fBq\fR). .RE .sp .ne 2 -.mk .na \fB\fB:e\fR \fIfile\fR \fR .ad .RS 17n -.rt Examine (display) a new file. If no \fIfile\fR is specified, the current file is redisplayed. .RE .sp .ne 2 -.mk .na \fB\fB:t\fR \fItagstring\fR \fR .ad .RS 17n -.rt Go to the tag named by the \fItagstring\fR argument and scroll/rewrite the screen with the tagged line in the current position. See the \fBctags\fR utility. @@ -798,35 +692,29 @@ utility. .sp .ne 2 -.mk .na \fB\fB\&'\fR\fIletter\fR \fR .ad .RS 17n -.rt Return to the position that was previously marked with the name \fIletter\fR. .RE .sp .ne 2 -.mk .na \fB\fB\&''\fR \fR .ad .RS 17n -.rt Return to the position from which the last move of more than a screenful was made. Defaults to the beginning of the file. .RE .sp .ne 2 -.mk .na \fB\fIi\fR\fB?\fR[\fI!\fR]\fIpattern\fR\fR .ad .RS 17n -.rt Search backward in the file for the \fIi\fRth line containing the \fIpattern\fR. The \fI!\fR specifies to search backward for the \fIi\fRth line that does not contain the \fIpattern\fR. @@ -834,24 +722,20 @@ that does not contain the \fIpattern\fR. .sp .ne 2 -.mk .na \fB\fIi\fR\fB/\fR\fB!\fR\fIpattern\fR\fR .ad .RS 17n -.rt Search forward in the file for the \fIi\fRth line that does not contain the pattern. .RE .sp .ne 2 -.mk .na \fB\fB!\fR[\fIcommand\fR]\fR .ad .RS 17n -.rt Invoke a shell or the specified command. .RE @@ -875,46 +759,38 @@ The following environment variables also affect the execution of \fB/usr/xpg4/bin/more\fR: .sp .ne 2 -.mk .na \fB\fBCOLUMNS\fR \fR .ad .RS 12n -.rt Overrides the system selected horizontal screen size. .RE .sp .ne 2 -.mk .na \fB\fBEDITOR\fR \fR .ad .RS 12n -.rt Used by the \fBv\fR command to select an editor. .RE .sp .ne 2 -.mk .na \fB\fBLINES\fR \fR .ad .RS 12n -.rt Overrides the system selected vertical screen size. The \fB-n\fR option has precedence over \fBLINES\fR in determining the number of lines in a screen. .RE .sp .ne 2 -.mk .na \fB\fBMORE\fR \fR .ad .RS 12n -.rt A string specifying options as described in the OPTIONS section, above. As in a command line, The options must be separated by blank characters and each option specification must start with a \(mi. Any command line options are processed @@ -928,35 +804,29 @@ $MORE\fR \fIoptions operands\fR The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR \fR .ad .RS 7n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR \fR .ad .RS 7n -.rt An error occurred. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB/usr/lib/more.help\fR\fR .ad .RS 22n -.rt help file for \fB/usr/bin/more\fR and \fB/usr/bin/page\fR only. .RE @@ -969,13 +839,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSINot enabled +CSI Not enabled .TE .SS "/usr/xpg4/bin/more" @@ -983,15 +852,14 @@ CSINot enabled .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man1/mpss.so.1.1 b/usr/src/man/man1/mpss.so.1.1 index f6e399a081..e14b891fd0 100644 --- a/usr/src/man/man1/mpss.so.1.1 +++ b/usr/src/man/man1/mpss.so.1.1 @@ -3,13 +3,13 @@ .\" 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 mpss.so.1 1 "20 Feb 2002" "SunOS 5.11" "User Commands" +.TH MPSS.SO.1 1 "Feb 20, 2002" .SH NAME mpss.so.1 \- shared object for setting preferred page size .SH SYNOPSIS .LP .nf -\fBmpss.so.1\fR +\fBmpss.so.1\fR .fi .SH DESCRIPTION @@ -36,7 +36,6 @@ environment variables to determine any preferred page size requirements and any processes these may be specific to. .sp .ne 2 -.mk .na \fB\fBMPSSHEAP\fR=\fIsize\fR \fR .ad @@ -45,7 +44,6 @@ processes these may be specific to. \fB\fBMPSSSTACK\fR=\fIsize\fR\fR .ad .RS 27n -.rt \fBMPSSHEAP\fR and \fBMPSSSTACK\fR specify the preferred page sizes for the heap and stack, respectively. The specified page size(s) are applied to all created processes. @@ -60,12 +58,10 @@ specify Kilobytes, Megabytes, Gigabytes, or Terabytes respectively. .sp .ne 2 -.mk .na \fB\fBMPSSCFGFILE\fR=\fIconfig-file\fR\fR .ad .RS 27n -.rt \fIconfig-file\fR is a text file which contains one or more \fBmpss\fR configuration entries of the form: .sp @@ -97,12 +93,10 @@ file \fB/etc/mpss.conf\fR if it exists. .sp .ne 2 -.mk .na \fB\fBMPSSERRFILE\fR=\fIpathname\fR\fR .ad .RS 27n -.rt By default, error messages are logged via \fBsyslog\fR(3C) using level \fBLOG_ERR\fR and facility \fBLOG_USER\fR. If \fBMPSSERRFILE\fR contains a valid \fIpathname\fR (such as \fB/dev/stderr\fR), error messages will be logged @@ -204,23 +198,19 @@ ora* ora1:4m:4m .SH FILES .sp .ne 2 -.mk .na \fB\fB/usr/lib/ld/map.bssalign\fR \fR .ad .RS 29n -.rt A template link-editor \fBmapfile\fR for aligning bss (see NOTES). .RE .sp .ne 2 -.mk .na \fB\fB/etc/mpss.conf\fR\fR .ad .RS 29n -.rt Configuration file .RE @@ -232,13 +222,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityEvolving +Interface Stability Evolving .TE .SH SEE ALSO diff --git a/usr/src/man/man1/msgcc.1 b/usr/src/man/man1/msgcc.1 index bb48eba81c..313d06637d 100644 --- a/usr/src/man/man1/msgcc.1 +++ b/usr/src/man/man1/msgcc.1 @@ -2,7 +2,7 @@ .\" Copyright (c) 2000-2007 AT&T Knowledge Ventures .\" To view license terms, see http://www.opensource.org/licenses/cpl1.0.txt .\" Portions Copyright (c) 2007, Sun Microsystems, Inc. -.TH msgcc 1 "9 Oct 2007" "SunOS 5.11" "User Commands" +.TH MSGCC 1 "Oct 9, 2007" .SH NAME msgcc \- C language message catalog compiler .SH SYNOPSIS @@ -34,56 +34,46 @@ pre-existing \fB-o\fR file. The following options are supported: .sp .ne 2 -.mk .na \fB\fIcc-options\fR\fR .ad .RS 14n -.rt Specify \fBcc\fR style options and arguments. .RE .sp .ne 2 -.mk .na \fB\fB-M-\fR\fIoption\fR\fR .ad .RS 14n -.rt Set a \fBmsgcc\fR option. .sp Specify option as one of the following: .sp .ne 2 -.mk .na \fB\fBmkmsgs\fR\fR .ad .RS 18n -.rt The \fB-o\fR file is assumed to be in \fBmkmsgs\fR(1) format. .RE .sp .ne 2 -.mk .na \fB\fBnew\fR\fR .ad .RS 18n -.rt Create a new \fB-o\fR file. .RE .sp .ne 2 -.mk .na \fB\fBpreserve\fR\fR .ad .RS 18n -.rt Messages in the \fB-o\fR file that are not in new \fB\&.msg\fR file arguments are preserved. The default is to either reuse the message numbers with new message text that is similar to the old or to delete the message text, leaving @@ -92,23 +82,19 @@ an unused message number. .sp .ne 2 -.mk .na \fB\fBset=\fR\fInumber\fR\fR .ad .RS 18n -.rt Set the message set number to \fInumber\fR. The default is \fB1\fR. .RE .sp .ne 2 -.mk .na \fB\fBsimilar=\fR\fInumber\fR\fR .ad .RS 18n -.rt The message text similarity message threshold. The similarity measure between old and new message text is: .sp @@ -128,12 +114,10 @@ turns off message replacement, but unused old messages are still deleted. Use .sp .ne 2 -.mk .na \fB\fBverbose\fR\fR .ad .RS 18n -.rt Trace similar message replacements on the standard error. .RE @@ -145,35 +129,29 @@ Trace similar message replacements on the standard error. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIfile\fR\fR .ad .RS 8n -.rt Specifies the name of the file on which \fBmsgcc\fR operates. .RE .SH EXIT STATUS .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -206,7 +184,7 @@ int main(int ac, char *av[]) return( EXIT_SUCCESS ); } -example% msgcc -o xxx -D__STDC__ -D__i386 hello.c +example% msgcc -o xxx -D__STDC__ -D__i386 hello.c example% cat hello.mso str "hello world" @@ -233,13 +211,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityVolatile +Interface Stability Volatile .TE .SH SEE ALSO diff --git a/usr/src/man/man1/msgcpp.1 b/usr/src/man/man1/msgcpp.1 index f6716d780d..d4f62f2b6e 100644 --- a/usr/src/man/man1/msgcpp.1 +++ b/usr/src/man/man1/msgcpp.1 @@ -2,13 +2,13 @@ .\" Copyright (c) 1986-2006 AT&T Knowledge Ventures .\" To view license terms, see http://www.opensource.org/licenses/cpl1.0.txt .\" Portions Copyright (c) 2007, Sun Microsystems, Inc. -.TH msgcpp 1 "9 Oct 2007" "SunOS 5.11" "User Commands" +.TH MSGCPP 1 "Oct 9, 2007" .SH NAME msgcpp \- C language message catalog preprocessor .SH SYNOPSIS .LP .nf -\fBmsgcpp\fR [\fB-ACEHMPVX\fR] [\fB-D\fR \fIname\fR[\fB=\fR\fIvalue\fR]] [\fB-I\fR \fIdirectory\fR] [\fB-U\fR \fIname\fR] +\fBmsgcpp\fR [\fB-ACEHMPVX\fR] [\fB-D\fR \fIname\fR[\fB=\fR\fIvalue\fR]] [\fB-I\fR \fIdirectory\fR] [\fB-U\fR \fIname\fR] [\fB-T\fR[\fIlength\fR]] [\fB-Y\fR \fIdirectory\fR] [\fIinput\fR [\fIoutput\fR] ] .fi @@ -23,46 +23,38 @@ Candidate message text is determined by arguments to the last \fB<error.h>\fR and \fB<option.h>\fR functions. The \fBmsgcpp\fR keyed output lines are: .sp .ne 2 -.mk .na \fB\fBcmd\fR \fIcommand\fR\fR .ad .RS 19n -.rt \fIcommand\fR is a candidate for \fB--??keys\fR option string generation. This is triggered by \fBb_command(int argc\fR, in the input. .RE .sp .ne 2 -.mk .na \fB\fBdef\fR \fIname string\fR\fR .ad .RS 19n -.rt \fIname\fR is a candidate variable with \fIstring\fR value string. .RE .sp .ne 2 -.mk .na \fB\fBstr\fR \fIstring\fR\fR .ad .RS 19n -.rt \fIstring\fR should be entered into the catalog. .RE .sp .ne 2 -.mk .na \fB\fBvar\fR \fIname\fR\fR .ad .RS 19n -.rt If \fBdef\fR \fIname\fR occurs then its string value should be entered into the catalog. .RE @@ -120,7 +112,6 @@ _BLD_msgcat ... #endif\fR. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-A\fR\fR .ad @@ -129,13 +120,11 @@ The following options are supported: \fB\fB--assert=\fR\fIassertion\fR\fR .ad .RS 25n -.rt Enter the assertion using \fB#assert\fR for system V compatibility. .RE .sp .ne 2 -.mk .na \fB\fB-C\fR\fR .ad @@ -144,7 +133,6 @@ Enter the assertion using \fB#assert\fR for system V compatibility. \fB\fB--comments\fR\fR .ad .RS 25n -.rt Pass comments to the output. .sp Comments are omitted by default. @@ -152,7 +140,6 @@ Comments are omitted by default. .sp .ne 2 -.mk .na \fB\fB-D\fR\fR .ad @@ -161,7 +148,6 @@ Comments are omitted by default. \fB\fB--define=\fR\fIname\fR\fB[=\fR\fIvalue\fR\fB]\fR\fR .ad .RS 25n -.rt Define the macro \fIname\fR to have \fIvalue\fR. This is the only portable way to pass options through \fBcc\fR to \fBcpp\fR(1). .RS +4 @@ -202,7 +188,6 @@ definition. .RE .sp .ne 2 -.mk .na \fB\fB-D-C\fR\fR .ad @@ -217,7 +202,6 @@ Preprocess for K&R C compatibility. .sp .ne 2 -.mk .na \fB\fB-D-D\fR\fIlevel\fR\fR .ad @@ -236,7 +220,6 @@ produce more output. Levels higher than \fB3\fR can only be enabled in the .sp .ne 2 -.mk .na \fB\fB-D-F\fR\fIname\fR\fR .ad @@ -248,7 +231,6 @@ messages and the line sync output. .sp .ne 2 -.mk .na \fB\fB-D-H\fR\fR .ad @@ -264,7 +246,6 @@ directory headers are suppressed. .sp .ne 2 -.mk .na \fB\fB-D-I\fR\fR .ad @@ -280,7 +261,6 @@ All directories contain C headers. This option is only used only with .sp .ne 2 -.mk .na \fB\fB-D-K\fR\fR .ad @@ -295,7 +275,6 @@ Enable the non-standard \fIname\fR\fB=\fR\fIvalue\fR macro argument mode. .sp .ne 2 -.mk .na \fB\fB-D-L\fR\fB[\fR\fIid\fR\fB]\fR\fR .ad @@ -311,7 +290,6 @@ to null. .sp .ne 2 -.mk .na \fB\fB-D-M\fR\fR .ad @@ -326,7 +304,6 @@ Disable multiple include detection. .sp .ne 2 -.mk .na \fB\fB-D-P\fR\fR .ad @@ -342,7 +319,6 @@ non-C input. .sp .ne 2 -.mk .na \fB\fB-D-Q\fR\fR .ad @@ -358,7 +334,6 @@ Dump macro definitions to the output so that the output may be passed through .sp .ne 2 -.mk .na \fB\fB-D-R\fR\fR .ad @@ -374,7 +349,6 @@ cannot make up their semantics between K&R and ISO C. .sp .ne 2 -.mk .na \fB\fB-D-S\fR\fR .ad @@ -390,7 +364,6 @@ Enable strict preprocessing semantics and warnings. This works with any mode .sp .ne 2 -.mk .na \fB\fB-D-T\fR\fItest\fR\fR .ad @@ -405,7 +378,6 @@ Enable implementation specific test code according to \fItest\fR. .sp .ne 2 -.mk .na \fB\fB-D-W\fR\fR .ad @@ -420,7 +392,6 @@ Enable pedantic warnings in non-hosted files. .sp .ne 2 -.mk .na \fB\fB-D-X\fR\fB[cc]\fR\fR .ad @@ -436,7 +407,6 @@ executable on \fB$PATH\fR. .sp .ne 2 -.mk .na \fB\fB-D-Z\fR\fR .ad @@ -451,7 +421,6 @@ Enable pool mode. .sp .ne 2 -.mk .na \fB\fB-D-d\fR\fR .ad @@ -463,7 +432,6 @@ output. .sp .ne 2 -.mk .na \fB\fB-D-m\fR\fR .ad @@ -475,7 +443,6 @@ disabled. .sp .ne 2 -.mk .na \fB\fB-D-+\fR\fR .ad @@ -492,7 +459,6 @@ Preprocess for the C++ dialect. .sp .ne 2 -.mk .na \fB\fB-E\fR\fR .ad @@ -501,13 +467,11 @@ Preprocess for the C++ dialect. \fB\fB--preprocess\fR\fR .ad .RS 25n -.rt Ignored; for compatibility with very old compilers. .RE .sp .ne 2 -.mk .na \fB\fB-H\fR\fR .ad @@ -516,14 +480,12 @@ Ignored; for compatibility with very old compilers. \fB\fB--include-reference\fR\fR .ad .RS 25n -.rt Emit \fB#include\fR file paths on the standard error, one per line, indented to show nesting. .RE .sp .ne 2 -.mk .na \fB\fB-I\fR\fR .ad @@ -532,7 +494,6 @@ show nesting. \fB\fB--include[=\fR\fIdirectory\fR\fB]\fR\fR .ad .RS 25n -.rt Append directory to the list of directories searched for \fB#include\fR files. .sp If directory is \fB-\fR: @@ -556,7 +517,6 @@ the directory \fB\&.\fR is searched only if it is explicitly specified by an .RE .sp .ne 2 -.mk .na \fB\fB-I-C\fR\fIdirectory\fR\fR .ad @@ -572,7 +532,6 @@ Mark \fIdirectory\fR as a C header directory. This option is used with .sp .ne 2 -.mk .na \fB\fB-I-D[\fR\fIfile\fR]\fR .ad @@ -584,7 +543,6 @@ definitions if \fIfile\fR is omitted. .sp .ne 2 -.mk .na \fB\fB-I-H\fR\fIdirectory\fR\fR .ad @@ -600,7 +558,6 @@ compatibility warnings disabled. .sp .ne 2 -.mk .na \fB\fB-I-I\fR\fIheader\fR\fR .ad @@ -615,7 +572,6 @@ Add \fIheader\fR to the list of ignored headers. .sp .ne 2 -.mk .na \fB\fB-I-M\fR\fIfile\fR\fR .ad @@ -628,7 +584,6 @@ for header. header is ignored \fBif = "map"\fR is omitted. .sp .ne 2 -.mk .na \fB\fB-I-R\fR\fIfile\fR\fR .ad @@ -639,7 +594,6 @@ Include \fIfile\fR but do not emit text or line syncs. .sp .ne 2 -.mk .na \fB\fB-I-S\fR\fIdirectory\fR\fR .ad @@ -650,7 +604,6 @@ Add \fIdirectory\fR to the default standard include directory list. .sp .ne 2 -.mk .na \fB\fB-I-T\fR\fIfile\fR\fR .ad @@ -664,7 +617,6 @@ omitted. .sp .ne 2 -.mk .na \fB\fB-M\fR\fR .ad @@ -673,7 +625,6 @@ omitted. \fB\fB--dependencies\fR\fR .ad .RS 25n -.rt Generate \fBmake\fR(1S) dependencies. This option is not needed with \fBnmake\fR. .sp @@ -683,35 +634,29 @@ output styles. The following optional flags are supported: .sp .ne 2 -.mk .na \fB\fBD\fR\fR .ad .RS 5n -.rt Generate dependencies in a separate \fB\&.d\fR file. Preprocessed output is still written to output, or the standard output if output is omitted. .RE .sp .ne 2 -.mk .na \fB\fBG\fR\fR .ad .RS 5n -.rt Also generate missing dependencies. .RE .sp .ne 2 -.mk .na \fB\fBM\fR\fR .ad .RS 5n -.rt Only generate local header dependencies. Hosted headers are omitted. Hosted headers are determined by the \fB-I-H\fR option and the -\fB-pp:hosted\fR and \fBpp:hostdir pragmas\fR. No special distinction is made between the \fB""\fR @@ -722,7 +667,6 @@ and \fB<>\fR include styles. .sp .ne 2 -.mk .na \fB\fB-P\fR\fR .ad @@ -731,7 +675,6 @@ and \fB<>\fR include styles. \fB\fB--sync\fR\fR .ad .RS 25n -.rt Emit line syncs. .sp Line sync is turned on by default. \fB-P\fR means \fB--nosync\fR. @@ -739,19 +682,16 @@ Line sync is turned on by default. \fB-P\fR means \fB--nosync\fR. .sp .ne 2 -.mk .na \fB\fB-T\fR\fB[\fR\fIlength\fR\fB]\fR\fR .ad .RS 25n -.rt If not \fBgcc\fR, truncate identifiers to \fIlength\fR characters for compatibility with old AT&T compilers. .RE .sp .ne 2 -.mk .na \fB\fB-U\fR\fR .ad @@ -760,13 +700,11 @@ compatibility with old AT&T compilers. \fB\fB--undefine=\fR\fIname\fR\fR .ad .RS 25n -.rt Remove the definition for the macro \fIname\fR. .RE .sp .ne 2 -.mk .na \fB\fB-V\fR\fR .ad @@ -775,13 +713,11 @@ Remove the definition for the macro \fIname\fR. \fB\fB--version\fR\fR .ad .RS 25n -.rt Emit the \fBlibpp\fR version. .RE .sp .ne 2 -.mk .na \fB\fB-X\fR\fR .ad @@ -790,14 +726,12 @@ Emit the \fBlibpp\fR version. \fB\fB--argmode\fR\fR .ad .RS 25n -.rt Enable \fIname\fR\fB=\fR\fIvalue\fR macro arguments for \fBeasel\fR compatibility. .RE .sp .ne 2 -.mk .na \fB\fB-Y\fR\fR .ad @@ -806,7 +740,6 @@ compatibility. \fB\fB--standard=\fR\fIdirectory\fR\fR .ad .RS 25n -.rt Add \fIdirectory\fR to the list searched for \fB#include <...>\fR files. .RE @@ -816,46 +749,38 @@ Add \fIdirectory\fR to the list searched for \fB#include <...>\fR files. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIinput\fR\fR .ad .RS 10n -.rt Specifies C source file to preprocess. .RE .sp .ne 2 -.mk .na \fB\fIoutput\fR\fR .ad .RS 10n -.rt Specifies output file. .RE .SH EXIT STATUS .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -911,13 +836,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityVolatile +Interface Stability Volatile .TE .SH SEE ALSO diff --git a/usr/src/man/man1/msgcvt.1 b/usr/src/man/man1/msgcvt.1 index f0506340e7..f8588e6ec6 100644 --- a/usr/src/man/man1/msgcvt.1 +++ b/usr/src/man/man1/msgcvt.1 @@ -2,7 +2,7 @@ .\" Copyright (c) 2000-2007 AT&T Knowledge Ventures .\" To view license terms, see http://www.opensource.org/licenses/cpl1.0.txt .\" Portions Copyright (c) 2007, Sun Microsystems, Inc. -.TH msgcvt 1 "9 Oct 2007" "SunOS 5.11" "User Commands" +.TH MSGCVT 1 "Oct 9, 2007" .SH NAME msgcvt \- convert message file to and from HTML .SH SYNOPSIS @@ -25,7 +25,6 @@ sites such as http://babelfish.altavista.com\&. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-h\fR\fR .ad @@ -34,7 +33,6 @@ The following options are supported: \fB\fB--html\fR\fR .ad .RS 10n -.rt Generate \fBHTML\fR from \fBgencat\fR(1) input. .sp This is the default. @@ -42,7 +40,6 @@ This is the default. .sp .ne 2 -.mk .na \fB\fB-m\fR\fR .ad @@ -51,14 +48,12 @@ This is the default. \fB\fB--msg\fR\fR .ad .RS 10n -.rt Generate a \fBgencat\fR(1) message file from (presumably translated) \fBHTML\fR. Wide characters are UTF-8 encoded. .RE .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad @@ -67,7 +62,6 @@ Generate a \fBgencat\fR(1) message file from (presumably translated) \fB\fB--raw\fR\fR .ad .RS 10n -.rt The message file is raw message text, one message per line, with no quoting or line numbering. .RE @@ -75,23 +69,19 @@ line numbering. .SH EXIT STATUS .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt One or more specified jobs does not exist. .RE @@ -123,13 +113,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityVolatile +Interface Stability Volatile .TE .SH SEE ALSO diff --git a/usr/src/man/man1/msgfmt.1 b/usr/src/man/man1/msgfmt.1 index 2001233c1d..7d14b50560 100644 --- a/usr/src/man/man1/msgfmt.1 +++ b/usr/src/man/man1/msgfmt.1 @@ -3,15 +3,15 @@ .\" 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 msgfmt 1 "17 Sep 2001" "SunOS 5.11" "User Commands" +.TH MSGFMT 1 "Sep 17, 2001" .SH NAME msgfmt \- create a message object from a message file .SH SYNOPSIS .LP .nf -\fBmsgfmt\fR [\fB-D\fR \fIdir\fR | \fB-\(midirectory\fR=\fIdir\fR] - [\fB-f\fR | \fB-\(miuse-fuzzy\fR] [\fB-g\fR] - [\fB-o\fR \fIoutput-file\fR | \fB-\(mioutput-file\fR=\fIoutput-file\fR] +\fBmsgfmt\fR [\fB-D\fR \fIdir\fR | \fB-\(midirectory\fR=\fIdir\fR] + [\fB-f\fR | \fB-\(miuse-fuzzy\fR] [\fB-g\fR] + [\fB-o\fR \fIoutput-file\fR | \fB-\(mioutput-file\fR=\fIoutput-file\fR] [\fB-s\fR] [\fB-\(mistrict\fR] [\fB-v\fR] [\fB-\(miverbose\fR] \fIfilename\fR.po... .fi @@ -40,7 +40,6 @@ the \fBLC_CTYPE\fR locale category or according to the codeset specified in the The following options are supported: .sp .ne 2 -.mk .na \fB\fB-D\fR \fIdir\fR\fR .ad @@ -49,13 +48,11 @@ The following options are supported: \fB\fB-\(midirectory=\fR\fIdir\fR\fR .ad .RS 27n -.rt Adds \fIdir\fR to the list for input files search. .RE .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad @@ -64,7 +61,6 @@ Adds \fIdir\fR to the list for input files search. \fB\fB-\(miuse-fuzzy\fR\fR .ad .RS 27n -.rt Uses fuzzy entries in output. If this option is not specified, fuzzy entries are not included into the output. These options are ignored if Solaris message catalogs are processed. @@ -72,19 +68,16 @@ catalogs are processed. .sp .ne 2 -.mk .na \fB\fB-g\fR\fR .ad .RS 27n -.rt Directs the utility to generate the GNU-compatible message catalog file. This option cannot be specified with the \fB-s\fR option. .RE .sp .ne 2 -.mk .na \fB\fB-o\fR \fIoutput-file\fR\fR .ad @@ -93,31 +86,26 @@ option cannot be specified with the \fB-s\fR option. \fB\fB-\(mioutput=\fR\fIoutput-file\fR\fR .ad .RS 27n -.rt Specifies the output file name as \fIoutput-file\fR. All domain directives and duplicate msgids in the .\fBpo\fR file are ignored. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 27n -.rt Directs the utility to generate the Solaris message catalog file. This option cannot be specified with the \fB-g\fR option. .RE .sp .ne 2 -.mk .na \fB\fB-\(mistrict\fR\fR .ad .RS 27n -.rt Directs the utility to append the suffix \fB\&.mo\fR to the generating message object file name if it doesn't have this suffix. This option is ignored if Solaris message catalogs are processed. @@ -125,7 +113,6 @@ Solaris message catalogs are processed. .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad @@ -134,7 +121,6 @@ Solaris message catalogs are processed. \fB\fB-\(miverbose\fR\fR .ad .RS 27n -.rt Verbose. Lists duplicate message identifiers if Solaris message catalog files are processed. Message strings are not redefined. .sp @@ -260,11 +246,11 @@ the target string to be used with plural form handling functions \fBngettext()\fR, \fBdngettext()\fR, and \fBdcngetttext()\fR. .sp .LP -Message strings can contain the escape sequences \fB\n\fR for newline, \fB\t\fR -for tab, \fB\v\fR for vertical tab, \fB\b\fR for backspace, \fB\r\fR for -carriage return, \fB\f\fR for formfeed, \fB\\\fR for backslash, \fB\"\fR for -double quote, \fB\a\fR for alarm, \fB\ddd\fR for octal bit pattern, and -\fB\xDD\fR for hexadecimal bit pattern. +Message strings can contain the escape sequences \fB\\n\fR for newline, +\fB\\t\fR for tab, \fB\\v\fR for vertical tab, \fB\\b\fR for backspace, +\fB\\r\fR for carriage return, \fB\\f\fR for formfeed, \fB\\\fR for backslash, +\fB\\"\fR for double quote, \fB\\a\fR for alarm, \fB\\ddd\fR for octal bit +pattern, and \fB\\xDD\fR for hexadecimal bit pattern. .sp .LP Comments for a GNU-compatible message file should be in one of the following @@ -290,12 +276,10 @@ and '\fB#:\fR' comments are informative only and are silently ignored by the separated by the comma character. The following \fIflag\fRs can be specified: .sp .ne 2 -.mk .na \fB\fBfuzzy\fR\fR .ad .RS 15n -.rt This flag can be inserted by the translator. It shows that the \fBmsgstr\fR string might not be a correct translation (anymore). Only the translator can judge if the translation requires further modification or is acceptable as is. @@ -306,7 +290,6 @@ entry for the immediately following msgid in the output message catalog. .sp .ne 2 -.mk .na \fB\fBc-format\fR\fR .ad @@ -315,7 +298,6 @@ entry for the immediately following msgid in the output message catalog. \fB\fBno-c-format\fR\fR .ad .RS 15n -.rt The \fBc-format\fR flag indicates that the \fBmsgid\fR string is used as a format string by printf-like functions. In case the \fBc-format\fR flag is given for a string, the \fBmsgfmt\fR utility does some more tests to check the @@ -498,13 +480,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled .TE .SH SEE ALSO diff --git a/usr/src/man/man1/msggen.1 b/usr/src/man/man1/msggen.1 index 740584e9fe..994b465ee1 100644 --- a/usr/src/man/man1/msggen.1 +++ b/usr/src/man/man1/msggen.1 @@ -2,7 +2,7 @@ .\" Copyright (c) 2000-2007 AT&T Knowledge Ventures .\" To view license terms, see http://www.opensource.org/licenses/cpl1.0.txt .\" Portions Copyright (c) 2007, Sun Microsystems, Inc. -.TH msggen 1 "9 Oct 2007" "SunOS 5.11" "User Commands" +.TH MSGGEN 1 "Oct 9, 2007" .SH NAME msggen \- generate a machine independent formatted message catalog .SH SYNOPSIS @@ -30,7 +30,6 @@ convert to/from UTF-8. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad @@ -39,150 +38,123 @@ The following options are supported: \fB\fB--format\fR\fR .ad .RS 12n -.rt List the \fBprintf\fR(3C) format signature for each message in \fIcatfile\fR. A format signature is one line containing one character for each format specification: .sp .ne 2 -.mk .na \fB\fBc\fR\fR .ad .RS 5n -.rt char .RE .sp .ne 2 -.mk .na \fB\fBd\fR\fR .ad .RS 5n -.rt double .RE .sp .ne 2 -.mk .na \fB\fBD\fR\fR .ad .RS 5n -.rt long double .RE .sp .ne 2 -.mk .na \fB\fBf\fR\fR .ad .RS 5n -.rt float .RE .sp .ne 2 -.mk .na \fB\fBh\fR\fR .ad .RS 5n -.rt short .RE .sp .ne 2 -.mk .na \fB\fBi\fR\fR .ad .RS 5n -.rt int .RE .sp .ne 2 -.mk .na \fB\fBj\fR\fR .ad .RS 5n -.rt long long .RE .sp .ne 2 -.mk .na \fB\fBl\fR\fR .ad .RS 5n -.rt long .RE .sp .ne 2 -.mk .na \fB\fBp\fR\fR .ad .RS 5n -.rt void* .RE .sp .ne 2 -.mk .na \fB\fBs\fR\fR .ad .RS 5n -.rt string .RE .sp .ne 2 -.mk .na \fB\fBt\fR\fR .ad .RS 5n -.rt ptrdiff_t .RE .sp .ne 2 -.mk .na \fB\fBz\fR\fR .ad .RS 5n -.rt size_t .RE .sp .ne 2 -.mk .na \fB\fB?\fR\fR .ad .RS 5n -.rt unknown .RE @@ -190,7 +162,6 @@ unknown .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad @@ -199,13 +170,11 @@ unknown \fB\fB--list\fR\fR .ad .RS 12n -.rt List \fIcatfile\fR in UTF-8 msgfile form. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad @@ -214,7 +183,6 @@ List \fIcatfile\fR in UTF-8 msgfile form. \fB\fB--set\fR\fR .ad .RS 12n -.rt Convert the \fIcatfile\fR to a message set number and print the number on the standard output. .RE @@ -225,23 +193,19 @@ standard output. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIcatfile\fR\fR .ad .RS 11n -.rt Machine independent formatted message catalog file. .RE .sp .ne 2 -.mk .na \fB\fImsgfile\fR\fR .ad .RS 11n -.rt Message text source file. .RE @@ -255,7 +219,6 @@ subsequent field. The \fBNL_*\fR constants are defined in one or both of \fB<limits.h>\fR and \fB<nl_types.h>\fR\&. .sp .ne 2 -.mk .na \fB\fB$\fR \fIcomment\fR\fR .ad @@ -267,7 +230,6 @@ comment. .sp .ne 2 -.mk .na \fB\fB$delset\fR \fIn comment\fR\fR .ad @@ -280,7 +242,6 @@ is treated as a comment. .sp .ne 2 -.mk .na \fB\fB$quote\fR \fIc\fR\fR .ad @@ -294,7 +255,6 @@ supplied, no quoting of message-text is recognized. .sp .ne 2 -.mk .na \fB\fB$set\fR \fIn comment\fR\fR .ad @@ -310,7 +270,6 @@ source file, all messages are located in message set 1. .sp .ne 2 -.mk .na \fB\fB$translation\fR \fIidentification YYYY-MM-DD\fR\fB[,...]\fR\fR .ad @@ -323,7 +282,6 @@ translation lines are combined into a single, comma-separated list. .sp .ne 2 -.mk .na \fB\fBm\fR \fImessage-text\fR\fR .ad @@ -343,23 +301,19 @@ from the catalogue. Message identifiers need not be contiguous. There are no .SH EXIT STATUS .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt One or more specified jobs does not exist. .RE @@ -391,13 +345,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityVolatile +Interface Stability Volatile .TE .SH SEE ALSO diff --git a/usr/src/man/man1/msgget.1 b/usr/src/man/man1/msgget.1 index ba631d535d..e3e1e3a138 100644 --- a/usr/src/man/man1/msgget.1 +++ b/usr/src/man/man1/msgget.1 @@ -2,7 +2,7 @@ .\" Copyright (c) 2000-2007 AT&T Knowledge Ventures .\" To view license terms, see http://www.opensource.org/licenses/cpl1.0.txt .\" Portions Copyright (c) 2007, Sun Microsystems, Inc. -.TH msgget 1 "9 Oct 2007" "SunOS 5.11" "User Commands" +.TH MSGGET 1 "Oct 9, 2007" .SH NAME msgget \- get a message from a message catalog .SH SYNOPSIS @@ -22,46 +22,38 @@ msgget \- get a message from a message catalog The following operands are supported: .sp .ne 2 -.mk .na \fB\fIcatalog\fR\fR .ad .RS 16n -.rt Specifies the message catalog name. .RE .sp .ne 2 -.mk .na \fB\fIcommand\fR\fR .ad .RS 16n -.rt Specifies command-specific message. .RE .sp .ne 2 -.mk .na \fB\fIlocale\fR\fR .ad .RS 16n -.rt Specifies the locale. If \fIlocale\fR is \fB-\fR then the current locale is used. .RE .sp .ne 2 -.mk .na \fB\fB[\fR\fIset\fR\fB].\fR\fInumber\fR\fR .ad .RS 16n -.rt Identifies the message by message number and an optional message set. If specified as \fB-\fR , the message set and number are determined by looking up text in the corresponding C locale message catalog. @@ -69,35 +61,29 @@ text in the corresponding C locale message catalog. .sp .ne 2 -.mk .na \fB\fItext\fR\fR .ad .RS 16n -.rt Specifies the text of the message to be output upon error. .RE .SH EXIT STATUS .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -130,13 +116,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityVolatile +Interface Stability Volatile .TE .SH SEE ALSO diff --git a/usr/src/man/man1/mt.1 b/usr/src/man/man1/mt.1 index 3164b22500..f7d7e8d29f 100644 --- a/usr/src/man/man1/mt.1 +++ b/usr/src/man/man1/mt.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 mt 1 "21 Jun 2007" "SunOS 5.11" "User Commands" +.TH MT 1 "Jun 21, 2007" .SH NAME mt \- magnetic tape control .SH SYNOPSIS @@ -24,12 +24,10 @@ If \fBTAPE\fR does not exist, \fBmt\fR uses the device \fB/dev/rmt/0n\fR. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-f\fR \fItapename\fR\fR .ad .RS 15n -.rt Specifies the raw tape device. .RE @@ -39,12 +37,10 @@ Specifies the raw tape device. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIcount\fR\fR .ad .RS 11n -.rt The number of times that the requested operation is to be performed. By default, \fBmt\fR performs \fIcommand\fR once. Multiple operations of \fIcommand\fR can be performed by specifying \fIcount\fR. @@ -52,58 +48,48 @@ default, \fBmt\fR performs \fIcommand\fR once. Multiple operations of .sp .ne 2 -.mk .na \fB\fIcommand\fR\fR .ad .RS 11n -.rt The following available commands that can be sent to a magnetic tape drive are supported. Only as many characters as are required to uniquely identify a \fIcommand\fR need be specified. .sp .ne 2 -.mk .na \fB\fBasf\fR\fR .ad .RS 10n -.rt Specifies absolute space to \fIcount\fR file number. This is equivalent to a \fBrewind\fR followed by a \fBfsf\fR \fIcount\fR. .RE .sp .ne 2 -.mk .na \fB\fBbsf\fR\fR .ad .RS 10n -.rt Back spaces over \fIcount\fR EOF marks. The tape is positioned on the beginning-of-tape side of the EOF mark. .RE .sp .ne 2 -.mk .na \fB\fBbsr\fR\fR .ad .RS 10n -.rt Back spaces \fIcount\fR records. .RE .sp .ne 2 -.mk .na \fB\fBbssf\fR\fR .ad .RS 10n -.rt Back spaces over the requested number of sequential file marks. Sequential file marks are where the file marks are one right after the other with no other blocks of any kind between the file marks. The number argument specifies how @@ -116,7 +102,6 @@ This command is not supported by all drives. .sp .ne 2 -.mk .na \fB\fBeof\fR\fR .ad @@ -125,41 +110,34 @@ This command is not supported by all drives. \fB\fBweof\fR\fR .ad .RS 10n -.rt Writes \fIcount\fR EOF marks at the current position on the tape. .RE .sp .ne 2 -.mk .na \fB\fBfsf\fR\fR .ad .RS 10n -.rt Forward spaces over \fIcount\fR EOF marks. The tape is positioned on the first block of the file. .RE .sp .ne 2 -.mk .na \fB\fBfsr\fR\fR .ad .RS 10n -.rt Forward spaces \fIcount\fR records. .RE .sp .ne 2 -.mk .na \fB\fBfssf\fR\fR .ad .RS 10n -.rt Forward spaces the over requested number of sequential file marks. Sequential file marks are where the file marks are one right after the other with no other blocks of any kind between the file marks. The number argument specifies how @@ -172,68 +150,56 @@ This command is not supported by all drives. .sp .ne 2 -.mk .na \fB\fBload\fR\fR .ad .RS 10n -.rt Requests drive load and thread current media. Not supported by all drives. .RE .sp .ne 2 -.mk .na \fB\fBlock\fR\fR .ad .RS 10n -.rt Prevents media removal. .RE .sp .ne 2 -.mk .na \fB\fBnbsf\fR\fR .ad .RS 10n -.rt Back spaces \fIcount\fR files. The tape is positioned on the first block of the file. This is equivalent to \fIcount+1\fR \fBbsf\fRs ollowed by one \fBfsf\fR. .RE .sp .ne 2 -.mk .na \fB\fBseek\fR\fR .ad .RS 10n -.rt Positions to requested logical tape position. .RE .sp .ne 2 -.mk .na \fB\fBtell\fR\fR .ad .RS 10n -.rt Gets and prints current logical tape position. .RE .sp .ne 2 -.mk .na \fB\fBunlock\fR\fR .ad .RS 10n -.rt Allows media removal. .RE @@ -241,12 +207,10 @@ If \fIcount\fR is specified with any of the following commands, the \fIcount\fR is ignored and the command is performed only once. .sp .ne 2 -.mk .na \fB\fBconfig\fR\fR .ad .RS 16n -.rt Reads the drives current configuration from the driver and displays it in \fBst.conf\fR format. See \fBst\fR(7D) for definition of fields and there meanings. @@ -254,24 +218,20 @@ meanings. .sp .ne 2 -.mk .na \fB\fBeom\fR\fR .ad .RS 16n -.rt Spaces to the end of recorded media on the tape. This is useful for appending files onto previously written tapes. .RE .sp .ne 2 -.mk .na \fB\fBerase\fR\fR .ad .RS 16n -.rt Erases the entire tape. .sp Some tape drives have option settings where only portions of the tape can be @@ -282,12 +242,10 @@ device specific manual for time details. .sp .ne 2 -.mk .na \fB\fBforcereserve\fR\fR .ad .RS 16n -.rt Attempts to break a SCSI II reserve issued by another initiator. When this command completes, the drive is not reserved for the current initiator, but is available for use. This command can be only be executed by those with @@ -296,7 +254,6 @@ super-user privileges. .sp .ne 2 -.mk .na \fB\fBoffline\fR\fR .ad @@ -305,65 +262,54 @@ super-user privileges. \fB\fBrewoffl\fR\fR .ad .RS 16n -.rt Rewinds the tape and, if appropriate, takes the drive unit off-line by unloading the tape. .RE .sp .ne 2 -.mk .na \fB\fBrelease\fR\fR .ad .RS 16n -.rt Re-establishes the default behavior of releasing at close. .RE .sp .ne 2 -.mk .na \fB\fBreserve\fR\fR .ad .RS 16n -.rt Allows the tape drive to remain reserved after closing the device. The drive must then be explicitly released. .RE .sp .ne 2 -.mk .na \fB\fBretension\fR\fR .ad .RS 16n -.rt Rewinds the cartridge tape completely, then winds it forward to the end of the reel and back to beginning-of-tape to smooth out tape tension. .RE .sp .ne 2 -.mk .na \fB\fBrewind\fR\fR .ad .RS 16n -.rt Rewinds the tape. .RE .sp .ne 2 -.mk .na \fB\fBstatus\fR\fR .ad .RS 16n -.rt Prints status information about the tape unit. .sp Status information can include the sense key reported by the drive, the @@ -377,67 +323,42 @@ might also report that WORM media is loaded in that drive. .SH EXIT STATUS .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt All operations were successful. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt Command was unrecognized or \fBmt\fR was unable to open the specified tape drive. .RE .sp .ne 2 -.mk .na \fB\fB2\fR\fR .ad .RS 5n -.rt An operation failed. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB/dev/rmt/*\fR\fR .ad .RS 14n -.rt magnetic tape interface .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) -. -\fBATTRIBUTE TYPE\fR\fBATTRIBUTE VALUE\fR -_ -\fBAvailability\fR\fBSUNWcsu\fR -.TE - .SH SEE ALSO .sp .LP diff --git a/usr/src/man/man1/mv.1 b/usr/src/man/man1/mv.1 index 9c5c2874f3..d96e183a4f 100644 --- a/usr/src/man/man1/mv.1 +++ b/usr/src/man/man1/mv.1 @@ -2,14 +2,14 @@ .\" Copyright 1989 AT&T .\" Copyright (c) 1992, X/Open Company Limited All Rights Reserved .\" Portions Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 mv 1 "17 Jul 2007" "SunOS 5.11" "User Commands" +.TH MV 1 "Jul 17, 2007" .SH NAME mv \- move files .SH SYNOPSIS @@ -117,12 +117,10 @@ the same owner id as the destination file. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 6n -.rt \fBmv\fR moves the file(s) without prompting even if it is writing over an existing \fItarget\fR. Note that this is the default if the standard input is not a terminal. @@ -130,12 +128,10 @@ not a terminal. .sp .ne 2 -.mk .na \fB\fB-i\fR\fR .ad .RS 6n -.rt \fBmv\fR prompts for confirmation whenever the move would overwrite an existing \fItarget\fR. An affirmative answer means that the move should proceed. Any other answer prevents \fBmv\fR from overwriting the \fItarget\fR. @@ -157,34 +153,28 @@ error. The last option specified determines the behavior of \fBmv\fR. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIsource\fR\fR .ad .RS 15n -.rt A path name of a file or directory to be moved. .RE .sp .ne 2 -.mk .na \fB\fItarget_file\fR\fR .ad .RS 15n -.rt A new path name for the file or directory being moved. .RE .sp .ne 2 -.mk .na \fB\fItarget_dir\fR\fR .ad .RS 15n -.rt A path name of an existing directory into which to move the input files. .RE @@ -215,23 +205,19 @@ expression defined for the \fByesexpr\fR. See \fBlocale\fR(5). The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt All input files were moved successfully. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -244,15 +230,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityStable +Interface Stability Stable .TE .SS "/usr/xpg4/bin/mv" @@ -260,15 +245,14 @@ Interface StabilityStable .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man1/nawk.1 b/usr/src/man/man1/nawk.1 index bb5d8cacd1..425db5d299 100644 --- a/usr/src/man/man1/nawk.1 +++ b/usr/src/man/man1/nawk.1 @@ -2,26 +2,26 @@ .\" Copyright 1989 AT&T .\" Copyright 1992, X/Open Company Limited All Rights Reserved .\" Portions Copyright (c) 2005, 2006 Sun Microsystems, Inc. All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 nawk 1 "24 May 2006" "SunOS 5.11" "User Commands" +.TH NAWK 1 "May 24, 2006" .SH NAME nawk \- pattern scanning and processing language .SH SYNOPSIS .LP .nf -\fB/usr/bin/nawk\fR [\fB-F\fR \fIERE\fR] [\fB-v\fR \fIassignment\fR] \fI\&'program'\fR | \fB-f\fR \fIprogfile\fR... +\fB/usr/bin/nawk\fR [\fB-F\fR \fIERE\fR] [\fB-v\fR \fIassignment\fR] \fI\&'program'\fR | \fB-f\fR \fIprogfile\fR... [\fIargument\fR]... .fi .LP .nf -\fB/usr/xpg4/bin/awk\fR [\fB-F\fR \fIERE\fR] [\fB-v\fR \fIassignment\fR]... \fI\&'program'\fR | \fB-f\fR \fIprogfile\fR... +\fB/usr/xpg4/bin/awk\fR [\fB-F\fR \fIERE\fR] [\fB-v\fR \fIassignment\fR]... \fI\&'program'\fR | \fB-f\fR \fIprogfile\fR... [\fIargument\fR]... .fi @@ -59,24 +59,20 @@ values of all fields and the \fBNF\fR built-in variable. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-F\fR \fIERE\fR\fR .ad .RS 17n -.rt Define the input field separator to be the extended regular expression \fIERE\fR, before any input is read (can be a character). .RE .sp .ne 2 -.mk .na \fB\fB-f\fR \fIprogfile\fR\fR .ad .RS 17n -.rt Specifies the pathname of the file \fIprogfile\fR containing a \fBnawk\fR program. If multiple instances of this option are specified, the concatenation of the files specified as \fIprogfile\fR in the order specified is the @@ -86,12 +82,10 @@ the command line as a single argument. .sp .ne 2 -.mk .na \fB\fB-v\fR \fIassignment\fR\fR .ad .RS 17n -.rt The \fIassignment\fR argument must be in the same form as an \fIassignment\fR operand. The assignment is of the form \fIvar=value\fR, where \fIvar\fR is the name of one of the variables described below. The specified assignment occurs @@ -106,12 +100,10 @@ specified. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIprogram\fR\fR .ad .RS 12n -.rt If no \fB-f\fR option is specified, the first operand to \fBnawk\fR is the text of the \fBnawk\fR program. The application supplies the \fIprogram\fR operand as a single argument to \fBnawk.\fR If the text does not end in a newline @@ -120,21 +112,17 @@ character, \fBnawk\fR interprets the text as if it did. .sp .ne 2 -.mk .na \fB\fIargument\fR\fR .ad .RS 12n -.rt Either of the following two types of \fIargument\fR can be intermixed: .sp .ne 2 -.mk .na \fB\fIfile\fR\fR .ad .RS 14n -.rt A pathname of a file that contains the input to be read, which is matched against the set of patterns in the program. If no \fIfile\fR operands are specified, or if a \fIfile\fR operand is \fB\(mi\fR, the standard input is @@ -143,12 +131,10 @@ used. .sp .ne 2 -.mk .na \fB\fIassignment\fR\fR .ad .RS 14n -.rt An operand that begins with an underscore or alphabetic character from the portable character set, followed by a sequence of underscores, digits and alphabetics from the portable character set, followed by the \fB=\fR character @@ -258,66 +244,64 @@ assignment operator). .sp .TS -tab(); -cw(1.38i) cw(1.38i) cw(1.35i) cw(1.39i) -lw(1.38i) lw(1.38i) lw(1.35i) lw(1.39i) -. -\fBSyntax\fR\fBName\fR\fBType of Result\fR\fBAssociativity\fR +c c c c +l l l l . +\fBSyntax\fR \fBName\fR \fBType of Result\fR \fBAssociativity\fR _ -( \fIexpr\fR )Groupingtype of \fIexpr\fRn/a +( \fIexpr\fR ) Grouping type of \fIexpr\fR n/a _ -$\fIexpr\fRField referencestringn/a +$\fIexpr\fR Field reference string n/a _ -++ \fIlvalue\fRPre-incrementnumericn/a - \(mi\(mi\fIlvalue\fRPre-decrementnumericn/a -\fIlvalue\fR ++Post-incrementnumericn/a -\fIlvalue\fR \(mi\(miPost-decrement numericn/a +++ \fIlvalue\fR Pre-increment numeric n/a + \(mi\(mi\fIlvalue\fR Pre-decrement numeric n/a +\fIlvalue\fR ++ Post-increment numeric n/a +\fIlvalue\fR \(mi\(mi Post-decrement numeric n/a _ -\fIexpr\fR ^ \fIexpr\fRExponentiationnumericright +\fIexpr\fR ^ \fIexpr\fR Exponentiation numeric right _ -! \fIexpr\fRLogical notnumericn/a -+ \fIexpr\fRUnary plusnumericn/a -\(mi \fIexpr\fRUnary minusnumericn/a +! \fIexpr\fR Logical not numeric n/a ++ \fIexpr\fR Unary plus numeric n/a +\(mi \fIexpr\fR Unary minus numeric n/a _ -\fIexpr\fR * \fIexpr\fRMultiplicationnumericleft -\fIexpr\fR / \fIexpr\fRDivisionnumericleft -\fIexpr\fR % \fIexpr\fRModulusnumericleft +\fIexpr\fR * \fIexpr\fR Multiplication numeric left +\fIexpr\fR / \fIexpr\fR Division numeric left +\fIexpr\fR % \fIexpr\fR Modulus numeric left _ -\fIexpr\fR + \fIexpr\fRAdditionnumericleft -\fIexpr\fR \(mi \fIexpr\fRSubtractionnumeric left +\fIexpr\fR + \fIexpr\fR Addition numeric left +\fIexpr\fR \(mi \fIexpr\fR Subtraction numeric left _ -\fIexpr\fR \fIexpr\fRString concatenationstringleft +\fIexpr\fR \fIexpr\fR String concatenation string left _ -\fIexpr\fR < \fIexpr\fRLess thannumericnone -\fIexpr\fR <= \fIexpr\fRLess than or equal tonumericnone -\fIexpr\fR != \fIexpr\fRNot equal tonumericnone -\fIexpr\fR == \fIexpr\fREqual tonumericnone -\fIexpr\fR > \fIexpr\fRGreater thannumericnone -\fIexpr\fR >= \fIexpr\fRGreater than or equal tonumericnone +\fIexpr\fR < \fIexpr\fR Less than numeric none +\fIexpr\fR <= \fIexpr\fR Less than or equal to numeric none +\fIexpr\fR != \fIexpr\fR Not equal to numeric none +\fIexpr\fR == \fIexpr\fR Equal to numeric none +\fIexpr\fR > \fIexpr\fR Greater than numeric none +\fIexpr\fR >= \fIexpr\fR Greater than or equal to numeric none _ -\fIexpr\fR ~ \fIexpr\fRERE matchnumericnone -\fIexpr\fR !~ \fIexpr\fRERE non-match numericnone +\fIexpr\fR ~ \fIexpr\fR ERE match numeric none +\fIexpr\fR !~ \fIexpr\fR ERE non-match numeric none _ -\fIexpr\fR in arrayArray membershipnumericleft -( \fIindex\fR ) inMulti-dimension arraynumericleft - \fIarray\fR membership +\fIexpr\fR in array Array membership numeric left +( \fIindex\fR ) in Multi-dimension array numeric left + \fIarray\fR membership _ -\fBexpr\fR && \fIexpr\fRLogical ANDnumericleft +\fBexpr\fR && \fIexpr\fR Logical AND numeric left _ -\fBexpr\fR |\|| \fIexpr\fRLogical ORnumericleft +\fBexpr\fR |\|| \fIexpr\fR Logical OR numeric left _ -\fIexpr1\fR ? \fIexpr2\fRConditional expressiontype of selectedright - : \fIexpr3\fR \fIexpr2\fR or \fIexpr3\fR +\fIexpr1\fR ? \fIexpr2\fR Conditional expression type of selected right + : \fIexpr3\fR \fIexpr2\fR or \fIexpr3\fR _ -\fIlvalue\fR ^= \fIexpr\fRExponentiationnumericright -assignment -\fIlvalue\fR %= \fIexpr\fRModulus assignmentnumericright -\fIlvalue\fR *= \fIexpr\fRMultiplicationnumericright -assignment -\fIlvalue\fR /= \fIexpr\fRDivision assignmentnumericright -\fIlvalue\fR += \fIexpr\fRAddition assignmentnumericright -\fIlvalue\fR \(mi= \fIexpr\fRSubtraction assignmentnumericright -\fIlvalue\fR = \fIexpr\fRAssignmenttype of \fIexpr\fRright +\fIlvalue\fR ^= \fIexpr\fR Exponentiation numeric right + assignment +\fIlvalue\fR %= \fIexpr\fR Modulus assignment numeric right +\fIlvalue\fR *= \fIexpr\fR Multiplication numeric right + assignment +\fIlvalue\fR /= \fIexpr\fR Division assignment numeric right +\fIlvalue\fR += \fIexpr\fR Addition assignment numeric right +\fIlvalue\fR \(mi= \fIexpr\fR Subtraction assignment numeric right +\fIlvalue\fR = \fIexpr\fR Assignment type of \fIexpr\fR right .TE .sp @@ -491,23 +475,19 @@ string\fR. \fB/usr/bin/nawk\fR and \fB/usr/xpg4/bin/awk\fR: .sp .ne 2 -.mk .na \fB\fBARGC\fR\fR .ad .RS 12n -.rt The number of elements in the \fBARGV\fR array. .RE .sp .ne 2 -.mk .na \fB\fBARGV\fR\fR .ad .RS 12n -.rt An array of command line arguments, excluding options and the \fIprogram\fR argument, numbered from zero to \fBARGC\fR\(mi1. .sp @@ -523,12 +503,10 @@ argument. .sp .ne 2 -.mk .na \fB\fBENVIRON\fR\fR .ad .RS 12n -.rt The variable \fBENVIRON\fR is an array representing the value of the environment. The indices of the array are strings consisting of the names of the environment variables, and the value of each array element is a string @@ -545,12 +523,10 @@ environment used is the environment at the time \fBnawk\fR began executing. .sp .ne 2 -.mk .na \fB\fBFILENAME\fR\fR .ad .RS 12n -.rt A pathname of the current input file. Inside a \fBBEGIN\fR action the value is undefined. Inside an \fBEND\fR action the value is the name of the last input file processed. @@ -558,12 +534,10 @@ file processed. .sp .ne 2 -.mk .na \fB\fBFNR\fR\fR .ad .RS 12n -.rt The ordinal number of the current record in the current file. Inside a \fBBEGIN\fR action the value is zero. Inside an \fBEND\fR action the value is the number of the last record processed in the last file processed. @@ -571,23 +545,19 @@ the number of the last record processed in the last file processed. .sp .ne 2 -.mk .na \fB\fBFS\fR\fR .ad .RS 12n -.rt Input field separator regular expression; a space character by default. .RE .sp .ne 2 -.mk .na \fB\fBNF\fR\fR .ad .RS 12n -.rt The number of fields in the current record. Inside a \fBBEGIN\fR action, the use of \fBNF\fR is undefined unless a \fBgetline\fR function without a \fIvar\fR argument is executed previously. Inside an \fBEND\fR action, \fBNF\fR @@ -598,12 +568,10 @@ prior to entering the \fBEND\fR action. .sp .ne 2 -.mk .na \fB\fBNR\fR\fR .ad .RS 12n -.rt The ordinal number of the current record from the start of input. Inside a \fBBEGIN\fR action the value is zero. Inside an \fBEND\fR action the value is the number of the last record processed. @@ -611,12 +579,10 @@ the number of the last record processed. .sp .ne 2 -.mk .na \fB\fBOFMT\fR\fR .ad .RS 12n -.rt The \fBprintf\fR format for converting numbers to strings in output statements \fB"%.6g"\fR by default. The result of the conversion is unspecified if the value of \fBOFMT\fR is not a floating-point format specification. @@ -624,45 +590,37 @@ value of \fBOFMT\fR is not a floating-point format specification. .sp .ne 2 -.mk .na \fB\fBOFS\fR\fR .ad .RS 12n -.rt The \fBprint\fR statement output field separator; a space character by default. .RE .sp .ne 2 -.mk .na \fB\fBORS\fR\fR .ad .RS 12n -.rt The \fBprint\fR output record separator; a newline character by default. .RE .sp .ne 2 -.mk .na \fB\fBLENGTH\fR\fR .ad .RS 12n -.rt The length of the string matched by the \fBmatch\fR function. .RE .sp .ne 2 -.mk .na \fB\fBRS\fR\fR .ad .RS 12n -.rt The first character of the string value of \fBRS\fR is the input record separator; a newline character by default. If \fBRS\fR contains more than one character, the results are unspecified. If \fBRS\fR is null, then records are @@ -673,12 +631,10 @@ field separator is always newline, no matter what the value of \fBFS\fR. .sp .ne 2 -.mk .na \fB\fBRSTART\fR\fR .ad .RS 12n -.rt The starting position of the string matched by the \fBmatch\fR function, numbering from 1. This is always equivalent to the return value of the \fBmatch\fR function. @@ -686,12 +642,10 @@ numbering from 1. This is always equivalent to the return value of the .sp .ne 2 -.mk .na \fB\fBSUBSEP\fR\fR .ad .RS 12n -.rt The subscript separator string for multi-dimensional arrays. The default value is \fB\e034\fR\&. .RE @@ -702,12 +656,10 @@ is \fB\e034\fR\&. The following variable is supported for \fB/usr/xpg4/bin/awk\fR only: .sp .ne 2 -.mk .na \fB\fBCONVFMT\fR\fR .ad .RS 11n -.rt The \fBprintf\fR format for converting numbers to strings (except for output statements, where \fBOFMT\fR is used). The default is \fB%.6g\fR. .RE @@ -729,25 +681,23 @@ the table below: .sp .TS -tab(); -lw(.61i) lw(2.44i) lw(2.44i) -lw(.61i) lw(2.44i) lw(2.44i) -. -\fBEscape Sequence\fR\fBDescription\fR\fBMeaning\fR +l l l +l l l . +\fBEscape Sequence\fR \fBDescription\fR \fBMeaning\fR _ -\fB\e"\fRBackslash quotation-markQuotation-mark character +\fB\e"\fR Backslash quotation-mark Quotation-mark character _ -\fB\e/\fRBackslash slashSlash character +\fB\e/\fR Backslash slash Slash character _ -\fB\e\fR\fIddd\fRT{ +\fB\e\fR\fIddd\fR T{ A backslash character followed by the longest sequence of one, two, or three octal-digit characters (01234567). If all of the digits are 0, (that is, representation of the NULL character), the behavior is undefined. -T}T{ +T} T{ The character encoded by the one-, two- or three-digit octal integer. Multi-byte characters require multiple, concatenated escape sequences, including the leading \e for each byte. T} _ -\fB\e\fR\fIc\fRT{ -A backslash character followed by any character not described in this table or special characters (\fB\e\e\fR, \fB\ea\fR, \fB\eb\fR, \fB\ef\fR, \fB\en\fR, \fB\er\fR, \fB\et\fR, \fB\ev\fR). -T}Undefined +\fB\e\fR\fIc\fR T{ +A backslash character followed by any character not described in this table or special characters (\fB\e\e\fR, \fB\ea\fR, \fB\eb\fR, \fB\ef\fR, \fB\en\fR, \fB\er\fR, \fB\et\fR, \fB\ev\fR). +T} Undefined .TE .sp @@ -886,10 +836,10 @@ An action is a sequence of statements. A statement can be one of the following: .in +2 .nf if ( \fIexpression\fR ) \fIstatement\fR [ else \fIstatement\fR ] -while ( \fIexpression\fR ) \fIstatement\fR +while ( \fIexpression\fR ) \fIstatement\fR do \fIstatement\fR while ( \fIexpression\fR ) -for ( \fIexpression\fR ; \fIexpression\fR ; \fIexpression\fR ) \fIstatement\fR -for ( \fIvar\fR in \fIarray\fR ) \fIstatement\fR +for ( \fIexpression\fR ; \fIexpression\fR ; \fIexpression\fR ) \fIstatement\fR +for ( \fIvar\fR in \fIarray\fR ) \fIstatement\fR delete \fIarray\fR[\fIsubscript\fR] #delete an array element break continue @@ -1078,100 +1028,82 @@ optional in the following list (by displaying them within the \fB[ ]\fR brackets), such use is undefined. .sp .ne 2 -.mk .na \fB\fBatan2(\fR\fIy\fR,\fIx\fR\fB)\fR\fR .ad .RS 17n -.rt Return arctangent of \fIy\fR/\fIx\fR. .RE .sp .ne 2 -.mk .na \fB\fBcos\fR(\fIx\fR)\fR .ad .RS 17n -.rt Return cosine of \fIx,\fR where \fIx\fR is in radians. .RE .sp .ne 2 -.mk .na \fB\fBsin\fR(\fIx\fR)\fR .ad .RS 17n -.rt Return sine of \fIx,\fR where \fIx\fR is in radians. .RE .sp .ne 2 -.mk .na \fB\fBexp\fR(\fIx\fR)\fR .ad .RS 17n -.rt Return the exponential function of \fIx\fR. .RE .sp .ne 2 -.mk .na \fB\fBlog\fR(\fIx\fR)\fR .ad .RS 17n -.rt Return the natural logarithm of \fIx\fR. .RE .sp .ne 2 -.mk .na \fB\fBsqrt\fR(\fIx\fR)\fR .ad .RS 17n -.rt Return the square root of \fIx\fR. .RE .sp .ne 2 -.mk .na \fB\fBint\fR(\fIx\fR)\fR .ad .RS 17n -.rt Truncate its argument to an integer. It is truncated toward 0 when \fIx\fR > 0. .RE .sp .ne 2 -.mk .na \fB\fBrand()\fR\fR .ad .RS 17n -.rt Return a random number \fIn\fR, such that 0 \(<= \fIn\fR < 1. .RE .sp .ne 2 -.mk .na \fB\fBsrand\fR([\fBexpr\fR])\fR .ad .RS 17n -.rt Set the seed value for \fBrand\fR to \fIexpr\fR or use the time of day if \fIexpr\fR is omitted. The previous seed value is returned. .RE @@ -1185,7 +1117,6 @@ unless the argument or parentheses are indicated as optional in the following list (by displaying them within the \fB[ ]\fR brackets), such use is undefined. .sp .ne 2 -.mk .na \fB\fBgsub\fR(\fIere\fR,\fIrepl\fR[,\|\fIin\fR])\fR .ad @@ -1198,7 +1129,6 @@ the regular expression (like the \fBed\fR utility global substitute) in .sp .ne 2 -.mk .na \fB\fBindex\fR(\fIs\fR,\fIt\fR)\fR .ad @@ -1210,7 +1140,6 @@ string \fIt\fR first occurs, or zero if it does not occur at all. .sp .ne 2 -.mk .na \fB\fBlength\fR[([\fIs\fR])]\fR .ad @@ -1222,7 +1151,6 @@ whole record, \fB$0\fR, if there is no argument. .sp .ne 2 -.mk .na \fB\fBmatch\fR(\fIs\fR,\fIere\fR)\fR .ad @@ -1237,7 +1165,6 @@ of the matched string, \(mi1 if no match is found. .sp .ne 2 -.mk .na \fB\fBsplit\fR(\fIs\fR,\fIa\fR[,\|\fIfs\fR])\fR .ad @@ -1256,7 +1183,6 @@ value of \fIfs\fR is unspecified. .sp .ne 2 -.mk .na \fB\fBsprintf\fR(\fBfmt\fR,\fIexpr\fR,\fIexpr\fR,\fB\&...\fR)\fR .ad @@ -1268,7 +1194,6 @@ and return the resulting string. .sp .ne 2 -.mk .na \fB\fBsub\fR(\fIere\fR,\fIrepl\fR[,\|\fIin\fR])\fR .ad @@ -1291,7 +1216,6 @@ uses the current record (\fB$0\fR) in its place. .sp .ne 2 -.mk .na \fB\fBsubstr\fR(\fIs\fR,\fIm\fR[,\|\fIn\fR])\fR .ad @@ -1304,7 +1228,6 @@ substring is limited by the length of the string \fIs\fR. .sp .ne 2 -.mk .na \fB\fBtolower\fR(\fIs\fR)\fR .ad @@ -1319,7 +1242,6 @@ string by the lower-case letter specified by the mapping. Other characters in .sp .ne 2 -.mk .na \fB\fBtoupper\fR(\fIs\fR)\fR .ad @@ -1343,12 +1265,10 @@ below. The input/output and general functions are: .sp .ne 2 -.mk .na \fB\fBclose(\fR\fIexpression\fR)\fR .ad .RS 27n -.rt Close the file or pipe opened by a \fBprint\fR or \fBprintf\fR statement or a call to \fBgetline\fR with the same string-valued \fIexpression\fR. If the close was successful, the function returns \fB0\fR; otherwise, it returns @@ -1357,12 +1277,10 @@ non-zero. .sp .ne 2 -.mk .na \fB\fIexpression\fR|\fBgetline\fR[\fIvar\fR]\fR .ad .RS 27n -.rt Read a record of input from a stream piped from the output of a command. The stream is created if no stream is currently open with the value of \fIexpression\fR as its command name. The stream created is equivalent to one @@ -1387,36 +1305,30 @@ parentheses properly. .sp .ne 2 -.mk .na \fB\fBgetline\fR\fR .ad .RS 30n -.rt Set \fB$0\fR to the next input record from the current input file. This form of \fBgetline\fR sets the \fBNF\fR, \fBNR\fR, and \fBFNR\fR variables. .RE .sp .ne 2 -.mk .na \fB\fBgetline\fR \fIvar\fR\fR .ad .RS 30n -.rt Set variable \fIvar\fR to the next input record from the current input file. This form of \fBgetline\fR sets the \fBFNR\fR and \fBNR\fR variables. .RE .sp .ne 2 -.mk .na \fB\fBgetline\fR [\fIvar\fR] \fB<\fR \fIexpression\fR\fR .ad .RS 30n -.rt Read the next record of input from a named file. The \fIexpression\fR is evaluated to produce a string that is used as a full pathname. If the file of that name is not currently open, it is opened. As long as the stream remains @@ -1435,12 +1347,10 @@ portable applications must be put in parentheses properly. .sp .ne 2 -.mk .na \fB\fBsystem\fR(\fIexpression\fR)\fR .ad .RS 30n -.rt Execute the command given by \fIexpression\fR in a manner equivalent to the \fBsystem\fR(3C) function and return the exit status of the command. .RE @@ -1758,7 +1668,7 @@ variable, one per line: n = split (ENVIRON["PATH"], path, ":") for (i = 1; i <= n; ++i) print path[i] - }\fR + }\fR .fi .in -2 .sp @@ -1812,12 +1722,10 @@ that affect execution: \fBLC_COLLATE\fR, \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and \fBNLSPATH\fR. .sp .ne 2 -.mk .na \fB\fBLC_NUMERIC\fR\fR .ad .RS 14n -.rt Determine the radix character used when interpreting numeric input, performing conversions between numeric and string values and formatting numeric output. Regardless of locale, the period character (the decimal-point character of the @@ -1831,23 +1739,19 @@ programs (including assignments in command-line arguments). The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt All input files were processed successfully. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE diff --git a/usr/src/man/man1/nc.1 b/usr/src/man/man1/nc.1 index 0aab2f1f71..abcd5d0290 100644 --- a/usr/src/man/man1/nc.1 +++ b/usr/src/man/man1/nc.1 @@ -6,7 +6,7 @@ .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, .\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" Portions Copyright (c) 2009, Sun Microsystems, Inc. All Rights Reserved. -.TH nc 1 "Apr 9 2009" "SunOS 5.11" "User Commands" +.TH NC 1 "Apr 9, 2009" .SH NAME nc \- arbitrary TCP and UDP connections and listens .SH SYNOPSIS @@ -17,7 +17,7 @@ nc \- arbitrary TCP and UDP connections and listens .LP .nf -\fBnc\fR [\fB-46dnrtuvz\fR] [\fB-i\fR \fIinterval\fR] [\fB-P\fR \fIproxy_username\fR] [\fB-p\fR \fIport\fR] +\fBnc\fR [\fB-46dnrtuvz\fR] [\fB-i\fR \fIinterval\fR] [\fB-P\fR \fIproxy_username\fR] [\fB-p\fR \fIport\fR] [\fB-s\fR \fIsource_ip_address\fR] [\fB-T\fR \fIToS\fR] [\fB-w\fR \fItimeout\fR] [\fB-X\fR \fIproxy_protocol\fR] [\fB-x\fR \fIproxy_address\fR[:\fIport\fR]] \fIhostname\fR \fIport_list\fR @@ -85,7 +85,6 @@ a SOCKS or HTTP \fBProxyCommand\fR for \fBssh\fR(1) The following options are supported: .sp .ne 2 -.mk .na \fB\fB-4\fR\fR .ad @@ -96,7 +95,6 @@ Force \fBnc\fR to use IPv4 addresses only. .sp .ne 2 -.mk .na \fB\fB-6\fR\fR .ad @@ -107,7 +105,6 @@ Force \fBnc\fR to use IPv6 addresses only. .sp .ne 2 -.mk .na \fB\fB-D\fR\fR .ad @@ -118,7 +115,6 @@ Enable debugging on the socket. .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad @@ -129,7 +125,6 @@ Do not attempt to read from \fBstdin\fR. .sp .ne 2 -.mk .na \fB\fB-h\fR\fR .ad @@ -140,7 +135,6 @@ Print \fBnc\fR help. .sp .ne 2 -.mk .na \fB\fB-i\fR \fIinterval\fR\fR .ad @@ -152,7 +146,6 @@ This option also causes a delay time between connections to multiple ports. .sp .ne 2 -.mk .na \fB\fB-k\fR\fR .ad @@ -166,7 +159,6 @@ It is an error to use this option without the \fB-l\fR option. .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad @@ -182,7 +174,6 @@ ignored. .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad @@ -200,7 +191,6 @@ not have any effect when used in conjunction with the \fB-U\fR option. .sp .ne 2 -.mk .na \fB\fB-P\fR \fIproxy_username\fR\fR .ad @@ -216,7 +206,6 @@ It is an error to use this option in conjunction with the \fB-l\fR option. .sp .ne 2 -.mk .na \fB\fB-p\fR \fIport\fR\fR .ad @@ -232,7 +221,6 @@ is not specified. .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad @@ -246,7 +234,6 @@ It is an error to use this option in conjunction with the \fB-l\fR option. .sp .ne 2 -.mk .na \fB\fB-s\fR \fIsource_ip_address\fR\fR .ad @@ -259,7 +246,6 @@ It is an error to use this option in conjunction with the \fB-l\fR option. .sp .ne 2 -.mk .na \fB\fB-T\fR \fIToS\fR\fR .ad @@ -272,7 +258,6 @@ hexadecimal value preceded by \fB0x\fR. .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad @@ -285,7 +270,6 @@ Cause \fBnc\fR to send \fIRFC 854\fR \fBDON'T\fR and \fBWON'T\fR responses to .sp .ne 2 -.mk .na \fB\fB-U\fR\fR .ad @@ -301,7 +285,6 @@ has to be provided to \fBnc\fR, not a host name or port. .sp .ne 2 -.mk .na \fB\fB-u\fR\fR .ad @@ -312,7 +295,6 @@ Use UDP instead of the default option of TCP. .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad @@ -323,7 +305,6 @@ Specify verbose output. .sp .ne 2 -.mk .na \fB\fB-w\fR \fItimeout\fR\fR .ad @@ -339,7 +320,6 @@ timeout. .sp .ne 2 -.mk .na \fB\fB-X\fR \fIproxy_protocol\fR\fR .ad @@ -355,7 +335,6 @@ It is an error to use this option in conjunction with the \fB-l\fR option. .sp .ne 2 -.mk .na \fB\fB-x\fR \fIproxy_address\fR[:\fIport\fR]\fR .ad @@ -370,7 +349,6 @@ It is an error to use this option in conjunction with the \fB-l\fR option. .sp .ne 2 -.mk .na \fB\fB-z\fR\fR .ad @@ -387,12 +365,10 @@ It is an error to use this option in conjunction with the \fB-l\fR option. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIhostname\fR\fR .ad .RS 13n -.rt Specify host name. .sp \fIhostname\fR can be a numerical IP address or a symbolic hostname (unless the @@ -408,18 +384,15 @@ port. If \fIhostname\fR argument is not specified with \fB-l\fR option then .sp .ne 2 -.mk .na \fB\fIpath\fR\fR .ad .RS 13n -.rt Specify pathname. .RE .sp .ne 2 -.mk .na \fB\fIport\fR\fR .ad @@ -428,7 +401,6 @@ Specify pathname. \fB\fIport_list\fR\fR .ad .RS 13n -.rt Specify port. .sp \fIport_list\fR can be specified as single integers, ranges or combinations of @@ -870,13 +842,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilitySee below. +Interface Stability See below. .TE .sp diff --git a/usr/src/man/man1/nca.1 b/usr/src/man/man1/nca.1 index 69772419c9..67c06f1994 100644 --- a/usr/src/man/man1/nca.1 +++ b/usr/src/man/man1/nca.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 nca 1 "22 Feb 2005" "SunOS 5.11" "User Commands" +.TH NCA 1 "Feb 22, 2005" .SH NAME nca, snca \- the Solaris Network Cache and Accelerator (NCA) .SH DESCRIPTION @@ -75,67 +75,55 @@ Log File format. .SH FILES .sp .ne 2 -.mk .na \fB\fB/etc/nca/ncakmod.conf\fR\fR .ad .RS 25n -.rt Lists configuration parameters for \fBNCA\fR. .RE .sp .ne 2 -.mk .na \fB\fB/etc/nca/ncalogd.conf\fR\fR .ad .RS 25n -.rt Lists configuration parameters for \fBNCA\fR logging. .RE .sp .ne 2 -.mk .na \fB\fB/etc/nca/nca.if\fR\fR .ad .RS 25n -.rt Lists the physical interfaces on which \fBNCA\fR runs. .RE .sp .ne 2 -.mk .na \fB\fB/etc/nca/ncaport.conf\fR\fR .ad .RS 25n -.rt \fBncaport\fR configuration file .RE .sp .ne 2 -.mk .na \fB\fB/etc/hostname.{}{0-9}\fR\fR .ad .RS 25n -.rt Lists all physical interfaces configured on the server. .RE .sp .ne 2 -.mk .na \fB\fB/etc/hosts\fR\fR .ad .RS 25n -.rt Lists all host names associated with the server. Entries in this file must match with entries in \fB/etc/hostname.{}{0-9}\fR for \fBNCA\fR to function. .RE @@ -148,13 +136,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed .TE .SH SEE ALSO diff --git a/usr/src/man/man1/ncab2clf.1 b/usr/src/man/man1/ncab2clf.1 index 65f2cf4867..bba14f654a 100644 --- a/usr/src/man/man1/ncab2clf.1 +++ b/usr/src/man/man1/ncab2clf.1 @@ -3,13 +3,13 @@ .\" 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 ncab2clf 1 "28 Sep 2001" "SunOS 5.11" "User Commands" +.TH NCAB2CLF 1 "Sep 28, 2001" .SH NAME ncab2clf \- convert binary log file to Common Log File format .SH SYNOPSIS .LP .nf -\fB/usr/bin/ncab2clf\fR [\fB-Dhv\fR] [\fB-i\fR \fIinput-file\fR] [\fB-o\fR \fIoutput-file\fR] +\fB/usr/bin/ncab2clf\fR [\fB-Dhv\fR] [\fB-i\fR \fIinput-file\fR] [\fB-o\fR \fIoutput-file\fR] [\fB-b\fR \fIsize\fR] [\fB-n\fR \fInumber\fR] [\fB-s\fR \fIdatetime\fR] .fi @@ -24,78 +24,64 @@ output goes to \fBstdout\fR. .SH OPTIONS .sp .ne 2 -.mk .na \fB\fB-b\fR\fR .ad .RS 18n -.rt Specifies the binary-log-file blocking in kilobytes; the default is 64 Kbyte. .RE .sp .ne 2 -.mk .na \fB\fB-D\fR\fR .ad .RS 18n -.rt Specifies that direct \fBI/O\fR be disabled. .RE .sp .ne 2 -.mk .na \fB\fB-h\fR\fR .ad .RS 18n -.rt Prints usage message. .RE .sp .ne 2 -.mk .na \fB\fB-i\fR \fIinput-file\fR\fR .ad .RS 18n -.rt Specifies the input file. .RE .sp .ne 2 -.mk .na \fB\fB-n\fR \fInumber\fR\fR .ad .RS 18n -.rt Output \fInumber\fR CLF records. .RE .sp .ne 2 -.mk .na \fB\fB-o\fR \fIoutput-file\fR\fR .ad .RS 18n -.rt Specifies the output file. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR \fIdatetime\fR\fR .ad .RS 18n -.rt Skip any records before the date and time specified in \fIdatetime\fR. You can specify the date and time in CLF format or in the format specified by the \fBtouch\fR(1) utility. CLF format is the dominant format, so \fBncab2clf\fR @@ -104,12 +90,10 @@ first analyzes \fIdatetime\fR assuming CLF. .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 18n -.rt Provides verbose output. .RE @@ -170,23 +154,19 @@ example% ncab2clf -s '10/Apr/2001:09:23:13' -n 100 < /dev/dsk/c2t1d0s6 The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR \fR .ad .RS 6n -.rt The file converted successfully .RE .sp .ne 2 -.mk .na \fB>\fB0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -198,13 +178,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityEvolving +Interface Stability Evolving .TE .SH SEE ALSO diff --git a/usr/src/man/man1/ncakmod.1 b/usr/src/man/man1/ncakmod.1 index ed3dded2d2..63bb6e8691 100644 --- a/usr/src/man/man1/ncakmod.1 +++ b/usr/src/man/man1/ncakmod.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 ncakmod 1 "28 Sep 2001" "SunOS 5.11" "User Commands" +.TH NCAKMOD 1 "Sep 28, 2001" .SH NAME ncakmod \- start or stop the NCA kernel module .SH SYNOPSIS @@ -26,8 +26,8 @@ kernel module will be activated for all physical interfaces listed in the .sp .in +2 .nf -To stop NCA, please set the status configuration parameter -to disable in ncakmod.conf and then reboot your system. See +To stop NCA, please set the status configuration parameter +to disable in ncakmod.conf and then reboot your system. See the ncakmod.conf(4) manual page for more information. .fi .in -2 @@ -41,23 +41,19 @@ reboot your system. .SH OPTIONS .sp .ne 2 -.mk .na \fB\fBstart\fR\fR .ad .RS 9n -.rt Starts the \fBNCA\fR kernel module. .RE .sp .ne 2 -.mk .na \fB\fBstop\fR\fR .ad .RS 9n -.rt Describes the current method for stopping the \fBNCA\fR feature. .RE @@ -79,23 +75,19 @@ example% \fB/etc/init.d/ncakmod start\fR .SH FILES .sp .ne 2 -.mk .na \fB\fB/etc/init.d/ncakmod\fR\fR .ad .RS 25n -.rt The NCA kernel module startup script. .RE .sp .ne 2 -.mk .na \fB\fB/etc/nca/ncakmod.conf\fR\fR .ad .RS 25n -.rt Specifies configuration options for the NCA kernel module. .RE @@ -107,13 +99,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityEvolving +Interface Stability Evolving .TE .SH SEE ALSO diff --git a/usr/src/man/man1/newform.1 b/usr/src/man/man1/newform.1 index cbae5c43c6..2a504d152e 100644 --- a/usr/src/man/man1/newform.1 +++ b/usr/src/man/man1/newform.1 @@ -3,13 +3,13 @@ .\" 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 newform 1 "21 Jul 1997" "SunOS 5.11" "User Commands" +.TH NEWFORM 1 "Jul 21, 1997" .SH NAME newform \- change the format of a text file .SH SYNOPSIS .LP .nf -\fBnewform\fR [\fB-s\fR] [\fB-i\fR\fItabspec\fR] [\fB-o\fR\fItabspec\fR] [\fB-b\fR\fIn\fR] [\fB-e\fR\fIn\fR] [\fB-p\fR\fIn\fR] +\fBnewform\fR [\fB-s\fR] [\fB-i\fR\fItabspec\fR] [\fB-o\fR\fItabspec\fR] [\fB-b\fR\fIn\fR] [\fB-e\fR\fIn\fR] [\fB-p\fR\fIn\fR] [\fB-a\fR\fIn\fR] [\fB-f\fR] [\fB-c\fR\fIchar\fR] [\fB-l\fR\fIn\fR] [\fIfilename\fR]... .fi @@ -33,12 +33,10 @@ command line. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-s\fR \fR .ad .RS 14n -.rt Shears off leading characters on each line up to the first tab and places up to 8 of the sheared characters at the end of the line. If more than 8 characters (not counting the first tab) are sheared, the eighth character is replaced by a @@ -61,12 +59,10 @@ expanded to spaces, padded with spaces out to column 72 (or truncated to column .sp .ne 2 -.mk .na \fB\fB-i\fR\fItabspec\fR \fR .ad .RS 14n -.rt Input tab specification: expands tabs to spaces, according to the tab specifications given. \fITabspec\fR recognizes all tab specification forms described in \fBtabs\fR(1). In addition, \fItabspec\fR may be \fB-\fR, in which @@ -78,12 +74,10 @@ expects no tabs; if any are found, they are treated as \fB\(mi1\fR\&. .sp .ne 2 -.mk .na \fB\fB-o\fR\fItabspec\fR \fR .ad .RS 14n -.rt Output tab specification: replaces spaces by tabs, according to the tab specifications given. The tab specifications are the same as for \fB-i\fR\fItabspec\fR. If no \fItabspec\fR is given, \fItabspec\fR defaults to @@ -93,12 +87,10 @@ converted to tabs on output. .sp .ne 2 -.mk .na \fB\fB-b\fR\fIn\fR \fR .ad .RS 14n -.rt Truncate \fIn\fR characters from the beginning of the line when the line length is greater than the effective line length (see \fB\(mil\fIn\fR\fR). Default is to truncate the number of characters necessary to obtain the effective line @@ -111,24 +103,20 @@ follows: .sp .ne 2 -.mk .na \fB\fB-e\fR\fIn\fR\fR .ad .RS 14n -.rt Same as \fB-b\fR\fIn\fR except that characters are truncated from the end of the line. .RE .sp .ne 2 -.mk .na \fB\fB-p\fR\fIn\fR\fR .ad .RS 14n -.rt Prefix \fIn\fR characters (see \fB-c\fR\fIchar\fR) to the beginning of a line when the line length is less than the effective line length. Default is to prefix the number of characters necessary to obtain the effective line length. @@ -136,23 +124,19 @@ prefix the number of characters necessary to obtain the effective line length. .sp .ne 2 -.mk .na \fB\fB-a\fR\fIn\fR\fR .ad .RS 14n -.rt Same as \fB-p\fR\fIn\fR except characters are appended to the end of a line. .RE .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 14n -.rt Write the tab specification format line on the standard output before any other lines are output. The tab specification format line which is printed will correspond to the format specified in the \fBlast\fR \fB-o\fR option. If no @@ -162,24 +146,20 @@ default specification of \fB\(mi8\fR\&. .sp .ne 2 -.mk .na \fB\fB-c\fR\fIchar\fR\fR .ad .RS 14n -.rt Change the prefix/append character to \fIchar\fR. Default character for \fIchar\fR is a space. .RE .sp .ne 2 -.mk .na \fB\fB-l\fR\fIn\fR\fR .ad .RS 14n -.rt Set the effective line length to \fIn\fR characters. If \fIn\fR is not entered, \fB-l\fR defaults to 72. The default line length without the \fB-l\fR option is 80 characters. Note: Tabs and backspaces are considered to be one character @@ -195,12 +175,10 @@ existing line in the file so that the \fB-b\fR option is activated. The following operand is supported: .sp .ne 2 -.mk .na \fB\fIfilename\fR \fR .ad .RS 13n -.rt Input file .RE @@ -210,23 +188,19 @@ Input file The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR \fR .ad .RS 6n -.rt Successful operation. .RE .sp .ne 2 -.mk .na \fB\fB1\fR \fR .ad .RS 6n -.rt Operation failed. .RE @@ -240,7 +214,6 @@ Operation failed. All diagnostics are fatal. .sp .ne 2 -.mk .na \fB\fBusage:\fR \fB \|.\|.\|.\fR \fR .ad @@ -251,7 +224,6 @@ All diagnostics are fatal. .sp .ne 2 -.mk .na \fB\fB"not \fR\fB-s\fR\fB format"\fR\fR .ad @@ -262,7 +234,6 @@ There was no tab on one line. .sp .ne 2 -.mk .na \fB\fB"can't open file"\fR\fR .ad @@ -273,7 +244,6 @@ Self-explanatory. .sp .ne 2 -.mk .na \fB\fB"internal line too long"\fR\fR .ad @@ -284,7 +254,6 @@ A line exceeds 512 characters after being expanded in the internal work buffer. .sp .ne 2 -.mk .na \fB\fB"tabspec in error" \fR\fR .ad @@ -296,7 +265,6 @@ ascending. .sp .ne 2 -.mk .na \fB\fB"tabspec indirection illegal" \fR\fR .ad diff --git a/usr/src/man/man1/newgrp.1 b/usr/src/man/man1/newgrp.1 index aaf521842c..30626dd8a3 100644 --- a/usr/src/man/man1/newgrp.1 +++ b/usr/src/man/man1/newgrp.1 @@ -3,14 +3,14 @@ .\" Copyright 1989 AT&T .\" Portions Copyright (c) 1982-2007 AT&T Knowledge Ventures .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 newgrp 1 "2 Nov 2007" "SunOS 5.11" "User Commands" +.TH NEWGRP 1 "Nov 2, 2007" .SH NAME newgrp \- log in to a new group .SH SYNOPSIS @@ -154,12 +154,10 @@ field splitting and file name generation are not performed. The following option is supported: .sp .ne 2 -.mk .na \fB\fB-l\fR | \fB\(mi\fR\fR .ad .RS 13n -.rt Change the environment to what would be expected if the user actually logged in again as a member of the new group. .RE @@ -170,12 +168,10 @@ again as a member of the new group. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIgroup\fR\fR .ad .RS 12n -.rt A group name from the group database or a non-negative numeric group ID. Specifies the group ID to which the real and effective group IDs is set. If \fIgroup\fR is a non-negative numeric string and exists in the group database @@ -185,12 +181,10 @@ that group name is used as the group ID. .sp .ne 2 -.mk .na \fB\fIargument\fR\fR .ad .RS 12n -.rt \fBsh\fR and \fBksh\fR only. Options and/or operand of the \fBnewgrp\fR command. .RE @@ -209,35 +203,29 @@ or not the group identification was changed successfully, the exit status is the exit status of the shell. Otherwise, the following exit value is returned: .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB/etc/group\fR\fR .ad .RS 15n -.rt System group file .RE .sp .ne 2 -.mk .na \fB\fB/etc/passwd\fR\fR .ad .RS 15n -.rt System password file .RE @@ -250,15 +238,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .SS "ksh93" @@ -266,13 +253,12 @@ StandardSee \fBstandards\fR(5). .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityUncommitted +Interface Stability Uncommitted .TE .SH SEE ALSO diff --git a/usr/src/man/man1/news.1 b/usr/src/man/man1/news.1 index a7fb93c7be..77b48d883c 100644 --- a/usr/src/man/man1/news.1 +++ b/usr/src/man/man1/news.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 news 1 "20 Dec 1996" "SunOS 5.11" "User Commands" +.TH NEWS 1 "Dec 20, 1996" .SH NAME news \- print news items .SH SYNOPSIS @@ -29,36 +29,30 @@ are considered ``current.'' .SH OPTIONS .sp .ne 2 -.mk .na \fB\fB-a\fR \fR .ad .RS 7n -.rt Print all items, regardless of currency. In this case, the stored time is not changed. .RE .sp .ne 2 -.mk .na \fB\fB-n\fR \fR .ad .RS 7n -.rt Report the names of the current items without printing their contents, and without changing the stored time. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR \fR .ad .RS 7n -.rt report how many current items exist, without printing their names or contents, and without changing the stored time. It is useful to include such an invocation of \fBnews\fR in one's \fB\&.profile\fR file, or in the system's @@ -82,34 +76,28 @@ variable that affects the execution of \fBnews\fR. .SH FILES .sp .ne 2 -.mk .na \fB\fB/etc/profile\fR\fR .ad .RS 20n -.rt .RE .sp .ne 2 -.mk .na \fB\fB/var/news/*\fR\fR .ad .RS 20n -.rt .RE .sp .ne 2 -.mk .na \fB\fB$HOME/.news_time\fR\fR .ad .RS 20n -.rt .RE diff --git a/usr/src/man/man1/newtask.1 b/usr/src/man/man1/newtask.1 index 41d5d8f663..1f70a383c6 100644 --- a/usr/src/man/man1/newtask.1 +++ b/usr/src/man/man1/newtask.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 newtask 1 "17 Nov 2004" "SunOS 5.11" "User Commands" +.TH NEWTASK 1 "Nov 17, 2004" .SH NAME newtask \- create new task and optionally change project .SH SYNOPSIS @@ -36,12 +36,10 @@ completion of the preceding system task. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-c\fR \fIpid\fR\fR .ad .RS 10n -.rt Cause a running process to enter a newly created task. A project for the new task can also be specified using the \fB-p\fR option. The invoking user must either own the process or have super-user privileges. @@ -57,12 +55,10 @@ This option is incompatible with the \fB-F\fR and \fB-l\fR options. .sp .ne 2 -.mk .na \fB\fB-F\fR\fR .ad .RS 10n -.rt Creates a finalized task, within which further \fBnewtask\fR or \fBsettaskid\fR(2) invocations would fail. Finalized tasks can be useful at some sites for simplifying the attribution of resource consumption. @@ -70,24 +66,20 @@ some sites for simplifying the attribution of resource consumption. .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 10n -.rt Changes the environment to what would be expected if the user actually logged in again as a member of the new project. .RE .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 10n -.rt Changes the project \fBID\fR of the new task to that associated with the given project name. The invoking user must be a valid member of the requested project, or must have super-user privileges, for the command to succeed. If no @@ -97,12 +89,10 @@ current project. .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 10n -.rt Verbose: displays the system task id as the new system task is begun. .RE @@ -112,12 +102,10 @@ Verbose: displays the system task id as the new system task is begun. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIproject\fR\fR .ad .RS 11n -.rt The project to which resource usage by the created task should be charged. The requested project must be defined in the project databases defined in \fBnsswitch.conf\fR(4). @@ -125,12 +113,10 @@ requested project must be defined in the project databases defined in .sp .ne 2 -.mk .na \fB\fIcommand\fR\fR .ad .RS 11n -.rt The command to be executed as the new task. If no command is given, the user's login shell is invoked. (If the login shell is not available, \fB/bin/sh\fR is invoked.) @@ -193,57 +179,47 @@ example$ \fBnewtask -c 9999 -p russia\fR The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt Successful execution. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt A fatal error occurred during execution. .RE .sp .ne 2 -.mk .na \fB\fB2\fR\fR .ad .RS 5n -.rt Invalid command line options were specified. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB/etc/project\fR\fR .ad .RS 16n -.rt Local database containing valid project definitions for this machine. .RE .sp .ne 2 -.mk .na \fB\fB/proc/pid/*\fR\fR .ad .RS 16n -.rt Process information and control files. .RE diff --git a/usr/src/man/man1/nice.1 b/usr/src/man/man1/nice.1 index 9925c592c1..e9ec019535 100644 --- a/usr/src/man/man1/nice.1 +++ b/usr/src/man/man1/nice.1 @@ -1,25 +1,25 @@ '\" te .\" Copyright 1989 AT&T Copyright (c) 2004, Sun Microsystems, Inc. All Rights Reserved Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 nice 1 "23 Jan 2004" "SunOS 5.11" "User Commands" +.TH NICE 1 "Jan 23, 2004" .SH NAME nice \- invoke a command with an altered scheduling priority .SH SYNOPSIS .LP .nf -\fB/usr/bin/nice\fR [\fB-\fIincrement\fR\fR | \fB-n\fR \fIincrement\fR] \fIcommand\fR +\fB/usr/bin/nice\fR [\fB-\fIincrement\fR\fR | \fB-n\fR \fIincrement\fR] \fIcommand\fR [\fIargument\fR]... .fi .LP .nf -\fB/usr/xpg4/bin/nice\fR [\fB-\fIincrement\fR\fR | \fB-n\fR \fIincrement\fR] \fIcommand\fR +\fB/usr/xpg4/bin/nice\fR [\fB-\fIincrement\fR\fR | \fB-n\fR \fIincrement\fR] \fIcommand\fR [\fIargument\fR]... .fi @@ -59,12 +59,10 @@ the utility versions. See \fBcsh\fR(1) for description. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-\fR\fIincrement\fR | \fB-n\fR \fIincrement\fR\fR .ad .RS 29n -.rt \fIincrement\fR is a positive or negative decimal integer that has the same effect on the execution of the utility as if the utility had called the \fBnice()\fR function with the numeric value of the \fIincrement\fR @@ -83,12 +81,10 @@ an unprivileged user is ignored. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIcommand\fR\fR .ad .RS 12n -.rt The name of a command that is to be invoked. If \fIcommand\fR names any of the special built-in utilities (see \fBshell_builtins\fR(1)), the results are undefined. @@ -96,12 +92,10 @@ undefined. .sp .ne 2 -.mk .na \fB\fIargument\fR\fR .ad .RS 12n -.rt Any string to be supplied as an argument when invoking \fIcommand\fR. .RE @@ -119,34 +113,28 @@ status of \fIcommand\fR. Otherwise, \fBnice\fR will exit with one of the following values: .sp .ne 2 -.mk .na \fB\fB1-125\fR\fR .ad .RS 9n -.rt An error occurred. .RE .sp .ne 2 -.mk .na \fB\fB126\fR\fR .ad .RS 9n -.rt \fIcommand\fR was found but could not be invoked. .RE .sp .ne 2 -.mk .na \fB\fB127\fR\fR .ad .RS 9n -.rt \fIcommand\fR could not be found. .RE @@ -159,13 +147,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled .TE .SS "/usr/xpg4/bin/nice" @@ -173,15 +160,14 @@ CSIEnabled .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man1/nl.1 b/usr/src/man/man1/nl.1 index ee000bdbb0..d8deee657b 100644 --- a/usr/src/man/man1/nl.1 +++ b/usr/src/man/man1/nl.1 @@ -1,27 +1,27 @@ '\" te .\" Copyright 1989 AT&T Copyright (c) 1995, Sun Microsystems, Inc. All Rights Reserved Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 nl 1 "28 Mar 1995" "SunOS 5.11" "User Commands" +.TH NL 1 "Mar 28, 1995" .SH NAME nl \- line numbering filter .SH SYNOPSIS .LP .nf -\fB/usr/bin/nl\fR [\fB-p\fR] [\fB-b\fR [\fItype\fR]] [\fB-d\fR [\fIdelim\fR]] [\fB-f\fR [\fItype\fR]] - [\fB-h\fR [\fItype\fR]] [\fB-i\fR [\fIincr\fR]] [\fB-l\fR [\fInum\fR]] [\fB-n\fR [\fIformat\fR]] +\fB/usr/bin/nl\fR [\fB-p\fR] [\fB-b\fR [\fItype\fR]] [\fB-d\fR [\fIdelim\fR]] [\fB-f\fR [\fItype\fR]] + [\fB-h\fR [\fItype\fR]] [\fB-i\fR [\fIincr\fR]] [\fB-l\fR [\fInum\fR]] [\fB-n\fR [\fIformat\fR]] [\fB-s\fR [\fIsep\fR]] [\fB-w\fR [\fIwidth\fR]] [\fB-v\fR [\fIstartnum\fR]] [\fIfile\fR] .fi .LP .nf -\fB/usr/xpg4/bin/nl\fR [\fB-p\fR] [\fB-b\fR \fItype\fR] [\fB-d\fR \fIdelim\fR] [\fB-f\fR \fItype\fR] - [\fB-h\fR \fItype\fR] [\fB-i\fR \fIincr\fR] [\fB-l\fR \fInum\fR] [\fB-n\fR \fIformat\fR] [\fB-s\fR \fIsep\fR] +\fB/usr/xpg4/bin/nl\fR [\fB-p\fR] [\fB-b\fR \fItype\fR] [\fB-d\fR \fIdelim\fR] [\fB-f\fR \fItype\fR] + [\fB-h\fR \fItype\fR] [\fB-i\fR \fIincr\fR] [\fB-l\fR \fInum\fR] [\fB-n\fR \fIformat\fR] [\fB-s\fR \fIsep\fR] [\fB-w\fR \fIwidth\fR] [\fB-v\fR \fIstartnum\fR] [\fIfile\fR] .fi @@ -48,17 +48,16 @@ nothing but the following delimiter character(s): .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -Line contentsStart Of +box; +c | c +l | l . +Line contents Start Of _ -\e:\e:\e:header +\e:\e:\e: header _ -\e:\e:body +\e:\e: body _ -\e:footer +\e: footer .TE .sp @@ -77,55 +76,45 @@ arguments. If option-arguments of \fB/usr/bin/nl\fR options are not specified, these options result in the default. The supported options are: .sp .ne 2 -.mk .na \fB\fB-b\fR\fItype\fR\fR .ad .RS 14n -.rt Specifies which logical page body lines are to be numbered. Recognized \fItype\fRs and their meanings are: .sp .ne 2 -.mk .na \fB\fBa\fR\fR .ad .RS 8n -.rt number all lines .RE .sp .ne 2 -.mk .na \fB\fBt\fR\fR .ad .RS 8n -.rt number all non-empty lines. .RE .sp .ne 2 -.mk .na \fB\fBn\fR\fR .ad .RS 8n -.rt no line numbering .RE .sp .ne 2 -.mk .na \fB\fBp\fIexp\fR\fR\fR .ad .RS 8n -.rt number only lines that contain the regular expression specified in \fIexp\fR. See NOTES below. .RE @@ -135,24 +124,20 @@ Default \fItype\fR for logical page body is \fBt\fR (text lines numbered). .sp .ne 2 -.mk .na \fB\fB-f\fR\fItype\fR\fR .ad .RS 14n -.rt Same as \fB-b\fR\fItype\fR except for footer. Default \fItype\fR for logical page footer is \fBn\fR (no lines numbered). .RE .sp .ne 2 -.mk .na \fB\fB-d\fR\fIdelim\fR\fR .ad .RS 14n -.rt The two delimiter characters specifying the start of a logical page section may be changed from the default characters (\e\|:\|) to two user-specified characters. If only one character is entered, the second character remains the @@ -162,36 +147,30 @@ delimiter characters. To enter a backslash, use two backslashes. .sp .ne 2 -.mk .na \fB\fB-h\fR\fItype\fR\fR .ad .RS 14n -.rt Same as \fB-b\fR\fItype\fR except for header. Default \fItype\fR for logical page header is \fBn\fR (no lines numbered). .RE .sp .ne 2 -.mk .na \fB\fB-i\fR\fIincr\fR\fR .ad .RS 14n -.rt \fIincr\fR is the increment value used to number logical page lines. Default \fIincr\fR is \fB1\fR. .RE .sp .ne 2 -.mk .na \fB\fB-l\fR\fInum\fR\fR .ad .RS 14n -.rt \fInum\fR is the number of blank lines to be considered as one. For example, \fB\(mil2\fR results in only the second adjacent blank being numbered (if the appropriate \fB-ha\fR, \fB-ba\fR, and/or \fB-fa\fR option is set). Default @@ -200,43 +179,35 @@ appropriate \fB-ha\fR, \fB-ba\fR, and/or \fB-fa\fR option is set). Default .sp .ne 2 -.mk .na \fB\fB-n\fR\fIformat\fR\fR .ad .RS 14n -.rt \fIformat\fR is the line numbering format. Recognized values are: .sp .ne 2 -.mk .na \fB\fBln\fR\fR .ad .RS 6n -.rt left justified, leading zeroes suppressed .RE .sp .ne 2 -.mk .na \fB\fBrn\fR\fR .ad .RS 6n -.rt right justified, leading zeroes suppressed .RE .sp .ne 2 -.mk .na \fB\fBrz\fR\fR .ad .RS 6n -.rt right justified, leading zeroes kept .RE @@ -245,47 +216,39 @@ Default \fIformat\fR is \fBrn\fR (right justified). .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 14n -.rt Do not restart numbering at logical page delimiters. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fIsep\fR\fR .ad .RS 14n -.rt \fIsep\fR is the character(s) used in separating the line number and the corresponding text line. Default \fIsep\fR is a \fBTAB\fR. .RE .sp .ne 2 -.mk .na \fB\fB-v\fR\fIstartnum\fR\fR .ad .RS 14n -.rt \fIstartnum\fR is the initial value used to number logical page lines. Default \fIstartnum\fR is \fB1\fR. .RE .sp .ne 2 -.mk .na \fB\fB-w\fR\fIwidth\fR\fR .ad .RS 14n -.rt \fIwidth\fR is the number of characters to be used for the line number. Default \fIwidth\fR is \fB6\fR. .RE @@ -296,12 +259,10 @@ corresponding text line. Default \fIsep\fR is a \fBTAB\fR. The following operand is supported: .sp .ne 2 -.mk .na \fB\fIfile\fR\fR .ad .RS 8n -.rt A path name of a text file to be line-numbered. .RE @@ -338,30 +299,25 @@ that affect the execution of \fBnl\fR: \fBLANG\fR, \fBLC_ALL\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB/usr/lib/locale/\fIlocale\fR/LC_COLLATE/CollTable\fR\fR .ad @@ -372,7 +328,6 @@ Collation table generated by \fBlocaledef\fR .sp .ne 2 -.mk .na \fB\fB/usr/lib/locale/\fIlocale\fR/LC_COLLATE/coll.so\fR\fR .ad @@ -390,13 +345,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man1/nm.1 b/usr/src/man/man1/nm.1 index 951fa822ab..ab7b537c2d 100644 --- a/usr/src/man/man1/nm.1 +++ b/usr/src/man/man1/nm.1 @@ -1,27 +1,27 @@ '\" te -.\" Copyright 1989 AT&T +.\" Copyright 1989 AT&T .\" Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 nm 1 "10 Oct 2007" "SunOS 5.11" "User Commands" +.TH NM 1 "Oct 10, 2007" .SH NAME nm \- print name list of an object file .SH SYNOPSIS .LP .nf -\fB/usr/bin/nm\fR [\fB-ACDhlnPprRsTuVv\fR] [\fB-efox\fR] [\fB-g\fR | \fB-u\fR] +\fB/usr/bin/nm\fR [\fB-ACDhlnPprRsTuVv\fR] [\fB-efox\fR] [\fB-g\fR | \fB-u\fR] [\fB-t\fR \fIformat\fR] \fIfile\fR... .fi .LP .nf -\fB/usr/xpg4/bin/nm\fR [\fB-ACDhlnPprRsTuVv\fR] [\fB-efox\fR] [\fB-g\fR | \fB-u\fR] +\fB/usr/xpg4/bin/nm\fR [\fB-ACDhlnPprRsTuVv\fR] [\fB-efox\fR] [\fB-g\fR | \fB-u\fR] [\fB-t\fR \fIformat\fR] \fIfile\fR... .fi @@ -40,34 +40,28 @@ utility reports that fact, but not consider it an error condition. The output of \fBnm\fR can be controlled using the following options: .sp .ne 2 -.mk .na \fB\fB-A\fR\fR .ad .RS 13n -.rt Writes the full path name or library name of an object on each line. .RE .sp .ne 2 -.mk .na \fB\fB-C\fR\fR .ad .RS 13n -.rt Demangles C++ symbol names before printing them out. .RE .sp .ne 2 -.mk .na \fB\fB-D\fR\fR .ad .RS 13n -.rt Displays the \fBSHT_DYNSYM\fR symbol information. This is the symbol table used by \fBld.so.1\fR and is present even in stripped dynamic executables. If \fB-D\fR is not specified, the default behavior is to display the @@ -76,56 +70,46 @@ by \fBld.so.1\fR and is present even in stripped dynamic executables. If .sp .ne 2 -.mk .na \fB\fB-e\fR\fR .ad .RS 13n -.rt See NOTES below. .RE .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 13n -.rt See NOTES below. .RE .sp .ne 2 -.mk .na \fB\fB-g\fR\fR .ad .RS 13n -.rt Writes only external (global) symbol information. .RE .sp .ne 2 -.mk .na \fB\fB-h\fR\fR .ad .RS 13n -.rt Does not display the output heading data. .RE .sp .ne 2 -.mk .na \fB\fB-L\fR\fR .ad .RS 13n -.rt Displays the \fBSHT_SUNW_LDYNSYM\fR symbol information. This symbol table contains local function symbols. \fBSHT_SUNW_LDYNSM\fR symbol tables are present even in stripped dynamic executables. These symbols augment the global @@ -136,191 +120,157 @@ information. .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 13n -.rt Distinguishes between \fBWEAK\fR and \fBGLOBAL\fR symbols by appending a * to the key letter for \fBWEAK\fR symbols. .RE .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 13n -.rt Sorts external symbols by name before they are printed. .RE .sp .ne 2 -.mk .na \fB\fB-o\fR\fR .ad .RS 13n -.rt Prints the value and size of a symbol in octal instead of decimal (equivalent to \fB-t\fR \fBo\fR). .RE .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 13n -.rt Produces easy to parse, terse output. Each symbol name is preceded by its value (blanks if undefined) and one of the letters: .sp .ne 2 -.mk .na \fB\fBA\fR\fR .ad .RS 5n -.rt Absolute symbol. .RE .sp .ne 2 -.mk .na \fB\fBB\fR\fR .ad .RS 5n -.rt bss (uninitialized data space) symbol. .RE .sp .ne 2 -.mk .na \fB\fBC\fR\fR .ad .RS 5n -.rt COMMON symbol. .RE .sp .ne 2 -.mk .na \fB\fBD\fR\fR .ad .RS 5n -.rt Data object symbol. .RE .sp .ne 2 -.mk .na \fB\fBF\fR\fR .ad .RS 5n -.rt File symbol. .RE .sp .ne 2 -.mk .na \fB\fBN\fR\fR .ad .RS 5n -.rt Symbol has no type. .RE .sp .ne 2 -.mk .na \fB\fBL\fR\fR .ad .RS 5n -.rt Thread-Local storage symbol. .RE .sp .ne 2 -.mk .na \fB\fBS\fR\fR .ad .RS 5n -.rt Section symbol. .RE .sp .ne 2 -.mk .na \fB\fBT\fR\fR .ad .RS 5n -.rt Text symbol. .RE .sp .ne 2 -.mk .na \fB\fBU\fR\fR .ad .RS 5n -.rt Undefined. .RE If the symbol's binding attribute is: .sp .ne 2 -.mk .na \fB\fBLOCAL\fR\fR .ad .RS 10n -.rt The key letter is lower case. .RE .sp .ne 2 -.mk .na \fB\fBWEAK\fR\fR .ad .RS 10n -.rt The key letter is upper case. If the \fB-l\fR modifier is specified, the upper case key letter is followed by a \fB*\fR .RE .sp .ne 2 -.mk .na \fB\fBGLOBAL\fR\fR .ad .RS 10n -.rt The key letter is upper case. .RE @@ -328,90 +278,74 @@ The key letter is upper case. .sp .ne 2 -.mk .na \fB\fB-P\fR\fR .ad .RS 13n -.rt Writes information in a portable output format, as specified in \fBStandard Output\fR. .RE .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 13n -.rt Prepends the name of the object file or archive to each output line. .RE .sp .ne 2 -.mk .na \fB\fB-R\fR\fR .ad .RS 13n -.rt Prints the archive name (if present), followed by the object file and symbol name. If the \fB-r\fR option is also specified, this option is ignored. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 13n -.rt Prints section name instead of section index. .RE .sp .ne 2 -.mk .na \fB\fB-t\fR \fIformat\fR\fR .ad .RS 13n -.rt Writes each numeric value in the specified format. The format is dependent on the single character used as the \fIformat\fR option-argument: .sp .ne 2 -.mk .na \fB\fBd\fR\fR .ad .RS 5n -.rt The offset is written in decimal (default). .RE .sp .ne 2 -.mk .na \fB\fBo\fR\fR .ad .RS 5n -.rt The offset is written in octal. .RE .sp .ne 2 -.mk .na \fB\fBx\fR\fR .ad .RS 5n -.rt The offset is written in hexadecimal. .RE @@ -419,70 +353,58 @@ The offset is written in hexadecimal. .sp .ne 2 -.mk .na \fB\fB-T\fR\fR .ad .RS 13n -.rt See \fBNOTES\fR. .RE .SS "/usr/bin/nm" .sp .ne 2 -.mk .na \fB\fB-u\fR\fR .ad .RS 6n -.rt Prints undefined symbols only. .RE .SS "/usr/xpg4/bin/nm" .sp .ne 2 -.mk .na \fB\fB-u\fR\fR .ad .RS 6n -.rt Prints long listing for each undefined symbol. See \fBOUTPUT\fR below. .RE .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 6n -.rt Sorts external symbols by value before they are printed. .RE .sp .ne 2 -.mk .na \fB\fB-V\fR\fR .ad .RS 6n -.rt Prints the version of the \fBnm\fR command executing on the standard error output. .RE .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad .RS 6n -.rt Prints the value and size of a symbol in hexadecimal instead of decimal (equivalent to \fB-t\fR \fBx\fR). .RE @@ -500,12 +422,10 @@ exception.) The following operand is supported: .sp .ne 2 -.mk .na \fB\fIfile\fR\fR .ad .RS 8n -.rt A path name of an object file, executable file or object-file library. .RE @@ -519,23 +439,19 @@ This section describes the \fBnm\fR utility's output options. For each symbol, the following information is printed: .sp .ne 2 -.mk .na \fB\fBIndex\fR\fR .ad .RS 15n -.rt The index of the symbol. (The index appears in brackets.) .RE .sp .ne 2 -.mk .na \fB\fBValue\fR\fR .ad .RS 15n -.rt The value of the symbol is one of the following: .RS +4 .TP @@ -559,109 +475,89 @@ A virtual address in executable and dynamic library files. .sp .ne 2 -.mk .na \fB\fBSize\fR\fR .ad .RS 15n -.rt The size in bytes of the associated object. .RE .sp .ne 2 -.mk .na \fB\fBType\fR\fR .ad .RS 15n -.rt A symbol is of one of the following types: .sp .ne 2 -.mk .na \fB\fBNOTYPE\fR\fR .ad .RS 11n -.rt No type was specified. .RE .sp .ne 2 -.mk .na \fB\fBOBJECT\fR\fR .ad .RS 11n -.rt A data object such as an array or variable. .RE .sp .ne 2 -.mk .na \fB\fBFUNC\fR\fR .ad .RS 11n -.rt A function or other executable code. .RE .sp .ne 2 -.mk .na \fB\fBREGI\fR\fR .ad .RS 11n -.rt A register symbol (\fBSPARC\fR only). .RE .sp .ne 2 -.mk .na \fB\fBSECTION\fR\fR .ad .RS 11n -.rt A section symbol. .RE .sp .ne 2 -.mk .na \fB\fBFILE\fR\fR .ad .RS 11n -.rt Name of the source file. .RE .sp .ne 2 -.mk .na \fB\fBCOMMON\fR\fR .ad .RS 11n -.rt An uninitialized common block. .RE .sp .ne 2 -.mk .na \fB\fBTLS\fR\fR .ad .RS 11n -.rt A variable associated with Thread-Local storage. .RE @@ -669,43 +565,35 @@ A variable associated with Thread-Local storage. .sp .ne 2 -.mk .na \fB\fBBind\fR\fR .ad .RS 15n -.rt The symbol's binding attributes. .sp .ne 2 -.mk .na \fB\fBLOCAL symbols\fR\fR .ad .RS 18n -.rt Have a scope limited to the object file containing their definition. .RE .sp .ne 2 -.mk .na \fB\fBGLOBAL symbols\fR\fR .ad .RS 18n -.rt Are visible to all object files being combined. .RE .sp .ne 2 -.mk .na \fB\fBWEAK symbols\fR\fR .ad .RS 18n -.rt Are essentially global symbols with a lower precedence than \fBGLOBAL\fR. .RE @@ -713,12 +601,10 @@ Are essentially global symbols with a lower precedence than \fBGLOBAL\fR. .sp .ne 2 -.mk .na \fB\fBOther\fR\fR .ad .RS 15n -.rt A symbol's visibility. .sp The lower bits of the \fBst_other\fR member of the \fBElf32_Sym\fR structure, @@ -742,44 +628,36 @@ used and can be one of: .sp .ne 2 -.mk .na \fB\fBShndx\fR\fR .ad .RS 15n -.rt Except for three special values, this is the section header table index in relation to which the symbol is defined. The following special values exist: .sp .ne 2 -.mk .na \fB\fBABS\fR\fR .ad .RS 10n -.rt Indicates the symbol's value does not change through relocation. .RE .sp .ne 2 -.mk .na \fB\fBCOMMON\fR\fR .ad .RS 10n -.rt Indicates an unallocated block and the value provides alignment constraints. .RE .sp .ne 2 -.mk .na \fB\fBUNDEF\fR\fR .ad .RS 10n -.rt Indicates an undefined symbol. .RE @@ -787,23 +665,19 @@ Indicates an undefined symbol. .sp .ne 2 -.mk .na \fB\fBName\fR\fR .ad .RS 15n -.rt The name of the symbol. .RE .sp .ne 2 -.mk .na \fB\fBObject Name\fR\fR .ad .RS 15n -.rt The name of the object or library if \fB-A\fR is specified. .RE @@ -916,23 +790,19 @@ that affect the execution of \fBnm\fR: \fBLANG\fR, \fBLC_ALL\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -945,13 +815,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed .TE .SH SEE ALSO @@ -967,12 +836,10 @@ The following options are obsolete because of changes to the object file format and might be deleted in a future release. .sp .ne 2 -.mk .na \fB\fB-e\fR\fR .ad .RS 6n -.rt Prints only external and static symbols. The symbol table now contains only static and external symbols. Automatic symbols no longer appear in the symbol table. They do appear in the debugging information produced by \fBcc\fR @@ -981,12 +848,10 @@ table. They do appear in the debugging information produced by \fBcc\fR .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 6n -.rt Produces full output. Redundant symbols (such as \fB\&.text\fR, \fB\&.data\fR, and so forth), which existed previously, do not exist and producing full output is identical to the default output. @@ -994,12 +859,10 @@ is identical to the default output. .sp .ne 2 -.mk .na \fB\fB-T\fR\fR .ad .RS 6n -.rt By default, \fBnm\fR prints the entire name of the symbols listed. Since symbol names have been moved to the last column, the problem of overflow is removed and it is no longer necessary to truncate the symbol name. diff --git a/usr/src/man/man1/nohup.1 b/usr/src/man/man1/nohup.1 index 47e700a55b..57e24dd11b 100644 --- a/usr/src/man/man1/nohup.1 +++ b/usr/src/man/man1/nohup.1 @@ -1,13 +1,13 @@ '\" te .\" Copyright 1989 AT&T Copyright (c) 2006, Sun Microsystems, Inc. All Rights Reserved Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 nohup 1 "19 Jun 2006" "SunOS 5.11" "User Commands" +.TH NOHUP 1 "Jun 19, 2006" .SH NAME nohup \- run a command immune to hangups .SH SYNOPSIS @@ -53,24 +53,20 @@ cause them to be killed. All stopped, running, and background jobs ignores \fBSIGHUP\fR. .sp .ne 2 -.mk .na \fB\fB/usr/bin/nohup\fR\fR .ad .RS 27n -.rt Processes run by \fB/usr/bin/nohup\fR are immune to \fBSIGHUP\fR (hangup) and \fBSIGQUIT\fR (quit) signals. .RE .sp .ne 2 -.mk .na \fB\fB/usr/bin/nohup\fR \fB-p\fR [\fB-Fa\fR]\fR .ad .RS 27n -.rt Processes specified by \fBID\fR are made immune to \fBSIGHUP\fR and \fBSIGQUIT\fR, and all output to the controlling terminal is redirected to \fBnohup.out\fR. If \fB-F\fR is specified, \fBnohup\fR forces control of each @@ -81,12 +77,10 @@ for either signal. .sp .ne 2 -.mk .na \fB\fB/usr/bin/nohup\fR \fB-g\fR [\fB-Fa\fR]\fR .ad .RS 27n -.rt Every process in the same process group as the processes specified by \fBID\fR are made immune to \fBSIGHUP\fR and \fBSIGQUIT\fR, and all output to the controlling terminal is redirected to \fBnohup.out\fR. If \fB-F\fR is @@ -97,12 +91,10 @@ specified, \fBnohup\fR changes the signal disposition of \fBSIGHUP\fR and .sp .ne 2 -.mk .na \fB\fB/usr/xpg4/bin/nohup\fR\fR .ad .RS 27n -.rt Processes run by \fB/usr/xpg4/bin/nohup\fR are immune to \fBSIGHUP\fR. .sp The \fBnohup\fR utility does not arrange to make processes immune to a @@ -123,47 +115,39 @@ redirected. The priority of the process run by \fBnohup\fR is not altered. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 6n -.rt Always changes the signal disposition of target processes. This option is valid only when specified with \fB-p\fR or \fB-g\fR. .RE .sp .ne 2 -.mk .na \fB\fB-F\fR\fR .ad .RS 6n -.rt Force. Grabs the target processes even if another process has control. This option is valid only when specified with \fB-p\fR or \fB-g.\fR .RE .sp .ne 2 -.mk .na \fB\fB-g\fR\fR .ad .RS 6n -.rt Operates on a list of process groups. This option is not valid with \fB-p\fR. .RE .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 6n -.rt Operates on a list of processes. This option is not valid with \fB-g\fR. .RE @@ -173,34 +157,28 @@ Operates on a list of processes. This option is not valid with \fB-g\fR. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIpid\fR\fR .ad .RS 12n -.rt A decimal process \fBID\fR to be manipulated by \fBnohup\fR \fB-p\fR. .RE .sp .ne 2 -.mk .na \fB\fIpgid\fR\fR .ad .RS 12n -.rt A decimal process group \fBID\fR to be manipulated by \fBnohup\fR \fB-g\fR. .RE .sp .ne 2 -.mk .na \fB\fIcommand\fR\fR .ad .RS 12n -.rt The name of a command that is to be invoked. If the \fIcommand\fR operand names any of the special \fBshell_builtins\fR(1) utilities, the results are undefined. @@ -208,12 +186,10 @@ undefined. .sp .ne 2 -.mk .na \fB\fIargument\fR\fR .ad .RS 12n -.rt Any string to be supplied as an argument when invoking the \fIcommand\fR operand. .RE @@ -295,12 +271,10 @@ that affect the execution of \fBnohup\fR: \fBLANG\fR, \fBLC_ALL\fR, \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, \fBPATH\fR, \fBNLSPATH\fR, and \fBPATH\fR. .sp .ne 2 -.mk .na \fB\fBHOME\fR\fR .ad .RS 8n -.rt Determine the path name of the user's home directory: if the output file \fBnohup.out\fR cannot be created in the current directory, the \fBnohup\fR command uses the directory named by \fBHOME\fR to create the file. @@ -312,23 +286,19 @@ command uses the directory named by \fBHOME\fR to create the file. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB126\fR\fR .ad .RS 7n -.rt \fIcommand\fR was found but could not be invoked. .RE .sp .ne 2 -.mk .na \fB\fB127\fR\fR .ad .RS 7n -.rt An error occurred in \fBnohup\fR, or \fIcommand\fR could not be found .RE @@ -339,24 +309,20 @@ operand. .SH FILES .sp .ne 2 -.mk .na \fB\fBnohup.out\fR\fR .ad .RS 19n -.rt The output file of the \fBnohup\fR execution if standard output is a terminal and if the current directory is writable. .RE .sp .ne 2 -.mk .na \fB\fB$HOME/nohup.out\fR\fR .ad .RS 19n -.rt The output file of the \fBnohup\fR execution if standard output is a terminal and if the current directory is not writable. .RE @@ -370,13 +336,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled .TE .SS "/usr/xpg4/bin/nohup" @@ -384,15 +349,14 @@ CSIEnabled .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man1/nroff.1 b/usr/src/man/man1/nroff.1 index b3fe693389..953795a0bc 100644 --- a/usr/src/man/man1/nroff.1 +++ b/usr/src/man/man1/nroff.1 @@ -3,13 +3,13 @@ .\" 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 nroff 1 "1 Nov 2007" "SunOS 5.11" "User Commands" +.TH NROFF 1 "Nov 1, 2007" .SH NAME nroff \- format documents for display or line-printer .SH SYNOPSIS .LP .nf -\fBnroff\fR [\fB-ehiq\fR] [\fB-m\fR\fIname\fR] [\fB-n\fR\fIN\fR] [\fB-o\fR\fIpagelist\fR] [\fB-r\fR\fIaN\fR] [\fB-s\fR\fIN\fR] +\fBnroff\fR [\fB-ehiq\fR] [\fB-m\fR\fIname\fR] [\fB-n\fR\fIN\fR] [\fB-o\fR\fIpagelist\fR] [\fB-r\fR\fIaN\fR] [\fB-s\fR\fIN\fR] [\fB-T\fR\fIname\fR] [\fB-u\fR\fIN\fR] [\fIfilename...\fR] .fi @@ -30,24 +30,20 @@ The following options are supported. Options can appear in any order so long as they appear \fIbefore\fR the files. .sp .ne 2 -.mk .na \fB\fB-e\fR\fR .ad .RS 14n -.rt Produces equally-spaced words in adjusted lines, using full terminal resolution. .RE .sp .ne 2 -.mk .na \fB\fB-h\fR\fR .ad .RS 14n -.rt Uses output \fITAB\fR characters during horizontal spacing to speed output and reduces output character count. \fITAB\fR settings are assumed to be every 8 nominal character widths. @@ -55,57 +51,47 @@ nominal character widths. .sp .ne 2 -.mk .na \fB\fB-i\fR\fR .ad .RS 14n -.rt Reads the standard input after the input files are exhausted. .RE .sp .ne 2 -.mk .na \fB\fB-q\fR\fR .ad .RS 14n -.rt Does not print output that was read from an \fB\&.rd\fR request. .RE .sp .ne 2 -.mk .na \fB\fB-m\fR\fIname\fR\fR .ad .RS 14n -.rt Prepends the macro file \fB/usr/share/lib/tmac/\fIname\fR\fR to the input files. .RE .sp .ne 2 -.mk .na \fB\fB-n\fR\fIN\fR\fR .ad .RS 14n -.rt Numbers first generated page \fIN\fR. .RE .sp .ne 2 -.mk .na \fB\fB-o\fR\fIpagelist\fR\fR .ad .RS 14n -.rt Prints only pages whose page numbers appear in the comma-separated \fIlist\fR of numbers and ranges. A range \fIN\fR\fB-\fR\fIM\fR means pages \fIN\fR through \fIM\fR; an initial \fB-N\fR means from the beginning to page \fIN\fR; @@ -114,23 +100,19 @@ and a final \fIN\fR\(mi means from \fIN\fR to the end. .sp .ne 2 -.mk .na \fB\fB-r\fR\fIaN\fR\fR .ad .RS 14n -.rt Sets register \fIa\fR (one-character) to \fIN\fR. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fIN\fR\fR .ad .RS 14n -.rt Stops every \fIN\fR pages. \fBnroff\fR halts prior to every \fIN\fR pages (default \fIN\fR=1) to allow paper loading or changing, and resumes upon receipt of a \fINEWLINE\fR. @@ -138,121 +120,99 @@ receipt of a \fINEWLINE\fR. .sp .ne 2 -.mk .na \fB\fB-T\fR\fIname\fR\fR .ad .RS 14n -.rt Prepares output for a device of the specified \fIname\fR. Known \fIname\fRs are: .sp .ne 2 -.mk .na \fB\fB37\fR\fR .ad .RS 14n -.rt Teletype Corporation Model 37 terminal \(em this is the default. .RE .sp .ne 2 -.mk .na \fB\fBlp\fR | \fBtn300\fR\fR .ad .RS 14n -.rt \fBGE\fR \(em any line printer or terminal without half-line capability. .RE .sp .ne 2 -.mk .na \fB\fB300\fR\fR .ad .RS 14n -.rt \fBDASI\fR-300. .RE .sp .ne 2 -.mk .na \fB\fB300-12\fR\fR .ad .RS 14n -.rt \fBDASI\fR-300 \(em 12-pitch. .RE .sp .ne 2 -.mk .na \fB\fB300S\fR\fR .ad .RS 14n -.rt \fBDASI\fR-300S. .RE .sp .ne 2 -.mk .na \fB\fB300S-12\fR\fR .ad .RS 14n -.rt \fBDASI\fR-300S. .RE .sp .ne 2 -.mk .na \fB\fB382\fR\fR .ad .RS 14n -.rt \fBDASI\fR-382 (fancy \fBDTC\fR 382). .RE .sp .ne 2 -.mk .na \fB\fB450\fR\fR .ad .RS 14n -.rt \fBDASI\fR-450 (Diablo Hyterm). .RE .sp .ne 2 -.mk .na \fB\fB450-12\fR\fR .ad .RS 14n -.rt \fBDASI\fR-450 (Diablo Hyterm) \(em 12-pitch. .RE .sp .ne 2 -.mk .na \fB\fB832\fR\fR .ad .RS 14n -.rt \fBAJ\fR 832. .RE @@ -260,12 +220,10 @@ Teletype Corporation Model 37 terminal \(em this is the default. .sp .ne 2 -.mk .na \fB\fB-u\fR\fIN\fR\fR .ad .RS 14n -.rt Set the emboldening factor for the font mounted in position \fB3\fR to \fIN\fR. If \fIN\fR is missing, then set the emboldening factor to \fB0\fR. .RE @@ -276,12 +234,10 @@ If \fIN\fR is missing, then set the emboldening factor to \fB0\fR. The following operand is supported: .sp .ne 2 -.mk .na \fB\fIfilename\fR\fR .ad .RS 12n -.rt The file containing text to be processed by \fBnroff\fR. .RE @@ -310,7 +266,6 @@ and \fBNLSPATH\fR. .SH FILES .sp .ne 2 -.mk .na \fB\fB/usr/tmp/trtmp*\fR\fR .ad @@ -321,7 +276,6 @@ temporary file (see NOTES) .sp .ne 2 -.mk .na \fB\fB/usr/share/lib/tmac/tmac.*\fR\fR .ad @@ -332,7 +286,6 @@ standard macro files .sp .ne 2 -.mk .na \fB\fB/usr/share/lib/nterm/*\fR\fR .ad @@ -343,7 +296,6 @@ terminal driving tables for \fBnroff\fR .sp .ne 2 -.mk .na \fB\fB/usr/share/lib/nterm/README\fR\fR .ad @@ -360,13 +312,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled .TE .SH SEE ALSO diff --git a/usr/src/man/man1/od.1 b/usr/src/man/man1/od.1 index 10ad0619b0..d2a7282744 100644 --- a/usr/src/man/man1/od.1 +++ b/usr/src/man/man1/od.1 @@ -1,13 +1,13 @@ '\" te .\" Copyright 1989 AT&T Copyright (c) 1992, X/Open Company Limited All Rights Reserved Portions Copyright (c) 2005, Sun Microsystems, Inc. All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 od 1 "20 May 2005" "SunOS 5.11" "User Commands" +.TH OD 1 "May 20, 2005" .SH NAME od \- octal dump .SH SYNOPSIS @@ -18,7 +18,7 @@ od \- octal dump .LP .nf -\fB/usr/bin/od\fR [\fB-bcCDdFfOoSsvXx\fR] [\fB-A\fR \fIaddress_base\fR] [\fB-j\fR \fIskip\fR] +\fB/usr/bin/od\fR [\fB-bcCDdFfOoSsvXx\fR] [\fB-A\fR \fIaddress_base\fR] [\fB-j\fR \fIskip\fR] [\fB-N\fR \fIcount\fR] [\fB-t\fR \fItype_string\fR]... [\fB-\fR] [\fIfile\fR]... .fi @@ -29,7 +29,7 @@ od \- octal dump .LP .nf -\fB/usr/xpg4/bin/od\fR [\fB-bcCDdFfOoSsvXx\fR] [\fB-A\fR \fIaddress_base\fR] +\fB/usr/xpg4/bin/od\fR [\fB-bcCDdFfOoSsvXx\fR] [\fB-A\fR \fIaddress_base\fR] [\fB-j\fR \fIskip\fR] [\fB-N\fR \fIcount\fR] [\fB-t\fR \fItype_string\fR]... [\fIfile\fR]... .fi @@ -48,34 +48,28 @@ specified. If no \fIfile\fR is specified, the standard input is used. The the following terms are used: .sp .ne 2 -.mk .na \fBword\fR .ad .RS 20n -.rt Refers to a 16-bit unit, independent of the word size of the machine. .RE .sp .ne 2 -.mk .na \fBlong word\fR .ad .RS 20n -.rt Refers to a 32-bit unit. .RE .sp .ne 2 -.mk .na \fBdouble long word\fR .ad .RS 20n -.rt Refers to a 64-bit unit. .RE @@ -85,12 +79,10 @@ Refers to a 64-bit unit. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-A\fR \fIaddress_base\fR \fR .ad .RS 20n -.rt Specifies the input offset base. The \fIaddress_base\fR option-argument must be a character. The characters \fBd\fR, \fBo\fR and \fBx\fR specify that the offset base will be written in decimal, octal or hexadecimal, respectively. The @@ -105,24 +97,20 @@ offset base is displayed in octal. .sp .ne 2 -.mk .na \fB\fB-b\fR \fR .ad .RS 20n -.rt Interprets bytes in octal. This is equivalent to \fB-t\fR \fBo1\fR. .RE .SS "/usr/bin/od" .sp .ne 2 -.mk .na \fB\fB-c\fR \fR .ad .RS 7n -.rt Displays single-byte characters. Certain non-graphic characters appear as C-language escapes: .sp @@ -154,12 +142,10 @@ Others appear as 3-digit octal numbers. For example: .SS "/usr/xpg4/bin/od" .sp .ne 2 -.mk .na \fB\fB-c\fR \fR .ad .RS 19n -.rt Interprets bytes as single-byte or multibyte characters according to the current setting of the \fBLC_CTYPE\fR locale category. Printable multibyte characters are written in the area corresponding to the first byte of the @@ -171,12 +157,10 @@ would using the \fB-C\fR option. .sp .ne 2 -.mk .na \fB\fB-C\fR \fR .ad .RS 19n -.rt Interprets bytes as single-byte or multibyte characters according to the current setting of the \fBLC_CTYPE\fR locale category. Printable multibyte characters are written in the area corresponding to the first byte of the @@ -202,59 +186,49 @@ byte in the character. .sp .ne 2 -.mk .na \fB\fB-d\fR \fR .ad .RS 19n -.rt Interprets words in unsigned decimal. This is equivalent to \fB-t\fR \fBu2\fR. .RE .sp .ne 2 -.mk .na \fB\fB-D\fR \fR .ad .RS 19n -.rt Interprets long words in unsigned decimal. This is equivalent to \fB-t\fR \fBu4\fR. .RE .sp .ne 2 -.mk .na \fB\fB-f\fR \fR .ad .RS 19n -.rt Interprets long words in floating point. This is equivalent to \fB-t\fR \fBf4\fR. .RE .sp .ne 2 -.mk .na \fB\fB-F\fR \fR .ad .RS 19n -.rt Interprets double long words in extended precision. This is equivalent to \fB-t\fR \fBf8\fR. .RE .sp .ne 2 -.mk .na \fB\fB-j\fR \fIskip\fR \fR .ad .RS 19n -.rt Jumps over \fIskip\fR bytes from the beginning of the input. The \fBod\fR command will read or seek past the first \fIskip\fR bytes in the concatenated input files. If the combined input is not at least \fIskip\fR bytes long, the @@ -274,12 +248,10 @@ the base of the \fIskip\fR option-argument. .sp .ne 2 -.mk .na \fB\fB-N\fR \fIcount\fR \fR .ad .RS 19n -.rt Formats no more than \fIcount\fR bytes of input. By default, \fIcount\fR is interpreted as a decimal number. With a leading \fB0x\fR or \fB0X\fR, \fIcount\fR is interpreted as a hexadecimal number; otherwise, with a leading @@ -292,69 +264,57 @@ by the base of the \fIcount\fR option-argument. .sp .ne 2 -.mk .na \fB\fB-o\fR \fR .ad .RS 19n -.rt Interprets words in octal. This is equivalent to \fB-t\fR \fBo2\fR. .RE .sp .ne 2 -.mk .na \fB\fB-O\fR \fR .ad .RS 19n -.rt Interprets long words in unsigned octal. This is equivalent to \fB-t\fR \fBo4\fR. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR \fR .ad .RS 19n -.rt Interprets words in signed decimal. This is equivalent to \fB-t\fR \fBd2\fR. .RE .sp .ne 2 -.mk .na \fB\fB-S\fR \fR .ad .RS 19n -.rt Interprets long words in signed decimal. This is equivalent to \fB-t\fR \fBd4\fR. .RE .sp .ne 2 -.mk .na \fB\fB-t\fR \fItype_string\fR \fR .ad .RS 19n -.rt Specifies one or more output types. The \fItype_string\fR option-argument must be a string specifying the types to be used when writing the input data. The string must consist of the type specification characters: .sp .ne 2 -.mk .na \fB\fBa\fR \fR .ad .RS 6n -.rt \fINamed character\fR. Interprets bytes as named characters. Only the least significant seven bits of each byte will be used for this type specification. Bytes with the values listed in the following table will be written using the @@ -364,8 +324,8 @@ The following are named characters in \fBod\fR: .sp .in +2 .nf -Value Name - +Value Name + \000 nul \001 soh \002 stx @@ -408,12 +368,10 @@ Value Name .sp .ne 2 -.mk .na \fB\fBc\fR \fR .ad .RS 6n -.rt \fICharacter\fR. Interprets bytes as single-byte or multibyte characters specified by the current setting of the \fBLC_CTYPE\fR locale category. Printable multibyte characters are written in the area corresponding to the @@ -430,12 +388,10 @@ The type specification characters \fBd\fR, \fBf\fR, \fBo\fR, \fBu\fR, and the number of bytes to be transformed by each instance of the output type. .sp .ne 2 -.mk .na \fB\fBf\fR \fR .ad .RS 18n -.rt \fIFloating point\fR. Can be followed by an optional \fBF\fR, \fBD\fR, or \fBL\fR indicating that the conversion should be applied to an item of type \fBfloat\fR, \fBdouble\fR, or \fBlong double\fR, respectively. @@ -443,12 +399,10 @@ the number of bytes to be transformed by each instance of the output type. .sp .ne 2 -.mk .na \fB\fBd\fR, \fBo\fR, \fBu\fR, and \fBx\fR\fR .ad .RS 18n -.rt \fISigned decimal\fR, \fIoctal\fR, \fIunsigned decimal\fR, and \fIhexadecimal\fR, respectively. Can be followed by an optional \fBC\fR, \fBS\fR, \fBI\fR, or \fBL\fR indicating that the conversion should be applied @@ -464,12 +418,10 @@ specified. .sp .ne 2 -.mk .na \fB\fB-v\fR \fR .ad .RS 19n -.rt Shows all input data (verbose). Without the \fB-v\fR option, all groups of output lines that would be identical to the immediately preceding output line (except for byte offsets), will be replaced with a line containing only an @@ -478,23 +430,19 @@ asterisk (*). .sp .ne 2 -.mk .na \fB\fB-x\fR \fR .ad .RS 19n -.rt Interprets words in hex. This is equivalent to \fB-t\fR \fBx2\fR. .RE .sp .ne 2 -.mk .na \fB\fB-X\fR \fR .ad .RS 19n -.rt Interprets long words in hex. This is equivalent to \fB-t\fR \fBx4\fR. .RE @@ -505,12 +453,10 @@ Interprets long words in hex. This is equivalent to \fB-t\fR \fBx4\fR. The following operands are supported for \fB/usr/bin/od\fR only: .sp .ne 2 -.mk .na \fB\fB\(mi\fR \fR .ad .RS 26n -.rt Uses the standard input in addition to any files specified. When this operand is not given, the standard input is used only if no \fIfile\fR operands are specified. @@ -518,12 +464,10 @@ specified. .sp .ne 2 -.mk .na \fB\fIfile\fR \fR .ad .RS 26n -.rt A path name of a file to be read. If no \fIfile\fR operands are specified, the standard input will be used. If there are no more than two operands, none of the \fB-A\fR, \fB-j\fR, \fB-N\fR, or \fB-t\fR options is specified, and @@ -563,7 +507,6 @@ is reached. .sp .ne 2 -.mk .na \fB\fB[+][0]\fR \fIoffset\fR \fB[.][b|B]\fR\fR .ad @@ -580,7 +523,6 @@ is reached. \fB\fB[+][0x|x]\fR \fIoffset\fR\fB[B]\fR\fR .ad .RS 26n -.rt The \fIoffset_string\fR operand specifies the byte offset in the file where dumping is to commence. The offset is interpreted in octal bytes by default. If \fIoffset\fR begins with "\fB0\fR", it is interpreted in octal. If @@ -602,19 +544,16 @@ conversions in the same offset operand. The following operands are supported for \fB/usr/xpg4/bin/od\fR only: .sp .ne 2 -.mk .na \fB\fIfile\fR \fR .ad .RS 29n -.rt Same as \fB/usr/bin/od\fR, except only one of the first two conditions must be true. .RE .sp .ne 2 -.mk .na \fB\fB[+] [0] \fR\fIoffset\fR \fB[.]\|[b|B]\fR\fR .ad @@ -639,7 +578,6 @@ true. \fB\fB+x\fR\fIoffset \fR\fB[B]\fR\fR .ad .RS 29n -.rt Description of \fIoffset_string\fR is the same as for \fB/usr/bin/od\fR. .RE @@ -655,23 +593,19 @@ that affect the execution of \fBod\fR: \fBLANG\fR, \fBLC_ALL\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR \fR .ad .RS 7n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR \fR .ad .RS 7n -.rt An error occurred. .RE @@ -684,13 +618,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIenabled +CSI enabled .TE .SS "/usr/xpg4/bin/od" @@ -698,15 +631,14 @@ CSIenabled .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIenabled +CSI enabled _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man1/on.1 b/usr/src/man/man1/on.1 index 0ea19ac374..a07ed7ca9b 100644 --- a/usr/src/man/man1/on.1 +++ b/usr/src/man/man1/on.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 on 1 "8 Oct 2003" "SunOS 5.11" "User Commands" +.TH ON 1 "Oct 8, 2003" .SH NAME on \- execute a command on a remote system with the local environment .SH SYNOPSIS @@ -32,23 +32,19 @@ the corresponding files for the \fBon\fR command. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad .RS 6n -.rt Debug mode. Prints out some messages as work is being done. .RE .sp .ne 2 -.mk .na \fB\fB-i\fR\fR .ad .RS 6n -.rt Interactive mode. Uses remote echoing and special character processing. This option is needed for programs that expect to be talking to a terminal. All terminal modes and window size changes are propagated. @@ -56,12 +52,10 @@ terminal modes and window size changes are propagated. .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 6n -.rt No Input. This option causes the remote program to get EOF when it reads from the standard input, instead of passing the standard input from the standard input of the \fBon\fR program. For example, \fB-n\fR is necessary when running @@ -76,7 +70,6 @@ commands in the background with job control. .SH DIAGNOSTICS .sp .ne 2 -.mk .na \fB\fBunknown host\fR\fR .ad @@ -87,7 +80,6 @@ Host name not found. .sp .ne 2 -.mk .na \fB\fBcannot connect to server\fR\fR .ad @@ -98,7 +90,6 @@ Host down or not running the server. .sp .ne 2 -.mk .na \fB\fBcan't find\fR\fR .ad @@ -109,7 +100,6 @@ Problem finding the working directory. .sp .ne 2 -.mk .na \fB\fBcan't locate mount point\fR \fR .ad @@ -120,7 +110,6 @@ Problem finding current file system. .sp .ne 2 -.mk .na \fB\fBRPC: Authentication error\fR \fR .ad @@ -133,7 +122,6 @@ keylogin. If that fails, try to set your publickey with chkey. .sp .ne 2 -.mk .na \fB\fBon \fIserver\fR: RPC: can't encode arguments\fR\fR .ad diff --git a/usr/src/man/man1/optisa.1 b/usr/src/man/man1/optisa.1 index 592360606f..1140913cb4 100644 --- a/usr/src/man/man1/optisa.1 +++ b/usr/src/man/man1/optisa.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 optisa 1 "25 Jul 1997" "SunOS 5.11" "User Commands" +.TH OPTISA 1 "Jul 25, 1997" .SH NAME optisa \- determine which variant instruction set is optimal to use .SH SYNOPSIS @@ -26,24 +26,20 @@ defined by the order in which instruction set names are returned by The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt One of the \fIinstruction_set\fR values you specified is printed by this command. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt There is no output; that is, this machine cannot use any \fIinstruction_set\fR that you specified with the \fBoptisa\fR command. .RE diff --git a/usr/src/man/man1/pack.1 b/usr/src/man/man1/pack.1 index ba04397c52..9aa241f7cd 100644 --- a/usr/src/man/man1/pack.1 +++ b/usr/src/man/man1/pack.1 @@ -1,15 +1,15 @@ '\" te -.\" Copyright 1989 AT&T +.\" Copyright 1989 AT&T .\" Copyright (c) 1996, Sun Microsystems, Inc. All Rights Reserved .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 pack 1 "13 Mar 2008" "SunOS 5.11" "User Commands" +.TH PACK 1 "Mar 13, 2008" .SH NAME pack, pcat, unpack \- compress and expand files .SH SYNOPSIS @@ -176,12 +176,10 @@ the unpacked file cannot be created. The following options are supported by \fBpack\fR: .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 6n -.rt Forces packing of \fBfile\fR. This is useful for causing an entire directory to be packed even if some of the files do not benefit. Packed files can be restored to their original form using \fBunpack\fR or \fBpcat\fR. @@ -192,12 +190,10 @@ restored to their original form using \fBunpack\fR or \fBpcat\fR. The following options are supported by \fBpack\fR and \fBunpack\fR: .sp .ne 2 -.mk .na \fB\fB-/\fR\fR .ad .RS 6n -.rt When packing or unpacking, copies any ACL and extended system attributes associated with the source file to the target file. If an ACL or extended system attributes cannot be copied, the original file is retained, a diagnostic @@ -211,24 +207,20 @@ message is written to \fBstderr\fR, and the final exit status is The following operands are supported: .sp .ne 2 -.mk .na \fB\fBfile\fR\fR .ad .RS 8n -.rt A path name of a file to be packed, unpacked, or pcated; \fBfile\fR can include or omit the \fB\&.z\fR suffix. .RE .sp .ne 2 -.mk .na \fB\fB\(mi\fR\fR .ad .RS 8n -.rt \fBpack\fR uses Huffman (minimum redundancy) codes on a byte-by-byte basis. If the \fB\(mi\fR argument is used, an internal flag is set that causes the number of times each byte is used, its relative frequency, and the code for the byte @@ -284,23 +276,19 @@ that affect the execution of \fBpack\fR, \fBpcat\fR, and \fBunpack\fR: The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. The number of files the command failed to pack/unpack is returned. If the number of failures exceeds \fB255\fR, then \fB255\fR is returned. @@ -314,13 +302,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -lw(2.75i) |lw(2.75i) -lw(2.75i) |lw(2.75i) -. -\fBATTRIBUTE TYPE\fR\fBATTRIBUTE VALUE\fR +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled .TE .SH SEE ALSO diff --git a/usr/src/man/man1/pagesize.1 b/usr/src/man/man1/pagesize.1 index 5af07231b6..6b78a7c9cf 100644 --- a/usr/src/man/man1/pagesize.1 +++ b/usr/src/man/man1/pagesize.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 pagesize 1 "4 May 2001" "SunOS 5.11" "User Commands" +.TH PAGESIZE 1 "May 4, 2001" .SH NAME pagesize \- display the size or sizes of a page of memory .SH SYNOPSIS @@ -24,12 +24,10 @@ constructing portable shell scripts. The following option is supported: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 6n -.rt Prints out all possible hardware address translation sizes supported by the system. .RE diff --git a/usr/src/man/man1/pargs.1 b/usr/src/man/man1/pargs.1 index ca8aa2d8f5..3f8e2bae8c 100644 --- a/usr/src/man/man1/pargs.1 +++ b/usr/src/man/man1/pargs.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 pargs 1 "19 Jun 2006" "SunOS 5.11" "User Commands" +.TH PARGS 1 "Jun 19, 2006" .SH NAME pargs \- print process arguments, environment variables, or auxiliary vector @@ -38,23 +38,19 @@ a conversion is impossible, strings are displayed as 7-bit \fBASCII\fR. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 6n -.rt Prints process arguments as contained in \fBargv[]\fR (default). .RE .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad .RS 6n -.rt Treats strings in the target process as though they were encoded in 7-bit \fBASCII\fR, regardless of the locale of the target. The use of \fBiconv\fR(3C) is suppressed. @@ -62,35 +58,29 @@ is suppressed. .sp .ne 2 -.mk .na \fB\fB-e\fR\fR .ad .RS 6n -.rt Prints process environment variables and values as pointed at by the \fB_environ\fR symbol or by \fBpr_envp\fR in \fB/proc/\fIpid\fR/psinfo\fR. .RE .sp .ne 2 -.mk .na \fB\fB-F\fR\fR .ad .RS 6n -.rt Force. Grabs the target process even if another process has control. .RE .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 6n -.rt Displays the arguments as a single command line. The command line is printed in a manner suitable for interpretation by \fB/bin/sh\fR. If the arguments contain unprintable characters, or if the target process is in a different locale, a @@ -100,12 +90,10 @@ interpreted correctly by \fB/bin/sh\fR. .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad .RS 6n -.rt Prints process auxiliary vector. .RE @@ -115,23 +103,19 @@ Prints process auxiliary vector. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIpid\fR\fR .ad .RS 8n -.rt Process \fBID\fR list. .RE .sp .ne 2 -.mk .na \fB\fIcore\fR\fR .ad .RS 8n -.rt Process core file. .RE @@ -149,23 +133,19 @@ at the moment of application of the \fBproc\fR tool in question. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 12n -.rt Successful operation. .RE .sp .ne 2 -.mk .na \fBnon-zero\fR .ad .RS 12n -.rt An error has occurred (such as no such process, permission denied, or invalid option). .RE @@ -173,12 +153,10 @@ option). .SH FILES .sp .ne 2 -.mk .na \fB\fB/proc/pid/*\fR\fR .ad .RS 15n -.rt Process information and control files. .RE @@ -190,13 +168,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityEvolving +Interface Stability Evolving .TE .SH SEE ALSO diff --git a/usr/src/man/man1/passwd.1 b/usr/src/man/man1/passwd.1 index c58f6e592b..8b719e6539 100644 --- a/usr/src/man/man1/passwd.1 +++ b/usr/src/man/man1/passwd.1 @@ -1,10 +1,10 @@ '\" te -.\" Copyright 1989 AT&T +.\" Copyright 1989 AT&T .\" Copyright (c) 2009, 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 passwd 1 "25 Feb 2009" "SunOS 5.11" "User Commands" +.TH PASSWD 1 "Feb 25, 2009" .SH NAME passwd \- change login password and password attributes .SH SYNOPSIS @@ -30,7 +30,7 @@ passwd \- change login password and password attributes .LP .nf -\fBpasswd\fR [\fB-r\fR files] [\fB-d\fR | \fB-l\fR | \fB-u\fR | \fB-N\fR] [\fB-f\fR] [\fB-n\fR \fImin\fR] +\fBpasswd\fR [\fB-r\fR files] [\fB-d\fR | \fB-l\fR | \fB-u\fR | \fB-N\fR] [\fB-f\fR] [\fB-n\fR \fImin\fR] [\fB-w\fR \fIwarn\fR] [\fB-x\fR \fImax\fR] \fIname\fR .fi @@ -76,7 +76,7 @@ passwd \- change login password and password attributes .LP .nf -\fBpasswd\fR \fB-r\fR nisplus [\fB-l\fR | \fB-u\fR | \fB-N\fR] [\fB-f\fR] [\fB-n\fR \fImin\fR] [\fB-w\fR \fIwarn\fR] +\fBpasswd\fR \fB-r\fR nisplus [\fB-l\fR | \fB-u\fR | \fB-N\fR] [\fB-f\fR] [\fB-n\fR \fImin\fR] [\fB-w\fR \fIwarn\fR] [\fB-x\fR \fImax\fR] [\fB-D\fR \fIdomainname\fR] \fIname\fR .fi @@ -271,67 +271,55 @@ or, if password aging information is not present, where .sp .ne 2 -.mk .na \fB\fIname\fR\fR .ad .RS 12n -.rt The login \fBID\fR of the user. .RE .sp .ne 2 -.mk .na \fB\fIstatus\fR\fR .ad .RS 12n -.rt The password status of \fIname\fR. .sp The \fIstatus\fR field can take the following values: .sp .ne 2 -.mk .na \fBLK\fR .ad .RS 6n -.rt This account is \fBlocked\fR account. See Security. .RE .sp .ne 2 -.mk .na \fBNL\fR .ad .RS 6n -.rt This account is a \fBno login\fR account. See \fBSecurity\fR. .RE .sp .ne 2 -.mk .na \fBNP\fR .ad .RS 6n -.rt This account has no password and is therefore open without authentication. .RE .sp .ne 2 -.mk .na \fBPS\fR .ad .RS 6n -.rt This account has a password. .RE @@ -339,12 +327,10 @@ This account has a password. .sp .ne 2 -.mk .na \fB\fImm/dd/yy\fR\fR .ad .RS 12n -.rt The date password was last changed for \fIname\fR. All password aging dates are determined using Greenwich Mean Time (Universal Time) and therefore can differ by as much as a day in other time zones. @@ -352,36 +338,30 @@ by as much as a day in other time zones. .sp .ne 2 -.mk .na \fB\fImin\fR\fR .ad .RS 12n -.rt The minimum number of days required between password changes for \fIname\fR. \fBMINWEEKS\fR is found in \fB/etc/default/passwd\fR and is set to \fBNULL\fR. .RE .sp .ne 2 -.mk .na \fB\fImax\fR\fR .ad .RS 12n -.rt The maximum number of days the password is valid for \fIname\fR. \fBMAXWEEKS\fR is found in \fB/etc/default/passwd\fR and is set to \fBNULL\fR. .RE .sp .ne 2 -.mk .na \fB\fIwarn\fR\fR .ad .RS 12n -.rt The number of days relative to \fImax\fR before the password expires and the \fIname\fR are warned. .RE @@ -404,12 +384,10 @@ login, while continuing to allow delayed execution. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 17n -.rt Shows password attributes for all entries. Use only with the \fB-s\fR option. \fIname\fR must not be provided. For the \fBnisplus\fR repository, this shows only the entries in the NIS+ password table in the local domain that the @@ -419,12 +397,10 @@ this is restricted to the superuser. .sp .ne 2 -.mk .na \fB\fB-D\fR \fIdomainname\fR\fR .ad .RS 17n -.rt Consults the \fBpasswd.org_dir\fR table in \fBdomainname\fR. If this option is not specified, the default \fBdomainname\fR returned by \fBnis_local_directory\fR(3NSL) are used. This domain name is the same as that @@ -433,12 +409,10 @@ returned by \fBdomainname\fR(1M). .sp .ne 2 -.mk .na \fB\fB-e\fR\fR .ad .RS 17n -.rt Changes the login shell. The choice of shell is limited by the requirements of \fBgetusershell\fR(3C). If the user currently has a shell that is not allowed by \fBgetusershell\fR, only root can change it. @@ -446,12 +420,10 @@ allowed by \fBgetusershell\fR, only root can change it. .sp .ne 2 -.mk .na \fB\fB-g\fR\fR .ad .RS 17n -.rt Changes the gecos (finger) information. For the \fBfiles\fR repository, this only works for the superuser. Normal users can change the \fBldap\fR, \fBnis\fR, or \fBnisplus\fR repositories. @@ -459,35 +431,29 @@ only works for the superuser. Normal users can change the \fBldap\fR, .sp .ne 2 -.mk .na \fB\fB-h\fR\fR .ad .RS 17n -.rt Changes the home directory. .RE .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 17n -.rt Specifies the repository to which an operation is applied. The supported repositories are \fBfiles\fR, \fBldap\fR, \fBnis\fR, or \fBnisplus\fR. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR \fIname\fR\fR .ad .RS 17n -.rt Shows password attributes for the login \fIname\fR. For the \fBnisplus\fR repository, this works for everyone. However for the \fBfiles\fR and \fBldap\fR repositories, this only works for the superuser. It does not work at all for @@ -504,57 +470,47 @@ characters in length that might not always be the case. The following are the current status codes: .sp .ne 2 -.mk .na \fB\fBLK\fR\fR .ad .RS 6n -.rt Account is locked for UNIX authenitcation. \fBpasswd -l\fR was run or the authentication failed \fBRETRIES\fR times. .RE .sp .ne 2 -.mk .na \fB\fBNL\fR\fR .ad .RS 6n -.rt The account is a no login account. \fBpasswd -N\fR has been run. .RE .sp .ne 2 -.mk .na \fB\fBNP\fR\fR .ad .RS 6n -.rt Account has no password. \fBpasswd -d\fR was run. .RE .sp .ne 2 -.mk .na \fB\fBPS\fR\fR .ad .RS 6n -.rt The account probably has a valid password. .RE .sp .ne 2 -.mk .na \fB\fBUN\fR\fR .ad .RS 6n -.rt The data in the password field is unknown. It is not a recognizable hashed password or any of the above entries. See \fBcrypt\fR(3C) for valid password hashes. @@ -568,12 +524,10 @@ hashes. Only a privileged user can use the following options: .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad .RS 11n -.rt Deletes password for \fIname\fR and unlocks the account. The login \fIname\fR is not prompted for password. It is only applicable to the \fBfiles\fR and \fBldap\fR repositories. @@ -584,36 +538,30 @@ not able to login. \fBPASSREQ=YES\fR is the delivered default. .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 11n -.rt Forces the user to change password at the next login by expiring the password for \fIname\fR. .RE .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 11n -.rt Locks password entry for \fIname\fR. See the \fB-d\fR or \fB-u\fR option for unlocking the account. .RE .sp .ne 2 -.mk .na \fB\fB-N\fR\fR .ad .RS 11n -.rt Makes the password entry for name a value that cannot be used for login, but does not lock the account. See the \fB-d\fR option for removing the value, or to set a password to allow logins. @@ -621,12 +569,10 @@ to set a password to allow logins. .sp .ne 2 -.mk .na \fB\fB-n\fR \fImin\fR\fR .ad .RS 11n -.rt Sets minimum field for \fIname\fR. The \fImin\fR field contains the minimum number of days between password changes for \fIname\fR. If \fImin\fR is greater than \fImax\fR, the user can not change the password. Always use this option @@ -636,24 +582,20 @@ off). In that case, \fImin\fR need not be set. .sp .ne 2 -.mk .na \fB\fB-u\fR\fR .ad .RS 11n -.rt Unlocks a locked password for entry name. See the \fB-d\fR option for removing the locked password, or to set a password to allow logins. .RE .sp .ne 2 -.mk .na \fB\fB-w\fR \fIwarn\fR\fR .ad .RS 11n -.rt Sets warn field for \fIname\fR. The \fIwarn\fR field contains the number of days before the password expires and the user is warned. This option is not valid if password aging is disabled. @@ -661,12 +603,10 @@ valid if password aging is disabled. .sp .ne 2 -.mk .na \fB\fB-x\fR \fImax\fR\fR .ad .RS 11n -.rt Sets maximum field for \fIname\fR. The \fImax\fR field contains the number of days that the password is valid for \fIname\fR. The aging for \fIname\fR is turned off immediately if \fImax\fR is set to \fB\(mi1\fR\&. @@ -678,12 +618,10 @@ turned off immediately if \fImax\fR is set to \fB\(mi1\fR\&. The following operand is supported: .sp .ne 2 -.mk .na \fB\fIname\fR\fR .ad .RS 8n -.rt User login name. .RE @@ -700,12 +638,10 @@ none of the above variables is set in the environment, the \fBC\fR (U.S. style) locale determines how \fBpasswd\fR behaves. .sp .ne 2 -.mk .na \fB\fBLC_CTYPE\fR\fR .ad .RS 15n -.rt Determines how \fBpasswd\fR handles characters. When \fBLC_CTYPE\fR is set to a valid value, \fBpasswd\fR can display and handle text and filenames containing valid characters for that locale. \fBpasswd\fR can display and handle Extended @@ -717,12 +653,10 @@ valid. .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 \fBC\fR locale, the messages are presented in the @@ -735,144 +669,118 @@ default form found in the program itself (in most cases, U.S. English). The \fBpasswd\fR command exits with one of the following values: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Success. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 6n -.rt Permission denied. .RE .sp .ne 2 -.mk .na \fB\fB2\fR\fR .ad .RS 6n -.rt Invalid combination of options. .RE .sp .ne 2 -.mk .na \fB\fB3\fR\fR .ad .RS 6n -.rt Unexpected failure. Password file unchanged. .RE .sp .ne 2 -.mk .na \fB\fB4\fR\fR .ad .RS 6n -.rt Unexpected failure. Password file(s) missing. .RE .sp .ne 2 -.mk .na \fB\fB5\fR\fR .ad .RS 6n -.rt Password file(s) busy. Try again later. .RE .sp .ne 2 -.mk .na \fB\fB6\fR\fR .ad .RS 6n -.rt Invalid argument to option. .RE .sp .ne 2 -.mk .na \fB\fB7\fR\fR .ad .RS 6n -.rt Aging option is disabled. .RE .sp .ne 2 -.mk .na \fB\fB8\fR\fR .ad .RS 6n -.rt No memory. .RE .sp .ne 2 -.mk .na \fB\fB9\fR\fR .ad .RS 6n -.rt System error. .RE .sp .ne 2 -.mk .na \fB\fB10\fR\fR .ad .RS 6n -.rt Account expired. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB/etc/default/passwd\fR\fR .ad .RS 23n -.rt Default values can be set for the following flags in \fB/etc/default/passwd\fR. For example: \fBMAXWEEKS=26\fR .sp .ne 2 -.mk .na \fB\fBDICTIONDBDIR\fR\fR .ad .RS 16n -.rt The directory where the generated dictionary databases reside. Defaults to \fB/var/passwd\fR. .sp @@ -882,12 +790,10 @@ does not perform a dictionary check. .sp .ne 2 -.mk .na \fB\fBDICTIONLIST\fR\fR .ad .RS 16n -.rt DICTIONLIST can contain list of comma separated dictionary files such as \fBDICTIONLIST=\fR\fIfile1\fR, \fIfile2\fR, \fIfile3\fR. Each dictionary file contains multiple lines and each line consists of a word and a NEWLINE @@ -903,12 +809,10 @@ To pre-build the dictionary database, see \fBmkpwdict\fR(1M). .sp .ne 2 -.mk .na \fB\fBHISTORY\fR\fR .ad .RS 16n -.rt Maximum number of prior password history to keep for a user. Setting the \fBHISTORY\fR value to zero (\fB0\fR), or removing the flag, causes the prior password history of all users to be discarded at the next password change by @@ -920,59 +824,49 @@ accounts defined in the \fBfiles\fR name service (local .sp .ne 2 -.mk .na \fB\fBMAXREPEATS\fR\fR .ad .RS 16n -.rt Maximum number of allowable consecutive repeating characters. If \fBMAXREPEATS\fR is not set or is zero (\fB0\fR), the default is no checks .RE .sp .ne 2 -.mk .na \fB\fBMAXWEEKS\fR\fR .ad .RS 16n -.rt Maximum time period that password is valid. .RE .sp .ne 2 -.mk .na \fB\fBMINALPHA\fR\fR .ad .RS 16n -.rt Minimum number of alpha character required. If \fBMINALPHA\fR is not set, the default is \fB2\fR. .RE .sp .ne 2 -.mk .na \fB\fBMINDIFF\fR\fR .ad .RS 16n -.rt Minimum differences required between an old and a new password. If \fBMINDIFF\fR is not set, the default is \fB3\fR. .RE .sp .ne 2 -.mk .na \fB\fBMINDIGIT\fR\fR .ad .RS 16n -.rt Minimum number of digits required. If \fBMINDIGIT\fR is not set or is set to zero (\fB0\fR), the default is no checks. You cannot be specify \fBMINDIGIT\fR if \fBMINNONALPHA\fR is also specified. @@ -980,24 +874,20 @@ if \fBMINNONALPHA\fR is also specified. .sp .ne 2 -.mk .na \fB\fBMINLOWER\fR\fR .ad .RS 16n -.rt Minimum number of lower case letters required. If not set or zero (0), the default is no checks. .RE .sp .ne 2 -.mk .na \fB\fBMINNONALPHA\fR\fR .ad .RS 16n -.rt Minimum number of non-alpha (including numeric and special) required. If \fBMINNONALPHA\fR is not set, the default is \fB1\fR. You cannot specify \fBMINNONALPHA\fR if \fBMINDIGIT\fR or \fBMINSPECIAL\fR is also specified. @@ -1005,23 +895,19 @@ Minimum number of non-alpha (including numeric and special) required. If .sp .ne 2 -.mk .na \fB\fBMINWEEKS\fR\fR .ad .RS 16n -.rt Minimum time period before the password can be changed. .RE .sp .ne 2 -.mk .na \fB\fBMINSPECIAL\fR\fR .ad .RS 16n -.rt Minimum number of special (non-alpha and non-digit) characters required. If \fBMINSPECIAL\fR is not set or is zero (\fB0\fR), the default is no checks. You cannot specify \fBMINSPECIAL\fR if you also specify \fBMINNONALPHA\fR. @@ -1029,58 +915,48 @@ cannot specify \fBMINSPECIAL\fR if you also specify \fBMINNONALPHA\fR. .sp .ne 2 -.mk .na \fB\fBMINUPPER\fR\fR .ad .RS 16n -.rt Minimum number of upper case letters required. If \fBMINUPPER\fR is not set or is zero (\fB0\fR), the default is no checks. .RE .sp .ne 2 -.mk .na \fB\fBNAMECHECK\fR\fR .ad .RS 16n -.rt Enable/disable checking or the login name. The default is to do login name checking. A case insensitive value of \fBno\fR disables this feature. .RE .sp .ne 2 -.mk .na \fB\fBPASSLENGTH\fR\fR .ad .RS 16n -.rt Minimum length of password, in characters. .RE .sp .ne 2 -.mk .na \fB\fBWARNWEEKS\fR\fR .ad .RS 16n -.rt Time period until warning of date of password's ensuing expiration. .RE .sp .ne 2 -.mk .na \fB\fBWHITESPACE\fR\fR .ad .RS 16n -.rt Determine if white space characters are allowed in passwords. Valid values are \fBYES\fR and \fBNO\fR. If \fBWHITESPACE\fR is not set or is set to \fBYES\fR, white space characters are allowed. @@ -1090,46 +966,38 @@ white space characters are allowed. .sp .ne 2 -.mk .na \fB\fB/etc/oshadow\fR\fR .ad .RS 23n -.rt Temporary file used by \fBpasswd\fR, \fBpassmgmt\fR and \fBpwconv\fR to update the real shadow file. .RE .sp .ne 2 -.mk .na \fB\fB/etc/passwd\fR\fR .ad .RS 23n -.rt Password file. .RE .sp .ne 2 -.mk .na \fB\fB/etc/shadow\fR\fR .ad .RS 23n -.rt Shadow password file. .RE .sp .ne 2 -.mk .na \fB\fB/etc/shells\fR\fR .ad .RS 23n -.rt Shell database. .RE @@ -1141,15 +1009,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilitySee below. +Interface Stability See below. .TE .sp diff --git a/usr/src/man/man1/paste.1 b/usr/src/man/man1/paste.1 index 29b3097b26..b8d66c9d8f 100644 --- a/usr/src/man/man1/paste.1 +++ b/usr/src/man/man1/paste.1 @@ -1,13 +1,13 @@ '\" te .\" Copyright 1989 AT&T Copyright (c) 1992, X/Open Company Limited All Rights Reserved Portions Copyright (c) 1996, Sun Microsystems, Inc. All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 paste 1 "20 Dec 1996" "SunOS 5.11" "User Commands" +.TH PASTE 1 "Dec 20, 1996" .SH NAME paste \- merge corresponding or subsequent lines of files .SH SYNOPSIS @@ -38,12 +38,10 @@ is specified. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-d\fR \fIlist\fR \fR .ad .RS 12n -.rt Unless a backslash character (\|\e\|) appears in \fIlist\fR, each character in \fIlist\fR is an element specifying a delimiter character. If a backslash character appears in \fIlist\fR, the backslash character and one or more @@ -86,45 +84,37 @@ If a backslash character appears in \fIlist\fR, it and the character following it will be used to represent the following delimiter characters: .sp .ne 2 -.mk .na \fB\fB\en\fR \fR .ad .RS 9n -.rt Newline character. .RE .sp .ne 2 -.mk .na \fB\fB\et\fR \fR .ad .RS 9n -.rt Tab character. .RE .sp .ne 2 -.mk .na \fB\fB\e\e\fR \fR .ad .RS 9n -.rt Backslash character. .RE .sp .ne 2 -.mk .na \fB\fB\e0\fR \fR .ad .RS 9n -.rt Empty string (not a null character). If \fB\e0\fR is immediately followed by the character \fBx\fR, the character \fBX\fR, or any character defined by the \fBLC_CTYPE\fR \fBdigit\fR keyword, the results are unspecified. @@ -135,12 +125,10 @@ If any other characters follow the backslash, the results are unspecified. .sp .ne 2 -.mk .na \fB\fB-s\fR \fR .ad .RS 12n -.rt Concatenate all of the lines of each separate input file in command line order. The \fBNEWLINE\fR character of every line except the last line in each input file will be replaced with the \fBTAB\fR character, unless otherwise specified @@ -153,12 +141,10 @@ by the \fB-d\fR option. The following operand is supported: .sp .ne 2 -.mk .na \fB\fIfile\fR \fR .ad .RS 9n -.rt A path name of an input file. If \fB\(mi\fR is specified for one or more of the \fIfile\fRs, the standard input will be used. The standard input will be read one line at a time, circularly, for each instance of \fB\(mi\fR\&. @@ -213,23 +199,19 @@ that affect the execution of \fBpaste\fR: \fBLANG\fR, \fBLC_ALL\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR \fR .ad .RS 7n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR \fR .ad .RS 7n -.rt An error occurred. .RE @@ -241,15 +223,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO @@ -260,45 +241,37 @@ Interface StabilityStandard .SH DIAGNOSTICS .sp .ne 2 -.mk .na \fB\fB"line too long"\fR\fR .ad .RS 22n -.rt Output lines are restricted to 511 characters. .RE .sp .ne 2 -.mk .na \fB\fB"too many files"\fR\fR .ad .RS 22n -.rt Except for \fB-s\fR option, no more than 12 input files may be specified. .RE .sp .ne 2 -.mk .na \fB\fB"no delimiters"\fR\fR .ad .RS 22n -.rt The \fB-d\fR option was specified with an empty list. .RE .sp .ne 2 -.mk .na \fB\fB"cannot open \fR\fBfile\fR\fB"\fR\fR .ad .RS 22n -.rt The specified file cannot be opened. .RE diff --git a/usr/src/man/man1/pathchk.1 b/usr/src/man/man1/pathchk.1 index f989d658a1..1cf769e767 100644 --- a/usr/src/man/man1/pathchk.1 +++ b/usr/src/man/man1/pathchk.1 @@ -1,13 +1,13 @@ '\" te .\" Copyright (c) 1992, X/Open Company Limited All Rights Reserved Portions Copyright (c) 1996, Sun Microsystems, Inc. All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 pathchk 1 "1 Feb 1995" "SunOS 5.11" "User Commands" +.TH PATHCHK 1 "Feb 1, 1995" .SH NAME pathchk \- check path names .SH SYNOPSIS @@ -70,12 +70,10 @@ specified above. The following option is supported: .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 6n -.rt Instead of performing checks based on the underlying file system, write a diagnostic for each \fIpath\fR operand that: .RS +4 @@ -105,12 +103,10 @@ character set. The following operand is supported: .sp .ne 2 -.mk .na \fB\fIpath\fR\fR .ad .RS 8n -.rt A path to be checked. .RE @@ -224,48 +220,40 @@ Note the usage of: .sp .ne 2 -.mk .na \fBa.\fR .ad .RS 6n -.rt The \fBpathchk\fR command has already verified, at this point, that \fB$path.out\fR will not be truncated. .RE .sp .ne 2 -.mk .na \fBb.\fR .ad .RS 6n -.rt With the \fBnoclobber\fR option set, the shell will verify that \fB$path.out\fR does not already exist before invoking \fBrm\fR. .RE .sp .ne 2 -.mk .na \fBc.\fR .ad .RS 6n -.rt If the shell succeeded in creating \fB$path.out\fR, \fBrm\fR will remove it so that the application can create the file again in the \fBPROCESSING\fR step. .RE .sp .ne 2 -.mk .na \fBd.\fR .ad .RS 6n -.rt If the \fBPROCESSING\fR step wants the file to exist already when it is invoked, the: .sp @@ -302,23 +290,19 @@ that affect the execution of \fBpathchk\fR: \fBLANG\fR, \fBLC_ALL\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt All \fIpath\fR operands passed all of the checks. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -330,13 +314,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man1/pax.1 b/usr/src/man/man1/pax.1 index 3156dedab3..3f5d75b940 100644 --- a/usr/src/man/man1/pax.1 +++ b/usr/src/man/man1/pax.1 @@ -1,39 +1,39 @@ '\" te .\" Copyright (c) 1992, X/Open Company Limited All Rights Reserved .\" Portions Copyright (c) 2008, Sun Microsystems, Inc. All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 pax 1 "16 Jul 2008" "SunOS 5.11" "User Commands" +.TH PAX 1 "Jul 16, 2008" .SH NAME pax \- portable archive interchange .SH SYNOPSIS .LP .nf -\fBpax\fR [\fB-cdnv\fR] [\fB-H\fR | \fB-L\fR] [\fB-f\fR \fIarchive\fR] [\fB-o\fR \fIoptions\fR]... +\fBpax\fR [\fB-cdnv\fR] [\fB-H\fR | \fB-L\fR] [\fB-f\fR \fIarchive\fR] [\fB-o\fR \fIoptions\fR]... [\fB-s\fR \fIreplstr\fR]... [\fIpattern\fR]... .fi .LP .nf -\fBpax\fR \fB-r\fR [\fB-cdiknuv@/\fR] [\fB-H\fR | \fB-L\fR] [\fB-f\fR \fIarchive\fR] [\fB-o\fR \fIoptions\fR]... +\fBpax\fR \fB-r\fR [\fB-cdiknuv@/\fR] [\fB-H\fR | \fB-L\fR] [\fB-f\fR \fIarchive\fR] [\fB-o\fR \fIoptions\fR]... [\fB-p\fR \fIstring\fR]... [\fB-s\fR \fIreplstr\fR]... [\fIpattern\fR]... .fi .LP .nf -\fBpax\fR \fB-w\fR [\fB-dituvX@/\fR] [\fB-H\fR | \fB-L\fR] [\fB-b\fR \fIblocksize\fR] [\fB-a\fR] - [\fB-f\fR \fIarchive\fR] [\fB-o\fR \fIoptions\fR]... [\fB-s\fR \fIreplstr\fR]... +\fBpax\fR \fB-w\fR [\fB-dituvX@/\fR] [\fB-H\fR | \fB-L\fR] [\fB-b\fR \fIblocksize\fR] [\fB-a\fR] + [\fB-f\fR \fIarchive\fR] [\fB-o\fR \fIoptions\fR]... [\fB-s\fR \fIreplstr\fR]... [\fB-x\fR \fIformat\fR] [\fIfile\fR]... .fi .LP .nf -\fBpax\fR \fB-r\fR \fB-w\fR [\fB-diklntuvX@/\fR] [\fB-H\fR | \fB-L\fR] [\fB-o\fR \fIoptions\fR]... +\fBpax\fR \fB-r\fR \fB-w\fR [\fB-diklntuvX@/\fR] [\fB-H\fR | \fB-L\fR] [\fB-o\fR \fIoptions\fR]... [\fB-p\fR \fIstring\fR]... [\fB-s\fR \fIreplstr\fR]... [\fIfile\fR]... \fIdirectory\fR .fi @@ -52,12 +52,10 @@ four modes of operation: \fBlist\fR, \fBread\fR, \fBwrite\fR, and \fBcopy\fR modes, corresponding respectively to the four forms shown in the SYNOPSIS. .sp .ne 2 -.mk .na \fB\fBlist\fR\fR .ad .RS 9n -.rt In \fBlist\fR mode, that is, when neither \fB-r\fR nor \fB-w\fR are specified, \fBpax\fR writes the names of the members of the archive file read from the standard input, with path names matching the specified patterns, to standard @@ -68,12 +66,10 @@ that file is listed as well. .sp .ne 2 -.mk .na \fB\fBread\fR\fR .ad .RS 9n -.rt In \fBread\fR mode, that is, when \fB-r\fR is specified, but \fB-w\fR is not, \fBpax\fR extracts the members of the archive file read from the standard input, with path names matching the specified patterns. If an extracted file is @@ -91,12 +87,10 @@ files are discussed under the \fB-p\fR option. .sp .ne 2 -.mk .na \fB\fBwrite\fR\fR .ad .RS 9n -.rt In \fBwrite\fR mode, that is, when \fB-w\fR is specified, but \fB-r\fR is not, \fBpax\fR writes the contents of the \fIfile\fR operands to the standard output in an archive format. If no \fIfile\fR operands are specified, a list of files @@ -106,12 +100,10 @@ directory includes all of the files in the file hierarchy rooted at the file. .sp .ne 2 -.mk .na \fB\fBcopy\fR\fR .ad .RS 9n -.rt In \fBcopy\fR mode, that is, when both \fB-r\fR and \fB-w\fR are specified, \fBpax\fR copies the \fIfile\fR operands to the destination directory. .sp @@ -181,24 +173,20 @@ diagnostic message to standard error and terminates. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 16n -.rt Appends files to the end of the archive. This option does not work for some archive devices, such as 1/4-inch streaming tapes and 8mm tapes. .RE .sp .ne 2 -.mk .na \fB\fB-b\fR \fIblocksize\fR\fR .ad .RS 16n -.rt Blocks the output at a positive decimal integer number of bytes per write to the archive file. Devices and archive formats can impose restrictions on blocking. Blocking is automatically determined on input. Portable applications @@ -209,24 +197,20 @@ option below. .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad .RS 16n -.rt Matches all file or archive members except those specified by the \fIpattern\fR or \fIfile\fR operands. .RE .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad .RS 16n -.rt Causes files of type directory being copied or archived or archive members of type directory being extracted or listed to match only the file or archive member itself and not the file hierarchy rooted at the file. @@ -234,12 +218,10 @@ member itself and not the file hierarchy rooted at the file. .sp .ne 2 -.mk .na \fB\fB-f\fR \fIarchive\fR\fR .ad .RS 16n -.rt Specifies the path name of the input or output archive, overriding the default standard input (in \fBlist\fR or \fBread\fR modes) or standard output (\fBwrite\fR mode). @@ -247,12 +229,10 @@ standard input (in \fBlist\fR or \fBread\fR modes) or standard output .sp .ne 2 -.mk .na \fB\fB-H\fR\fR .ad .RS 16n -.rt If a symbolic link referencing a file of type directory is specified on the command line, \fBpax\fR archives the file hierarchy rooted in the file referenced by the link, using the name of the link as the root of the file @@ -264,12 +244,10 @@ link. The default behavior is to archive the symbolic link itself. .sp .ne 2 -.mk .na \fB\fB-i\fR\fR .ad .RS 16n -.rt Interactively renames files or archive members. For each archive member matching a \fIpattern\fR operand or file matching a \fIfile\fR operand, a prompt is written to the file \fB/dev/tty\fR. The prompt contains the name of @@ -287,23 +265,19 @@ extraction are unspecified. .sp .ne 2 -.mk .na \fB\fB-k\fR\fR .ad .RS 16n -.rt Prevents the overwriting of existing files. .RE .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 16n -.rt Links files. In \fBcopy\fR mode, hard links are made between the source and destination file hierarchies whenever possible. If specified in conjunction with \fB-H\fR or \fB-L\fR, when a symbolic link is encountered, the hard link @@ -316,12 +290,10 @@ the destination. .sp .ne 2 -.mk .na \fB\fB-L\fR\fR .ad .RS 16n -.rt If a symbolic link referencing a file of type directory is specified on the command line or encountered during the traversal of a file hierarchy, \fBpax\fR archives the file hierarchy rooted in the file referenced by the link, using @@ -335,12 +307,10 @@ symbolic link itself. .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 16n -.rt Selects the first archive member that matches each \fIpattern\fR operand. No more than one archive member is matched for each pattern, although members of type directory still match the file hierarchy rooted at that file. @@ -348,12 +318,10 @@ type directory still match the file hierarchy rooted at that file. .sp .ne 2 -.mk .na \fB\fB-o\fR \fIoptions\fR\fR .ad .RS 16n -.rt Provides information to the implementation to modify the algorithm for extracting or writing files. The value of options consists of one or more comma-separated keywords of the form: @@ -387,7 +355,6 @@ following keyword values of \fIoptions\fR are supported for the file formats as indicated: .sp .ne 2 -.mk .na \fB\fBdelete=\fR\fIpattern\fR\fR .ad @@ -416,7 +383,6 @@ omitted from extended header records that \fBpax\fR produces. .sp .ne 2 -.mk .na \fB\fBexthdr.name=\fR\fIstring\fR\fR .ad @@ -428,47 +394,39 @@ blocks for the extended header. The name is the contents of \fIstring\fR, after the following character substitutions have been made: .sp .ne 2 -.mk .na \fB\fB%d\fR\fR .ad .RS 6n -.rt The directory name of the file, equivalent to the result of the \fIdirname\fR utility on the translated path name. .RE .sp .ne 2 -.mk .na \fB\fB%f\fR\fR .ad .RS 6n -.rt The filename of the file, equivalent to the result of the \fIbasename\fR utility on the translated path name. .RE .sp .ne 2 -.mk .na \fB\fB%p\fR\fR .ad .RS 6n -.rt The process ID of the \fBpax\fR process. .RE .sp .ne 2 -.mk .na \fB\fB%%\fR\fR .ad .RS 6n -.rt A '%' character. .RE @@ -488,7 +446,6 @@ following default value: .sp .ne 2 -.mk .na \fB\fBglobexthdr.name=\fR\fIstring\fR\fR .ad @@ -503,35 +460,29 @@ global extended header records. The name is the contents of \fIstring\fR, after the following character substitutions have been made: .sp .ne 2 -.mk .na \fB\fB%n\fR\fR .ad .RS 6n -.rt An integer that represents the sequence number of the global extended header record in the archive, starting at \fB1\fR. .RE .sp .ne 2 -.mk .na \fB\fB%p\fR\fR .ad .RS 6n -.rt The process ID of the \fBpax\fR process. .RE .sp .ne 2 -.mk .na \fB\fB%%\fR\fR .ad .RS 6n -.rt A '%' character. .RE @@ -553,7 +504,6 @@ variable. If \fBTMPDIR\fR is not set, \fBpax\fR uses \fB/tmp\fR. .sp .ne 2 -.mk .na \fB\fBinvalid=\fR\fIaction\fR\fR .ad @@ -593,12 +543,10 @@ The following mutually-exclusive values of the \fIaction\fR argument are supported: .sp .ne 2 -.mk .na \fB\fBbypass\fR\fR .ad .RS 10n -.rt In \fBread\fR or \fBcopy\fR mode, \fBpax\fR bypasses the file, causing no change to the destination hierarchy. In \fBlist\fR mode, \fBpax\fR writes all requested valid values for the file, but its method for writing invalid values @@ -607,12 +555,10 @@ is unspecified. .sp .ne 2 -.mk .na \fB\fBrename\fR\fR .ad .RS 10n -.rt In \fBread\fR or \fBcopy\fR mode, \fBpax\fR acts as if the \fB-i\fR option were in effect for each file with invalid filename or link name values, allowing the user to provide a replacement name interactively. In \fBlist\fR mode, \fBpax\fR @@ -621,12 +567,10 @@ behaves identically to the \fBbypass\fR action. .sp .ne 2 -.mk .na \fB\fBUTF-8\fR\fR .ad .RS 10n -.rt \fBpax\fR uses the actual \fBUTF-8\fR encoding for the name when it is used in \fBread\fR, \fBcopy\fR, or \fBlist\fR mode and a filename, link name, owner name, or any other field in an extended header record cannot be translated from @@ -636,12 +580,10 @@ the implementation. .sp .ne 2 -.mk .na \fB\fBwrite\fR\fR .ad .RS 10n -.rt In \fBread\fR or \fBcopy\fR mode, \fBpax\fR writes the file, translating the name, regardless of whether this can overwrite an existing file with a valid name. In \fBlist\fR mode, \fBpax\fR behaves identically to the \fBbypass\fR @@ -657,7 +599,6 @@ suppressed if the \fB-k\fR option is also specified. .sp .ne 2 -.mk .na \fB\fBlinkdata\fR\fR .ad @@ -671,7 +612,6 @@ written to the archive. .sp .ne 2 -.mk .na \fB\fBlistopt=\fR\fIformat\fR\fR .ad @@ -690,7 +630,6 @@ order. .sp .ne 2 -.mk .na \fB\fBtimes\fR\fR .ad @@ -706,12 +645,10 @@ any of the keywords and values, including implementation extensions, can be used in \fB-o\fR option-arguments, in either of two modes: .sp .ne 2 -.mk .na \fB\fBkeyword=\fR\fIvalue\fR\fR .ad .RS 18n -.rt When used in \fBwrite\fR or \fBcopy\fR mode, these keyword/value pairs are included at the beginning of the archive as \fBtypeflag g\fR global extended header records. When used in \fBread\fR or \fBlist\fR mode, these keyword/value @@ -721,12 +658,10 @@ g\fR global extended header records. .sp .ne 2 -.mk .na \fB\fBkeyword:=\fR\fIvalue\fR\fR .ad .RS 18n -.rt When used in \fBwrite\fR or \fBcopy\fR mode, these keyword/value pairs are included as records at the beginning of a \fBtypeflag x\fR extended header for each file. This is equivalent to the equal-sign form except that it creates no @@ -752,12 +687,10 @@ the group name is forced to a new value for all files read from the archive. .sp .ne 2 -.mk .na \fB\fB-p\fR \fIstring\fR\fR .ad .RS 16n -.rt Specifies one or more file characteristic options (privileges). The \fIstring\fR option-argument must be a string specifying file characteristics to be retained or discarded on extraction. The string consists of the @@ -767,57 +700,47 @@ multiple \fB-p\fR options can be specified. The meaning of the specification characters is as follows: .sp .ne 2 -.mk .na \fB\fBa\fR\fR .ad .RS 5n -.rt Does not preserve file access times. .RE .sp .ne 2 -.mk .na \fB\fBe\fR\fR .ad .RS 5n -.rt Preserves the user \fBID\fR, group \fBID\fR, file mode bits, access time, and modification time. .RE .sp .ne 2 -.mk .na \fB\fBm\fR\fR .ad .RS 5n -.rt Does not preserve file modification times. .RE .sp .ne 2 -.mk .na \fB\fBo\fR\fR .ad .RS 5n -.rt Preserves the user \fBID\fR and group \fBID\fR. .RE .sp .ne 2 -.mk .na \fB\fBp\fR\fR .ad .RS 5n -.rt Preserves the file mode bits. .RE @@ -846,23 +769,19 @@ preserved. .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 16n -.rt Reads an archive file from standard input. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR \fIreplstr\fR\fR .ad .RS 16n -.rt Modifies file or archive member names named by \fIpattern\fR or \fIfile\fR operands according to the substitution expression \fIreplstr\fR, which is based on the \fBed\fR(1) \fBs\fR (substitution) utility, using the regular expression @@ -893,12 +812,10 @@ ignored when reading and writing archives. .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad .RS 16n -.rt When reading files from the file system, and if the user has the permissions required by \fButime()\fR to do so, sets the access time of each file read to the access time that it had before being read by \fBpax\fR. @@ -906,34 +823,28 @@ the access time that it had before being read by \fBpax\fR. .sp .ne 2 -.mk .na \fB\fB-u\fR\fR .ad .RS 16n -.rt Ignores files that are older (having a less recent file modification time) than a pre-existing file or archive member with the same name. .sp .ne 2 -.mk .na \fB\fBread\fR mode\fR .ad .RS 14n -.rt An archive member with the same name as a file in the file system is extracted if the archive member is newer than the file. .RE .sp .ne 2 -.mk .na \fB\fBwrite\fR mode\fR .ad .RS 14n -.rt An archive file member with the same name as a file in the file system is superseded if the file is newer than the archive member. If option \fB-a\fR is also specified, this is accomplished by appending to the archive. Otherwise, it @@ -943,12 +854,10 @@ archive or by appending to the archive. .sp .ne 2 -.mk .na \fB\fBcopy\fR mode\fR .ad .RS 14n -.rt The file in the destination hierarchy is replaced by the file in the source hierarchy or by a link to the file in the source hierarchy if the file in the source hierarchy is newer. @@ -958,12 +867,10 @@ source hierarchy is newer. .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 16n -.rt In \fBlist\fR mode, produces a verbose table of contents (see \fBStandard Output\fR). Otherwise, writes archive member path names and extended attributes to standard error (see \fBStandard Error\fR). @@ -971,33 +878,27 @@ to standard error (see \fBStandard Error\fR). .sp .ne 2 -.mk .na \fB\fB-w\fR\fR .ad .RS 16n -.rt Writes files to the standard output in the specified archive format. .RE .sp .ne 2 -.mk .na \fB\fB-x\fR \fIformat\fR\fR .ad .RS 16n -.rt Specifies the output archive format. The \fBpax\fR utility recognizes the following formats: .sp .ne 2 -.mk .na \fB\fBcpio\fR\fR .ad .RS 10n -.rt The extended \fBcpio\fR(1) interchange format. See IEEE Std 1003.1-2001. The default \fIblocksize\fR for this format for character special archive files is \fB5120\fR. Implementations support all \fIblocksize\fR values less than or @@ -1011,12 +912,10 @@ greater than this value are archived with the \fBUID\fR and \fBGID\fR of .sp .ne 2 -.mk .na \fB\fBpax\fR\fR .ad .RS 10n -.rt The \fBpax\fR interchange format. See IEEE Std 1003.1-2001. The default \fIblocksize\fR for this format for character special archive files is \fB5120\fR. Implementations support all \fIblocksize\fR values less than or @@ -1031,12 +930,10 @@ greater than \fB100\fR characters. .sp .ne 2 -.mk .na \fB\fBustar\fR\fR .ad .RS 10n -.rt The extended \fBtar\fR(1) interchange format. See the IEEE 1003.1(1990) specifications. The default \fIblocksize\fR for this format for character special archive files is \fB10240\fR. Implementations support all @@ -1051,12 +948,10 @@ greater than this value are archived with the \fBUID\fR and \fBGID\fR of .sp .ne 2 -.mk .na \fB\fBxustar\fR\fR .ad .RS 10n -.rt Similar to \fBustar\fR. Also allows archiving and extracting files whose size is greater than 8GB; whose \fBUID\fR, \fBGID\fR, \fIdevmajor\fR, or \fIdevminor\fR values are greater than \fB2097151\fR; whose path (including @@ -1075,12 +970,10 @@ In \fBcopy\fR mode, if no \fB-x\fR format is specified, \fBpax\fR behaves as if .sp .ne 2 -.mk .na \fB\fB-X\fR\fR .ad .RS 16n -.rt When traversing the file hierarchy specified by a path name, \fBpax\fR does not descend into directories that have a different device ID (\fBst_dev\fR, see \fBstat\fR(2)). @@ -1088,12 +981,10 @@ descend into directories that have a different device ID (\fBst_dev\fR, see .sp .ne 2 -.mk .na \fB\fB-@\fR\fR .ad .RS 16n -.rt Includes extended attributes in the archive. \fBpax\fR does not place extended attributes in the archive by default. .sp @@ -1109,12 +1000,10 @@ Attempts to explicitly extract attribute records are ignored. .sp .ne 2 -.mk .na \fB\fB-/\fR\fR .ad .RS 16n -.rt Includes extended system attributes in the archive. \fBpax\fR does not place extended system attributes in the archive by default. .sp @@ -1310,34 +1199,28 @@ Otherwise, the \fB%L\fR conversion specification is the equivalent of \fB%F\fR. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIdirectory\fR\fR .ad .RS 13n -.rt The destination directory path name for \fBcopy\fR mode. .RE .sp .ne 2 -.mk .na \fB\fIfile\fR\fR .ad .RS 13n -.rt A path name of a file to be copied or archived. .RE .sp .ne 2 -.mk .na \fB\fIpattern\fR\fR .ad .RS 13n -.rt A pattern matching one or more path names of archive members. A pattern must conform to the pattern matching notation found on the \fBfnmatch\fR(5) manual page. The default, if no \fIpattern\fR is specified, is to select all members @@ -1503,12 +1386,10 @@ high-performance files. Although it can seem complex, there are really two modes that are most commonly used: .sp .ne 2 -.mk .na \fB\fB-p\fR \fBe\fR\fR .ad .RS 8n -.rt Preserve everything. This would be used by the historical superuser, someone with all the appropriate privileges, to preserve all aspects of the files as they are recorded in the archive. The \fBe\fR flag is the sum of \fBo\fR and @@ -1517,12 +1398,10 @@ they are recorded in the archive. The \fBe\fR flag is the sum of \fBo\fR and .sp .ne 2 -.mk .na \fB\fB-p\fR \fBp\fR\fR .ad .RS 8n -.rt Preserve the file mode bits. This would be used by the user with regular privileges who wished to preserve aspects of the file other than the ownership. The file times are preserved by default, but two other flags are offered to @@ -1701,12 +1580,10 @@ that affect the execution of \fBpax\fR: \fBLANG\fR, \fBLC_ALL\fR, \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, \fBLC_TIME\fR, and \fBNLSPATH\fR. .sp .ne 2 -.mk .na \fB\fBLC_COLLATE\fR\fR .ad .RS 14n -.rt Determine the locale for the behaviour of ranges, equivalence classes, and multi-character collating elements used in the pattern matching expressions for the \fIpattern\fR operand, the basic regular expression for the \fB-s\fR @@ -1716,12 +1593,10 @@ locale keyword in the \fBLC_MESSAGES\fR category. .sp .ne 2 -.mk .na \fB\fBTMPDIR\fR\fR .ad .RS 14n -.rt Determine the path name that provides part of the default global extended header record file, as described for the \fB-o\fR \fBglobexthdr=\fR keyword as described in the OPTIONS section. @@ -1729,12 +1604,10 @@ described in the OPTIONS section. .sp .ne 2 -.mk .na \fB\fBTZ\fR\fR .ad .RS 14n -.rt Determine the timezone used to calculate date and time strings when the \fB-v\fR option is specified. If \fBTZ\fR is unset or null, an unspecified default timezone is used. @@ -1746,23 +1619,19 @@ default timezone is used. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt All files were processed successfully. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -1810,21 +1679,19 @@ has no need for extended attributes. .sp .TS -tab(); -cw(2.67i) cw(2.83i) -lw(2.67i) lw(2.83i) -. -DescriptionBlock -Global Extended Headerustar Header [\fItypeflag\fR=g] -Global Extended Header Data -File 1: Extended Header is includedustar Header [\fItypeflag\fR=x] -Extended Header Data -[\fItypeflag\fR=0] -ustar Header Data for File 1 -File 2: No Extended Header is includedustar Header [\fItypeflag\fR=0] -Data for File2 -End of Archive IndicatorBlock of binary zeros -Block of binary zeros +c c +l l . +Description Block +Global Extended Header ustar Header [\fItypeflag\fR=g] + Global Extended Header Data +File 1: Extended Header is included ustar Header [\fItypeflag\fR=x] + Extended Header Data + [\fItypeflag\fR=0] + ustar Header Data for File 1 +File 2: No Extended Header is included ustar Header [\fItypeflag\fR=0] + Data for File2 +End of Archive Indicator Block of binary zeros + Block of binary zeros .TE .SS "\fBpax\fR Header Block" @@ -1835,12 +1702,10 @@ described in \fBustar Interchange Format\fR except that two additional \fItypeflag\fR values are defined: .sp .ne 2 -.mk .na \fB\fBg\fR\fR .ad .RS 5n -.rt Represents global extended header records for the following files in the archive. The format of these extended header records are as described in \fBpax Extended Header\fR. Each value affects all subsequent files that do not @@ -1853,12 +1718,10 @@ archive. .sp .ne 2 -.mk .na \fB\fBx\fR\fR .ad .RS 5n -.rt Represents extended header records for the following file in the archive (which has its own \fBustar\fR header block). The format of these extended header records is as described in \fBpax Extended Header\fR. @@ -1930,12 +1793,10 @@ mode, \fBpax\fR behaves as if an archive had been created with applicable extended header records and then extracted. .sp .ne 2 -.mk .na \fB\fBatime\fR\fR .ad .RS 16n -.rt The file access time for the specified files, equivalent to the value of the \fBst_atime\fR member of the stat structure for a file, as described by the \fBstat\fR(2) function. The access time (\fBatime\fR) is restored if the @@ -1945,12 +1806,10 @@ process has the appropriate privilege required to do so. The format of the .sp .ne 2 -.mk .na \fB\fBcharset\fR\fR .ad .RS 16n -.rt The name of the character set used to encode the data in the specified files. The entries in the following table are defined to refer to known standards; additional names can be agreed on between the originator and recipient. @@ -1958,28 +1817,26 @@ additional names can be agreed on between the originator and recipient. .sp .TS -tab(); -lw(2.75i) lw(2.75i) -lw(2.75i) lw(2.75i) -. -\fIvalue\fRFormal Standard -ISO-IR 646 1990ISO/IEC646:1990 -ISO-IR 8859 1 1998ISO/IEC8859-1:1998 -ISO-IR 8859 2 1999ISO/IEC 8859-2:1999 -ISO-IR 8859 3 1999ISO/IEC 8859-3:1999 -ISO-IR 8859 4 1999ISO/IEC8859-4:1998 -ISO-IR 8859 5 1999ISO/IEC8859-5-1999 -ISO-IR 8859 6 1999ISO/IEC8859-6-1999 -ISO-IR 8859 7 1987ISO/IEC8859-7:1987 -ISO-IR 8859 8 1999ISO/IEC8859-8:1999 -ISO-IR 8859 9 1999ISO/IEC8859-9:1999 -ISO-IR 8859 10 1998ISO/IEC8859-10:1999 -ISO-IR 8859 13 1998ISO/IEC8859-13:1998 -ISO-IR 8859 14 1998ISO/IEC8859-14:1998 -ISO-IR 8859 15 1999ISO/IEC8859-15:1999 -ISO-IR 10646 2000ISO/IEC 10646:2000 -ISO-IR 10646 2000 UTF-8ISO/IEC 10646,UTF-8 encoding -BINARYNone +l l +l l . +\fIvalue\fR Formal Standard +ISO-IR 646 1990 ISO/IEC646:1990 +ISO-IR 8859 1 1998 ISO/IEC8859-1:1998 +ISO-IR 8859 2 1999 ISO/IEC 8859-2:1999 +ISO-IR 8859 3 1999 ISO/IEC 8859-3:1999 +ISO-IR 8859 4 1999 ISO/IEC8859-4:1998 +ISO-IR 8859 5 1999 ISO/IEC8859-5-1999 +ISO-IR 8859 6 1999 ISO/IEC8859-6-1999 +ISO-IR 8859 7 1987 ISO/IEC8859-7:1987 +ISO-IR 8859 8 1999 ISO/IEC8859-8:1999 +ISO-IR 8859 9 1999 ISO/IEC8859-9:1999 +ISO-IR 8859 10 1998 ISO/IEC8859-10:1999 +ISO-IR 8859 13 1998 ISO/IEC8859-13:1998 +ISO-IR 8859 14 1998 ISO/IEC8859-14:1998 +ISO-IR 8859 15 1999 ISO/IEC8859-15:1999 +ISO-IR 10646 2000 ISO/IEC 10646:2000 +ISO-IR 10646 2000 UTF-8 ISO/IEC 10646,UTF-8 encoding +BINARY None .TE The encoding is included in an extended header for information only; when @@ -1992,24 +1849,20 @@ header record for a file. .sp .ne 2 -.mk .na \fB\fBcomment\fR\fR .ad .RS 16n -.rt A series of characters used as a comment. All characters in the \fIvalue\fR field are ignored by \fBpax\fR. .RE .sp .ne 2 -.mk .na \fB\fBgid\fR\fR .ad .RS 16n -.rt The group ID of the group that owns the file, expressed as a decimal number using digits from the \fIISO/IEC 646: 1991 standard\fR. This record overrides the \fBgid\fR field in the specified header blocks. When used in write or copy @@ -2019,12 +1872,10 @@ group ID is greater than 2097151 (octal \fB7777777\fR). .sp .ne 2 -.mk .na \fB\fIgname\fR\fR .ad .RS 16n -.rt The group of the files, formatted as a group name in the group database. This record overrides the \fBgid\fR and \fIgname\fR fields in the specified header blocks, and any \fBgid\fR extended header record. When used in read, copy, or @@ -2039,12 +1890,10 @@ represented entirely with the letters and digits of the portable character set. .sp .ne 2 -.mk .na \fB\fBlinkpath\fR\fR .ad .RS 16n -.rt The pathname of a link being created to another file, of any type, previously archived. This record overrides the \fIlinkname\fR field in the specified \fBustar\fR header blocks. The specified \fBustar\fR header block determines @@ -2060,12 +1909,10 @@ portable character set other than \fBNULL\fR. .sp .ne 2 -.mk .na \fB\fImtime\fR\fR .ad .RS 16n -.rt The pathname of a link being created to another file, of any type, previously archived. This record overrides the \fIlinkname\fR field in the specified \fBustar\fR header blocks. The specified \fBustar\fR header block determines @@ -2081,12 +1928,10 @@ members of the portable character set other than \fBNULL\fR. .sp .ne 2 -.mk .na \fB\fBpath\fR\fR .ad .RS 16n -.rt The pathname of the specified files. This record overrides the name and \fIprefix\fR fields in the specified header blocks. \fBpax\fR translates the pathname of the file from the UTF-8 encoding to the character set appropriate @@ -2098,36 +1943,30 @@ represented entirely with the members of the portable character set other than .sp .ne 2 -.mk .na \fB\fBrealtime.\fR\fIany\fR\fR .ad .RS 16n -.rt The keywords prefixed by \fBrealtime\fR are reserved for future standardization. .RE .sp .ne 2 -.mk .na \fB\fBsecurity.\fR\fIany\fR\fR .ad .RS 16n -.rt The keywords prefixed by \fBsecurity\fR are reserved for future standardization. .RE .sp .ne 2 -.mk .na \fB\fIsize\fR\fR .ad .RS 16n -.rt The size of the file in octets, expressed as a decimal number using digits from the \fIISO/IEC 646: 1991 standard\fR. This record overrides the \fIsize\fR field in the specified header blocks. When used in write or copy mode, @@ -2137,12 +1976,10 @@ field in the specified header blocks. When used in write or copy mode, .sp .ne 2 -.mk .na \fB\fIuid\fR\fR .ad .RS 16n -.rt The user \fBID\fR of the file owner, expressed as a decimal number using digits from the I\fISO/IEC 646:1991\fR standard. This record overrides the \fBuid\fR field in the following header block(s). When used in write or copy mode, @@ -2152,12 +1989,10 @@ ID is greater than \fB2097151 (octal 7777777)\fR. .sp .ne 2 -.mk .na \fB\fIuname\fR\fR .ad .RS 16n -.rt The owner of the specified files, formatted as a user name in the user database. This record overrides the \fIuid\fR and \fIuname\fR fields in the specified header blocks, and any \fIuid\fR extended header record. When used in @@ -2280,27 +2115,25 @@ lengths and offsets are in decimal. \fBTable 1 \fR\fBustar\fR Header Block .sp .TS -tab(); -cw(1.83i) cw(1.83i) cw(1.83i) -lw(1.83i) lw(1.83i) lw(1.83i) -. -Field NameOctet OffsetLength (in Octets) -\fIname\fR\fB0\fR100 -\fImode\fR1008 -\fIuid\fR1088 -\fIgid\fR1168 -\fIsize\fR12412 -\fImtime\fR13612 -\fIchksum\fR1488 -\fItypeflag\fR1561 -\fIlinkname\fR157100 -\fImagic\fR2576 -\fIversion\fR2632 -\fIuname\fR26532 -\fIgname\fR29732 -\fIdevmajor\fR3298 -\fIdevminor\fR3378 -\fIprefix\fR345155 +c c c +l l l . +Field Name Octet Offset Length (in Octets) +\fIname\fR \fB0\fR 100 +\fImode\fR 100 8 +\fIuid\fR 108 8 +\fIgid\fR 116 8 +\fIsize\fR 124 12 +\fImtime\fR 136 12 +\fIchksum\fR 148 8 +\fItypeflag\fR 156 1 +\fIlinkname\fR 157 100 +\fImagic\fR 257 6 +\fIversion\fR 263 2 +\fIuname\fR 265 32 +\fIgname\fR 297 32 +\fIdevmajor\fR 329 8 +\fIdevminor\fR 337 8 +\fIprefix\fR 345 155 .TE .sp @@ -2376,27 +2209,25 @@ representation. The encoded bits represent the following values in the .sp .TS -tab(); -lw(.57i) lw(1.64i) lw(3.29i) -lw(.57i) lw(1.64i) lw(3.29i) -. -Bit ValueIEE Std 1003.1-2001 BitDescription -04000S_ISUIDSet UID on execution -02000S_ISGIDSet GID on exectution -01000\fIreserved\fRReserved for future standardization -00400S_IRUSRRead permission for file owner class -00200S_IWUSRWrite permission for file owner class -00100S_IXUSRT{ +l l l +l l l . +Bit Value IEE Std 1003.1-2001 Bit Description +04000 S_ISUID Set UID on execution +02000 S_ISGID Set GID on exectution +01000 \fIreserved\fR Reserved for future standardization +00400 S_IRUSR Read permission for file owner class +00200 S_IWUSR Write permission for file owner class +00100 S_IXUSR T{ Execute/search permission for file owner class T} -00040S_IRGRPRead permission for file group class -00020S_IWGRPWrite permission for file group class -00010S_IXGRPT{ +00040 S_IRGRP Read permission for file group class +00020 S_IWGRP Write permission for file group class +00010 S_IXGRP T{ Execute/search permission for file group class T} -00004S_IROTHRead permission for file other class -00002S_IWOTHWrite permission for file other class -00001S_IXOTHT{ +00004 S_IROTH Read permission for file other class +00002 S_IWOTH Write permission for file other class +00001 S_IXOTH T{ Execute/search permission for file other class T} .TE @@ -2453,12 +2284,10 @@ that the conversion took place. All of the \fItypeflag\fR fields are coded in the \fIISO/IEC 646: 1991\fR standard IRV: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 17n -.rt Represents a regular file. For backward compatibility, a \fItypeflag\fR value of binary zero ('\e0') should be recognized as meaning a regular file when extracting files from the archive. Archives written with this version of the @@ -2468,12 +2297,10 @@ archive file format create regular files with a \fItypeflag\fR value of the .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 17n -.rt Represents a file linked to another file, of any type, previously archived. Such files are identified by each file having the same device and file serial number. The linked-to name is specified in the \fIlinkname\fR field with a @@ -2482,24 +2309,20 @@ number. The linked-to name is specified in the \fIlinkname\fR field with a .sp .ne 2 -.mk .na \fB\fB2\fR\fR .ad .RS 17n -.rt Represents a symbolic link. The contents of the symbolic link are stored in the \fIlinkname\fR field. .RE .sp .ne 2 -.mk .na \fB\fB3,4\fR\fR .ad .RS 17n -.rt Represents character special files and block special files respectively. In this case the \fIdevmajor\fR and \fIdevminor\fR fields contain information defining the device, the format of which is unspecified by volume \fIIEEE Std @@ -2509,12 +2332,10 @@ local specification or can ignore the entry. .sp .ne 2 -.mk .na \fB\fB5\fR\fR .ad .RS 17n -.rt Specifies a directory or subdirectory. On systems where disk allocation is performed on a directory basis, the \fIsize\fR field contain the maximum number of octets (which can be rounded to the nearest disk block allocation unit) that @@ -2525,24 +2346,20 @@ Systems that do not support limiting in this manner should ignore the .sp .ne 2 -.mk .na \fB\fB6\fR\fR .ad .RS 17n -.rt Specifies a FIFO special file. The archiving of a FIFO file archives the existence of this file and not its contents. .RE .sp .ne 2 -.mk .na \fB\fB7\fR\fR .ad .RS 17n -.rt Reserved to represent a file to which an implementation has associated some high- performance attribute. Implementations without such extensions should treat this file as a regular file (type 0). @@ -2550,12 +2367,10 @@ treat this file as a regular file (type 0). .sp .ne 2 -.mk .na \fB\fBA-Z\fR\fR .ad .RS 17n -.rt The letters \fBA\fR through \fBZ\fR inclusive are reserved for custom implementations. All other values are reserved for future versions of \fIIEEE Std 1003.1-200x\fR. @@ -2563,12 +2378,10 @@ Std 1003.1-200x\fR. .sp .ne 2 -.mk .na \fB\fBSUN.devmajor\fR\fR .ad .RS 17n -.rt A Solaris extension to \fBpax\fR extended header keywords. Specifies the major device number of the file. .sp @@ -2580,12 +2393,10 @@ fit in 8 octets. .sp .ne 2 -.mk .na \fB\fBSUN.devminor\fR\fR .ad .RS 17n -.rt A Solaris extension to \fBpax\fR extended header keywords. Specifies the minor device number of the file. .sp @@ -2597,12 +2408,10 @@ fit in 8 octets. .sp .ne 2 -.mk .na \fB\fBSUN.holesdata\fR\fR .ad .RS 17n -.rt A Solaris extension to \fBpax\fR extended header keywords. Specifies the data and hole pairs for a sparse file. .sp @@ -2644,12 +2453,10 @@ bytes 24576 to 32768 is restored as data, and so forth. .sp .ne 2 -.mk .na \fB\fBX\fR\fR .ad .RS 17n -.rt A Solaris custom \fBtypeflag\fR implementation which specifies an \fBxustar\fR format (see \fB-x format\fR) extended header. The \fBtypeflag 'x'\fR extended header is treated as a \fBustar typeflag 'x'\fR extended header. @@ -2657,12 +2464,10 @@ header is treated as a \fBustar typeflag 'x'\fR extended header. .sp .ne 2 -.mk .na \fB\fBE\fR\fR .ad .RS 17n -.rt A Solaris custom \fBtypeflag\fR implementation which specifies an extended attributes header. See \fBfsattr\fR(5). .RE @@ -2704,46 +2509,40 @@ additional details. .sp .TS -tab(); -lw(1.83i) lw(1.83i) lw(1.83i) -lw(1.83i) lw(1.83i) lw(1.83i) -. -Header Field NameLength (in Octets)Interpreted as -\fIc_magic\fR6Octal number -\fIc_dev\fR6Octal number -\fIc_ino\fR6Octal number -\fIc_mode\fR6Octal number -\fIc_uid\fR6Octal number -\fIc_gid\fR6Octal number -\fIc_nlink\fR6Octal number -\fIc_rdev\fR6Octal number -\fIc_mtime\fR11Octal number -\fIc_namesize\fR6Octal number -\fIc_filesize\fR11Octal number +l l l +l l l . +Header Field Name Length (in Octets) Interpreted as +\fIc_magic\fR 6 Octal number +\fIc_dev\fR 6 Octal number +\fIc_ino\fR 6 Octal number +\fIc_mode\fR 6 Octal number +\fIc_uid\fR 6 Octal number +\fIc_gid\fR 6 Octal number +\fIc_nlink\fR 6 Octal number +\fIc_rdev\fR 6 Octal number +\fIc_mtime\fR 11 Octal number +\fIc_namesize\fR 6 Octal number +\fIc_filesize\fR 11 Octal number .TE .sp .sp .TS -tab(); -lw(1.83i) lw(1.83i) lw(1.83i) -lw(1.83i) lw(1.83i) lw(1.83i) -. -Filename Field NameLengthInterpreted as -\fIc_name\fR\fIc_namesize\fRPathname string +l l l +l l l . +Filename Field Name Length Interpreted as +\fIc_name\fR \fIc_namesize\fR Pathname string .TE .sp .sp .TS -tab(); -lw(1.83i) lw(1.83i) lw(1.83i) -lw(1.83i) lw(1.83i) lw(1.83i) -. -Filename Field NameLengthInterpreted as -\fIc_filedata\fR\fIc_filesize\fRData +l l l +l l l . +Filename Field Name Length Interpreted as +\fIc_filedata\fR \fIc_filesize\fR Data .TE .SS "\fBcpio\fR Header" @@ -2758,24 +2557,20 @@ is written to the most-significant digit of the stream of octets first. The fields are interpreted as follows: .sp .ne 2 -.mk .na \fB\fIc_magic\fR\fR .ad .RS 15n -.rt Identifies the archive as being a transportable archive by containing the identifying value \fB"070707"\fR. .RE .sp .ne 2 -.mk .na \fB\fIc_dev,c_ino\fR\fR .ad .RS 15n -.rt Contains values that uniquely identify the file within the archive (that is, no files contain the same pair of \fIc_dev\fR and \fIc_ino\fR values unless they are links to the same file). The values are determined in an unspecified @@ -2784,12 +2579,10 @@ manner. .sp .ne 2 -.mk .na \fB\fIc_mode\fR\fR .ad .RS 15n -.rt Contains the file type and access permissions as defined in the following table. .sp @@ -2802,76 +2595,66 @@ intended to be transported to other systems. .sp .TS -tab(); -lw(1.83i) lw(1.83i) lw(1.83i) -lw(1.83i) lw(1.83i) lw(1.83i) -. -File Permissions NameValueIndicates -\fBC_IRUSR\fR\fB000400\fRby owner -\fBC_IWUSR\fR\fB000200\fRby owner -\fBC_IXUSR\fR\fB000100\fRby owner -\fBC_IRGRP\fR\fB000040\fRby group -\fBCW_IWFGP\fR\fB000020\fRby group -\fBCW_IXGRP\fR\fB000010\fRby group -\fBCW_IROTH\fR\fB000004\fRby others -\fBCW_IWOTH\fR\fB000002\fRby others -\fBCW_IXOTH\fR\fB000001\fRby others -\fBCW_ISUID\fR\fB004000\fRSet \fBuid\fR -\fBW_ISGID\fR\fB002000\fRSet \fBgid\fR -\fBW_ISVTX\fR\fB001000\fRReserved +l l l +l l l . +File Permissions Name Value Indicates +\fBC_IRUSR\fR \fB000400\fR by owner +\fBC_IWUSR\fR \fB000200\fR by owner +\fBC_IXUSR\fR \fB000100\fR by owner +\fBC_IRGRP\fR \fB000040\fR by group +\fBCW_IWFGP\fR \fB000020\fR by group +\fBCW_IXGRP\fR \fB000010\fR by group +\fBCW_IROTH\fR \fB000004\fR by others +\fBCW_IWOTH\fR \fB000002\fR by others +\fBCW_IXOTH\fR \fB000001\fR by others +\fBCW_ISUID\fR \fB004000\fR Set \fBuid\fR +\fBW_ISGID\fR \fB002000\fR Set \fBgid\fR +\fBW_ISVTX\fR \fB001000\fR Reserved .TE .sp .sp .TS -tab(); -lw(1.83i) lw(1.83i) lw(1.83i) -lw(1.83i) lw(1.83i) lw(1.83i) -. -File Type NameValueIndicates -\fBC_ISDIR\fR\fB040000\fRDirectory -\fBC_ISFIFO\fR\fB010000\fRFIFO -\fBC_ISREG\fR\fB0100000\fRRegular file -\fBC_ISLNK\fR\fB0120000\fRSymbolic link -\fBC_ISBLK\fR\fB060000\fRBlock special file -\fBC_ISCHR\fR\fB020000\fRCharacter special file -\fBC_ISSOCK\fR\fB0140000\fRSocket -\fBC_ISCTG\fR\fB0110000\fRReserved +l l l +l l l . +File Type Name Value Indicates +\fBC_ISDIR\fR \fB040000\fR Directory +\fBC_ISFIFO\fR \fB010000\fR FIFO +\fBC_ISREG\fR \fB0100000\fR Regular file +\fBC_ISLNK\fR \fB0120000\fR Symbolic link +\fBC_ISBLK\fR \fB060000\fR Block special file +\fBC_ISCHR\fR \fB020000\fR Character special file +\fBC_ISSOCK\fR \fB0140000\fR Socket +\fBC_ISCTG\fR \fB0110000\fR Reserved .TE .RE .sp .ne 2 -.mk .na \fB\fIc_uid\fR\fR .ad .RS 15n -.rt Contains the user ID of the owner. .RE .sp .ne 2 -.mk .na \fB\fIc_gid\fR\fR .ad .RS 15n -.rt Contains the group ID of the group .RE .sp .ne 2 -.mk .na \fB\fIc_nlink\fR\fR .ad .RS 15n -.rt Contains a number greater than or equal to the number of links in the archive referencing the file. If the \fB-a\fR option is used to append to a \fBcpio\fR archive, \fBpax\fR does need not to account for the files in the existing part @@ -2883,47 +2666,39 @@ existing part of the archive if additional files with the same \fIc_dev\fR and .sp .ne 2 -.mk .na \fB\fIc_rdev\fR\fR .ad .RS 15n -.rt Contains implementation-defined information for character or block special files. .RE .sp .ne 2 -.mk .na \fB\fIc_mtime\fR\fR .ad .RS 15n -.rt Contains the latest time of modification of the file at the time the archive was created. .RE .sp .ne 2 -.mk .na \fB\fIc_namesize\fR\fR .ad .RS 15n -.rt Contains the length of the pathname, including the terminating NULL character. .RE .sp .ne 2 -.mk .na \fB\fIc_filesize\fR\fR .ad .RS 15n -.rt Contains the length of the file in octets. This is the length of the data section following the header structure. .RE @@ -2999,15 +2774,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .SH SEE ALSO diff --git a/usr/src/man/man1/pfexec.1 b/usr/src/man/man1/pfexec.1 index d518027f37..07b89eefa2 100644 --- a/usr/src/man/man1/pfexec.1 +++ b/usr/src/man/man1/pfexec.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 pfexec 1 "3 Mar 2003" "SunOS 5.11" "User Commands" +.TH PFEXEC 1 "Mar 3, 2003" .SH NAME pfexec, pfsh, pfcsh, pfksh \- execute a command in a profile .SH SYNOPSIS @@ -84,23 +84,19 @@ current user, not necessarily all privileges. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR \fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB1\fR \fR .ad .RS 6n -.rt An error occurred. .RE diff --git a/usr/src/man/man1/pg.1 b/usr/src/man/man1/pg.1 index 45ef440b12..a6703f2b90 100644 --- a/usr/src/man/man1/pg.1 +++ b/usr/src/man/man1/pg.1 @@ -1,19 +1,19 @@ '\" te .\" Copyright 1989 AT&T Copyright (c) 1996, Sun Microsystems, Inc. All Rights Reserved Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 pg 1 "25 Feb 1996" "SunOS 5.11" "User Commands" +.TH PG 1 "Feb 25, 1996" .SH NAME pg \- files perusal filter for CRTs .SH SYNOPSIS .LP .nf -\fBpg\fR [\fB-\fInumber\fR\fR] [\fB-p\fR \fIstring\fR] [\fB-cefnrs\fR] [+ \fIlinenumber\fR] +\fBpg\fR [\fB-\fInumber\fR\fR] [\fB-p\fR \fIstring\fR] [\fB-cefnrs\fR] [+ \fIlinenumber\fR] [+/ \fIpattern\fR /] [\fIfilename\fR]... .fi @@ -36,12 +36,10 @@ base for the terminal type specified by the environment variable \fBTERM\fR. If .SH OPTIONS .sp .ne 2 -.mk .na \fB\fB-\fR\fInumber\fR\fR .ad .RS 15n -.rt An integer specifying the size (in lines) of the window that \fBpg\fR is to use instead of the default. (On a terminal containing 24 lines, the default window size is 23). @@ -49,12 +47,10 @@ size is 23). .sp .ne 2 -.mk .na \fB\fB-p\fR\fIstring\fR\fR .ad .RS 15n -.rt \fBpg\fR uses \fIstring\fR as the prompt. If the prompt string contains a \fB%d\fR, the first occurrence of \fB%d\fR in the prompt will be replaced by the current page number when the prompt is issued. The default prompt string is @@ -63,12 +59,10 @@ the current page number when the prompt is issued. The default prompt string is .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad .RS 15n -.rt Home the cursor and clear the screen before displaying each page. This option is ignored if \fBclear_screen\fR is not defined for this terminal type in the \fBterminfo\fR(4) data base. @@ -76,23 +70,19 @@ is ignored if \fBclear_screen\fR is not defined for this terminal type in the .sp .ne 2 -.mk .na \fB\fB-e\fR\fR .ad .RS 15n -.rt \fBpg\fR does \fInot\fR pause at the end of each file. .RE .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 15n -.rt Normally, \fBpg\fR splits lines longer than the screen width, but some sequences of characters in the text being displayed (for instance, escape sequences for underlining) generate undesirable results. The \fB-f\fR option @@ -101,12 +91,10 @@ inhibits \fBpg\fR from splitting lines. .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 15n -.rt Normally, commands must be terminated by a <\fInewline\fR> character. This option causes an automatic end of command as soon as a command letter is entered. @@ -114,47 +102,39 @@ entered. .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 15n -.rt Restricted mode. The shell escape is disallowed. \fBpg\fR prints an error message but does not exit. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 15n -.rt \fBpg\fR prints all messages and prompts in the standard output mode (usually inverse video). .RE .sp .ne 2 -.mk .na \fB\fB+\fR\fIlinenumber\fR\fR .ad .RS 15n -.rt Start up at \fIlinenumber\fR. .RE .sp .ne 2 -.mk .na \fB\fB+/\fR\fIpattern\fR\fB/\fR\fR .ad .RS 15n -.rt Start up at the first line containing the regular expression pattern. .RE @@ -164,12 +144,10 @@ Start up at the first line containing the regular expression pattern. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIfilename\fR\fR .ad .RS 12n -.rt A path name of a text file to be displayed. If no \fIfilename\fR is given, or if it is \(mi, the standard input is read. .RE @@ -195,23 +173,19 @@ is used if none is provided. The perusal commands and their defaults are as follows: .sp .ne 2 -.mk .na \fB(+1)<\fInewline\fR> or <\fIblank\fR>\fR .ad .RS 28n -.rt This causes one page to be displayed. The address is specified in pages. .RE .sp .ne 2 -.mk .na \fB(+1) \fBl\fR\fR .ad .RS 28n -.rt With a relative address this causes \fBpg\fR to simulate scrolling the screen, forward or backward, the number of lines specified. With an absolute address this command prints a screenful beginning at the specified line. @@ -219,34 +193,28 @@ this command prints a screenful beginning at the specified line. .sp .ne 2 -.mk .na \fB(+1) \fBd\fR or \fB^D\fR\fR .ad .RS 28n -.rt Simulates scrolling half a screen forward or backward. .RE .sp .ne 2 -.mk .na \fB\fIi\fR\fBf\fR\fR .ad .RS 28n -.rt Skip \fIi\fR screens of text. .RE .sp .ne 2 -.mk .na \fB\fIi\fR\fBz\fR\fR .ad .RS 28n -.rt Same as <\fInewline\fR> except that \fIi\fR, if present, becomes the new default number of lines per screenful. .RE @@ -256,23 +224,19 @@ default number of lines per screenful. The following perusal commands take no \fIaddress\fR. .sp .ne 2 -.mk .na \fB\fB\&.\fR or \fB^L\fR\fR .ad .RS 13n -.rt Typing a single period causes the current page of text to be redisplayed. .RE .sp .ne 2 -.mk .na \fB\fB$\fR\fR .ad .RS 13n -.rt Displays the last full window in the file. Use with caution when the input is a pipe. .RE @@ -285,12 +249,10 @@ They must always be terminated by a <\fInewline\fR>, even if the \fB-n\fR option is specified. .sp .ne 2 -.mk .na \fB\fIi\fR\fB/\fR\fIpattern\fR\fB/\fR\fR .ad .RS 14n -.rt Search forward for the \fIi\fRth (default \fIi\fR=1) occurrence of \fIpattern\fR. Searching begins immediately after the current page and continues to the end of the current file, without wrap-around. @@ -298,23 +260,19 @@ continues to the end of the current file, without wrap-around. .sp .ne 2 -.mk .na \fB\fIi\fR\fB^\fR\fIpattern\fR\fB^\fR\fR .ad .RS 14n -.rt .RE .sp .ne 2 -.mk .na \fB\fIi\fR\fB?\fR\fIpattern\fR\fB?\fR\fR .ad .RS 14n -.rt Search backwards for the \fIi\fRth (default \fIi\fR=1) occurrence of \fIpattern\fR. Searching begins immediately before the current page and continues to the beginning of the current file, without wrap-around. The ^ @@ -333,48 +291,40 @@ The user of \fBpg\fR can modify the environment of perusal with the following commands: .sp .ne 2 -.mk .na \fB\fIi\fR\fBn\fR\fR .ad .RS 14n -.rt Begin perusing the \fIi\fRth next file in the command line. The \fIi\fR is an unsigned number, default value is 1. .RE .sp .ne 2 -.mk .na \fB\fIi\fR\fBp\fR\fR .ad .RS 14n -.rt Begin perusing the \fIi\fRth previous file in the command line. \fIi\fR is an unsigned number, default is 1. .RE .sp .ne 2 -.mk .na \fB\fIi\fR\fBw\fR\fR .ad .RS 14n -.rt Display another window of text. If \fIi\fR is present, set the window size to \fIi\fR. .RE .sp .ne 2 -.mk .na \fB\fBs\fR \fIfilename\fR\fR .ad .RS 14n -.rt Save the input in the named file. Only the current file being perused is saved. The white space between the \fBs\fR and \fIfilename\fR is optional. This command must always be terminated by a <\fInewline\fR>, even if the \fB-n\fR @@ -383,34 +333,28 @@ option is specified. .sp .ne 2 -.mk .na \fB\fBh\fR\fR .ad .RS 14n -.rt Help by displaying an abbreviated summary of available commands. .RE .sp .ne 2 -.mk .na \fB\fBq\fR or \fBQ\fR\fR .ad .RS 14n -.rt Quit \fBpg\fR. .RE .sp .ne 2 -.mk .na \fB\fB!\fR\fBcommand\fR\fR .ad .RS 14n -.rt \fICommand\fR is passed to the shell, whose name is taken from the \fBSHELL\fR environment variable. If this is not available, the default shell is used. This command must always be terminated by a <\fInewline\fR>, even if the \fB-n\fR @@ -457,12 +401,10 @@ that affect the execution of \fBpg\fR: \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and The following environment variables affect the execution of \fBpg\fR: .sp .ne 2 -.mk .na \fB\fBCOLUMNS\fR\fR .ad .RS 11n -.rt Determine the horizontal screen size. If unset or \fINULL,\fR use the value of \fBTERM\fR, the window size, baud rate, or some combination of these, to indicate the terminal type for the screen size calculation. @@ -470,12 +412,10 @@ indicate the terminal type for the screen size calculation. .sp .ne 2 -.mk .na \fB\fBLINES\fR\fR .ad .RS 11n -.rt Determine the number of lines to be displayed on the screen. If unset or \fINULL,\fR use the value of \fBTERM\fR, the window size, baud rate, or some combination of these, to indicate the terminal type for the screen size @@ -484,23 +424,19 @@ calculation. .sp .ne 2 -.mk .na \fB\fBSHELL\fR\fR .ad .RS 11n -.rt Determine the name of the command interpreter executed for a !command. .RE .sp .ne 2 -.mk .na \fB\fBTERM\fR\fR .ad .RS 11n -.rt Determine terminal attributes. Optionally attempt to search a system-dependent database, keyed on the value of the \fBTERM\fR environment variable. If no information is available, a terminal incapable of cursor-addressable movement @@ -513,30 +449,25 @@ is assumed. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB/tmp/pg*\fR\fR .ad @@ -547,7 +478,6 @@ temporary file when input is from a pipe .sp .ne 2 -.mk .na \fB\fB/usr/share/lib/terminfo/?/*\fR\fR .ad diff --git a/usr/src/man/man1/pgrep.1 b/usr/src/man/man1/pgrep.1 index bb88ab0bdb..f4ae7ffce1 100644 --- a/usr/src/man/man1/pgrep.1 +++ b/usr/src/man/man1/pgrep.1 @@ -3,25 +3,25 @@ .\" 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 pgrep 1 "6 May 2004" "SunOS 5.11" "User Commands" +.TH PGREP 1 "May 6, 2004" .SH NAME pgrep, pkill \- find or signal processes by name and other attributes .SH SYNOPSIS .LP .nf -\fBpgrep\fR [\fB-flvx\fR] [\fB-n\fR | \fB-o\fR] [\fB-d\fR \fIdelim\fR] [\fB-P\fR \fIppidlist\fR] - [\fB-g\fR \fIpgrplist\fR] [\fB-s\fR \fIsidlist\fR] [\fB-u\fR \fIeuidlist\fR] [\fB-U\fR \fIuidlist\fR] - [\fB-G\fR \fIgidlist\fR] [\fB-J\fR \fIprojidlist\fR] [\fB-t\fR \fItermlist\fR] - [\fB-T\fR \fItaskidlist\fR] [\fB-c\fR \fIctidlist\fR] [\fB-z\fR \fIzoneidlist\fR] +\fBpgrep\fR [\fB-flvx\fR] [\fB-n\fR | \fB-o\fR] [\fB-d\fR \fIdelim\fR] [\fB-P\fR \fIppidlist\fR] + [\fB-g\fR \fIpgrplist\fR] [\fB-s\fR \fIsidlist\fR] [\fB-u\fR \fIeuidlist\fR] [\fB-U\fR \fIuidlist\fR] + [\fB-G\fR \fIgidlist\fR] [\fB-J\fR \fIprojidlist\fR] [\fB-t\fR \fItermlist\fR] + [\fB-T\fR \fItaskidlist\fR] [\fB-c\fR \fIctidlist\fR] [\fB-z\fR \fIzoneidlist\fR] [\fIpattern\fR] .fi .LP .nf -\fBpkill\fR [\fB-\fIsignal\fR\fR] [\fB-fvx\fR] [\fB-n\fR | \fB-o\fR] [\fB-P\fR \fIppidlist\fR] - [\fB-g\fR \fIpgrplist\fR] [\fB-s\fR \fIsidlist\fR] [\fB-u\fR \fIeuidlist\fR] [\fB-U\fR \fIuidlist\fR] - [\fB-G\fR \fIgidlist\fR] [\fB-J\fR \fIprojidlist\fR] [\fB-t\fR \fItermlist\fR] - [\fB-T\fR \fItaskidlist\fR] [\fB-c\fR \fIctidlist\fR] [\fB-z\fR \fIzoneidlist\fR] +\fBpkill\fR [\fB-\fIsignal\fR\fR] [\fB-fvx\fR] [\fB-n\fR | \fB-o\fR] [\fB-P\fR \fIppidlist\fR] + [\fB-g\fR \fIpgrplist\fR] [\fB-s\fR \fIsidlist\fR] [\fB-u\fR \fIeuidlist\fR] [\fB-U\fR \fIuidlist\fR] + [\fB-G\fR \fIgidlist\fR] [\fB-J\fR \fIprojidlist\fR] [\fB-t\fR \fItermlist\fR] + [\fB-T\fR \fItaskidlist\fR] [\fB-c\fR \fIctidlist\fR] [\fB-z\fR \fIzoneidlist\fR] [\fIpattern\fR] .fi @@ -79,23 +79,19 @@ line option to \fBpkill\fR. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-c\fR \fIctidlist\fR\fR .ad .RS 17n -.rt Matches only processes whose process contract ID is in the given list. .RE .sp .ne 2 -.mk .na \fB\fB-d\fR \fIdelim\fR\fR .ad .RS 17n -.rt Specifies the output delimiter string to be printed between each matching process \fBID\fR. If no \fB-d\fR option is specified, the default is a newline character. The \fB-d\fR option is only valid when specified as an option to @@ -104,12 +100,10 @@ character. The \fB-d\fR option is only valid when specified as an option to .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 17n -.rt The regular expression \fIpattern\fR should be matched against the full process argument string (obtained from the \fBpr_psargs\fR field of the \fB/proc/\fInnnnn\fR/psinfo\fR file). If no \fB-f\fR option is specified, the @@ -119,12 +113,10 @@ from the \fBpr_fname\fR field of the \fB/proc/\fInnnnn\fR/psinfo\fR file). .sp .ne 2 -.mk .na \fB\fB-g\fR \fIpgrplist\fR\fR .ad .RS 17n -.rt Matches only processes whose process group \fBID\fR is in the given list. If group 0 is included in the list, this is interpreted as the process group \fBID\fR of the \fBpgrep\fR or \fBpkill\fR process. @@ -132,12 +124,10 @@ group 0 is included in the list, this is interpreted as the process group .sp .ne 2 -.mk .na \fB\fB-G\fR \fIgidlist\fR\fR .ad .RS 17n -.rt Matches only processes whose real group \fBID\fR is in the given list. Each group \fBID\fR may be specified as either a group name or a numerical group \fBID\fR. @@ -145,12 +135,10 @@ group \fBID\fR may be specified as either a group name or a numerical group .sp .ne 2 -.mk .na \fB\fB-J\fR \fIprojidlist\fR\fR .ad .RS 17n -.rt Matches only processes whose project \fBID\fR is in the given list. Each project \fBID\fR may be specified as either a project name or a numerical project \fBID\fR. @@ -158,12 +146,10 @@ project \fBID\fR. .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 17n -.rt Long output format. Prints the process name along with the process \fBID\fR of each matching process. The process name is obtained from the \fBpr_psargs\fR or \fBpr_fname\fR field, depending on whether the \fB-f\fR option was specified @@ -173,47 +159,39 @@ each matching process. The process name is obtained from the \fBpr_psargs\fR or .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 17n -.rt Matches only the newest (most recently created) process that meets all other specified matching criteria. Cannot be used with option \fB-o\fR. .RE .sp .ne 2 -.mk .na \fB\fB-o\fR\fR .ad .RS 17n -.rt Matches only the oldest (earliest created) process that meets all other specified matching criteria. Cannot be used with option \fB-n\fR. .RE .sp .ne 2 -.mk .na \fB\fB-P\fR \fIppidlist\fR\fR .ad .RS 17n -.rt Matches only processes whose parent process \fBID\fR is in the given list. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR \fIsidlist\fR\fR .ad .RS 17n -.rt Matches only processes whose process session \fBID\fR is in in the given list. If \fBID\fR 0 is included in the list, this is interpreted as the session \fBID\fR of the \fBpgrep\fR or \fBpkill\fR process. @@ -221,12 +199,10 @@ If \fBID\fR 0 is included in the list, this is interpreted as the session .sp .ne 2 -.mk .na \fB\fB-t\fR \fItermlist\fR\fR .ad .RS 17n -.rt Matches only processes which are associated with a terminal in the given list. Each terminal is specified as the suffix following "/dev/" of the terminal's device path name in \fB/dev\fR. For example, \fBterm/a\fR or \fBpts/0\fR. @@ -234,12 +210,10 @@ device path name in \fB/dev\fR. For example, \fBterm/a\fR or \fBpts/0\fR. .sp .ne 2 -.mk .na \fB\fB-T\fR \fItaskidlist\fR\fR .ad .RS 17n -.rt Matches only processes whose task \fBID\fR is in the given list. If \fBID\fR 0 is included in the list, this is interpreted as the task \fBID\fR of the \fBpgrep\fR or \fBpkill\fR process. @@ -247,12 +221,10 @@ is included in the list, this is interpreted as the task \fBID\fR of the .sp .ne 2 -.mk .na \fB\fB-u\fR \fIeuidlist\fR\fR .ad .RS 17n -.rt Matches only processes whose effective user \fBID\fR is in the given list. Each user \fBID\fR may be specified as either a login name or a numerical user \fBID\fR. @@ -260,36 +232,30 @@ user \fBID\fR may be specified as either a login name or a numerical user .sp .ne 2 -.mk .na \fB\fB-U\fR \fIuidlist\fR\fR .ad .RS 17n -.rt Matches only processes whose real user \fBID\fR is in the given list. Each user \fBID\fR may be specified as either a login name or a numerical user \fBID\fR. .RE .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 17n -.rt Reverses the sense of the matching. Matches all processes \fBexcept\fR those which meet the specified matching criteria. .RE .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad .RS 17n -.rt Considers only processes whose argument string or executable file name \fBexactly\fR matches the specified \fIpattern\fR to be matching processes. The pattern match is considered to be exact when all characters in the process @@ -298,12 +264,10 @@ argument string or executable file name match the pattern. .sp .ne 2 -.mk .na \fB\fB-z\fR \fIzoneidlist\fR\fR .ad .RS 17n -.rt Matches only processes whose zone \fBID\fR is in the given list. Each zone \fBID\fR may be specified as either a zone name or a numerical zone \fBID\fR. This option is only useful when executed in the global zone. If the \fBpkill\fR @@ -313,12 +277,10 @@ have asserted the \fB{PRIV_PROC_ZONE}\fR privilege (see \fBprivileges\fR(5)). .sp .ne 2 -.mk .na \fB\fB-\fR\fIsignal\fR\fR .ad .RS 17n -.rt Specifies the signal to send to each matched process. If no signal is specified, \fBSIGTERM\fR is sent by default. The value of \fIsignal\fR can be one of the symbolic names defined in \fBsignal.h\fR(3HEAD) without the @@ -333,12 +295,10 @@ one of the symbolic names defined in \fBsignal.h\fR(3HEAD) without the The following operand is supported: .sp .ne 2 -.mk .na \fB\fIpattern\fR\fR .ad .RS 11n -.rt Specifies an Extended Regular Expression (\fBERE\fR) pattern to match against either the executable file name or full process argument string. See \fBregex\fR(5) for a complete description of the \fBERE\fR syntax. @@ -380,57 +340,47 @@ example% \fBpkill -n xterm\fR The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt One or more processes were matched. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt No processes were matched. .RE .sp .ne 2 -.mk .na \fB\fB2\fR\fR .ad .RS 5n -.rt Invalid command line options were specified. .RE .sp .ne 2 -.mk .na \fB\fB3\fR\fR .ad .RS 5n -.rt A fatal error occurred. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB/proc/\fInnnnn\fR/psinfo\fR\fR .ad .RS 22n -.rt Process information files .RE diff --git a/usr/src/man/man1/pkginfo.1 b/usr/src/man/man1/pkginfo.1 index d71cd4f796..e86c3b103a 100644 --- a/usr/src/man/man1/pkginfo.1 +++ b/usr/src/man/man1/pkginfo.1 @@ -3,19 +3,19 @@ .\" 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 pkginfo 1 "30 Oct 2007" "SunOS 5.11" "User Commands" +.TH PKGINFO 1 "Oct 30, 2007" .SH NAME pkginfo \- display software package information .SH SYNOPSIS .LP .nf -\fBpkginfo\fR [\fB-q\fR | \fB-x\fR | \fB-l\fR] [\fB-p\fR | \fB-i\fR] [\fB-r\fR] [\fB-a\fR \fIarch\fR] +\fBpkginfo\fR [\fB-q\fR | \fB-x\fR | \fB-l\fR] [\fB-p\fR | \fB-i\fR] [\fB-r\fR] [\fB-a\fR \fIarch\fR] [\fB-v\fR \fIversion\fR] [\fB-c\fR \fIcategory\fR]... [\fIpkginst\fR]... .fi .LP .nf -\fBpkginfo\fR [\fB-d\fR \fIdevice\fR] [\fB-R\fR \fIroot_path\fR] [\fB-q\fR | \fB-x\fR | \fB-l\fR] [\fB-a\fR \fIarch\fR] +\fBpkginfo\fR [\fB-d\fR \fIdevice\fR] [\fB-R\fR \fIroot_path\fR] [\fB-q\fR | \fB-x\fR | \fB-l\fR] [\fB-a\fR \fIarch\fR] [\fB-v\fR \fIversion\fR] [\fB-c\fR \fIcategory\fR]... [\fIpkginst\fR]... .fi @@ -40,7 +40,6 @@ the \fB-d\fR option. The options \fB-q\fR, \fB-x\fR, and \fB-l\fR are mutually exclusive. .sp .ne 2 -.mk .na \fB\fB-a\fR \fIarch\fR\fR .ad @@ -51,7 +50,6 @@ Specify the architecture of the package as \fBarch\fR. .sp .ne 2 -.mk .na \fB\fB-c\fR \fIcategory\fR\fR .ad @@ -65,7 +63,6 @@ list. The match is not case specific. .sp .ne 2 -.mk .na \fB\fB-d\fR \fIdevice\fR\fR .ad @@ -79,7 +76,6 @@ indicate the default installation spool directory (\fB/var/spool/pkg\fR). .sp .ne 2 -.mk .na \fB\fB-i\fR\fR .ad @@ -90,7 +86,6 @@ Display information for fully installed packages only. .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad @@ -102,7 +97,6 @@ designated package(s). .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad @@ -113,7 +107,6 @@ Display information for partially installed packages only. .sp .ne 2 -.mk .na \fB\fB-q\fR\fR .ad @@ -125,7 +118,6 @@ package has been installed. .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad @@ -136,7 +128,6 @@ List the installation base for relocatable packages. .sp .ne 2 -.mk .na \fB\fB-R\fR \fIroot_path\fR\fR .ad @@ -149,7 +140,6 @@ tree starting in the specified \fIroot_path\fR. .sp .ne 2 -.mk .na \fB\fB-v\fR \fIversion\fR\fR .ad @@ -164,7 +154,6 @@ during version comparison. .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad @@ -178,7 +167,6 @@ package version (if available). .SH OPERANDS .sp .ne 2 -.mk .na \fB\fIpkginst\fR\fR .ad @@ -195,7 +183,6 @@ to be escaped. In the C-Shell, "\fB*\fR" must be surrounded by single quotes .SH EXIT STATUS .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad @@ -206,7 +193,6 @@ Successful completion. .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad @@ -218,7 +204,6 @@ An error occurred. .SH FILES .sp .ne 2 -.mk .na \fB\fB/var/spool/pkg\fR\fR .ad diff --git a/usr/src/man/man1/pkgmk.1 b/usr/src/man/man1/pkgmk.1 index 02f2290f10..9191ace5e2 100644 --- a/usr/src/man/man1/pkgmk.1 +++ b/usr/src/man/man1/pkgmk.1 @@ -4,14 +4,14 @@ .\" 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 pkgmk 1 "30 Oct 2007" "SunOS 5.11" "User Commands" +.TH PKGMK 1 "Oct 30, 2007" .SH NAME pkgmk \- produce an installable package .SH SYNOPSIS .LP .nf -\fBpkgmk\fR [\fB-o\fR] [\fB-a\fR \fIarch\fR] [\fB-b\fR \fIbase_src_dir\fR] [\fB-d\fR \fIdevice\fR] - [\fB-f\fR \fIprototype\fR] [\fB-l\fR \fIlimit\fR] [\fB-p\fR \fIpstamp\fR] [\fB-r\fR \fIroot_path\fR] +\fBpkgmk\fR [\fB-o\fR] [\fB-a\fR \fIarch\fR] [\fB-b\fR \fIbase_src_dir\fR] [\fB-d\fR \fIdevice\fR] + [\fB-f\fR \fIprototype\fR] [\fB-l\fR \fIlimit\fR] [\fB-p\fR \fIpstamp\fR] [\fB-r\fR \fIroot_path\fR] [\fB-v\fR \fIversion\fR] [\fIvariable=value\fR]... [\fIpkginst\fR] .fi @@ -85,24 +85,20 @@ package commands can process a datastream of up to 4 GB. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-a\fR \fIarch\fR\fR .ad .RS 19n -.rt Overrides the architecture information provided in the \fBpkginfo\fR(4) file with \fIarch\fR. .RE .sp .ne 2 -.mk .na \fB\fB-b\fR \fIbase_src_dir\fR\fR .ad .RS 19n -.rt Prepends the indicated \fIbase_src_dir\fR to locate relocatable objects on the source machine. Use this option to search for all objects in the prototype file. \fBpkgmk\fR expects to find the objects in /\fIbase_src_dir\fR or to @@ -111,12 +107,10 @@ locate the objects by use of the \fB-b\fR and \fB-r\fR options, respectively. .sp .ne 2 -.mk .na \fB\fB-d\fR \fIdevice\fR\fR .ad .RS 19n -.rt Creates the package on \fIdevice\fR. \fIdevice\fR can be an absolute directory pathname or the identifiers for a floppy disk or removable disk (for example, \fB/dev/diskette\fR). The default device is the installation spool directory @@ -125,24 +119,20 @@ pathname or the identifiers for a floppy disk or removable disk (for example, .sp .ne 2 -.mk .na \fB\fB-f\fR \fIprototype\fR\fR .ad .RS 19n -.rt Uses the file \fIprototype\fR as input to the command. The default \fIprototype\fR filename is [\fBPp\fR]\fBrototype\fR. .RE .sp .ne 2 -.mk .na \fB\fB-l\fR \fIlimit\fR\fR .ad .RS 19n -.rt Specifies the maximum size in 512 byte blocks of the output device as \fBlimit\fR. By default, if the output file is a directory or a mountable device, \fBpkgmk\fR employs the \fBdf\fR(1M) command to dynamically calculate @@ -153,36 +143,30 @@ format. .sp .ne 2 -.mk .na \fB\fB-o\fR\fR .ad .RS 19n -.rt Overwrites the same instance; package instance is overwritten if it already exists. .RE .sp .ne 2 -.mk .na \fB\fB-p\fR \fIpstamp\fR\fR .ad .RS 19n -.rt Overrides the production stamp definition in the \fBpkginfo\fR(4) file with \fIpstamp\fR. .RE .sp .ne 2 -.mk .na \fB\fB-r\fR \fIroot_path\fR\fR .ad .RS 19n -.rt Uses the indicated \fIroot_path\fR with the source pathname appended to locate objects on the source machine, using a comma (\fB,\fR) as the separator for the path elements. If this option is specified, look for the full destination path @@ -192,24 +176,20 @@ specified, look for the leaf filename in the current directory. .sp .ne 2 -.mk .na \fB\fB-v\fR \fIversion\fR\fR .ad .RS 19n -.rt Overrides the version information provided in the \fBpkginfo\fR(4) file with \fIversion\fR. .RE .sp .ne 2 -.mk .na \fB\fIvariable=value\fR\fR .ad .RS 19n -.rt Places the indicated variable in the packaging environment. (See \fBprototype\fR(4) for definitions of variable specifications.) .RE @@ -220,12 +200,10 @@ Places the indicated variable in the packaging environment. (See The following operand is supported: .sp .ne 2 -.mk .na \fB\fIpkginst\fR\fR .ad .RS 11n -.rt A package designation by its instance. An instance can be the package abbreviation or a specific instance (for example, \fBinst.1\fR or \fBinst.2\fR). All instances of a package can be requested by \fBinst.*\fR. The @@ -240,23 +218,19 @@ need to be escaped. In the C-Shell, \fB*\fR must be surrounded by single quotes The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE diff --git a/usr/src/man/man1/pkgparam.1 b/usr/src/man/man1/pkgparam.1 index af190b122e..9f8ad572c4 100644 --- a/usr/src/man/man1/pkgparam.1 +++ b/usr/src/man/man1/pkgparam.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 pkgparam 1 "30 Oct 2007" "SunOS 5.11" "User Commands" +.TH PKGPARAM 1 "Oct 30, 2007" .SH NAME pkgparam \- display package parameter values .SH SYNOPSIS @@ -49,12 +49,10 @@ associated with the package are shown. Options and arguments for this command are: .sp .ne 2 -.mk .na \fB\fB-d\fR \fIdevice\fR\fR .ad .RS 16n -.rt Specify the \fIdevice\fR on which a \fIpkginst\fR is stored. It can be a directory pathname or the identifiers for tape, floppy disk, or removable disk (for example, \fB/var/tmp\fR, \fB/dev/diskette\fR, and \fB/dev/dsk/c1d0s0\fR). @@ -64,23 +62,19 @@ spool directory (\fB/var/spool/pkg\fR). .sp .ne 2 -.mk .na \fB\fB-f\fR \fIfilename\fR\fR .ad .RS 16n -.rt Read \fIfilename\fR for parameter values. .RE .sp .ne 2 -.mk .na \fB\fB-R\fR \fIroot_path\fR\fR .ad .RS 16n -.rt Defines the full path name of a subdirectory to use as the \fIroot_path\fR. All files, including package system information files, are relocated to a directory tree starting in the specified \fIroot_path\fR. @@ -88,36 +82,30 @@ tree starting in the specified \fIroot_path\fR. .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 16n -.rt Verbose mode. Display name of parameter and its value. .RE .SH OPERANDS .sp .ne 2 -.mk .na \fB\fIpkginst\fR\fR .ad .RS 11n -.rt Defines a specific package instance for which parameter values should be displayed. .RE .sp .ne 2 -.mk .na \fB\fIparam\fR\fR .ad .RS 11n -.rt Defines a specific parameter whose value should be displayed. .RE @@ -129,23 +117,19 @@ command exits with a non-zero status. .SH EXIT STATUS .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE diff --git a/usr/src/man/man1/pkgproto.1 b/usr/src/man/man1/pkgproto.1 index 72b815995e..5c7cc316de 100644 --- a/usr/src/man/man1/pkgproto.1 +++ b/usr/src/man/man1/pkgproto.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 pkgproto 1 "30 Oct 2007" "SunOS 5.11" "User Commands" +.TH PKGPROTO 1 "Oct 30, 2007" .SH NAME pkgproto \- generate prototype file entries for input to pkgmk command .SH SYNOPSIS @@ -37,47 +37,39 @@ package commands can process a datastream of up to 4 GB. .SH OPTIONS .sp .ne 2 -.mk .na \fB\fB-i\fR\fR .ad .RS 12n -.rt Ignores symbolic links and records the paths as \fBftype\fR=\fBf\fR (a file) versus \fBftype\fR=\fBs\fR (symbolic link). .RE .sp .ne 2 -.mk .na \fB\fB-c\fR \fIclass\fR\fR .ad .RS 12n -.rt Maps the class of all paths to \fIclass\fR. .RE .SH OPERANDS .sp .ne 2 -.mk .na \fB\fIpath1\fR\fR .ad .RS 9n -.rt Pathname where objects are located. .RE .sp .ne 2 -.mk .na \fB\fIpath2\fR\fR .ad .RS 9n -.rt Pathname which should be substituted on output for \fIpath1\fR. .RE @@ -100,7 +92,7 @@ f none usrbin/sdb=/usr/bin/sdb 0775 bin bin f none usrbin/shl=/usr/bin/shl 4755 bin bin d none etc/master.d 0755 root daemon f none etc/master.d/kernel=/etc/master.d/kernel 0644 root daemon -f none etc/rc=/etc/rc 0744 root daemon +f none etc/rc=/etc/rc 0744 root daemon .fi .in -2 .sp @@ -129,23 +121,19 @@ d none /tmp 777 root root .SH EXIT STATUS .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE diff --git a/usr/src/man/man1/pkgtrans.1 b/usr/src/man/man1/pkgtrans.1 index 15a08dc64a..6f0f54c353 100644 --- a/usr/src/man/man1/pkgtrans.1 +++ b/usr/src/man/man1/pkgtrans.1 @@ -4,13 +4,13 @@ .\" 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 pkgtrans 1 "30 Oct 2007" "SunOS 5.11" "User Commands" +.TH PKGTRANS 1 "Oct 30, 2007" .SH NAME pkgtrans \- translate package format .SH SYNOPSIS .LP .nf -\fBpkgtrans\fR [\fB-inosg\fR] [\fB-k\fR \fIkeystore\fR] [\fB-a\fR \fIalias\fR] [\fB-P\fR \fIpasswd\fR] \fIdevice1\fR \fIdevice2\fR +\fBpkgtrans\fR [\fB-inosg\fR] [\fB-k\fR \fIkeystore\fR] [\fB-a\fR \fIalias\fR] [\fB-P\fR \fIpasswd\fR] \fIdevice1\fR \fIdevice2\fR [\fIpkginst\fR]... .fi @@ -49,12 +49,10 @@ one file system format to another file system format The options and arguments for this command are: .sp .ne 2 -.mk .na \fB\fB-a\fR \fIalias\fR\fR .ad .RS 15n -.rt Use public key certificate associated with friendlyName alias, and the corresponding private key. See \fBKEYSTORE LOCATIONS\fR and \fBKEYSTORE AND CERTIFICATE FORMATS\fR in \fBpkgadd\fR(1M) for more information. @@ -62,34 +60,28 @@ CERTIFICATE FORMATS\fR in \fBpkgadd\fR(1M) for more information. .sp .ne 2 -.mk .na \fB\fB-g\fR\fR .ad .RS 15n -.rt Sign resulting datastream. .RE .sp .ne 2 -.mk .na \fB\fB-i\fR\fR .ad .RS 15n -.rt Copies only the \fBpkginfo\fR(4) and \fBpkgmap\fR(4) files. .RE .sp .ne 2 -.mk .na \fB\fB-k\fR \fIkeystore\fR\fR .ad .RS 15n -.rt Use keystore to retrieve private key used to generate signature. If it not specified, default locations are searched to find the specified private key specified by \fB-a\fR. If no alias is given, and multiple keys exist in the key @@ -104,12 +96,10 @@ directory of the user invoking \fBpkgtrans\fR. .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 15n -.rt Creates a new instance of the package on the destination device if any instance of this package already exists, up to the number specified by the \fBMAXINST\fR variable in the \fBpkginfo\fR(4) file. @@ -117,36 +107,30 @@ variable in the \fBpkginfo\fR(4) file. .sp .ne 2 -.mk .na \fB\fB-o\fR\fR .ad .RS 15n -.rt Overwrites the same instance on the destination device. Package instance will be overwritten if it already exists. .RE .sp .ne 2 -.mk .na \fB\fB-P\fR \fIpasswd\fR\fR .ad .RS 15n -.rt Supply password used to decrypt the keystore. See \fBPASS PHRASE ARGUMENTS\fR in \fBpkgadd\fR(1M) for details on the syntax of the argument to this option. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 15n -.rt Indicates that the package should be written to \fIdevice2\fR as a datastream rather than as a file system. The default behavior is to write a file system format on devices that support both formats. @@ -155,36 +139,30 @@ format on devices that support both formats. .SH OPERANDS .sp .ne 2 -.mk .na \fB\fIdevice1\fR\fR .ad .RS 11n -.rt Indicates the source device. The package or packages on this device will be translated and placed on \fIdevice2\fR. See DEVICE SPECIFIERS, below. .RE .sp .ne 2 -.mk .na \fB\fIdevice2\fR\fR .ad .RS 11n -.rt Indicates the destination device. Translated packages will be placed on this device. See DEVICE SPECIFIERS, below. .RE .sp .ne 2 -.mk .na \fB\fIpkginst\fR\fR .ad .RS 11n -.rt Specifies which package instance or instances on \fIdevice1\fR should be translated. The token \fBall\fR may be used to indicate all packages. \fBpkginst.*\fR can be used to indicate all instances of a package. If no @@ -206,12 +184,10 @@ package can be stored to and retrieved from. Note that source and destination devices cannot be the same. .sp .ne 2 -.mk .na \fBdevice\fR .ad .RS 16n -.rt Packages can be stored to a character or block device by specifying the device identifier as the device. Common examples of this device type are \fB/dev/rmt/0\fR for a removable magnetic tape and \fB/floppy/floppy0\fR for @@ -222,12 +198,10 @@ character device, web server, or as input to \fBpkgadd\fR(1M). .sp .ne 2 -.mk .na \fBdevice alias\fR .ad .RS 16n -.rt Devices that have been specified in \fB/etc/device.tab\fR are eligible for being the recipient or source of a package. Common examples of this type of device specification are \fBspool\fR (the default package device location) and @@ -237,12 +211,10 @@ device specification are \fBspool\fR (the default package device location) and .sp .ne 2 -.mk .na \fBdirectory\fR .ad .RS 16n -.rt Packages can be stored onto a directory by specifying an absolute path to a file system directory. The package contents reside in a directory within the specified directory. The package directory name must be identical to its @@ -336,23 +308,19 @@ maximum number of package instances. .SH EXIT STATUS .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -364,13 +332,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilitySee below. +Interface Stability See below. .TE .sp diff --git a/usr/src/man/man1/pktool.1 b/usr/src/man/man1/pktool.1 index 4a1888b636..491d7c6493 100644 --- a/usr/src/man/man1/pktool.1 +++ b/usr/src/man/man1/pktool.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 pktool 1 "23 Mar 2009" "SunOS 5.11" "User Commands" +.TH PKTOOL 1 "Mar 23, 2009" .SH NAME pktool \- manage certificates and keys .SH SYNOPSIS @@ -31,12 +31,10 @@ file-based. The following command options are supported: .sp .ne 2 -.mk .na \fB\fB-f\fR \fIoption_file\fR\fR .ad .RS 18n -.rt Allows the user to set up the options in a file instead of entering the options on the command line. .sp @@ -62,12 +60,10 @@ objtype=key .sp .ne 2 -.mk .na \fB\fB-i\fR\fR .ad .RS 18n -.rt Allows the user to specify the \fBsubject-DN\fR interactively for the \fBgencert\fR and \fBgencsr\fR subcommands. When \fB-i\fR is specified, the user is prompted to input some data to form a \fBsubject-DN\fR. @@ -106,7 +102,6 @@ The resulting \fBsubject-DN\fR is: The following subcommands are supported: .sp .ne 2 -.mk .na \fB\fBdelete\fR\fR .ad @@ -172,7 +167,7 @@ pktool delete keystore=file pktool delete keystore=file objtype=crl infile=\fIinput-fn\fR - + .fi .in -2 .sp @@ -186,7 +181,6 @@ Number (PIN). .sp .ne 2 -.mk .na \fB\fBdownload\fR\fR .ad @@ -196,7 +190,7 @@ The format for the \fBdownload\fR subcommand is as follows: .sp .in +2 .nf - pktool download url=\fIurl_str\fR + pktool download url=\fIurl_str\fR [objtype=crl|cert] [http_proxy=\fIproxy_str\fR] [outfile=\fIoutput-fn\fR] @@ -213,7 +207,6 @@ CRL or certificate file. If the CRL or the certificate is expired, .sp .ne 2 -.mk .na \fB\fBexport\fR\fR .ad @@ -261,7 +254,6 @@ file-based keystore to the specified file. .sp .ne 2 -.mk .na \fB\fBgencert\fR\fR .ad @@ -297,7 +289,7 @@ pktool gencert [-i] [ keystore=pkcs11] [keylen=\fIkey-size\fR] [lifetime=\fInumber\fR-hour|\fInumber\fR-day|\fInumber\fR-year] [eku=[critical:]\fIEKU_name,...\fR] - + pktool gencert [-i] keystore=file outcert=\fIcert-fn\fR outkey=\fIkey-fn\fR @@ -322,7 +314,6 @@ key to the specified keystore. .sp .ne 2 -.mk .na \fB\fBgencsr\fR\fR .ad @@ -345,7 +336,7 @@ pktool gencsr [-i] keystore=nss [keylen=\fIkey-size\fR] [format=pem|der] [eku=[critical:]\fIEKU_name,...\fR] - + pktool gencsr [-i] keystore=pkcs11 label=\fIkey-label\fR outcsr=\fIcsr-fn\fR @@ -357,7 +348,7 @@ pktool gencsr [-i] keystore=pkcs11 [keylen=\fIkey-size\fR] [format=pem|der] [eku=[critical:]\fIEKU_name,...\fR] - + pktool gencsr [-i] keystore=file outcsr=\fIcsr-fn\fR outkey=\fIkey-fn\fR @@ -380,7 +371,6 @@ the user to enter a PIN for token-based keystore. .sp .ne 2 -.mk .na \fB\fBgenkey\fR\fR .ad @@ -427,7 +417,6 @@ subcommand prompts the user to enter a PIN for token-based keystore. .sp .ne 2 -.mk .na \fB\fBimport\fR\fR .ad @@ -493,7 +482,6 @@ specified keystore. .sp .ne 2 -.mk .na \fB\fBinittoken\fR\fR .ad @@ -520,7 +508,6 @@ this command to proceed. .sp .ne 2 -.mk .na \fB\fBlist\fR\fR .ad @@ -550,7 +537,7 @@ pktool list [keystore=pkcs11] pktool list keystore=pkcs11 objtype=crl infile=\fIinput-fn\fR - + pktool list keystore=nss objtype=cert [subject=\fIsubject-DN\fR] @@ -566,7 +553,7 @@ pktool list keystore=nss [token=\fItoken\fR[:\fImanuf\fR[:\fIserial\fR]]] [dir=\fIdirectory-path\fR] [prefix=\fIDBprefix\fR] - + pktool list keystore=file objtype=cert [infile=\fIinput-fn\fR] @@ -590,7 +577,6 @@ to authenticate to the PKCS#11 token by entering the correct PIN. .sp .ne 2 -.mk .na \fB\fBsetpin\fR\fR .ad @@ -633,7 +619,6 @@ By default the \fBusertype\fR is assumed to be \fBuser\fR. .sp .ne 2 -.mk .na \fB\fBsigncsr\fR\fR .ad @@ -695,7 +680,6 @@ signcsr keystore=nss .sp .ne 2 -.mk .na \fB\fBtokens\fR\fR .ad @@ -715,7 +699,6 @@ The tokens subcommand lists all visible PKCS#11 tokens. .sp .ne 2 -.mk .na \fB\fB-?\fR\fR .ad @@ -741,7 +724,6 @@ synonym for \fB-?\fR. The \fBpktool\fR subcommands support the following options: .sp .ne 2 -.mk .na \fBaltname=[critical:]\fIsubjectAltName\fR\fR .ad @@ -760,7 +742,6 @@ Example 1: Add an IP address to the \fIsubjectAltName\fR extension. .sp .ne 2 -.mk .na \fB\fBcurrlabel=token label\fR\fR .ad @@ -773,7 +754,6 @@ for details about the format of the token name to be used. .sp .ne 2 -.mk .na \fB\fBdir=\fR\fIdirectory_path\fR\fR .ad @@ -785,7 +765,6 @@ requested object is stored. .sp .ne 2 -.mk .na \fB\fBeku\fR=[critical:]\fIEKU_Name\fR,[critical:]\fIEKU_Name, ...\fR]\fR .ad @@ -812,7 +791,6 @@ eku=KPClientAuth,clientAuth .sp .ne 2 -.mk .na \fB\fBextractable=y | n\fR\fR .ad @@ -825,7 +803,6 @@ is \fBy\fR. .sp .ne 2 -.mk .na \fBformat=pem | der | pkcs12\fR .ad @@ -843,7 +820,6 @@ default format is \fBpem\fR. .sp .ne 2 -.mk .na \fB\fBinfile=\fR\fIinput-fn\fR\fR .ad @@ -858,7 +834,6 @@ for \fBlist\fR, \fBdelete\fR and \fBimport\fR subcommands when .sp .ne 2 -.mk .na \fB\fBissuer=\fR\fIissuer-DN\fR\fR .ad @@ -869,7 +844,6 @@ Specifies the issuer of a certificate. .sp .ne 2 -.mk .na \fB\fBkeylen=\fR\fIkey-size\fR\fR .ad @@ -891,7 +865,6 @@ ignored if specified. .sp .ne 2 -.mk .na \fBkeystore=\fBnss | pkcs11 | file\fR\fR .ad @@ -903,7 +876,6 @@ file-based plugin. .sp .ne 2 -.mk .na \fB\fBkeytype=rsa | dsa | aes | arcfour | des | 3des | generic\fR\fR .ad @@ -953,7 +925,6 @@ keyusage=critical:digitalSignature,dataEncipherment .sp .ne 2 -.mk .na \fB\fBlabel=\fIkey-label\fR | \fIcert-label\fR\fR\fR .ad @@ -976,7 +947,6 @@ Certificate (when \fBobjtype=key\fR) or the private key (when .sp .ne 2 -.mk .na \fB\fBlifetime=\fInumber\fR-hour|\fInumber\fR-day|\fInumber\fR-year\fR\fR .ad @@ -991,7 +961,6 @@ lifetime=2-day, lifetime=3-year\fR .sp .ne 2 -.mk .na \fB\fBnewlabel=token label\fR\fR .ad @@ -1004,7 +973,6 @@ change the label assigned to the token that is being initialized. See the .sp .ne 2 -.mk .na \fB\fBnickname=\fR\fIcert-nickname\fR\fR .ad @@ -1025,7 +993,6 @@ resulting certificate. .sp .ne 2 -.mk .na \fB\fBobjtype=cert | key | crl\fR\fR .ad @@ -1038,7 +1005,6 @@ Specifies the class of the object: \fBcert,\fR \fBkey,\fR or \fBcrl\fR. For the .sp .ne 2 -.mk .na \fB\fBobjtype=public | private | both\fR\fR .ad @@ -1060,7 +1026,6 @@ compatibility with earlier versions of the \fBpktool\fR command. .sp .ne 2 -.mk .na \fB\fBoutcert=\fR\fIcert-fn\fR\fR .ad @@ -1073,7 +1038,6 @@ required with this option. .sp .ne 2 -.mk .na \fB\fBoutcrl=\fIoutput-crl-fn\fR\fR\fR .ad @@ -1084,7 +1048,6 @@ Specifies the output CRL filename to write to. .sp .ne 2 -.mk .na \fB\fBoutcsr=\fR\fIcsr-fn\fR\fR .ad @@ -1095,7 +1058,6 @@ Specifies the output CSR filename to write to. .sp .ne 2 -.mk .na \fB\fBoutfile=\fR\fIoutput-fn\fR\fR .ad @@ -1110,7 +1072,6 @@ specified, the downloaded file name is the basename of the URL string. .sp .ne 2 -.mk .na \fB\fBoutformat=pem | der | pkcs12\fR\fR .ad @@ -1129,7 +1090,6 @@ supported formats are: \fBpem\fR, \fBder\fR or \fBpkcs12\fR. The default is .sp .ne 2 -.mk .na \fB\fBoutkey=\fR\fIkey-fn\fR\fR .ad @@ -1141,7 +1101,6 @@ only required when using the \fBfiles\fR keystore. .sp .ne 2 -.mk .na \fB\fBprefix=\fR\fIDBprefix\fR\fR .ad @@ -1152,7 +1111,6 @@ Specifies the NSS database prefix. This option only applies to the NSS token. .sp .ne 2 -.mk .na \fB\fBprint=y | n\fR\fR .ad @@ -1169,7 +1127,6 @@ warning like \fBcannot reveal the key value\fR is issued. .sp .ne 2 -.mk .na \fB\fBsensitive=y | n\fR\fR .ad @@ -1182,7 +1139,6 @@ sensitive. The valid values are: \fBy\fR and \fBn\fR. The default value is .sp .ne 2 -.mk .na \fB\fBserial=\fR\fIhex-serial-number\fR\fR .ad @@ -1194,7 +1150,6 @@ specified as a hex value. Example: \fB0x0102030405060708090a0b0c0d0e0f\fR .sp .ne 2 -.mk .na \fB\fBsubject=\fR\fIsubject-DN\fR\fR .ad @@ -1205,7 +1160,7 @@ request. An example \fBsubject=\fR setting might be: .sp .in +2 .nf -subject=O=Sun Microsystems Inc., \e +subject=O=Sun Microsystems Inc., \e OU=Solaris Security Technologies Group, \e L=Ashburn, ST=VA, C=US, CN=John Smith .fi @@ -1216,7 +1171,6 @@ L=Ashburn, ST=VA, C=US, CN=John Smith .sp .ne 2 -.mk .na \fB\fBtoken=\fItoken\fR[:\fImanuf\fR[:\fIserial\fR]]\fR\fR .ad @@ -1237,7 +1191,6 @@ default to \fBpkcs11_softtoken\fR if this option is not specified. .sp .ne 2 -.mk .na \fB\fBtrust=\fItrust\fR-\fIvalue\fR\fR\fR .ad @@ -1249,7 +1202,6 @@ and that the standard NSS syntax applies. .sp .ne 2 -.mk .na \fB\fBusertype=user | so\fR\fR .ad @@ -1262,7 +1214,6 @@ in order to set the PIN for the security officer of the token. .sp .ne 2 -.mk .na \fB\fBurl=\fR\fIurl_string\fR\fR .ad @@ -1273,7 +1224,6 @@ Specifies the URL to download a CRL or a certificate file. .sp .ne 2 -.mk .na \fB\fBverifycrl=y | n\fR\fR .ad @@ -1286,7 +1236,6 @@ default value is \fBn\fR. .sp .ne 2 -.mk .na \fB\fBhttp_proxy=\fR\fIproxy_str\fR\fR .ad @@ -1357,23 +1306,19 @@ file into the keystore indicated in the command: The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -1385,13 +1330,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed .TE .SH SEE ALSO diff --git a/usr/src/man/man1/plabel.1 b/usr/src/man/man1/plabel.1 index 0428488128..f5851d3095 100644 --- a/usr/src/man/man1/plabel.1 +++ b/usr/src/man/man1/plabel.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 plabel 1 "20 Jul 2007" "SunOS 5.11" "User Commands" +.TH PLABEL 1 "Jul 20, 2007" .SH NAME plabel \- get the label of a process .SH SYNOPSIS @@ -22,23 +22,19 @@ displayed in default format. .SH OPTIONS .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 6n -.rt Display the label that is associated with \fIpid\fR in short form. .RE .sp .ne 2 -.mk .na \fB\fB-S\fR\fR .ad .RS 6n -.rt Display the label that is associated with \fIpid\fR in long form. .RE @@ -48,45 +44,37 @@ Display the label that is associated with \fIpid\fR in long form. \fBplabel\fR exits with one of the following values: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt Unsuccessful completion because of a usage error. .RE .sp .ne 2 -.mk .na \fB\fB2\fR\fR .ad .RS 5n -.rt Inability to translate label. .RE .sp .ne 2 -.mk .na \fB\fB3\fR\fR .ad .RS 5n -.rt Inability to allocate memory. .RE @@ -98,13 +86,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilitySee below. +Interface Stability See below. .TE .sp diff --git a/usr/src/man/man1/plgrp.1 b/usr/src/man/man1/plgrp.1 index 354bb7df3d..95dd491b44 100644 --- a/usr/src/man/man1/plgrp.1 +++ b/usr/src/man/man1/plgrp.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 plgrp 1 "8 Sep 2006" "SunOS 5.11" "User Commands" +.TH PLGRP 1 "Sep 8, 2006" .SH NAME plgrp \- observe and affect home lgroup and lgroup affinities of threads .SH SYNOPSIS @@ -24,7 +24,7 @@ plgrp \- observe and affect home lgroup and lgroup affinities of threads .LP .nf -\fBplgrp\fR [\fB-F\fR] \fB-A\fR \fIlgroup_list\fR/\fInone\fR | \fIweak\fR |\fIstrong\fR [,...] \fIpid\fR +\fBplgrp\fR [\fB-F\fR] \fB-A\fR \fIlgroup_list\fR/\fInone\fR | \fIweak\fR |\fIstrong\fR [,...] \fIpid\fR [/\fIlwps\fR] ... .fi @@ -107,7 +107,6 @@ selected at once by using the hyphen (\fB-\fR) and comma(\fB,\fR). For example, The following options are supported: .sp .ne 2 -.mk .na \fB\fB-a\fR \fIlgroup_list\fR\fR .ad @@ -119,7 +118,6 @@ specified \fIlgroup_list\fR. .sp .ne 2 -.mk .na \fB\fB-A\fR \fIlgroup_list\fR\fB/\fR\fInone\fR\fB|\fR\fIweak\fR\fB|\fR\fIstrong \fR\fB[,...]\fR\fR @@ -135,7 +133,6 @@ given to set several affinities at once. .sp .ne 2 -.mk .na \fB\fB-F\fR\fR .ad @@ -151,7 +148,6 @@ this proc tool. See \fBWARNINGS\fR for more details. .sp .ne 2 -.mk .na \fB\fB-h\fR\fR .ad @@ -163,7 +159,6 @@ specified, this is the default. .sp .ne 2 -.mk .na \fB\fB-H\fR \fIlgroup_list\fR\fR .ad @@ -182,23 +177,19 @@ to the \fBlgroups\fR in a round robin fashion. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIlwps\fR\fR .ad .RS 8n -.rt Specifies thread. See \fBUSAGE\fR. .RE .sp .ne 2 -.mk .na \fB\fIpid\fR\fR .ad .RS 8n -.rt Specifies process ID. See \fBUSAGE\fR. .RE @@ -284,34 +275,28 @@ PID/LWPID HOME AFFINITY The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt Syntax error. Nothing was changed. .RE .sp .ne 2 -.mk .na \fB\fB2\fR\fR .ad .RS 5n -.rt Non-fatal error or interrupt. Something might have changed. .RE @@ -323,13 +308,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilitySee below. +Interface Stability See below. .TE .sp diff --git a/usr/src/man/man1/plimit.1 b/usr/src/man/man1/plimit.1 index fb36530492..59eef652a6 100644 --- a/usr/src/man/man1/plimit.1 +++ b/usr/src/man/man1/plimit.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 plimit 1 "8 Jun 1998" "SunOS 5.11" "User Commands" +.TH PLIMIT 1 "Jun 8, 1998" .SH NAME plimit \- get or set the resource limits of running processes .SH SYNOPSIS @@ -36,24 +36,20 @@ limit. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-k\fR\fR .ad .RS 6n -.rt On output, show file sizes in kilobytes (1024 bytes) rather than in 512-byte blocks. .RE .sp .ne 2 -.mk .na \fB\fB-m\fR\fR .ad .RS 6n -.rt On output, show file and memory sizes in megabytes (1024*1024 bytes). .RE @@ -73,45 +69,37 @@ limit is either the literal string \fBunlimited\fR, or a number, with an optional scaling factor, as follows: .sp .ne 2 -.mk .na \fB\fIn\fR\fBk\fR\fR .ad .RS 9n -.rt \fIn\fR kilobytes .RE .sp .ne 2 -.mk .na \fB\fIn\fR\fBm\fR\fR .ad .RS 9n -.rt \fIn\fR megabytes (minutes for CPU time) .RE .sp .ne 2 -.mk .na \fB\fIn\fR\fBh\fR\fR .ad .RS 9n -.rt \fIn\fR hours (for CPU time only) .RE .sp .ne 2 -.mk .na \fB\fImm\fR\fB:\fR\fIss\fR\fR .ad .RS 9n -.rt minutes and seconds (for CPU time only) .RE @@ -120,78 +108,64 @@ minutes and seconds (for CPU time only) The soft limit cannot exceed the hard limit. .sp .ne 2 -.mk .na \fB\fB-c\fR\fI soft,hard\fR\fR .ad .RS 16n -.rt Set core file size limits (default unit is 512-byte blocks). .RE .sp .ne 2 -.mk .na \fB\fB-d\fR\fI soft,hard\fR\fR .ad .RS 16n -.rt Set data segment (heap) size limits (default unit is kilobytes). .RE .sp .ne 2 -.mk .na \fB\fB-f\fR\fI soft,hard\fR\fR .ad .RS 16n -.rt Set file size limits (default unit is 512-byte blocks). .RE .sp .ne 2 -.mk .na \fB\fB-n\fR\fI soft,hard\fR\fR .ad .RS 16n -.rt Set file descriptor limits (no default unit). .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fI soft,hard\fR\fR .ad .RS 16n -.rt Set stack segment size limits (default unit is kilobytes). .RE .sp .ne 2 -.mk .na \fB\fB-t\fR\fI soft,hard\fR\fR .ad .RS 16n -.rt Set CPU time limits (default unit is seconds). .RE .sp .ne 2 -.mk .na \fB\fB-v\fR\fI soft,hard\fR\fR .ad .RS 16n -.rt Set virtual memory size limits (default unit is kilobytes). .RE @@ -201,12 +175,10 @@ Set virtual memory size limits (default unit is kilobytes). The following operands are supported. .sp .ne 2 -.mk .na \fBpid\fR .ad .RS 7n -.rt Process ID list. .RE @@ -218,12 +190,10 @@ as no such process, permission denied, or invalid option). .SH FILES .sp .ne 2 -.mk .na \fB\fB/proc/\fR\fIpid\fR\fB/*\fR\fR .ad .RS 15n -.rt process information and control files .RE diff --git a/usr/src/man/man1/pmadvise.1 b/usr/src/man/man1/pmadvise.1 index 06e60b6e7c..93d3b45576 100644 --- a/usr/src/man/man1/pmadvise.1 +++ b/usr/src/man/man1/pmadvise.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 pmadvise 1 "25 Sep 2008" "SunOS 5.11" "User Commands" +.TH PMADVISE 1 "Sep 25, 2008" .SH NAME pmadvise \- applies advice about memory to a process .SH SYNOPSIS @@ -29,12 +29,10 @@ program to all segments of a specified type. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-F\fR\fR .ad .RS 6n -.rt Force by grabbing the target process even if another process has control. .sp You should exercise caution when using the \fB-F\fR option. See \fBproc\fR(1). @@ -42,23 +40,19 @@ You should exercise caution when using the \fB-F\fR option. See \fBproc\fR(1). .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 6n -.rt Show unresolved dynamic linker map names. .RE .sp .ne 2 -.mk .na \fB\fB-o\fR\fR .ad .RS 6n -.rt Specify advice to apply in the following form: .sp .in +2 @@ -102,12 +96,10 @@ unit of measure. .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 6n -.rt Print verbose output. Display output as \fBpmap\fR(1) does, showing what advice is being applied where. This can be useful when the advice is being applied to a named region (for example, private, shared, and so forth) to get feedback on @@ -147,12 +139,10 @@ MADV_ACCESS_DEFAULT, MADV_ACCESS_LWP, MADV_ACCESS_MANY The following operands are supported: .sp .ne 2 -.mk .na \fB\fIpid\fR\fR .ad .RS 7n -.rt Process ID. .RE @@ -205,7 +195,7 @@ The following example displays verbose output from \fBpmadvise\fR: .sp .in +2 .nf - + % pmadvise -o heap=access_lwp,stack=access_default -v $$ 1720: -sh 00010000 88K r-x-- /sbin/sh @@ -233,46 +223,38 @@ FFBFE000 8K rw--- [ stack ] <= access_default 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 \fB\fBnon-zero\fR\fR .ad .RS 12n -.rt An error occurred. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB/proc/*\fR\fR .ad .RS 19n -.rt Process files .RE .sp .ne 2 -.mk .na \fB\fB/usr/prob/lib/*\fR\fR .ad .RS 19n -.rt \fBproc\fR tools support files .RE @@ -284,13 +266,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilitySee below. +Interface Stability See below. .TE .sp diff --git a/usr/src/man/man1/pmap.1 b/usr/src/man/man1/pmap.1 index 8dac9903b6..5f2c360872 100644 --- a/usr/src/man/man1/pmap.1 +++ b/usr/src/man/man1/pmap.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 pmap 1 "9 Sep 2006" "SunOS 5.11" "User Commands" +.TH PMAP 1 "Sep 9, 2006" .SH NAME pmap \- display information about the address space of a process .SH SYNOPSIS @@ -37,28 +37,23 @@ The \fBpmap\fR utility prints information about the address space of a process. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 20n -.rt Prints anonymous and swap reservations for shared mappings. .RE .sp .ne 2 -.mk .na \fB\fB-A\fR \fIaddress_range\fR\fR .ad .RS 20n -.rt Specifies the subrange of address space to display. \fIaddress_range\fR is specified in one of the following forms: .sp .ne 2 -.mk .na \fB\fIstart_addr\fR\fR .ad @@ -72,7 +67,6 @@ the whole segment even when the \fB-L\fR option is specified. .sp .ne 2 -.mk .na \fB\fIstart_addr\fR\fB,\fR\fR .ad @@ -85,7 +79,6 @@ containing the specified address. .sp .ne 2 -.mk .na \fB\fIstart_addr\fR\fB,\fR\fIend_addr\fR\fR .ad @@ -99,7 +92,6 @@ page containing the end address. .sp .ne 2 -.mk .na \fB\fB,\fR\fIend_addr\fR\fR .ad @@ -115,12 +107,10 @@ containing the specified address. .sp .ne 2 -.mk .na \fB\fB-F\fR\fR .ad .RS 20n -.rt Force. Grabs the target process even if another process has control. .sp See \fBUSAGE\fR. @@ -128,68 +118,56 @@ See \fBUSAGE\fR. .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 20n -.rt Shows unresolved dynamic linker map names. .RE .sp .ne 2 -.mk .na \fB\fB-L\fR\fR .ad .RS 20n -.rt Prints lgroup containing physical memory that backs virtual memory. .RE .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 20n -.rt Prints the process's reserved addresses. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 20n -.rt Prints \fBHAT\fR page size information. .RE .sp .ne 2 -.mk .na \fB\fB-S\fR\fR .ad .RS 20n -.rt Displays swap reservation information per mapping. See USAGE for more information. .RE .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad .RS 20n -.rt Displays additional information per mapping. See USAGE for more information. .RE @@ -199,7 +177,6 @@ Displays additional information per mapping. See USAGE for more information. The \fBpmap\fR utility prints information about the address space of a process. .sp .ne 2 -.mk .na \fBProcess Mappings\fR .ad @@ -224,7 +201,6 @@ the output includes the segments bounded by those addresses. .sp .ne 2 -.mk .na \fBProcess Lgroup Mappings\fR .ad @@ -257,7 +233,6 @@ In addition, the thread and memory placement can be changed by using .sp .ne 2 -.mk .na \fBProcess anon/locked mapping details\fR .ad @@ -280,7 +255,6 @@ this process. .sp .ne 2 -.mk .na \fBSwap Reservations\fR .ad @@ -316,7 +290,6 @@ contiguous mapping of each hardware translation page size belonging to the same lgroup. The column headings are shown in parentheses below. .sp .ne 2 -.mk .na \fBVirtual Address (\fBAddress\fR)\fR .ad @@ -328,7 +301,6 @@ mapping. Virtual addresses are displayed in ascending order. .sp .ne 2 -.mk .na \fBVirtual Mapping Size (\fBKbytes\fR)\fR .ad @@ -339,7 +311,6 @@ The virtual size in kilobytes of each mapping. .sp .ne 2 -.mk .na \fBResident Physical Memory (\fBRSS\fR)\fR .ad @@ -351,7 +322,6 @@ including that which is shared with other address spaces. .sp .ne 2 -.mk .na \fBAnonymous Memory (\fBAnon\fR)\fR .ad @@ -367,7 +337,6 @@ pages with mappings mapped with \fBMAP_PRIVATE\fR (see \fBmmap\fR(2)). .sp .ne 2 -.mk .na \fBLocked (\fBLocked\fR)\fR .ad @@ -380,7 +349,6 @@ locked with \fBmlock()\fR and System V shared memory created with .sp .ne 2 -.mk .na \fBPermissions/Flags (\fBMode\fR)\fR .ad @@ -390,46 +358,38 @@ The virtual memory permissions are shown for each mapping. Valid permissions are: .sp .ne 2 -.mk .na \fB\fBr:\fR\fR .ad .RS 6n -.rt The mapping can be read by the process. .RE .sp .ne 2 -.mk .na \fB\fBw:\fR\fR .ad .RS 6n -.rt The mapping can be written by the process. .RE .sp .ne 2 -.mk .na \fB\fBx:\fR\fR .ad .RS 6n -.rt Instructions that reside within the mapping can be executed by the process. .RE Flags showing additional information for each mapping can be displayed: .sp .ne 2 -.mk .na \fB\fBs:\fR\fR .ad .RS 6n -.rt The mapping is shared such that changes made in the observed address space are committed to the mapped file, and are visible from all other processes sharing the mapping. @@ -437,12 +397,10 @@ the mapping. .sp .ne 2 -.mk .na \fB\fBR:\fR\fR .ad .RS 6n -.rt Swap space is not reserved for this mapping. Mappings created with \fBMAP_NORESERVE\fR and System V \fBISM\fR shared memory mappings do not reserve swap space. @@ -450,12 +408,10 @@ reserve swap space. .sp .ne 2 -.mk .na \fB\fB*:\fR\fR .ad .RS 6n -.rt The data for the mapping is not present in the core file (only applicable when applied to a core file). See \fBcoreadm\fR(1M) for information on configuring core file content. @@ -465,7 +421,6 @@ core file content. .sp .ne 2 -.mk .na \fBLgroup (\fBLgrp\fR)\fR .ad @@ -476,7 +431,6 @@ The lgroup containing the physical memory that backs the specified mapping. .sp .ne 2 -.mk .na \fBMapping Name (\fBMapped File\fR)\fR .ad @@ -506,45 +460,37 @@ mappings: .sp .ne 2 -.mk .na \fB\fB[ heap ]\fR\fR .ad .RS 22n -.rt The mapping is the process heap. .RE .sp .ne 2 -.mk .na \fB\fB[ stack ]\fR\fR .ad .RS 22n -.rt The mapping is the main stack. .RE .sp .ne 2 -.mk .na \fB\fB[ stack tid=\fIn\fR ]\fR\fR .ad .RS 22n -.rt The mapping is the stack for thread \fIn\fR. .RE .sp .ne 2 -.mk .na \fB\fB[ altstack tid=\fIn\fR ]\fR\fR .ad .RS 22n -.rt The mapping is used as the alternate signal stack for thread \fIn\fR. .RE @@ -563,24 +509,20 @@ system calls are reported with the names shown below: .sp .ne 2 -.mk .na \fB\fBshmid=n:\fR\fR .ad .RS 17n -.rt The mapping is a System V shared memory mapping. The shared memory identifier that the mapping was created with is reported. .RE .sp .ne 2 -.mk .na \fB\fBism shmid=n:\fR\fR .ad .RS 17n -.rt The mapping is an "Intimate Shared Memory" variant of System V shared memory. \fBISM\fR mappings are created with the \fBSHM_SHARE_MMU\fR flag set, in accordance with \fBshmat\fR(2) (see \fBshmop\fR(2)). @@ -588,12 +530,10 @@ accordance with \fBshmat\fR(2) (see \fBshmop\fR(2)). .sp .ne 2 -.mk .na \fB\fBdism shmid=n:\fR\fR .ad .RS 17n -.rt The mapping is a pageable variant of \fBISM\fR. Pageable \fBISM\fR is created with the \fBSHM_PAGEABLE\fR flag set in accordance with \fBshmat\fR(2) (see \fBshmop\fR(2)). @@ -613,7 +553,6 @@ buffers. No mapping name is shown for other mapped objects. .sp .ne 2 -.mk .na \fBPage Size (\fBPgsz\fR)\fR .ad @@ -625,7 +564,6 @@ this mapping. See \fBmemcntl\fR(2) for further information. .sp .ne 2 -.mk .na \fBSwap Space (\fBSwap\fR)\fR .ad @@ -1010,46 +948,38 @@ FFBFE000 8K rw--- 2 [ stack ] The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 12n -.rt Successful operation. .RE .sp .ne 2 -.mk .na \fBnon-zero\fR .ad .RS 12n -.rt An error has occurred. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB/proc/*\fR\fR .ad .RS 19n -.rt process files .RE .sp .ne 2 -.mk .na \fB\fB/usr/proc/lib/*\fR\fR .ad .RS 19n -.rt \fBproc\fR tools supporting files .RE @@ -1061,13 +991,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilitySee below. +Interface Stability See below. .TE .sp diff --git a/usr/src/man/man1/postio.1 b/usr/src/man/man1/postio.1 index 10f3459e90..ffd7084208 100644 --- a/usr/src/man/man1/postio.1 +++ b/usr/src/man/man1/postio.1 @@ -3,19 +3,19 @@ .\" 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 "9 Sep 1996" "SunOS 5.11" "User Commands" +.TH POSTIO 1 "Sep 9, 1996" .SH NAME postio \- serial interface for PostScript printers .SH SYNOPSIS .LP .nf -\fBpostio\fR \fB-l\fR \fIline\fR [\fB-D\fR] [\fB-i\fR] [\fB-q\fR] [\fB-t\fR] [\fB-S\fR] [\fB-b\fR \fIspeed\fR] [\fB-B\fR \fInum\fR] +\fBpostio\fR \fB-l\fR \fIline\fR [\fB-D\fR] [\fB-i\fR] [\fB-q\fR] [\fB-t\fR] [\fB-S\fR] [\fB-b\fR \fIspeed\fR] [\fB-B\fR \fInum\fR] [\fB-L\fR \fIfile\fR] [\fB-P\fR \fIstring\fR] [\fB-R\fR \fInum\fR] [\fIfile\fR]... .fi .LP .nf -\fB/usr/lib/lp/postscript/postio\fR +\fB/usr/lib/lp/postscript/postio\fR .fi .SH DESCRIPTION @@ -29,24 +29,20 @@ postio \- serial interface for PostScript printers The first group of \fIoptions\fR should be sufficient for most applications: .sp .ne 2 -.mk .na \fB\fB-D\fR\fR .ad .RS 13n -.rt Enable debug mode. Guarantees that everything read on \fBline\fR will be added to the log file (standard error by default). .RE .sp .ne 2 -.mk .na \fB\fB-q\fR\fR .ad .RS 13n -.rt Prevents status queries while \fIfiles\fR are being sent to the printer. When status queries are disabled a dummy message is appended to the log file before each block is transmitted. @@ -54,12 +50,10 @@ each block is transmitted. .sp .ne 2 -.mk .na \fB\fB-b\fR\fI speed\fR\fR .ad .RS 13n -.rt 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 baud. @@ -67,24 +61,20 @@ baud. .sp .ne 2 -.mk .na \fB\fB-B\fR\fI num\fR\fR .ad .RS 13n -.rt Set the internal buffer size for reading and writing \fIfiles\fR to \fInum\fR bytes. By default \fInum\fR is \fB2048\fR bytes. .RE .sp .ne 2 -.mk .na \fB\fB-l\fR\fI line\fR\fR .ad .RS 13n -.rt 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 \fBline\fR does not begin with a \fB/\fR it may be treated as a Datakit @@ -93,12 +83,10 @@ destination. .sp .ne 2 -.mk .na \fB\fB-L\fR\fI file\fR\fR .ad .RS 13n -.rt Data received on \fBline\fR gets put in \fBfile\fR. The default log \fBfile\fR is standard error. Printer or status messages that don't show a change in state are not normally written to \fBfile\fR but can be forced out using the \fB-D\fR @@ -107,24 +95,20 @@ option. .sp .ne 2 -.mk .na \fB\fB-P\fR\fI string\fR\fR .ad .RS 13n -.rt Send \fIstring\fR to the printer before any of the input files. The default \fIstring\fR is simple PostScript code that disables timeouts. .RE .sp .ne 2 -.mk .na \fB\fB-R\fR\fI num\fR\fR .ad .RS 13n -.rt Run \fBpostio\fR as a single process if \fInum\fR is 1 or as separate read and write processes if \fInum\fR is 2. By default \fBpostio\fR runs as a single process. @@ -137,12 +121,10 @@ The next two \fIoptions\fR are provided for users who expect to run programs: .sp .ne 2 -.mk .na \fB\fB-i\fR\fR .ad .RS 6n -.rt Run the program in interactive mode. Any \fIfiles\fR are sent first and followed by the standard input. Forces separate read and write processes and overrides many other options. To exit interactive mode use your interrupt or @@ -152,12 +134,10 @@ quit character. To get a friendly interactive connection with the printer type .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad .RS 6n -.rt Data received on \fBline\fR and not recognized as printer or status information is written to the standard output. Forces separate read and write processes. Convenient if you have a PostScript program that will be returning useful data @@ -170,12 +150,10 @@ The last option is not generally recommended and should only be used if all else fails to provide a reliable connection: .sp .ne 2 -.mk .na \fB\fB-S\fR\fR .ad .RS 6n -.rt Slow the transmission of data to the printer. Severely limits throughput, runs as a single process, disables the \fB-q\fR option, limits the internal buffer size to 1024 bytes, can use an excessive amount of CPU time, and does nothing @@ -273,23 +251,19 @@ data in file results, and put log messages in file \fIlog\fR: 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 diff --git a/usr/src/man/man1/postprint.1 b/usr/src/man/man1/postprint.1 index 44a7d7ea21..f31d69235e 100644 --- a/usr/src/man/man1/postprint.1 +++ b/usr/src/man/man1/postprint.1 @@ -3,20 +3,20 @@ .\" 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 "9 Sep 1996" "SunOS 5.11" "User Commands" +.TH POSTPRINT 1 "Sep 9, 1996" .SH NAME postprint \- PostScript translator for text files .SH SYNOPSIS .LP .nf -\fBpostprint\fR [\fB-c\fR \fInum\fR] [\fB-f\fR \fIname\fR] [\fB-l\fR \fInum\fR] [\fB-m\fR \fInum\fR] [\fB-n\fR \fInum\fR] - [\fB-o\fR \fIlist\fR] [\fB-p\fR \fImode\fR] [\fB-r\fR \fInum\fR] [\fB-s\fR \fInum\fR] [\fB-t\fR \fI num\fR] +\fBpostprint\fR [\fB-c\fR \fInum\fR] [\fB-f\fR \fIname\fR] [\fB-l\fR \fInum\fR] [\fB-m\fR \fInum\fR] [\fB-n\fR \fInum\fR] + [\fB-o\fR \fIlist\fR] [\fB-p\fR \fImode\fR] [\fB-r\fR \fInum\fR] [\fB-s\fR \fInum\fR] [\fB-t\fR \fI num\fR] [\fB-x\fR \fInum\fR] [\fB-y\fR \fInum\fR] [\fIfile\fR]... .fi .LP .nf -\fB/usr/lib/lp/postscript/postprint\fR +\fB/usr/lib/lp/postscript/postprint\fR .fi .SH DESCRIPTION @@ -28,23 +28,19 @@ if \fB\(mi\fR is one of the input \fIfiles\fR, the standard input is read. .SH OPTIONS .sp .ne 2 -.mk .na \fB\fB-c\fR\fI num\fR\fR .ad .RS 11n -.rt Print \fInum\fR copies of each page. By default, only one copy is printed. .RE .sp .ne 2 -.mk .na \fB\fB-f\fR\fI name\fR\fR .ad .RS 11n -.rt Print \fIfiles\fR using font \fIname\fR. Any PostScript font can be used, although the best results will be obtained only with constant width fonts. The default font is Courier. @@ -52,12 +48,10 @@ default font is Courier. .sp .ne 2 -.mk .na \fB\fB-l\fR\fI num\fR\fR .ad .RS 11n -.rt 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 guess a value, based on the point size that's being used. @@ -65,12 +59,10 @@ guess a value, based on the point size that's being used. .sp .ne 2 -.mk .na \fB\fB-m\fR\fI num\fR\fR .ad .RS 11n -.rt 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. @@ -78,24 +70,20 @@ default magnification is \fB1.0\fR. .sp .ne 2 -.mk .na \fB\fB-n\fR\fI num\fR\fR .ad .RS 11n -.rt 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. .RE .sp .ne 2 -.mk .na \fB\fB-o\fR\fI list\fR\fR .ad .RS 11n -.rt 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 @@ -110,24 +98,20 @@ of paper. .sp .ne 2 -.mk .na \fB\fB-p\fR\fI mode\fR\fR .ad .RS 11n -.rt Print \fIfiles\fR in either portrait or landscape \fImode\fR. Only the first character of \fImode\fR is significant. The default \fImode\fR is portrait. .RE .sp .ne 2 -.mk .na \fB\fB-r\fR\fI num\fR\fR .ad .RS 11n -.rt 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. @@ -135,12 +119,10 @@ newline if \fInum\fR is \fB2\fR. The default \fInum\fR is \fB0\fR. .sp .ne 2 -.mk .na \fB\fB-s\fR\fI num\fR\fR .ad .RS 11n -.rt 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 @@ -150,24 +132,20 @@ use the \fB\(mil0\fR option to scale the number of lines per page. .sp .ne 2 -.mk .na \fB\fB-t\fR\fI num\fR\fR .ad .RS 11n -.rt Assume tabs are set every \fInum\fR columns, starting with the first column. By default, tabs are set every \fB8\fR columns. .RE .sp .ne 2 -.mk .na \fB\fB-x\fR\fI num\fR\fR .ad .RS 11n -.rt 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 @@ -176,12 +154,10 @@ moves everything to the right. The default offset is \fB0.25\fR inches. .sp .ne 2 -.mk .na \fB\fB-y\fR\fI num\fR\fR .ad .RS 11n -.rt 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. .RE @@ -226,30 +202,25 @@ To print three logical pages on each physical page in portrait mode: 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/usr/lib/lp/postscript/forms.ps\fR\fR .ad @@ -260,7 +231,6 @@ An error occurred. .sp .ne 2 -.mk .na \fB\fB/usr/lib/lp/postscript/ps.requests\fR\fR .ad diff --git a/usr/src/man/man1/postreverse.1 b/usr/src/man/man1/postreverse.1 index 135a99a179..f514561cff 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 "9 Sep 1996" "SunOS 5.11" "User Commands" +.TH POSTREVERSE 1 "Sep 9, 1996" .SH NAME postreverse \- reverse the page order in a PostScript file .SH SYNOPSIS @@ -14,7 +14,7 @@ postreverse \- reverse the page order in a PostScript file .LP .nf -\fB/usr/lib/lp/postscript/postreverse\fR +\fB/usr/lib/lp/postscript/postreverse\fR .fi .SH DESCRIPTION @@ -42,12 +42,10 @@ prologue, the output file can be minimally conforming, even if the input .SH OPTIONS .sp .ne 2 -.mk .na \fB\fB-o\fR\fI list\fR\fR .ad .RS 11n -.rt Select pages whose numbers are given in the comma-separated \fIlist\fR. The \fIlist\fR contains single numbers \fIN\fR and ranges \fIN1 \fR\(mi \fIN2\fR. A missing \fIN1\fR means the lowest numbered page, a missing \fIN2\fR means the @@ -61,12 +59,10 @@ layouts would print, and they would appear on one physical sheet of paper. .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 11n -.rt Do not reverse the pages in \fBfile\fR. .RE @@ -116,23 +112,19 @@ without reversing the pages: 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 diff --git a/usr/src/man/man1/ppgsz.1 b/usr/src/man/man1/ppgsz.1 index fcd43b778d..c40589f026 100644 --- a/usr/src/man/man1/ppgsz.1 +++ b/usr/src/man/man1/ppgsz.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 ppgsz 1 "23 Jan 2003" "SunOS 5.11" "User Commands" +.TH PPGSZ 1 "Jan 23, 2003" .SH NAME ppgsz \- set preferred page size for stack, heap, and/or other anonymous segments @@ -26,12 +26,10 @@ process(es) while changing the page size. See \fBmemcntl\fR(2). The following options are supported: .sp .ne 2 -.mk .na \fB\fB-F\fR\fR .ad .RS 22n -.rt Force. Sets the preferred page size options(s) for target process(es) even if controlled by other process(es). Caution should be exercised when using the \fB-F\fR flag. See \fBproc\fR(1). @@ -39,21 +37,17 @@ controlled by other process(es). Caution should be exercised when using the .sp .ne 2 -.mk .na \fB\fB-o\fR \fIoption\fR[,\fIoption\fR]\fR .ad .RS 22n -.rt The \fIoption\fRs are: .sp .ne 2 -.mk .na \fB\fBheap\fR=\fIsize\fR\fR .ad .RS 14n -.rt This option specifies the preferred page size for the heap of the target process(es). \fBheap\fR is defined to be the bss (uninitialized data) and the brk area that immediately follows the bss (see \fBbrk\fR(2)). The preferred @@ -63,12 +57,10 @@ allocated in the future. See NOTES. .sp .ne 2 -.mk .na \fB\fBstack\fR=\fIsize\fR\fR .ad .RS 14n -.rt This option specifies the preferred page size for the stack of the target process(es). The preferred stack page size is set for the existing stack and newly allocated parts of the stack as it expands. @@ -76,12 +68,10 @@ newly allocated parts of the stack as it expands. .sp .ne 2 -.mk .na \fB\fBanon\fR=\fIsize\fR\fR .ad .RS 14n -.rt This option specifies the preferred page size for all existing \fBMAP_PRIVATE\fR anonymous segments of the target process(es), other than \fBheap\fR and \fBstack\fR, which are large enough to fit at least one aligned @@ -111,12 +101,10 @@ Terabytes, respectively. \fB4194304\fR, \fB0x400000\fR, \fB4096K\fR, .sp .ne 2 -.mk .na \fB\fB-p\fR \fIpid\fR\fR .ad .RS 22n -.rt Sets the preferred page size option(s) for the target process(es) in the process-id (\fIpid\fR) list following the \fB-p\fR option. The pid list can also consist of names in the \fB/proc\fR directory. Only the process owner or @@ -174,70 +162,58 @@ exit status of \fBppgsz\fR will be the exit status of \fIcmd\fR. Otherwise, \fBppgsz\fR will exit with one of the following values: .sp .ne 2 -.mk .na \fB\fB0\fR \fR .ad .RS 7n -.rt Successfully set preferred page size(s) for processes in the pid list. .RE .sp .ne 2 -.mk .na \fB\fB125\fR\fR .ad .RS 7n -.rt -An error occurred in \fBppgsz\fR. Errors include: invalid argument, invalid +An error occurred in \fBppgsz\fR. Errors include: invalid argument, invalid page size(s) specified, and failure to set preferred page size(s) for one or more processes in the pid list or \fIcmd\fR. .RE .sp .ne 2 -.mk .na \fB\fB126\fR\fR .ad .RS 7n -.rt \fIcmd\fR was found but could not be invoked. .RE .sp .ne 2 -.mk .na \fB\fB127\fR\fR .ad .RS 7n -.rt \fIcmd\fR could not be found. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB/proc/*\fR \fR .ad .RS 29n -.rt Process files. .RE .sp .ne 2 -.mk .na \fB\fB/usr/lib/ld/map.bssalign\fR \fR .ad .RS 29n -.rt A template link-editor \fBmapfile\fR for aligning bss (see NOTES). .RE @@ -249,13 +225,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityEvolving +Interface Stability Evolving .TE .SH SEE ALSO diff --git a/usr/src/man/man1/ppriv.1 b/usr/src/man/man1/ppriv.1 index 0090f4d81d..f565d90d38 100644 --- a/usr/src/man/man1/ppriv.1 +++ b/usr/src/man/man1/ppriv.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 ppriv 1 "24 Feb 2008" "SunOS 5.11" "User Commands" +.TH PPRIV 1 "Feb 24, 2008" .SH NAME ppriv \- inspect or modify process privilege sets and attributes .SH SYNOPSIS @@ -14,7 +14,7 @@ ppriv \- inspect or modify process privilege sets and attributes .LP .nf -\fB/usr/bin/ppriv\fR [\fB-v\fR] [\fB-S\fR] [\fB-D\fR | \fB-N\fR] [\fB-s\fR \fIspec\fR] +\fB/usr/bin/ppriv\fR [\fB-v\fR] [\fB-S\fR] [\fB-D\fR | \fB-N\fR] [\fB-s\fR \fIspec\fR] [\fIpid\fR | \fIcore\fR]... .fi @@ -43,46 +43,38 @@ specified privileges or privileges set specifications. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-D\fR\fR .ad .RS 11n -.rt Turns on privilege debugging for the processes or command supplied. .RE .sp .ne 2 -.mk .na \fB\fB-e\fR\fR .ad .RS 11n -.rt Interprets the remainder of the arguments as a command line and runs the command line with specified privilege attributes and sets. .RE .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 11n -.rt Lists all currently defined privileges on stdout. .RE .sp .ne 2 -.mk .na \fB\fB-M\fR\fR .ad .RS 11n -.rt When a system is configured with Trusted Extensions, this option turns on the \fBNET_MAC_AWARE\fR and \fBNET_MAC_AWARE_INHERIT\fR process attributes. .sp @@ -92,34 +84,28 @@ communicate with lower-level remote peers. .sp .ne 2 -.mk .na \fB\fB-N\fR\fR .ad .RS 11n -.rt Turns off privilege debugging for the processes or command supplied. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR \fIspec\fR\fR .ad .RS 11n -.rt Modifies a process's privilege sets according to \fIspec\fR, a specification with the format \fB[AEILP][+-=]\fR\fIprivsetspec\fR, containing no spaces, where: .sp .ne 2 -.mk .na \fB\fBAEILP\fR\fR .ad .RS 15n -.rt Indicates one or more letters indicating which privilege sets to change. These are case insensitive, for example, either \fBa\fR or \fBA\fR indicates all privilege sets. @@ -127,24 +113,20 @@ privilege sets. .sp .ne 2 -.mk .na \fB\fB+-=\fR\fR .ad .RS 15n -.rt Indicates a modifier to respectively add (\fB+\fR), remove (\fB-\fR), or assign (\fB=\fR) the listed privileges to the specified set(s) in \fIprivsetspec\fR. .RE .sp .ne 2 -.mk .na \fB\fIprivsetspec\fR\fR .ad .RS 15n -.rt Indicates a comma-separated privilege set specification (\fBpriv1\fR,\fBpriv2\fR, and so on), as described in \fBpriv_str_to_set\fR(3C). @@ -158,24 +140,20 @@ are mutually exclusive. .sp .ne 2 -.mk .na \fB\fB-S\fR\fR .ad .RS 11n -.rt Short. Reports the shortest possible output strings for sets. The default is portable output. See \fBpriv_str_to_set\fR(3C). .RE .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 11n -.rt Verbose. Reports privilege sets using privilege names. .RE @@ -235,7 +213,7 @@ effective set. .sp .in +2 .nf -example$ \fBppriv -s EI-proc_session $$\fR +example$ \fBppriv -s EI-proc_session $$\fR .fi .in -2 .sp @@ -341,46 +319,38 @@ See \fBsetpflags\fR(2) for explanations of the flags. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 12n -.rt Successful operation. .RE .sp .ne 2 -.mk .na \fBnon-zero\fR .ad .RS 12n -.rt An error has occurred. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB/proc/*\fR\fR .ad .RS 23n -.rt Process files .RE .sp .ne 2 -.mk .na \fB\fB/etc/name_to_sysnum\fR\fR .ad .RS 23n -.rt system call name to number mapping .RE @@ -392,13 +362,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilitySee below. +Interface Stability See below. .TE .sp diff --git a/usr/src/man/man1/pr.1 b/usr/src/man/man1/pr.1 index 9b955e68b6..5d871aaa60 100644 --- a/usr/src/man/man1/pr.1 +++ b/usr/src/man/man1/pr.1 @@ -2,30 +2,30 @@ .\" Copyright (c) 1992, X/Open Company Limited All Rights Reserved .\" Copyright 1989 AT&T .\" Portions Copyright (c) 1995, Sun Microsystems, Inc. All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 pr 1 "18 Mar 1997" "SunOS 5.11" "User Commands" +.TH PR 1 "Mar 18, 1997" .SH NAME pr \- print files .SH SYNOPSIS .LP .nf -\fB/usr/bin/pr\fR [+ \fIpage\fR] [\fB-column\fR] [\fB-adFmrt\fR] [\fB-e\fR [\fIchar\fR] [\fIgap\fR]] - [\fB-h\fR \fIheader\fR] [\fB-i\fR [\fIchar\fR] [\fIgap\fR]] [\fB-l\fR \fIlines\fR] - [\fB-n\fR [\fIchar\fR] [\fIwidth\fR]] [\fB-o\fR \fIoffset\fR] [\fB-s\fR [\fIchar\fR]] +\fB/usr/bin/pr\fR [+ \fIpage\fR] [\fB-column\fR] [\fB-adFmrt\fR] [\fB-e\fR [\fIchar\fR] [\fIgap\fR]] + [\fB-h\fR \fIheader\fR] [\fB-i\fR [\fIchar\fR] [\fIgap\fR]] [\fB-l\fR \fIlines\fR] + [\fB-n\fR [\fIchar\fR] [\fIwidth\fR]] [\fB-o\fR \fIoffset\fR] [\fB-s\fR [\fIchar\fR]] [\fB-w\fR \fIwidth\fR] [\fB-fp\fR] [\fIfile\fR]... .fi .LP .nf -\fB/usr/xpg4/bin/pr\fR [+ \fIpage\fR] [\fB-column\fR | \fB-c\fR \fIcolumn\fR] [\fB-adFmrt\fR] - [\fB-e\fR [\fIchar\fR] [\fIgap\fR]] [\fB-h\fR \fIheader\fR] [\fB-i\fR [\fIchar\fR] [\fIgap\fR]] - [\fB-l\fR \fIlines\fR] [\fB-n\fR [\fIchar\fR] [\fIwidth\fR]] [\fB-o\fR \fIoffset\fR] +\fB/usr/xpg4/bin/pr\fR [+ \fIpage\fR] [\fB-column\fR | \fB-c\fR \fIcolumn\fR] [\fB-adFmrt\fR] + [\fB-e\fR [\fIchar\fR] [\fIgap\fR]] [\fB-h\fR \fIheader\fR] [\fB-i\fR [\fIchar\fR] [\fIgap\fR]] + [\fB-l\fR \fIlines\fR] [\fB-n\fR [\fIchar\fR] [\fIwidth\fR]] [\fB-o\fR \fIoffset\fR] [\fB-s\fR [\fIchar\fR]] [\fB-w\fR \fIwidth\fR] [\fB-fp\fR] [\fIfile\fR]... .fi @@ -76,23 +76,19 @@ The following options are supported for both \fB/usr/bin/pr\fR and \fB/usr/xpg4/bin/pr\fR: .sp .ne 2 -.mk .na \fB\fB+\fR\fIpage\fR\fR .ad .RS 29n -.rt Begins output at page number \fIpage\fR of the formatted input. .RE .sp .ne 2 -.mk .na \fB\fB-\fR\fIcolumn\fR\fR .ad .RS 29n -.rt Produces multi-column output that is arranged in \fIcolumn\fR columns (default is \fB1\fR) and is written down each column in the order in which the text is received from the input file. This option should not be used with \fB-m\fR. The @@ -105,12 +101,10 @@ to write the output. .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 29n -.rt Modifies the effect of the \fB-\fR\fIcolumn\fR option so that the columns are filled across the page in a round-robin order (for example, when \fIcolumn\fR is 2, the first input line heads column 1, the second heads column 2, the third @@ -119,24 +113,20 @@ is the second line in column 1, and so forth). .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad .RS 29n -.rt Produces output that is double-spaced; append an extra \fBNEWLINE\fR character following every \fBNEWLINE\fR character found in the input. .RE .sp .ne 2 -.mk .na \fB\fB\fR\fB-e\fR\fB\|[\|\fR\fIchar\fR\fB\|][\|\fR\fIgap\fR\fB\|]\fR\fR .ad .RS 29n -.rt Expands each input \fBTAB\fR character to the next greater column position specified by the formula \fIn\fR \fI*gap+1\fR, where \fIn\fR is an integer \fB>0\fR. If \fIgap\fR is \fB0\fR or is omitted, it defaults to \fB8\fR. All @@ -147,12 +137,10 @@ specified, it will be used as the input tab character. .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 29n -.rt Uses a \fBFORMFEED\fR character for new pages, instead of the default behavior that uses a sequence of \fBNEWLINE\fR characters. Pauses before beginning the first page if the standard output is associated with a terminal. @@ -160,24 +148,20 @@ first page if the standard output is associated with a terminal. .sp .ne 2 -.mk .na \fB\fB-h\fR \fIheader\fR\fR .ad .RS 29n -.rt Uses the string \fIheader\fR to replace the contents of the \fIfile\fR operand in the page header. .RE .sp .ne 2 -.mk .na \fB\fB-l\fR \fIlines\fR\fR .ad .RS 29n -.rt Overrides the 66-line default and reset the page length to \fIlines\fR. If \fIlines\fR is not greater than the sum of both the header and trailer depths (in lines), \fBpr\fR will suppress both the header and trailer, as if the @@ -186,12 +170,10 @@ Overrides the 66-line default and reset the page length to \fIlines\fR. If .sp .ne 2 -.mk .na \fB\fB-m\fR\fR .ad .RS 29n -.rt Merges files. Standard output will be formatted so \fBpr\fR writes one line from each file specified by \fIfile\fR, side by side into text columns of equal fixed widths, in terms of the number of column positions. Implementations @@ -200,12 +182,10 @@ support merging of at least nine \fIfile\fRs. .sp .ne 2 -.mk .na \fB\fB-n\|[\|\fR\fIchar\fR\fB\|][\|\fR\fIwidth\fR\fB\|]\fR\fR .ad .RS 29n -.rt Provides \fIwidth\fR-digit line numbering (default for \fIwidth\fR is \fB5\fR). The number will occupy the first \fIwidth\fR column positions of each text column of default output or each line of \fB-m\fR output. If \fIchar\fR (any @@ -216,12 +196,10 @@ character). .sp .ne 2 -.mk .na \fB\fB-o\fR \fIoffset\fR\fR .ad .RS 29n -.rt Each line of output will be preceded by offset <space>s. If the \fB-o\fR option is not specified, the default offset is \fB0\fR. The space taken will be in addition to the output line width (see \fB-w\fR option below). @@ -229,12 +207,10 @@ addition to the output line width (see \fB-w\fR option below). .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 29n -.rt Pauses before beginning each page if the standard output is directed to a terminal (\fBpr\fR will write an \fBALERT\fR character to standard error and wait for a carriage-return character to be read on \fB/dev/tty\fR). @@ -242,23 +218,19 @@ wait for a carriage-return character to be read on \fB/dev/tty\fR). .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 29n -.rt Writes no diagnostic reports on failure to open files. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR \fB[\fR\fIchar\fR\fB]\fR\fR .ad .RS 29n -.rt Separates text columns by the single character \fIchar\fR instead of by the appropriate number of \fBSPACE\fR characters (default for \fIchar\fR is the \fBTAB\fR character). @@ -266,12 +238,10 @@ appropriate number of \fBSPACE\fR characters (default for \fIchar\fR is the .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad .RS 29n -.rt Writes neither the five-line identifying header nor the five-line trailer usually supplied for each page. Quits writing after the last line of each file without spacing to the end of the page. @@ -279,12 +249,10 @@ without spacing to the end of the page. .sp .ne 2 -.mk .na \fB\fB-w\fR \fIwidth\fR\fR .ad .RS 29n -.rt Sets the width of the line to \fIwidth\fR column positions for multiple text-column output only. If the \fB-w\fR option is not specified and the \fB-s\fR option is not specified, the default width is \fB72\fR. If the @@ -300,12 +268,10 @@ For single column output, input lines will not be truncated. The following options are supported for \fB/usr/bin/pr\fR only: .sp .ne 2 -.mk .na \fB\fB-F\fR\fR .ad .RS 27n -.rt Folds the lines of the input file. When used in multi-column mode (with the \fB-a\fR or \fB-m\fR options), lines will be folded to fit the current column's width. Otherwise, they will be folded to fit the current line width (80 @@ -314,12 +280,10 @@ columns). .sp .ne 2 -.mk .na \fB\fB\fR\fB-i\fR\fB\|[\|\fR\fIchar\fR\fB\|][\|\fR\fIgap\fR\fB\|]\fR\fR .ad .RS 27n -.rt In output, replaces \fBSPACE\fR characters with \fBTAB\fR characters wherever one or more adjacent \fBSPACE\fR characters reach column positions \fIgap+1\fR, \fI2*gap+1\fR, \fI3*gap+1\fR, and so forth. If \fIgap\fR is \fB0\fR or is @@ -334,24 +298,20 @@ as the output \fBTAB\fR character. The following options are supported for \fB/usr/xpg4/bin/pr\fR only: .sp .ne 2 -.mk .na \fB\fB-F\fR\fR .ad .RS 27n -.rt Uses a \fBFORMFEED\fR character for new pages, instead of the default behavior that uses a sequence of \fBNEWLINE\fR characters. .RE .sp .ne 2 -.mk .na \fB\fB\fR\fB-i\fR\fB\|[\|\fR\fIchar\fR\fB\|][\|\fR\fIgap\fR\fB\|]\fR\fR .ad .RS 27n -.rt In output, replaces multiple \fBSPACE\fR characters with \fBTAB\fR characters wherever two or more adjacent \fBSPACE\fR characters reach column positions \fIgap+1\fR, \fI2*gap+1\fR, \fI3*gap+1\fR, and so forth. If \fIgap\fR is @@ -366,12 +326,10 @@ will be used as the output \fBTAB\fR character. The following operand is supported: .sp .ne 2 -.mk .na \fB\fIfile\fR\fR .ad .RS 8n -.rt A path name of a file to be written. If no \fIfile\fR operands are specified, or if a \fIfile\fR operand is \fB\(mi\fR, the standard input will be used. .RE @@ -429,23 +387,19 @@ that affect the execution of \fBpr\fR: \fBLANG\fR, \fBLC_ALL\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -458,13 +412,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled .TE .SS "/usr/xpg4/bin/pr" @@ -472,17 +425,16 @@ CSIEnabled .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityCommitted +Interface Stability Committed _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .SH SEE ALSO diff --git a/usr/src/man/man1/praliases.1 b/usr/src/man/man1/praliases.1 index 15e72e0152..cd28e5966a 100644 --- a/usr/src/man/man1/praliases.1 +++ b/usr/src/man/man1/praliases.1 @@ -10,20 +10,20 @@ .\" Copyright (c) 1998-2006, 2008 Sendmail, Inc. and its suppliers. All rights reserved. .\" The following license terms and conditions apply, unless a different license is obtained from Sendmail, Inc., 6425 Christie Ave, Fourth Floor, Emeryville, CA 94608, USA, or by electronic mail at license@sendmail.com. License Terms: Use, Modification and Redistribution .\" (including distribution of any modified or derived work) in source and binary forms is permitted only if each of the following conditions is met: 1. Redistributions qualify as "freeware" or "Open Source Software" under one of the following terms: (a) Redistributions are made at no charge -.\" beyond the reasonable cost of materials and delivery. (b) Redistributions are accompanied by a copy of the Source Code or by an irrevocable offer to provide a copy of the Source Code for up to three years at the cost of materials and delivery. Such redistributions +.\" beyond the reasonable cost of materials and delivery. (b) Redistributions are accompanied by a copy of the Source Code or by an irrevocable offer to provide a copy of the Source Code for up to three years at the cost of materials and delivery. Such redistributions .\" must allow further use, modification, and redistribution of the Source Code under substantially the same terms as this license. For the purposes of redistribution "Source Code" means the complete compilable and linkable source code of sendmail including all modifications. .\" 2. Redistributions of source code must retain the copyright notices as they appear in each source code file, these license terms, and the disclaimer/limitation of liability set forth as paragraph 6 below. 3. Redistributions in binary form must reproduce the Copyright Notice, these license .\" terms, and the disclaimer/limitation of liability set forth as paragraph 6 below, in the documentation and/or other materials provided with the distribution. For the purposes of binary distribution the "Copyright Notice" refers to the following language: "Copyright (c) 1998-2004 Sendmail, .\" Inc. All rights reserved." 4. Neither the name of Sendmail, Inc. nor the University of California nor the names of their contributors may be used to endorse or promote products derived from this software without specific prior written permission. The name "sendmail" is a trademark .\" of Sendmail, Inc. 5. All redistributions must comply with the conditions imposed by the University of California on certain embedded code, whose copyright notice and conditions for redistribution are as follows: (a) Copyright (c) 1988, 1993 The Regents of the University of California. .\" All rights reserved. (b) Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: (i) Redistributions of source code must retain the above copyright notice, this list of -.\" conditions and the following disclaimer. (ii) Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. +.\" conditions and the following disclaimer. (ii) Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. .\" (iii) Neither the name of the University nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. 6. Disclaimer/Limitation of Liability: THIS SOFTWARE IS PROVIDED BY SENDMAIL, .\" INC. AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SENDMAIL, INC., THE REGENTS OF THE UNIVERSITY OF CALIFORNIA OR CONTRIBUTORS .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER .\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. .\" Copyright (c) 2009, Sun Microsystems, Inc. All Rights Reserved -.TH praliases 1 "29 Mar 2004" "SunOS 5.11" "User Commands" +.TH PRALIASES 1 "Mar 29, 2004" .SH NAME praliases \- display system mail aliases .SH SYNOPSIS @@ -45,23 +45,19 @@ is looked up and the appropriate \fBkey:value\fR is displayed if found. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-C\fR \fIconfigfile\fR\fR .ad .RS 17n -.rt Specifies a \fBsendmail\fR configuration file. .RE .sp .ne 2 -.mk .na \fB\fB-f\fR \fIaliasfile\fR\fR .ad .RS 17n -.rt Reads the specified file \fIaliasfile\fR instead of the default \fBsendmail\fR system aliases file. .RE @@ -72,12 +68,10 @@ system aliases file. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIkey\fR\fR .ad .RS 7n -.rt A specific alias key to look up. .RE @@ -87,52 +81,43 @@ A specific alias key to look up. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful operation. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB/etc/mail/aliases\fR\fR .ad .RS 25n -.rt Default \fBsendmail\fR system aliases file .RE .sp .ne 2 -.mk .na \fB\fB/etc/mail/aliases.db\fR\fR .ad .RS 25n -.rt Database versions of the \fB/etc/mail/aliases\fR file .RE .sp .ne 2 -.mk .na \fB\fB/etc/mail/aliases.dir\fR\fR .ad @@ -141,18 +126,15 @@ Database versions of the \fB/etc/mail/aliases\fR file \fB\fB/etc/mail/aliases.pag\fR\fR .ad .RS 25n -.rt Database versions of the \fB/etc/mail/aliases\fR file .RE .sp .ne 2 -.mk .na \fB\fB/etc/mail/sendmail.cf\fR\fR .ad .RS 25n -.rt Default \fBsendmail\fR configuration file .RE diff --git a/usr/src/man/man1/prctl.1 b/usr/src/man/man1/prctl.1 index e79a71ace5..18c3fc5066 100644 --- a/usr/src/man/man1/prctl.1 +++ b/usr/src/man/man1/prctl.1 @@ -3,15 +3,15 @@ .\" 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 prctl 1 "25 Aug 2009" "SunOS 5.11" "User Commands" +.TH PRCTL 1 "Aug 25, 2009" .SH NAME prctl \- get or set the resource controls of running processes, tasks, and projects .SH SYNOPSIS .LP .nf -\fBprctl\fR [\fB-P\fR] [\fB-t\fR [basic | privileged | system]] - [\fB-n\fR \fIname\fR [\fB-srx\fR] [\fB-v\fR \fIvalue\fR] [\fB-e\fR | \fB-d\fR \fIaction\fR] [\fB-p\fR \fIpid\fR]] +\fBprctl\fR [\fB-P\fR] [\fB-t\fR [basic | privileged | system]] + [\fB-n\fR \fIname\fR [\fB-srx\fR] [\fB-v\fR \fIvalue\fR] [\fB-e\fR | \fB-d\fR \fIaction\fR] [\fB-p\fR \fIpid\fR]] [\fB-i\fR \fIidtype\fR] \fIid\fR... .fi @@ -37,7 +37,6 @@ it is considered a modify operation. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-d\fR | \fB-e\fR \fIaction\fR\fR .ad @@ -54,24 +53,20 @@ is added as if \fB-s\fR were specified. \fBActions:\fR .sp .ne 2 -.mk .na \fB\fBall\fR\fR .ad .RS 17n -.rt This action is only available with \fB-d\fR. It disables all actions. This fails on resource control values that have the \fBdeny\fR global flag. .RE .sp .ne 2 -.mk .na \fB\fBdeny\fR\fR .ad .RS 17n -.rt Indicates that the resource control attempts to deny granting the resource to the process, task, project, or zone on a request for resources in excess of the resource control value. \fBdeny\fR actions can not be enabled if the resource @@ -81,24 +76,20 @@ disabled if the resource control has the \fBdeny\fR global flag. .sp .ne 2 -.mk .na \fB\fBsignal\fR\fR .ad .RS 17n -.rt This action is only available with \fB-d\fR. It deactivates the \fBsignal\fR action. .RE .sp .ne 2 -.mk .na \fB\fBsignal\fR=\fIsignum\fR\fR .ad .RS 17n -.rt In the \fBsignal=\fR\fIsignum\fR action, \fIsignum\fR is a signal number (or string representation of a signal). Setting a \fBsignal\fR action on a resource control with the \fBno-local-action\fR global flag fails. A limited set of @@ -109,7 +100,6 @@ signals can be sent. See \fBNOTES\fR for additional details. .sp .ne 2 -.mk .na \fB\fB-i\fR \fIidtype\fR\fR .ad @@ -133,7 +123,6 @@ project and zone to which that task is a member. .sp .ne 2 -.mk .na \fB\fB-n\fR \fIname\fR\fR .ad @@ -145,7 +134,6 @@ unspecified, all resource controls are retrieved. .sp .ne 2 -.mk .na \fB\fB-p\fR \fIpid\fR\fR .ad @@ -160,7 +148,6 @@ controls on a task, project, or zone, the \fB-p\fR option is required if the .sp .ne 2 -.mk .na \fB\fB-P\fR\fR .ad @@ -171,7 +158,6 @@ Display resource control values in space delimited format. .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad @@ -183,7 +169,6 @@ Replaces the first resource control value (matching with the \fB-t\fR .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad @@ -208,7 +193,6 @@ value. .sp .ne 2 -.mk .na \fB\fB-t\fR [ \fBbasic\fR | \fBprivileged\fR | \fBsystem\fR ]\fR .ad @@ -225,7 +209,6 @@ including \fBsystem\fR, are displayed if no type is specified. .sp .ne 2 -.mk .na \fB\fB-v\fR \fIvalue\fR\fR .ad @@ -243,7 +226,6 @@ value. .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad @@ -265,12 +247,10 @@ the invocation is considered a get operation. The following operand is supported: .sp .ne 2 -.mk .na \fB\fIid\fR\fR .ad .RS 6n -.rt The \fBID\fR of the entity (\fBprocess\fR, \fBtask\fR, \fBproject\fR, or \fBzone\fR) to interrogate. If the invoking user's credentials are unprivileged and the entity being interrogated possesses different credentials, the @@ -526,46 +506,38 @@ The cap can be lowered to 50% using: The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt Success. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt Fatal error encountered. .RE .sp .ne 2 -.mk .na \fB\fB2\fR\fR .ad .RS 5n -.rt Invalid command line options were specified. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB/proc/pid/*\fR\fR .ad .RS 15n -.rt Process information and control files .RE @@ -577,13 +549,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilitySee below. +Interface Stability See below. .TE .sp diff --git a/usr/src/man/man1/preap.1 b/usr/src/man/man1/preap.1 index 3bd075a612..edef258226 100644 --- a/usr/src/man/man1/preap.1 +++ b/usr/src/man/man1/preap.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 preap 1 "19 Jun 2006" "SunOS 5.11" "User Commands" +.TH PREAP 1 "Jun 19, 2006" .SH NAME preap \- force a defunct process to be reaped by its parent .SH SYNOPSIS @@ -62,12 +62,10 @@ The process has been defunct for less than one minute. The following option is supported: .sp .ne 2 -.mk .na \fB\fB-F\fR\fR .ad .RS 6n -.rt Forces the parent to reap the child, overriding safety checks. .RE @@ -77,12 +75,10 @@ Forces the parent to reap the child, overriding safety checks. The following operand is supported: .sp .ne 2 -.mk .na \fB\fIpid\fR\fR .ad .RS 7n -.rt Process \fBID\fR list. .RE @@ -101,23 +97,19 @@ The following exit values are returned by \fBpreap\fR, which prints the exit status of each target process reaped: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 12n -.rt Successfully operation. .RE .sp .ne 2 -.mk .na \fBnon-zero\fR .ad .RS 12n -.rt Failure, such as no such process, permission denied, or invalid option. .RE diff --git a/usr/src/man/man1/prex.1 b/usr/src/man/man1/prex.1 index 755ab555c5..ee598efd43 100644 --- a/usr/src/man/man1/prex.1 +++ b/usr/src/man/man1/prex.1 @@ -3,13 +3,13 @@ .\" 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 prex 1 "1 Mar 2004" "SunOS 5.11" "User Commands" +.TH PREX 1 "Mar 1, 2004" .SH NAME prex \- control tracing and manipulate probe points in a process or the kernel .SH SYNOPSIS .LP .nf -\fBprex\fR [\fB-o\fR \fItrace_file_name\fR] [\fB-l\fR \fIlibraries\fR] [\fB-s\fR \fIkbytes_size\fR] \fIcmd\fR +\fBprex\fR [\fB-o\fR \fItrace_file_name\fR] [\fB-l\fR \fIlibraries\fR] [\fB-s\fR \fIkbytes_size\fR] \fIcmd\fR [\fIcmd-args\fR]... .fi @@ -116,17 +116,15 @@ The "\fB#\fR" character implies that the rest of the line is a comment. .sp .TS -tab(); -cw(2.75i) cw(2.75i) -lw(2.75i) lw(2.75i) -. -CommandResult +c c +l l . +Command Result _ -% \fBprex a.out\fRT{ +% \fBprex a.out\fR T{ Attaches \fBprex\fR to your program and starts \fBprex\fR. T} -prex> \fBenable $all\fREnables all the probes. -prex> \fBquit resume\fRT{ +prex> \fBenable $all\fR Enables all the probes. +prex> \fBquit resume\fR T{ Quits \fBprex\fR and resumes execution of program. T} .TE @@ -181,12 +179,10 @@ Program\fR below for more information on signals and the target process. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-k\fR\fR .ad .RS 22n -.rt \fBkernel mode\fR: \fBprex\fR is used to control probes in the Solaris kernel. In kernel mode, additional commands are defined, and some commands valid in other modes are invalid. See \fBKernel Mode\fR below. @@ -194,12 +190,10 @@ other modes are invalid. See \fBKernel Mode\fR below. .sp .ne 2 -.mk .na \fB\fB-l\fR \fIlibraries\fR\fR .ad .RS 22n -.rt The \fIlibraries\fR mentioned are linked in to the target application using \fBLD_PRELOAD\fR (see \fBld\fR(1)). This option cannot be used when attaching to a running process. The argument to the \fB-l\fR option should be a @@ -210,12 +204,10 @@ specified and where they will be found. .sp .ne 2 -.mk .na \fB\fB-o\fR \fItrace_file_name\fR\fR .ad .RS 22n -.rt File to be used for the trace output. \fItrace_file_name\fR is assumed to be relative to the current working directory of \fBprex\fR (that is, the directory that the user was in when \fBprex\fR was started). @@ -229,12 +221,10 @@ program. If \fBTMPDIR\fR is not set, \fB/tmp\fR is used. .sp .ne 2 -.mk .na \fB\fB-s\fR \fIkbytes_size\fR\fR .ad .RS 22n -.rt Maximum size of the output trace file in Kbytes. The default size of the trace \fIkbytes_size\fR is \fB4096\fR (2^10) bytes or \fB4\fR Mbytes for normal usage, and \fB384\fR or \fB384\fR kbytes in kernel mode. The minimum size that @@ -269,24 +259,20 @@ The \fIattribute\fR or \fIvalue\fR (generically called "spec") can be any of the following: .sp .ne 2 -.mk .na \fB\fBIDENT\fR\fR .ad .RS 14n -.rt Any sequence of letters, digits, _\|, \e\|, ., % not beginning with a digit. \fBIDENT\fR implies an exact match. .RE .sp .ne 2 -.mk .na \fB\fBQUOTED_STR\fR\fR .ad .RS 14n -.rt Usually used to escape reserved words (any commands in the command language). \fBQUOTED_STR\fR implies an exact match and has to be enclosed in single quotes (' '). @@ -294,12 +280,10 @@ Usually used to escape reserved words (any commands in the command language). .sp .ne 2 -.mk .na \fB\fBREGEXP\fR\fR .ad .RS 14n -.rt An \fBed\fR(1) regular expression pattern match. \fBREGEXP\fR has to be enclosed in slashes (/ /), A / can be included in a \fBREGEXP\fR by escaping it with a backslash \e\|. @@ -782,18 +766,15 @@ arguments, \fBpfilter\fR prints the current process filter set and the state of the process filter mode switch: .sp .ne 2 -.mk .na \fB\fBon\fR or \fBoff\fR\fR .ad .RS 18n -.rt set the state of the process filter mode switch. .RE .sp .ne 2 -.mk .na \fB\fBadd\fR \fIpidlist\fR\fR .ad @@ -802,7 +783,6 @@ set the state of the process filter mode switch. \fB\fBdelete\fR \fIpidlist\fR\fR .ad .RS 18n -.rt add or delete processes from the process filter set. \fIpidlist\fR is a comma-separated list of one or more process ids. .RE @@ -891,34 +871,28 @@ ktrace on # turn tracing on .SH FILES .sp .ne 2 -.mk .na \fB\fB\&.prexrc\fR\fR .ad .RS 15n -.rt local \fBprex\fR initialization file .RE .sp .ne 2 -.mk .na \fB\fB~/.prexrc\fR\fR .ad .RS 15n -.rt user's \fBprex\fR initialization file .RE .sp .ne 2 -.mk .na \fB\fB/proc/\fInnnnn\fR\fR\fR .ad .RS 15n -.rt process files .RE diff --git a/usr/src/man/man1/print.1 b/usr/src/man/man1/print.1 index 294fce44b4..3aefc897c8 100644 --- a/usr/src/man/man1/print.1 +++ b/usr/src/man/man1/print.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 print 1 "27 Mar 2008" "SunOS 5.11" "User Commands" +.TH PRINT 1 "Mar 27, 2008" .SH NAME print \- shell built-in function to output characters to the screen or window .SH SYNOPSIS @@ -40,112 +40,92 @@ Unless, the \fB-r\fR, \fB-R\fR, or \fB-f\fR option is speciifed, each \fB\e\fR character in each string operand is processed specially as follows: .sp .ne 2 -.mk .na \fB\fB\ea\fR\fR .ad .RS 8n -.rt Alert character. .RE .sp .ne 2 -.mk .na \fB\fB\eb\fR\fR .ad .RS 8n -.rt Backspace character. .RE .sp .ne 2 -.mk .na \fB\fB\ec\fR\fR .ad .RS 8n -.rt Terminate output without appending NEWLINE. The remaining string operands are ignored. .RE .sp .ne 2 -.mk .na \fB\fB\eE\fR\fR .ad .RS 8n -.rt Escape character (\fBASCII\fR octal \fB033\fR). .RE .sp .ne 2 -.mk .na \fB\fB\ef\fR\fR .ad .RS 8n -.rt FORM FEED character. .RE .sp .ne 2 -.mk .na \fB\fB\en\fR\fR .ad .RS 8n -.rt NEWLINE character. .RE .sp .ne 2 -.mk .na \fB\fB\et\fR\fR .ad .RS 8n -.rt Tab character. .RE .sp .ne 2 -.mk .na \fB\fB\ev\fR\fR .ad .RS 8n -.rt Vertical tab character. .RE .sp .ne 2 -.mk .na \fB\fB\e\e\fR\fR .ad .RS 8n -.rt Backslash character. .RE .sp .ne 2 -.mk .na \fB\fB\e0\fR\fIx\fR\fR .ad .RS 8n -.rt The 8-bit character whose \fBASCII\fR code is the \fB1\fR-, \fB2\fR-, or \fB3\fR-digit octal number \fIx\fR. .RE @@ -157,59 +137,49 @@ The 8-bit character whose \fBASCII\fR code is the \fB1\fR-, \fB2\fR-, or The following options are supported by \fBksh\fR: .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 12n -.rt Suppresses \fBnew-line\fR from being added to the output. .RE .sp .ne 2 -.mk .na \fB\fB-r\fR\fB-R\fR\fR .ad .RS 12n -.rt Raw mode. Ignore the escape conventions of \fBecho\fR. The \fB-R\fR option prints all subsequent arguments and options other than \fB-n\fR. .RE .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 12n -.rt Cause the arguments to be written onto the pipe of the process spawned with \fB|&\fR instead of standard output. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 12n -.rt Cause the arguments to be written onto the history file instead of standard output. .RE .sp .ne 2 -.mk .na \fB\fB-u\fR [ \fIn\fR ]\fR .ad .RS 12n -.rt Specify a one digit file descriptor unit number \fIn\fR on which the output is placed. The default is 1. .RE @@ -220,12 +190,10 @@ placed. The default is 1. The following options are supported by \fBksh93\fR: .sp .ne 2 -.mk .na \fB\fB-e\fR \fI\fR\fR .ad .RS 13n -.rt Unless \fB-f\fR is specified, process \fB\e\fR sequences in each string operand as described above. This is the default behavior. .sp @@ -235,12 +203,10 @@ that is used. .sp .ne 2 -.mk .na \fB\fB-f\fR \fIformat\fR\fR .ad .RS 13n -.rt Write the string arguments using the format string \fIformat\fR and do not append a NEWLINE. See \fBprintf\fR(1) for details on how to specify format. .sp @@ -252,29 +218,24 @@ the first unneeded format specifier. .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 13n -.rt Do not append a NEWLINE character to the output. .RE .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 13n -.rt Write to the current co-process instead of standard output. .RE .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad @@ -283,7 +244,6 @@ Write to the current co-process instead of standard output. \fB\fB-R\fR\fR .ad .RS 13n -.rt Do not process \fB\e\fR sequences in each string operand as described above. .sp If both \fB-e\fR and \fB-r\fR are specified, the last one specified is the one @@ -292,24 +252,20 @@ that is used. .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 13n -.rt Write the output as an entry in the shell history file instead of standard output. .RE .sp .ne 2 -.mk .na \fB\fB-u\fR \fIfd\fR\fR .ad .RS 13n -.rt Write to file descriptor number \fIfd\fR instead of standard output. The default value is \fB1\fR. .RE @@ -320,23 +276,19 @@ default value is \fB1\fR. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt Output file is not open for writing. .RE diff --git a/usr/src/man/man1/printf.1 b/usr/src/man/man1/printf.1 index 6c3cc5b476..1ca18a3274 100644 --- a/usr/src/man/man1/printf.1 +++ b/usr/src/man/man1/printf.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 printf 1 "11 Aug 2009" "SunOS 5.11" "User Commands" +.TH PRINTF 1 "Aug 11, 2009" .SH NAME printf \- write formatted output .SH SYNOPSIS @@ -39,12 +39,10 @@ The \fBprintf\fR utility writes each string operand to standard output using The following operands are supported by \fB/usr/bin/printf\fR: .sp .ne 2 -.mk .na \fB\fIformat\fR\fR .ad .RS 12n -.rt A string describing the format to use to write the remaining operands. The \fIformat\fR operand is used as the \fIformat\fR string described on the \fBformats\fR(5) manual page, with the following exceptions: @@ -141,12 +139,10 @@ specification, the behavior is unspecified. .sp .ne 2 -.mk .na \fB\fIargument\fR\fR .ad .RS 12n -.rt The strings to be written to standard output, under the control of \fBformat\fR. The \fIargument\fR operands are treated as strings if the corresponding conversion character is \fBb\fR, \fBc\fR or \fBs\fR. Otherwise, @@ -180,121 +176,99 @@ The \fIformat\fR operands support the full range of ANSI C/C99/XPG6 formatting specifiers as well as additional specifiers: .sp .ne 2 -.mk .na \fB\fB%b\fR\fR .ad .RS 6n -.rt Each character in the string operand is processed specially, as follows: .sp .ne 2 -.mk .na \fB\fB\ea\fR\fR .ad .RS 8n -.rt Alert character. .RE .sp .ne 2 -.mk .na \fB\fB\eb\fR\fR .ad .RS 8n -.rt Backspace character. .RE .sp .ne 2 -.mk .na \fB\fB\ec\fR\fR .ad .RS 8n -.rt Terminate output without appending NEWLINE. The remaining string operands are ignored. .RE .sp .ne 2 -.mk .na \fB\fB\eE\fR\fR .ad .RS 8n -.rt Escape character (\fBASCII\fR octal \fB033\fR). .RE .sp .ne 2 -.mk .na \fB\fB\ef\fR\fR .ad .RS 8n -.rt FORM FEED character. .RE .sp .ne 2 -.mk .na \fB\fB\en\fR\fR .ad .RS 8n -.rt NEWLINE character. .RE .sp .ne 2 -.mk .na \fB\fB\et\fR\fR .ad .RS 8n -.rt TAB character. .RE .sp .ne 2 -.mk .na \fB\fB\ev\fR\fR .ad .RS 8n -.rt Vertical tab character. .RE .sp .ne 2 -.mk .na \fB\fB\e\e\fR\fR .ad .RS 8n -.rt Backslash character. .RE .sp .ne 2 -.mk .na \fB\fB\e0\fR\fIx\fR\fR .ad .RS 8n -.rt The 8-bit character whose \fBASCII\fR code is the \fB1\fR-, \fB2\fR-, or \fB3\fR-digit octal number \fIx\fR. .RE @@ -303,48 +277,40 @@ The 8-bit character whose \fBASCII\fR code is the \fB1\fR-, \fB2\fR-, or .sp .ne 2 -.mk .na \fB\fB%B\fR\fR .ad .RS 6n -.rt Treat the argument as a variable name and output the value without converting it to a string. This is most useful for variables of type \fB-b\fR. .RE .sp .ne 2 -.mk .na \fB\fB%H\fR\fR .ad .RS 6n -.rt Output string with characters \fB<\fR, \fB&\fR, \fB>\fR, \fB"\fR, and non-printable characters, properly escaped for use in HTML and XML documents. .RE .sp .ne 2 -.mk .na \fB\fB%P\fR\fR .ad .RS 6n -.rt Treat \fIstring\fR as an extended regular expression and convert it to a shell pattern. .RE .sp .ne 2 -.mk .na \fB\fB%q\fR\fR .ad .RS 6n -.rt Output \fIstring\fR quoted in a manner that it can be read in by the shell to get back the same string. However, empty strings resulting from missing string operands are not quoted. @@ -352,24 +318,20 @@ operands are not quoted. .sp .ne 2 -.mk .na \fB\fB%R\fR\fR .ad .RS 6n -.rt Treat \fIstring\fR as an shell pattern expression and convert it to an extended regular expression. .RE .sp .ne 2 -.mk .na \fB\fB%T\fR\fR .ad .RS 6n -.rt Treat \fIstring\fR as a date/time string and format it. The \fBT\fR can be preceded by (\fIdformat\fR), where \fIdformat\fR is a date format as defined by the \fBdate\fR(1) command. @@ -377,12 +339,10 @@ the \fBdate\fR(1) command. .sp .ne 2 -.mk .na \fB\fB%Z\fR\fR .ad .RS 6n -.rt Output a byte whose value is \fB0\fR. .RE @@ -595,15 +555,14 @@ as the \fIformat\fR operand: .sp .TS -tab() box; -cw(1.27i) cw(1.27i) cw(2.96i) -lw(1.27i) lw(1.27i) lw(2.96i) -. -ArgumentsStandardDiagnostic -5a5printf: 5a not completely converted -99999999992147483647printf: 9999999999: Results too large --9999999999-2147483648printf: -9999999999: Results too large -ABC0printf: ABC expected numeric value +box; +c c c +l l l . +Arguments Standard Diagnostic +5a 5 printf: 5a not completely converted +9999999999 2147483647 printf: 9999999999: Results too large +-9999999999 -2147483648 printf: -9999999999: Results too large +ABC 0 printf: ABC expected numeric value .TE .sp @@ -636,20 +595,19 @@ produces: .sp .TS -tab() box; -lw(.5i) lw(5i) -lw(.5i) lw(5i) -. -\fB3\fRNumeric value of constant 3 -\fB3\fRNumeric value of constant 3 -\fB\(mi3\fRNumeric value of constant \(mi3 -\fB51\fRT{ +box; +l l +l l . +\fB3\fR Numeric value of constant 3 +\fB3\fR Numeric value of constant 3 +\fB\(mi3\fR Numeric value of constant \(mi3 +\fB51\fR T{ Numeric value of the character `3' in the ISO/IEC 646:1991 standard codeset T} -\fB43\fRT{ +\fB43\fR T{ Numeric value of the character `+' in the ISO/IEC 646:1991 standard codeset T} -\fB45\fRT{ +\fB45\fR T{ Numeric value of the character `\(mi' in the SO/IEC 646:1991 standard codeset T} .TE @@ -909,23 +867,19 @@ that affect the execution of \fBprintf\fR: \fBLANG\fR, \fBLC_ALL\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -938,17 +892,16 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityCommitted +Interface Stability Committed _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .SS "ksh93" @@ -956,13 +909,12 @@ StandardSee \fBstandards\fR(5). .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityUncommitted +Interface Stability Uncommitted .TE .SH SEE ALSO diff --git a/usr/src/man/man1/priocntl.1 b/usr/src/man/man1/priocntl.1 index 9c9c829de0..fff5514754 100644 --- a/usr/src/man/man1/priocntl.1 +++ b/usr/src/man/man1/priocntl.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 priocntl 1 "1 Apr 2008" "SunOS 5.11" "User Commands" +.TH PRIOCNTL 1 "Apr 1, 2008" .SH NAME priocntl \- display or set scheduling parameters of specified process(es) .SH SYNOPSIS @@ -20,13 +20,13 @@ priocntl \- display or set scheduling parameters of specified process(es) .LP .nf -\fBpriocntl\fR \fB-s\fR [\fB-c\fR \fIclass\fR] [\fIclass-specific\fR \fIoptions\fR] +\fBpriocntl\fR \fB-s\fR [\fB-c\fR \fIclass\fR] [\fIclass-specific\fR \fIoptions\fR] [\fB-i\fR \fIidtype\fR] [\fIidlist\fR] .fi .LP .nf -\fBpriocntl\fR \fB-e\fR [\fB-c\fR \fIclass\fR] [\fIclass-specific\fR \fIoptions\fR] \fIcommand\fR +\fBpriocntl\fR \fB-e\fR [\fB-c\fR \fIclass\fR] [\fIclass-specific\fR \fIoptions\fR] \fIcommand\fR [\fIargument(s)\fR] .fi @@ -176,12 +176,10 @@ the user's current class. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-c\fR \fIclass\fR\fR .ad .RS 13n -.rt Specifies the \fIclass\fR to be set. (The valid \fIclass\fR arguments are \fBRT\fR for real-time, \fBTS\fR for time-sharing, \fBIA\fR for inter-active, \fBFSS\fR for fair-share, or \fBFX\fR for fixed-priority.) If the specified @@ -190,35 +188,29 @@ class is not already configured, it is automatically configured. .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad .RS 13n -.rt Displays the scheduling parameters associated with a set of processes. .RE .sp .ne 2 -.mk .na \fB\fB-e\fR\fR .ad .RS 13n -.rt Executes a specified command with the class and scheduling parameters associated with a set of processes. .RE .sp .ne 2 -.mk .na \fB\fB-i\fR \fIidtype\fR\fR .ad .RS 13n -.rt This option, together with the \fIidlist\fR arguments (if any), specifies one or more processes to which the \fBpriocntl\fR command is to apply. The interpretation of \fIidlist\fR depends on the value of \fIidtype\fR. If the @@ -229,12 +221,10 @@ The valid \fIidtype\fR arguments and corresponding interpretations of \fIidlist\fR are as follows: .sp .ne 2 -.mk .na \fB\fB-i\fR \fBall\fR\fR .ad .RS 13n -.rt The \fBpriocntl\fR command applies to all existing processes. No \fIidlist\fR should be specified (if one is specified, it is ignored). The permission restrictions described below still apply. @@ -242,24 +232,20 @@ restrictions described below still apply. .sp .ne 2 -.mk .na \fB\fB-i\fR \fBctid\fR\fR .ad .RS 13n -.rt idlist is a list of process contract IDs. The \fBpriocntl\fR command applies to all processes with a process contract ID equal to an ID from the list. .RE .sp .ne 2 -.mk .na \fB\fB-i\fR \fBclass\fR\fR .ad .RS 13n -.rt \fIidlist\fR consists of a single class name (\fBRT\fR for real-time, \fBTS\fR for time-sharing, \fBIA\fR for inter-active, \fBFSS\fR for fair-share, or \fBFX\fR for fixed-priority). The \fBpriocntl\fR command applies to all @@ -268,12 +254,10 @@ processes in the specified class. .sp .ne 2 -.mk .na \fB\fB-i\fR \fBgid\fR\fR .ad .RS 13n -.rt \fIidlist\fR is a list of group \fBID\fRs. The \fBpriocntl\fR command applies to all processes with an effective group \fBID\fR equal to an \fBID\fR from the list. @@ -281,48 +265,40 @@ list. .sp .ne 2 -.mk .na \fB\fB-i\fR \fBpgid\fR\fR .ad .RS 13n -.rt \fIidlist\fR is a list of process group \fBID\fRs. The \fBpriocntl\fR command applies to all processes in the specified process groups. .RE .sp .ne 2 -.mk .na \fB\fB-i\fR \fBpid\fR\fR .ad .RS 13n -.rt \fIidlist\fR is a list of process \fBID\fRs. The \fBpriocntl\fR command applies to the specified processes. .RE .sp .ne 2 -.mk .na \fB\fB-i\fR \fBppid\fR\fR .ad .RS 13n -.rt \fIidlist\fR is a list of parent process \fBID\fRs. The \fBpriocntl\fR command applies to all processes whose parent process \fBID\fR is in the list. .RE .sp .ne 2 -.mk .na \fB\fB-i\fR \fBprojid\fR\fR .ad .RS 13n -.rt \fIidlist\fR is a list of project \fBID\fRs. The \fBpriocntl\fR command applies to all processes with an effective project \fBID\fR equal to an \fBID\fR from the list. @@ -330,36 +306,30 @@ the list. .sp .ne 2 -.mk .na \fB\fB-i\fR \fBsid\fR\fR .ad .RS 13n -.rt \fIidlist\fR is a list of session \fBID\fRs. The \fBpriocntl\fR command applies to all processes in the specified sessions. .RE .sp .ne 2 -.mk .na \fB\fB-i\fR \fBtaskid\fR\fR .ad .RS 13n -.rt \fIidlist\fR is a list of task \fBID\fRs. The \fBpriocntl\fR command applies to all processes in the specified tasks. .RE .sp .ne 2 -.mk .na \fB\fB-i\fR \fBuid\fR\fR .ad .RS 13n -.rt \fIidlist\fR is a list of user \fBID\fRs. The \fBpriocntl\fR command applies to all processes with an effective user \fBID\fR equal to an \fBID\fR from the list. @@ -367,12 +337,10 @@ list. .sp .ne 2 -.mk .na \fB\fB-i\fR \fBzoneid\fR\fR .ad .RS 13n -.rt \fIidlist\fR is a list of zone \fBID\fRs. The \fBpriocntl\fR command applies to all processes with an effective zone \fBID\fR equal to an \fBID\fR from the list. @@ -382,12 +350,10 @@ list. .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 13n -.rt Displays a list of the classes currently configured in the system along with class-specific information about each class. The format of the class-specific information displayed is described under USAGE. @@ -395,12 +361,10 @@ information displayed is described under USAGE. .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 13n -.rt Sets the scheduling parameters associated with a set of processes. .RE @@ -409,35 +373,29 @@ Sets the scheduling parameters associated with a set of processes. The valid class-specific options for setting real-time parameters are: .sp .ne 2 -.mk .na \fB\fB-p\fR \fIrtpri\fR\fR .ad .RS 21n -.rt Sets the real-time priority of the specified process(es) to \fIrtpri\fR. .RE .sp .ne 2 -.mk .na \fB\fB-t\fR \fItqntm\fR [\fB-r\fR \fIres\fR]\fR .ad .RS 21n -.rt Sets the time quantum of the specified process(es) to \fItqntm\fR. You can optionally specify a resolution as explained below. .RE .sp .ne 2 -.mk .na \fB\fB-q\fR \fItqsig\fR\fR .ad .RS 21n -.rt Sets the real-time time quantum signal of the specified process(es) to \fItqsig\fR. .RE @@ -447,23 +405,19 @@ Sets the real-time time quantum signal of the specified process(es) to The valid class-specific options for setting time-sharing parameters are: .sp .ne 2 -.mk .na \fB\fB-m\fR \fItsuprilim\fR\fR .ad .RS 16n -.rt Sets the user priority limit of the specified process(es) to \fItsuprilim\fR. .RE .sp .ne 2 -.mk .na \fB\fB-p\fR \fItsupri\fR\fR .ad .RS 16n -.rt Sets the user priority of the specified process(es) to \fItsupri\fR. .RE @@ -472,23 +426,19 @@ Sets the user priority of the specified process(es) to \fItsupri\fR. The valid class-specific options for setting inter-active parameters are: .sp .ne 2 -.mk .na \fB\fB-m\fR \fIiauprilim\fR\fR .ad .RS 16n -.rt Sets the user priority limit of the specified process(es) to \fIiauprilim\fR. .RE .sp .ne 2 -.mk .na \fB\fB-p\fR \fIiaupri\fR\fR .ad .RS 16n -.rt Sets the user priority of the specified process(es) to \fIiaupri\fR. .RE @@ -497,23 +447,19 @@ Sets the user priority of the specified process(es) to \fIiaupri\fR. The valid class-specific options for setting fair-share parameters are: .sp .ne 2 -.mk .na \fB\fB-m\fR \fIfssuprilim\fR\fR .ad .RS 17n -.rt Sets the user priority limit of the specified process(es) to \fIfssuprilim\fR. .RE .sp .ne 2 -.mk .na \fB\fB-p\fR \fIfssupri\fR\fR .ad .RS 17n -.rt Sets the user priority of the specified process(es) to \fIfssupri\fR. .RE @@ -522,34 +468,28 @@ Sets the user priority of the specified process(es) to \fIfssupri\fR. The valid class-specific options for setting fixed-priority parameters are: .sp .ne 2 -.mk .na \fB\fB-m\fR \fIfxuprilim\fR\fR .ad .RS 16n -.rt Sets the user priority limit of the specified process(es) to \fIfxuprilim\fR. .RE .sp .ne 2 -.mk .na \fB\fB-p\fR \fIfxupri\fR\fR .ad .RS 16n -.rt Sets the user priority of the specified process(es) to \fIfxupri\fR. .RE .sp .ne 2 -.mk .na \fB\fB-t\fR \fItqntm\fR\fR .ad .RS 16n -.rt [\fB-r\fR \fIres\fR] Sets the time quantum of the specified process(es) to \fItqntm\fR. You can optionally specify a resolution as explained below. .RE @@ -1007,23 +947,19 @@ The following exit values are returned: For options \fB-d\fR, \fB-l\fR, and \fB-s\fR: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt Successful operation. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt Error condition. .RE @@ -1036,12 +972,10 @@ Return of the Exit Status of the executed command denotes successful operation. Otherwise, .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt Command could not be executed at the specified priority. .RE @@ -1053,13 +987,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled .TE .SH SEE ALSO @@ -1077,7 +1010,6 @@ CSIEnabled \fBpriocntl\fR prints the following error messages: .sp .ne 2 -.mk .na \fB\fBProcess(es) not found\fR\fR .ad @@ -1088,7 +1020,6 @@ None of the specified processes exists. .sp .ne 2 -.mk .na \fB\fBSpecified processes from different classes\fR\fR .ad @@ -1100,7 +1031,6 @@ option is not present, and processes from more than one class are specified. .sp .ne 2 -.mk .na \fB\fBInvalid option or argument\fR\fR .ad diff --git a/usr/src/man/man1/proc.1 b/usr/src/man/man1/proc.1 index 233fb2c212..21a9134844 100644 --- a/usr/src/man/man1/proc.1 +++ b/usr/src/man/man1/proc.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 proc 1 "10 Dec 2008" "SunOS 5.11" "User Commands" +.TH PROC 1 "Dec 10, 2008" .SH NAME proc, pflags, pcred, pldd, psig, pstack, pfiles, pwdx, pstop, prun, pwait, ptime \- proc tools @@ -104,12 +104,10 @@ delimiters. For example \fB/1,2,7-9\fR examines threads \fB1\fR, \fB2\fR, See \fBWARNINGS\fR. .sp .ne 2 -.mk .na \fB\fBpflags\fR\fR .ad .RS 10n -.rt Print the \fB/proc\fR tracing flags, the pending and held signals, and other \fB/proc\fR status information for each process or specified lwps in each process. @@ -117,60 +115,50 @@ process. .sp .ne 2 -.mk .na \fB\fBpcred\fR\fR .ad .RS 10n -.rt Print or set the credentials (effective, real, saved \fBUID\fRs and \fBGID\fRs) of each process. .RE .sp .ne 2 -.mk .na \fB\fBpldd\fR\fR .ad .RS 10n -.rt List the dynamic libraries linked into each process, including shared objects explicitly attached using \fBdlopen\fR(3C). See also \fBldd\fR(1). .RE .sp .ne 2 -.mk .na \fB\fBpsig\fR\fR .ad .RS 10n -.rt List the signal actions and handlers of each process. See \fBsignal.h\fR(3HEAD). .RE .sp .ne 2 -.mk .na \fB\fBpstack\fR\fR .ad .RS 10n -.rt Print a hex+symbolic stack trace for each process or specified lwps in each process. .RE .sp .ne 2 -.mk .na \fB\fBpfiles\fR\fR .ad .RS 10n -.rt Report \fBfstat\fR(2) and \fBfcntl\fR(2) information for all open files in each process. For network endpoints, the local (and peer if connected) address information is also provided. For sockets, the socket type, socket options and @@ -182,56 +170,46 @@ for more information. .sp .ne 2 -.mk .na \fB\fBpwdx\fR\fR .ad .RS 10n -.rt Print the current working directory of each process. .RE .sp .ne 2 -.mk .na \fB\fBpstop\fR\fR .ad .RS 10n -.rt Stop each process or the specified lwps (\fBPR_REQUESTED\fR stop). .RE .sp .ne 2 -.mk .na \fB\fBprun\fR\fR .ad .RS 10n -.rt Set running each process or the specified lwps (the inverse of \fBpstop\fR). .RE .sp .ne 2 -.mk .na \fB\fBpwait\fR\fR .ad .RS 10n -.rt Wait for all of the specified processes to terminate. .RE .sp .ne 2 -.mk .na \fB\fBptime\fR\fR .ad .RS 10n -.rt Time the \fIcommand\fR, like \fBtime\fR(1), but using microstate accounting for reproducible precision. Unlike \fBtime\fR(1), children of the command are not timed. @@ -246,23 +224,19 @@ statistics for the specified \fIpid\fR. The following general options are supported: .sp .ne 2 -.mk .na \fB\fB-F\fR\fR .ad .RS 6n -.rt Force. Grabs the target process even if another process has control. .RE .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 6n -.rt (\fBpsig\fR and \fBpfiles\fR only) Sets non-verbose mode. \fBpsig\fR displays signal handler addresses rather than names. \fBpfiles\fR does not display verbose information for each file descriptor. Instead, \fBpfiles\fR limits its @@ -272,23 +246,19 @@ output to the information that would be retrieved if the process applied .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 6n -.rt (\fBpflags\fR only) If the process is stopped, displays its machine registers. .RE .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 6n -.rt (\fBpwait\fR only) Verbose. Reports terminations to standard output. .RE @@ -297,24 +267,20 @@ output to the information that would be retrieved if the process applied In addition to the general options, \fBpcred\fR supports the following options: .sp .ne 2 -.mk .na \fB\fB-g\fR \fIgroup/gid\fR\fR .ad .RS 16n -.rt Sets the real, effective, and saved group ids (\fBGID\fRs) of the target processes to the specified value. .RE .sp .ne 2 -.mk .na \fB\fB-G\fR \fIgrouplist\fR\fR .ad .RS 16n -.rt Sets the supplementary \fBGID\fRs of the target process to the specified list of groups. The supplementary groups should be specified as a comma-separated list of group names ids. An empty list clears the supplementary group list of @@ -323,12 +289,10 @@ the target processes. .sp .ne 2 -.mk .na \fB\fB-l\fR \fIlogin\fR\fR .ad .RS 16n -.rt Sets the real, effective, and saved \fBUID\fRs of the target processes to the \fBUID\fR of the specified login. Sets the real, effective, and saved \fBGID\fRs of the target processes to the \fBGID\fR of the specified login. @@ -338,12 +302,10 @@ specified login. .sp .ne 2 -.mk .na \fB\fB-u\fR \fIuser/uid\fR\fR .ad .RS 16n -.rt Sets the real, effective, and saved user ids (\fBUID\fRs) of the target processes to the specified value. .RE @@ -353,12 +315,10 @@ processes to the specified value. In addition to the general options, \fBpldd\fR supports the following option: .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 6n -.rt Shows unresolved dynamic linker map names. .RE @@ -367,133 +327,109 @@ Shows unresolved dynamic linker map names. In addition to the general options, \fBptime\fR supports the following options: .sp .ne 2 -.mk .na \fB\fB-m\fR\fR .ad .RS 10n -.rt Display the full set of microstate accounting statistics. .sp The displayed fields are as follows: .sp .ne 2 -.mk .na \fB\fBreal\fR\fR .ad .RS 8n -.rt Wall clock time. .RE .sp .ne 2 -.mk .na \fB\fBuser\fR\fR .ad .RS 8n -.rt User level CPU time. .RE .sp .ne 2 -.mk .na \fB\fBsys\fR\fR .ad .RS 8n -.rt System call CPU time. .RE .sp .ne 2 -.mk .na \fB\fBtrap\fR\fR .ad .RS 8n -.rt Other system trap CPU time. .RE .sp .ne 2 -.mk .na \fB\fBtflt\fR\fR .ad .RS 8n -.rt Text page fault sleep time. .RE .sp .ne 2 -.mk .na \fB\fBdflt\fR\fR .ad .RS 8n -.rt Data page fault sleep time. .RE .sp .ne 2 -.mk .na \fB\fBkflt\fR\fR .ad .RS 8n -.rt Kernel page fault sleep time. .RE .sp .ne 2 -.mk .na \fB\fBlock\fR\fR .ad .RS 8n -.rt User lock wait sleep time. .RE .sp .ne 2 -.mk .na \fB\fBslp\fR\fR .ad .RS 8n -.rt All other sleep time. .RE .sp .ne 2 -.mk .na \fB\fBlat\fR\fR .ad .RS 8n -.rt CPU latency (wait) time. .RE .sp .ne 2 -.mk .na \fB\fBstop\fR\fR .ad .RS 8n -.rt Stopped time. .RE @@ -501,12 +437,10 @@ Stopped time. .sp .ne 2 -.mk .na \fB\fB-p\fR \fIpid\fR\fR .ad .RS 10n -.rt Displays a snapshot of timing statistics for the specified \fIpid\fR. .RE @@ -558,35 +492,29 @@ not available. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 12n -.rt Successful operation. .RE .sp .ne 2 -.mk .na \fBnon-zero\fR .ad .RS 12n -.rt An error has occurred. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB/proc/*\fR\fR .ad .RS 11n -.rt process files .RE @@ -598,13 +526,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilitySee below. +Interface Stability See below. .TE .sp diff --git a/usr/src/man/man1/prof.1 b/usr/src/man/man1/prof.1 index c403e52e4f..6c16595837 100644 --- a/usr/src/man/man1/prof.1 +++ b/usr/src/man/man1/prof.1 @@ -4,13 +4,13 @@ .\" 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 prof 1 "25 Aug 2009" "SunOS 5.11" "User Commands" +.TH PROF 1 "Aug 25, 2009" .SH NAME prof \- display profile data .SH SYNOPSIS .LP .nf -\fBprof\fR [\fB-ChsVz\fR] [\fB-a\fR | c | n | t] [\fB-o\fR | x] [\fB-g\fR | l] [\fB-m\fR \fImdata\fR] +\fBprof\fR [\fB-ChsVz\fR] [\fB-a\fR | c | n | t] [\fB-o\fR | x] [\fB-g\fR | l] [\fB-m\fR \fImdata\fR] [\fIprog\fR] .fi @@ -31,45 +31,37 @@ The mutually exclusive options \fB-a\fR, \fB-c\fR, \fB-n\fR, and \fB-t\fR determine the type of sorting of the output lines: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 6n -.rt Sort by increasing symbol address. .RE .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad .RS 6n -.rt Sort by decreasing number of calls. .RE .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 6n -.rt Sort lexically by symbol name. .RE .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad .RS 6n -.rt Sort by decreasing percentage of total time (default). .RE @@ -79,23 +71,19 @@ The mutually exclusive options \fB-o\fR and \fB-x\fR specify the printing of the address of each symbol monitored: .sp .ne 2 -.mk .na \fB\fB-o\fR\fR .ad .RS 6n -.rt Print each symbol address (in octal) along with the symbol name. .RE .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad .RS 6n -.rt Print each symbol address (in hexadecimal) along with the symbol name. .RE @@ -121,24 +109,20 @@ attributed to \fBA\fR, making it appear as if more time had been spent in located. .sp .ne 2 -.mk .na \fB\fB-g\fR\fR .ad .RS 6n -.rt List the time spent in static (non-global) functions separately. The \fB-g\fR option function is the opposite of the \fB-l\fR function. .RE .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 6n -.rt Suppress printing statically declared functions. If this option is given, time spent executing in a static function is allocated to the closest global function loaded before the static function in the executable. This option is @@ -151,69 +135,57 @@ with care. The following options may be used in any combination: .sp .ne 2 -.mk .na \fB\fB-C\fR\fR .ad .RS 12n -.rt Demangle C++ symbol names before printing them out. .RE .sp .ne 2 -.mk .na \fB\fB-h\fR\fR .ad .RS 12n -.rt Suppress the heading normally printed on the report. This is useful if the report is to be processed further. .RE .sp .ne 2 -.mk .na \fB\fB-m\fR \fImdata\fR\fR .ad .RS 12n -.rt Use file \fImdata\fR instead of \fBmon.out\fR as the input profile file. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 12n -.rt Print a summary of several of the monitoring parameters and statistics on the standard error output. .RE .sp .ne 2 -.mk .na \fB\fB-V\fR\fR .ad .RS 12n -.rt Print \fBprof\fR version information on the standard error output. .RE .sp .ne 2 -.mk .na \fB\fB-z\fR\fR .ad .RS 12n -.rt Include all symbols in the profile range, even if associated with zero number of calls and zero time. .RE @@ -225,12 +197,10 @@ A single function may be split into subfunctions for profiling by means of the .SH ENVIRONMENT VARIABLES .sp .ne 2 -.mk .na \fB\fBPROFDIR\fR\fR .ad .RS 11n -.rt The name of the file created by a profiled program is controlled by the environment variable \fBPROFDIR\fR. If \fBPROFDIR\fR is not set, \fBmon.out\fR is produced in the directory current when the program terminates. If @@ -243,23 +213,19 @@ prefix removed, and \fIpid\fR is the process ID of the program. If .SH FILES .sp .ne 2 -.mk .na \fB\fBmon.out\fR\fR .ad .RS 11n -.rt default profile file .RE .sp .ne 2 -.mk .na \fB\fBa.out\fR\fR .ad .RS 11n -.rt default namelist (object) file .RE diff --git a/usr/src/man/man1/profiles.1 b/usr/src/man/man1/profiles.1 index 97ffd7f14d..f0db54973e 100644 --- a/usr/src/man/man1/profiles.1 +++ b/usr/src/man/man1/profiles.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 profiles 1 "11 Feb 2000" "SunOS 5.11" "User Commands" +.TH PROFILES 1 "Feb 11, 2000" .SH NAME profiles \- print execution profiles for a user .SH SYNOPSIS @@ -45,12 +45,10 @@ in \fBprof_attr\fR(4) provide the authorizations list, and matching entries in The following options are supported: .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 6n -.rt Lists the commands in each profile followed by the special process attributes such as user and group \fBID\fRs. .RE @@ -100,23 +98,19 @@ example% The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR \fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB1\fR \fR .ad .RS 6n -.rt An error occurred. .RE diff --git a/usr/src/man/man1/projects.1 b/usr/src/man/man1/projects.1 index 3cd7cc3e2f..1e26afc1d4 100644 --- a/usr/src/man/man1/projects.1 +++ b/usr/src/man/man1/projects.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 projects 1 "13 May 2004" "SunOS 5.11" "User Commands" +.TH PROJECTS 1 "May 13, 2004" .SH NAME projects \- print project membership of user .SH SYNOPSIS @@ -30,35 +30,29 @@ associated \fBNIS\fR maps and \fBLDAP\fR databases for project information. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad .RS 6n -.rt Prints only default project. .RE .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 6n -.rt Prints verbose info on each project projectname. If no projectnames are given, info on all projects is printed. .RE .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 6n -.rt Prints project descriptions along with project names. .RE @@ -68,23 +62,19 @@ Prints project descriptions along with project names. The following operand is supported: .sp .ne 2 -.mk .na \fB\fIprojectname\fR\fR .ad .RS 15n -.rt Display information for the specified project. .RE .sp .ne 2 -.mk .na \fB\fIuser\fR\fR .ad .RS 15n -.rt Displays project memberships for the specified user. .RE @@ -110,46 +100,38 @@ beatles The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR \fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 6n -.rt A fatal error occurred during execution. .RE .sp .ne 2 -.mk .na \fB\fB2\fR\fR .ad .RS 6n -.rt Invalid command line options were specified. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB/etc/project\fR\fR .ad .RS 16n -.rt Local database containing valid project definitions for this machine. .RE @@ -161,12 +143,11 @@ See \fBattributes\fR(5) for a description of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE -StabilitySee below. +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE +Stability See below. .TE .sp diff --git a/usr/src/man/man1/ps.1 b/usr/src/man/man1/ps.1 index 53591ed29d..5e8c1b9be0 100644 --- a/usr/src/man/man1/ps.1 +++ b/usr/src/man/man1/ps.1 @@ -10,15 +10,15 @@ .\" 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 ps 1 "16 Aug 2009" "SunOS 5.11" "User Commands" +.TH PS 1 "Aug 16, 2009" .SH NAME ps \- report process status .SH SYNOPSIS .LP .nf -\fBps\fR [\fB-aAcdefjHlLPyZ\fR] [\fB-g\fR \fIgrplist\fR] [\fB-h\fR \fIlgrplist\fR] - [\fB-n\fR \fInamelist\fR] [\fB-o\fR \fIformat\fR]... [\fB-p\fR \fIproclist\fR] - [\fB-s\fR \fIsidlist\fR] [\fB-t\fR \fIterm\fR] [\fB-u\fR \fIuidlist\fR] [\fB-U\fR \fIuidlist\fR] +\fBps\fR [\fB-aAcdefjHlLPyZ\fR] [\fB-g\fR \fIgrplist\fR] [\fB-h\fR \fIlgrplist\fR] + [\fB-n\fR \fInamelist\fR] [\fB-o\fR \fIformat\fR]... [\fB-p\fR \fIproclist\fR] + [\fB-s\fR \fIsidlist\fR] [\fB-t\fR \fIterm\fR] [\fB-u\fR \fIuidlist\fR] [\fB-U\fR \fIuidlist\fR] [\fB-G\fR \fIgidlist\fR] [\fB-z\fR \fIzonelist\fR] .fi @@ -42,35 +42,29 @@ for \fIproclist\fR and \fIgrplist\fR must be numeric. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 15n -.rt Lists information about \fBa\fRll processes most frequently requested: all those except session leaders and processes not associated with a terminal. .RE .sp .ne 2 -.mk .na \fB\fB-A\fR\fR .ad .RS 15n -.rt Lists information for all processes. Identical to \fB-e\fR, below. .RE .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad .RS 15n -.rt Prints information in a format that reflects scheduler properties as described in \fBpriocntl\fR(1). The \fB-c\fR option affects the output of the \fB-f\fR and \fB-l\fR options, as described below. @@ -78,23 +72,19 @@ and \fB-l\fR options, as described below. .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad .RS 15n -.rt Lists information about all processes except session leaders. .RE .sp .ne 2 -.mk .na \fB\fB-e\fR\fR .ad .RS 15n -.rt Lists information about \fBe\fRvery process now running. .sp When the \fB-e\fRoption is specified, options \fB-z\fR, \fB-t\fR, \fB-u\fR, @@ -104,24 +94,20 @@ have no effect. .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 15n -.rt Generates a \fBf\fRull listing. (See below for significance of columns in a full listing.) .RE .sp .ne 2 -.mk .na \fB\fB-g\fR \fIgrplist\fR\fR .ad .RS 15n -.rt Lists only process data whose group leader's \fBID\fR number(s) appears in \fIgrplist\fR. (A group leader is a process whose process \fBID\fR number is identical to its process group \fBID\fR number.) @@ -129,12 +115,10 @@ identical to its process group \fBID\fR number.) .sp .ne 2 -.mk .na \fB\fB-G\fR \fIgidlist\fR\fR .ad .RS 15n -.rt Lists information for processes whose real group ID numbers are given in \fIgidlist\fR. The \fIgidlist\fR must be a single argument in the form of a blank- or comma-separated list. @@ -142,81 +126,67 @@ blank- or comma-separated list. .sp .ne 2 -.mk .na \fB\fB-h\fR \fIlgrplist\fR\fR .ad .RS 15n -.rt Lists only the processes homed to the specified \fIlgrplist\fR. Nothing is listed for any invalid group specified in \fIlgrplist\fR. .RE .sp .ne 2 -.mk .na \fB\fB-H\fR\fR .ad .RS 15n -.rt Prints the home lgroup of the process under an additional column header, LGRP. .RE .sp .ne 2 -.mk .na \fB\fB-j\fR\fR .ad .RS 15n -.rt Prints session \fBID\fR and process group \fBID\fR. .RE .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 15n -.rt Generates a \fBl\fRong listing. (See below.) .RE .sp .ne 2 -.mk .na \fB\fB-L\fR\fR .ad .RS 15n -.rt Prints information about each light weight process (\fIlwp\fR) in each selected process. (See below.) .RE .sp .ne 2 -.mk .na \fB\fB-n\fR \fInamelist\fR\fR .ad .RS 15n -.rt Specifies the name of an alternative system \fInamelist\fR file in place of the default. This option is accepted for compatibility, but is ignored. .RE .sp .ne 2 -.mk .na \fB\fB-o\fR \fIformat\fR\fR .ad .RS 15n -.rt Prints information according to the format specification given in \fIformat\fR. This is fully described in \fBDISPLAY FORMATS\fR. Multiple \fB-o\fR options can be specified; the format specification is interpreted as the @@ -226,48 +196,40 @@ option-arguments. .sp .ne 2 -.mk .na \fB\fB-p\fR \fIproclist\fR\fR .ad .RS 15n -.rt Lists only process data whose process \fBID\fR numbers are given in \fIproclist\fR. .RE .sp .ne 2 -.mk .na \fB\fB-P\fR\fR .ad .RS 15n -.rt Prints the number of the processor to which the process or lwp is bound, if any, under an additional column header, \fBPSR\fR. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR \fIsidlist\fR\fR .ad .RS 15n -.rt Lists information on all session leaders whose \fBID\fRs appear in \fIsidlist\fR. .RE .sp .ne 2 -.mk .na \fB\fB-t\fR \fIterm\fR\fR .ad .RS 15n -.rt Lists only process data associated with \fIterm\fR. Terminal identifiers are specified as a device file name, and an identifier. For example, \fBterm/a\fR, or \fBpts/0\fR. @@ -275,12 +237,10 @@ or \fBpts/0\fR. .sp .ne 2 -.mk .na \fB\fB-u\fR \fIuidlist\fR\fR .ad .RS 15n -.rt Lists only process data whose effective user \fBID\fR number or login name is given in \fIuidlist\fR. In the listing, the numerical user \fBID\fR is printed unless you give the \fB-f\fR option, which prints the login name. @@ -288,12 +248,10 @@ unless you give the \fB-f\fR option, which prints the login name. .sp .ne 2 -.mk .na \fB\fB-U\fR \fIuidlist\fR\fR .ad .RS 15n -.rt Lists information for processes whose real user \fBID\fR numbers or login names are given in \fIuidlist\fR. The \fIuidlist\fR must be a single argument in the form of a blank- or comma-separated list. @@ -301,12 +259,10 @@ form of a blank- or comma-separated list. .sp .ne 2 -.mk .na \fB\fB-y\fR\fR .ad .RS 15n -.rt Under a long listing (\fB-l\fR), omits the obsolete \fBF\fR and \fBADDR\fR columns and includes an \fBRSS\fR column to report the resident set size of the process. Under the \fB-y\fR option, both \fBRSS\fR and \fBSZ\fR (see below) is @@ -315,24 +271,20 @@ reported in units of kilobytes instead of pages. .sp .ne 2 -.mk .na \fB\fB-z\fR \fIzonelist\fR\fR .ad .RS 15n -.rt Lists only processes in the specified zones. Zones can be specified either by name or ID. This option is only useful when executed in the global zone. .RE .sp .ne 2 -.mk .na \fB\fB-Z\fR\fR .ad .RS 15n -.rt Prints the name of the zone with which the process is associated under an additional column header, \fBZONE\fR. The \fBZONE\fR column width is limited to 8 characters. Use \fBps\fR \fB-eZ\fR for a quick way to see information about @@ -370,12 +322,10 @@ determine only what information is provided for a process; they do not determine which processes are listed. .sp .ne 2 -.mk .na \fB\fBF\fR(l)\fR .ad .RS 14n -.rt Flags (hexadecimal and additive) associated with the process. These flags are available for historical purposes; no meaning should be currently ascribed to them. @@ -383,78 +333,64 @@ them. .sp .ne 2 -.mk .na \fB\fBS\fR (l)\fR .ad .RS 14n -.rt The state of the process: .sp .ne 2 -.mk .na \fBO\fR .ad .RS 5n -.rt Process is running on a processor. .RE .sp .ne 2 -.mk .na \fBS\fR .ad .RS 5n -.rt Sleeping: process is waiting for an event to complete. .RE .sp .ne 2 -.mk .na \fBR\fR .ad .RS 5n -.rt Runnable: process is on run queue. .RE .sp .ne 2 -.mk .na \fBT\fR .ad .RS 5n -.rt Process is stopped, either by a job control signal or because it is being traced. .RE .sp .ne 2 -.mk .na \fBW\fR .ad .RS 5n -.rt Waiting: process is waiting for CPU usage to drop to the CPU-caps enforced limits. .RE .sp .ne 2 -.mk .na \fBZ\fR .ad .RS 5n -.rt Zombie state: process terminated and parent not waiting. .RE @@ -462,129 +398,107 @@ Zombie state: process terminated and parent not waiting. .sp .ne 2 -.mk .na \fB\fBUID\fR (f,l)\fR .ad .RS 14n -.rt The effective user \fBID\fR number of the process (the login name is printed under the \fB-f\fR option). .RE .sp .ne 2 -.mk .na \fB\fBPID\fR(all)\fR .ad .RS 14n -.rt The process \fBID\fR of the process (this datum is necessary in order to kill a process). .RE .sp .ne 2 -.mk .na \fB\fBPPID\fR(f,l)\fR .ad .RS 14n -.rt The process \fBID\fR of the parent process. .RE .sp .ne 2 -.mk .na \fB\fBC\fR(f,l)\fR .ad .RS 14n -.rt Processor utilization for scheduling (obsolete). Not printed when the \fB-c\fR option is used. .RE .sp .ne 2 -.mk .na \fB\fBCLS\fR(f,l)\fR .ad .RS 14n -.rt Scheduling class. Printed only when the \fB-c\fR option is used. .RE .sp .ne 2 -.mk .na \fB\fBPRI\fR(l)\fR .ad .RS 14n -.rt The priority of the process. Without the \fB-c\fR option, higher numbers mean lower priority. With the \fB-c\fR option, higher numbers mean higher priority. .RE .sp .ne 2 -.mk .na \fB\fBNI\fR(l)\fR .ad .RS 14n -.rt Nice value, used in priority computation. Not printed when the \fB-c\fR option is used. Only processes in the certain scheduling classes have a nice value. .RE .sp .ne 2 -.mk .na \fB\fBADDR\fR(l)\fR .ad .RS 14n -.rt The memory address of the process. .RE .sp .ne 2 -.mk .na \fB\fBSZ\fR(l)\fR .ad .RS 14n -.rt The total size of the process in virtual memory, including all mapped files and devices, in pages. See \fBpagesize\fR(1). .RE .sp .ne 2 -.mk .na \fB\fBWCHAN\fR(l)\fR .ad .RS 14n -.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\fBSTIME\fR(f)\fR .ad .RS 14n -.rt The starting time of the process, given in hours, minutes, and seconds. (A process begun more than twenty-four hours before the \fBps\fR inquiry is executed is given in months and days.) @@ -592,46 +506,38 @@ executed is given in months and days.) .sp .ne 2 -.mk .na \fB\fBTTY\fR(all)\fR .ad .RS 14n -.rt The controlling terminal for the process (the message, \fB?\fR, is printed when there is no controlling terminal). .RE .sp .ne 2 -.mk .na \fB\fBTIME\fR(all)\fR .ad .RS 14n -.rt The cumulative execution time for the process. .RE .sp .ne 2 -.mk .na \fB\fBLTIME\fR(all)\fR .ad .RS 14n -.rt The execution time for the lwp being reported. .RE .sp .ne 2 -.mk .na \fB\fBCMD\fR(all)\fR .ad .RS 14n -.rt The command name (the full command name and its arguments, up to a limit of 80 characters, are printed under the \fB-f\fR option). .RE @@ -642,23 +548,19 @@ The following two additional columns are printed when the \fB-j\fR option is specified: .sp .ne 2 -.mk .na \fB\fBPGID\fR\fR .ad .RS 8n -.rt The process ID of the process group leader. .RE .sp .ne 2 -.mk .na \fB\fBSID\fR\fR .ad .RS 8n -.rt The process ID of the session leader. .RE @@ -668,23 +570,19 @@ The following two additional columns are printed when the \fB-L\fR option is specified: .sp .ne 2 -.mk .na \fB\fBLWP\fR\fR .ad .RS 8n -.rt The lwp ID of the lwp being reported. .RE .sp .ne 2 -.mk .na \fB\fBNLWP\fR\fR .ad .RS 8n -.rt The number of lwps in the process (if \fB-f\fR is also specified). .RE @@ -720,12 +618,10 @@ text fields are null, no header line is written. The following names are recognized in the POSIX locale: .sp .ne 2 -.mk .na \fB\fBuser\fR\fR .ad .RS 10n -.rt The effective user \fBID\fR of the process. This is the textual user \fBID\fR, if it can be obtained and the field width permits, or a decimal representation otherwise. @@ -733,12 +629,10 @@ otherwise. .sp .ne 2 -.mk .na \fB\fBruser\fR\fR .ad .RS 10n -.rt The real user \fBID\fR of the process. This is the textual user \fBID\fR, if it can be obtained and the field width permits, or a decimal representation otherwise. @@ -746,12 +640,10 @@ otherwise. .sp .ne 2 -.mk .na \fB\fBgroup\fR\fR .ad .RS 10n -.rt The effective group \fBID\fR of the process. This is the textual group \fBID,\fR if it can be obtained and the field width permits, or a decimal representation otherwise. @@ -759,12 +651,10 @@ representation otherwise. .sp .ne 2 -.mk .na \fB\fBrgroup\fR\fR .ad .RS 10n -.rt The real group \fBID\fR of the process. This is the textual group \fBID,\fR if it can be obtained and the field width permits, or a decimal representation otherwise. @@ -772,45 +662,37 @@ otherwise. .sp .ne 2 -.mk .na \fB\fBpid\fR\fR .ad .RS 10n -.rt The decimal value of the process \fBID\fR. .RE .sp .ne 2 -.mk .na \fB\fBppid\fR\fR .ad .RS 10n -.rt The decimal value of the parent process \fBID\fR. .RE .sp .ne 2 -.mk .na \fB\fBpgid\fR\fR .ad .RS 10n -.rt The decimal value of the process group \fBID.\fR .RE .sp .ne 2 -.mk .na \fB\fBpcpu\fR\fR .ad .RS 10n -.rt The ratio of CPU time used recently to CPU time available in the same period, expressed as a percentage. The meaning of ``recently'' in this context is unspecified. The CPU time available is determined in an unspecified manner. @@ -818,35 +700,29 @@ unspecified. The CPU time available is determined in an unspecified manner. .sp .ne 2 -.mk .na \fB\fBvsz\fR\fR .ad .RS 10n -.rt The total size of the process in virtual memory, in kilobytes. .RE .sp .ne 2 -.mk .na \fB\fBnice\fR\fR .ad .RS 10n -.rt The decimal value of the system scheduling priority of the process. See \fBnice\fR(1). .RE .sp .ne 2 -.mk .na \fB\fBetime\fR\fR .ad .RS 10n -.rt In the POSIX locale, the elapsed time since the process was started, in the form: .sp @@ -855,45 +731,37 @@ form: where .sp .ne 2 -.mk .na \fB\fIdd\fR\fR .ad .RS 6n -.rt is the number of days .RE .sp .ne 2 -.mk .na \fB\fIhh\fR\fR .ad .RS 6n -.rt is the number of hours .RE .sp .ne 2 -.mk .na \fB\fImm\fR\fR .ad .RS 6n -.rt is the number of minutes .RE .sp .ne 2 -.mk .na \fB\fIss\fR\fR .ad .RS 6n -.rt is the number of seconds .RE @@ -903,12 +771,10 @@ fields is two-digit decimal integers padded on the left with zeros. .sp .ne 2 -.mk .na \fB\fBtime\fR\fR .ad .RS 10n -.rt In the POSIX locale, the cumulative CPU time of the process in the form: .sp \fB[\fR\fIdd\fR-\fB]\fR\fIhh\fR:\fImm\fR:\fIss\fR @@ -919,35 +785,29 @@ The \fIdd\fR, \fIhh\fR, \fImm\fR, and \fIss\fR fields is as described in the .sp .ne 2 -.mk .na \fB\fBtty\fR\fR .ad .RS 10n -.rt The name of the controlling terminal of the process (if any) in the same format used by the \fBwho\fR(1) command. .RE .sp .ne 2 -.mk .na \fB\fBcomm\fR\fR .ad .RS 10n -.rt The name of the command being executed (\fBargv[0]\fR value) as a string. .RE .sp .ne 2 -.mk .na \fB\fBargs\fR\fR .ad .RS 10n -.rt The command with all its arguments as a string. The implementation might truncate this value to the field width; it is implementation-dependent whether any further truncation occurs. It is unspecified whether the string represented @@ -965,280 +825,230 @@ started. The following names are recognized in the Solaris implementation: .sp .ne 2 -.mk .na \fB\fBf\fR\fR .ad .RS 11n -.rt Flags (hexadecimal and additive) associated with the process. .RE .sp .ne 2 -.mk .na \fB\fBs\fR\fR .ad .RS 11n -.rt The state of the process. .RE .sp .ne 2 -.mk .na \fB\fBc\fR\fR .ad .RS 11n -.rt Processor utilization for scheduling (obsolete). .RE .sp .ne 2 -.mk .na \fB\fBuid\fR\fR .ad .RS 11n -.rt The effective user \fBID\fR number of the process as a decimal integer. .RE .sp .ne 2 -.mk .na \fB\fBruid\fR\fR .ad .RS 11n -.rt The real user \fBID\fR number of the process as a decimal integer. .RE .sp .ne 2 -.mk .na \fB\fBgid\fR\fR .ad .RS 11n -.rt The effective group \fBID\fR number of the process as a decimal integer. .RE .sp .ne 2 -.mk .na \fB\fBrgid\fR\fR .ad .RS 11n -.rt The real group \fBID\fR number of the process as a decimal integer. .RE .sp .ne 2 -.mk .na \fB\fBprojid\fR\fR .ad .RS 11n -.rt The project \fBID\fR number of the process as a decimal integer. .RE .sp .ne 2 -.mk .na \fB\fBproject\fR\fR .ad .RS 11n -.rt The project \fBID\fR of the process as a textual value if that value can be obtained; otherwise, as a decimal integer. .RE .sp .ne 2 -.mk .na \fB\fBzoneid\fR\fR .ad .RS 11n -.rt The zone \fBID\fR number of the process as a decimal integer. .RE .sp .ne 2 -.mk .na \fB\fBzone\fR\fR .ad .RS 11n -.rt The zone \fBID\fR of the process as a textual value if that value can be obtained; otherwise, as a decimal integer. .RE .sp .ne 2 -.mk .na \fB\fBsid\fR\fR .ad .RS 11n -.rt The process ID of the session leader. .RE .sp .ne 2 -.mk .na \fB\fBtaskid\fR\fR .ad .RS 11n -.rt The task \fBID\fR of the process. .RE .sp .ne 2 -.mk .na \fB\fBclass\fR\fR .ad .RS 11n -.rt The scheduling class of the process. .RE .sp .ne 2 -.mk .na \fB\fBpri\fR\fR .ad .RS 11n -.rt The priority of the process. Higher numbers mean higher priority. .RE .sp .ne 2 -.mk .na \fB\fBopri\fR\fR .ad .RS 11n -.rt The obsolete priority of the process. Lower numbers mean higher priority. .RE .sp .ne 2 -.mk .na \fB\fBlwp\fR\fR .ad .RS 11n -.rt The decimal value of the lwp \fBID\fR. Requesting this formatting option causes one line to be printed for each lwp in the process. .RE .sp .ne 2 -.mk .na \fB\fBnlwp\fR\fR .ad .RS 11n -.rt The number of lwps in the process. .RE .sp .ne 2 -.mk .na \fB\fBpsr\fR\fR .ad .RS 11n -.rt The number of the processor to which the process or lwp is bound. .RE .sp .ne 2 -.mk .na \fB\fBpset\fR\fR .ad .RS 11n -.rt The \fBID\fR of the processor set to which the process or lwp is bound. .RE .sp .ne 2 -.mk .na \fB\fBaddr\fR\fR .ad .RS 11n -.rt The memory address of the process. .RE .sp .ne 2 -.mk .na \fB\fBosz\fR\fR .ad .RS 11n -.rt The total size of the process in virtual memory, in pages. .RE .sp .ne 2 -.mk .na \fB\fBwchan\fR\fR .ad .RS 11n -.rt The address of an event for which the process is sleeping (if \(mi, the process is running). .RE .sp .ne 2 -.mk .na \fB\fBstime\fR\fR .ad .RS 11n -.rt The starting time or date of the process, printed with no blanks. .RE .sp .ne 2 -.mk .na \fB\fBrss\fR\fR .ad .RS 11n -.rt The resident set size of the process, in kilobytes. The \fBrss\fR value reported by \fBps\fR is an estimate provided by \fBproc\fR(4) that might underestimate the actual resident set size. Users who wish to get more accurate @@ -1248,47 +1058,39 @@ instead. .sp .ne 2 -.mk .na \fB\fBpmem\fR\fR .ad .RS 11n -.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\fBfname\fR\fR .ad .RS 11n -.rt The first 8 bytes of the base name of the process's executable file. .RE .sp .ne 2 -.mk .na \fB\fBctid\fR\fR .ad .RS 11n -.rt The contract ID of the process contract the process is a member of as a decimal integer. .RE .sp .ne 2 -.mk .na \fB\fBlgrp\fR\fR .ad .RS 11n -.rt The home lgroup of the process. .RE @@ -1304,21 +1106,20 @@ corresponding to each format specifier. .sp .TS -tab() box; -cw(1.38i) cw(1.38i) cw(1.38i) cw(1.38i) -cw(1.38i) cw(1.38i) cw(1.38i) cw(1.38i) -. -FormatDefaultFormatDefault -SpecifierHeaderSpecifierHeader +box; +c c c c +c c c c . +Format Default Format Default +Specifier Header Specifier Header _ -argsCOMMANDppidPPID -commCOMMANDrgroupRGROUP -etimeELAPSEDruserRUSER -groupGROUPtimeTIME -niceNIttyTT -pcpu%CPUuserUSER -pgidPGIDvszVSZ -pidPID +args COMMAND ppid PPID +comm COMMAND rgroup RGROUP +etime ELAPSED ruser RUSER +group GROUP time TIME +nice NI tty TT +pcpu %CPU user USER +pgid PGID vsz VSZ +pid PID .TE .sp @@ -1329,27 +1130,26 @@ default header used with each. .sp .TS -tab() box; -cw(1.38i) cw(1.38i) cw(1.38i) cw(1.38i) -cw(1.38i) cw(1.38i) cw(1.38i) cw(1.38i) -. -FormatDefaultFormatDefault -SpecifierHeaderSpecifierHeader +box; +c c c c +c c c c . +Format Default Format Default +Specifier Header Specifier Header _ -addrADDRprojidPROJID -cCprojectPROJECT -classCLSpsrPSR -fFrgidRGID -fnameCOMMANDrssRSS -gidGIDruidRUID -lgrpLGRPsS -lwpLWPsidSID -nlwpNLWPstimeSTIME -opriPRItaskidTASKID -oszSZuidUID -pmem%MEMwchanWCHAN -priPRIzoneZONE -ctidCTIDzoneidZONEID +addr ADDR projid PROJID +c C project PROJECT +class CLS psr PSR +f F rgid RGID +fname COMMAND rss RSS +gid GID ruid RUID +lgrp LGRP s S +lwp LWP sid SID +nlwp NLWP stime STIME +opri PRI taskid TASKID +osz SZ uid UID +pmem %MEM wchan WCHAN +pri PRI zone ZONE +ctid CTID zoneid ZONEID .TE .SH EXAMPLES @@ -1393,12 +1193,10 @@ that affect the execution of \fBps\fR: \fBLANG\fR, \fBLC_ALL\fR, \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, \fBLC_TIME\fR, and \fBNLSPATH\fR. .sp .ne 2 -.mk .na \fB\fBCOLUMNS\fR\fR .ad .RS 11n -.rt Override the system-selected horizontal screen size, used to determine the number of text columns to display. .RE @@ -1409,68 +1207,56 @@ number of text columns to display. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB/dev/pts/*\fR\fR .ad .RS 15n -.rt .RE .sp .ne 2 -.mk .na \fB\fB/dev/term/*\fR\fR .ad .RS 15n -.rt terminal (``tty'') names searcher files .RE .sp .ne 2 -.mk .na \fB\fB/etc/passwd\fR\fR .ad .RS 15n -.rt \fBUID\fR information supplier .RE .sp .ne 2 -.mk .na \fB\fB/proc/*\fR\fR .ad .RS 15n -.rt process control files .RE @@ -1482,17 +1268,16 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled (see USAGE) +CSI Enabled (see USAGE) _ -Interface StabilityCommitted +Interface Stability Committed _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .SH SEE ALSO diff --git a/usr/src/man/man1/ptree.1 b/usr/src/man/man1/ptree.1 index 11179dd66d..a8de77c0bd 100644 --- a/usr/src/man/man1/ptree.1 +++ b/usr/src/man/man1/ptree.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 ptree 1 "11 Oct 2005" "SunOS 5.11" "User Commands" +.TH PTREE 1 "Oct 11, 2005" .SH NAME ptree \- print process trees .SH SYNOPSIS @@ -25,35 +25,29 @@ otherwise it is assumed to be a user login name. The default is all processes. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 11n -.rt All. Print all processes, including children of process 0. .RE .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad .RS 11n -.rt Contracts. Print process contract memberships in addition to parent-child relationships. See \fBprocess\fR(4). This option implies the \fB-a\fR option. .RE .sp .ne 2 -.mk .na \fB\fB-z\fR \fIzone\fR\fR .ad .RS 11n -.rt Zones. Print only processes in the specified \fIzone\fR. Each zone \fBID\fR can be specified as either a zone name or a numerical zone \fBID\fR. .sp @@ -66,12 +60,10 @@ This option is only useful when executed in the global zone. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIpid\fR\fR .ad .RS 8n -.rt Process-id or a list of process-ids. \fBptree\fR also accepts \fB/proc/\fR\fInnn\fR as a process-id, so the shell expansion \fB/proc/*\fR can be used to specify all processes in the system. @@ -79,12 +71,10 @@ be used to specify all processes in the system. .sp .ne 2 -.mk .na \fB\fIuser\fR\fR .ad .RS 8n -.rt Username or list of usernames. Processes whose effective user IDs match those given are displayed. .RE @@ -119,35 +109,29 @@ $ ptree -a `pgrep ssh` The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 12n -.rt Successful operation. .RE .sp .ne 2 -.mk .na \fBnon-zero\fR .ad .RS 12n -.rt An error has occurred. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB/proc/*\fR\fR .ad .RS 11n -.rt process files .RE @@ -159,13 +143,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilitySee below. +Interface Stability See below. .TE .sp diff --git a/usr/src/man/man1/pvs.1 b/usr/src/man/man1/pvs.1 index 154638b843..8304261cd3 100644 --- a/usr/src/man/man1/pvs.1 +++ b/usr/src/man/man1/pvs.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 pvs 1 "25 Sep 2008" "SunOS 5.11" "User Commands" +.TH PVS 1 "Sep 25, 2008" .SH NAME pvs \- display the internal version information of dynamic objects .SH SYNOPSIS @@ -59,34 +59,28 @@ The following options are supported. If neither the \fB-d\fR or \fB-r\fR options are specified, both are enabled. .sp .ne 2 -.mk .na \fB\fB-C\fR\fR .ad .RS 18n -.rt Demangles C++ symbol names. .RE .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad .RS 18n -.rt Prints version definition information. .RE .sp .ne 2 -.mk .na \fB\fB-I\fR \fIindex-expr\fR\fR .ad .RS 18n -.rt Qualifies the versions to examine with a specific version index or index range. For example, the version with index 3 in an object can be displayed using: .sp @@ -127,12 +121,10 @@ See Matching Options for additional information about the matching options .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 18n -.rt Prints any symbols that have been reduced from global to local binding due to versioning. By convention, these symbol entries are located in the \fI\&.symtab\fR section, and fall between the \fIFILE\fR symbol representing @@ -147,12 +139,10 @@ Use of the \fB-l\fR option implicitly enables the \fB-s\fR option .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 18n -.rt Normalizes version definition information. By default, all version definitions within the object are displayed. However, version definitions can inherit other version definitions. Under normalization, only the head of each inheritance @@ -161,12 +151,10 @@ list is displayed. .sp .ne 2 -.mk .na \fB\fB-N\fR \fIname\fR\fR .ad .RS 18n -.rt When used with the \fB-d\fR option, \fB-N\fR prints only the information for the given version definition \fIname\fR and any of its inherited version definitions. @@ -189,12 +177,10 @@ See Matching Options for additional information about the matching options .sp .ne 2 -.mk .na \fB\fB-o\fR\fR .ad .RS 18n -.rt Creates one-line version definition output. By default, file, version definitions, and any symbol output is indented to ease human inspection. This option prefixes each output line with the file and version definition name and @@ -203,23 +189,19 @@ can be more useful for analysis with automated tools. .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 18n -.rt Prints version dependency (requirements) information. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 18n -.rt Prints the symbols associated with each version definition. Any data symbols from versions defined by the object are accompanied with the size, in bytes, of the data item. @@ -227,12 +209,10 @@ the data item. .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 18n -.rt Verbose output. Indicates any weak version definitions, and any version definition inheritance. When used with the \fB-N\fR and \fB-d\fR options, the inheritance of the base version definition is also shown. When used with the @@ -245,12 +225,10 @@ inheritance of the base version definition is also shown. When used with the The following operands are supported. .sp .ne 2 -.mk .na \fB\fIfile\fR\fR .ad .RS 8n -.rt The \fBELF\fR file about which internal version information is displayed. .RE diff --git a/usr/src/man/man1/pwd.1 b/usr/src/man/man1/pwd.1 index d2bcd30207..451ce390c1 100644 --- a/usr/src/man/man1/pwd.1 +++ b/usr/src/man/man1/pwd.1 @@ -3,20 +3,20 @@ .\" Copyright 1989 AT&T .\" Portions Copyright (c) 1982-2007 AT&T Knowledge Ventures .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 pwd 1 "2 Nov 2007" "SunOS 5.11" "User Commands" +.TH PWD 1 "Nov 2, 2007" .SH NAME pwd \- return working directory name .SH SYNOPSIS .LP .nf -\fB/usr/bin/pwd\fR +\fB/usr/bin/pwd\fR .fi .SH DESCRIPTION @@ -40,23 +40,19 @@ that affect the execution of \fBpwd\fR: \fBLANG\fR, \fBLC_ALL\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -73,17 +69,16 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityCommitted +Interface Stability Committed _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .SH SEE ALSO diff --git a/usr/src/man/man1/ranlib.1 b/usr/src/man/man1/ranlib.1 index 5709bca24b..734961eb6e 100644 --- a/usr/src/man/man1/ranlib.1 +++ b/usr/src/man/man1/ranlib.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 ranlib 1 "28 Jun 2007" "SunOS 5.11" "User Commands" +.TH RANLIB 1 "Jun 28, 2007" .SH NAME ranlib \- convert archives to random libraries .SH SYNOPSIS diff --git a/usr/src/man/man1/rcapstat.1 b/usr/src/man/man1/rcapstat.1 index 3d1b66a6bd..875b1f73bf 100644 --- a/usr/src/man/man1/rcapstat.1 +++ b/usr/src/man/man1/rcapstat.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 rcapstat 1 "16 Jun 2009" "SunOS 5.11" "User Commands" +.TH RCAPSTAT 1 "Jun 16, 2009" .SH NAME rcapstat \- report resource cap enforcement daemon statistics .SH SYNOPSIS @@ -35,12 +35,10 @@ Reports are issued every \fIinterval\fR seconds up to the quantity specified by The following options are supported: .sp .ne 2 -.mk .na \fB\fB-g\fR\fR .ad .RS 12n -.rt Global statistics. Reports the minimum memory utilization for memory cap enforcement (see \fBrcapadm\fR(1M)) and reports current memory utilization as a percentage of installed physical memory. @@ -48,24 +46,20 @@ percentage of installed physical memory. .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 12n -.rt Report statistics for capped projects. This is the default if no option is specified. .RE .sp .ne 2 -.mk .na \fB\fB-T\fR \fBu\fR | \fBd\fR\fR .ad .RS 12n -.rt Display a time stamp. .sp Specify \fBu\fR for a printed representation of the internal representation of @@ -75,12 +69,10 @@ time. See \fBtime\fR(2). Specify \fBd\fR for standard date format. See .sp .ne 2 -.mk .na \fB\fB-z\fR\fR .ad .RS 12n -.rt Report statistics for capped zones. .RE @@ -91,56 +83,46 @@ The following list defines the column headings in the \fBrcapstat\fR report and provides information about how to interpret the report. .sp .ne 2 -.mk .na \fB\fBid\fR\fR .ad .RS 11n -.rt The project ID or zone \fBID\fR of the capped project or zone. .RE .sp .ne 2 -.mk .na \fB\fBproject\fR\fR .ad .RS 11n -.rt The project name. .RE .sp .ne 2 -.mk .na \fB\fBzone\fR\fR .ad .RS 11n -.rt The zone name. .RE .sp .ne 2 -.mk .na \fB\fBnproc\fR\fR .ad .RS 11n -.rt The number of processes in the project or zone since the last report. .RE .sp .ne 2 -.mk .na \fB\fBvm\fR\fR .ad .RS 11n -.rt The total virtual memory size of the project or zone's processes, including all mapped files and devices, in kilobytes (\fBK\fR), megabytes (\fBM\fR), or gigabytes (\fBG\fR). @@ -148,12 +130,10 @@ gigabytes (\fBG\fR). .sp .ne 2 -.mk .na \fB\fBrss\fR\fR .ad .RS 11n -.rt The total resident set size (\fBRSS\fR) of the project or zone's processes, in kilobytes (\fBK\fR), megabytes (\fBM\fR), or gigabytes (\fBG\fR). The count does not account for shared pages. @@ -161,24 +141,20 @@ does not account for shared pages. .sp .ne 2 -.mk .na \fB\fBcap\fR\fR .ad .RS 11n -.rt The \fBRSS\fR cap for the project or zone. See \fBrcapd\fR(1M) for information about how to specify memory caps. .RE .sp .ne 2 -.mk .na \fB\fBat\fR\fR .ad .RS 11n -.rt The total amount of memory that \fBrcapd\fR attempted to page out. .sp Paging refers to the act of relocating portions of memory, called pages, to or @@ -187,12 +163,10 @@ from physical memory. \fBrcapd\fR pages out the most infrequently used pages. .sp .ne 2 -.mk .na \fB\fBavgat\fR\fR .ad .RS 11n -.rt The average amount of memory that \fBrcapd\fR attempted to page out during each sample cycle. The rate at which \fBrcapd\fR samples \fBRSS\fR can be set with \fBrcapadm\fR(1M). @@ -200,24 +174,20 @@ with \fBrcapadm\fR(1M). .sp .ne 2 -.mk .na \fB\fBpg\fR\fR .ad .RS 11n -.rt An estimate of the total amount of memory that \fBrcapd\fR successfully paged out. .RE .sp .ne 2 -.mk .na \fB\fBavgpg\fR\fR .ad .RS 11n -.rt An estimate of the average amount of memory that \fBrcapd\fR successfully paged out during each sample cycle. The rate at which \fBrcapd\fR samples process \fBRSS\fR sizes can be set with \fBrcapadm\fR. @@ -229,23 +199,19 @@ out during each sample cycle. The rate at which \fBrcapd\fR samples process The following operands are supported: .sp .ne 2 -.mk .na \fB\fIinterval\fR\fR .ad .RS 12n -.rt Specifies the reporting interval in seconds. The default interval is 5 seconds. .RE .sp .ne 2 -.mk .na \fB\fIcount\fR\fR .ad .RS 12n -.rt Specifies the number of reports to produce. By default, \fBrcapstat\fR reports statistics until a termination signal is received or until the \fBrcapd\fR process exits. @@ -281,7 +247,7 @@ example# \fBrcapstat 5 5\fR 78194 user2 1 2368K 1928K 10M 0K 0K 0K 0K id project nproc vm rss cap at avgat pg avgpg 112270 user1 24 123M 35M 50M 0K 0K 0K 0K - 78194 user2 1 2368K 1928K 10M 0K 0K 0K 0K + 78194 user2 1 2368K 1928K 10M 0K 0K 0K 0K .fi .in -2 .sp @@ -373,34 +339,28 @@ processes to operate without perpetually incurring page faults. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt An error occurred. .RE .sp .ne 2 -.mk .na \fB\fB2\fR\fR .ad .RS 5n -.rt Invalid command-line options were specified. .RE diff --git a/usr/src/man/man1/rcp.1 b/usr/src/man/man1/rcp.1 index 5ba516393e..ebb0dbfbb5 100644 --- a/usr/src/man/man1/rcp.1 +++ b/usr/src/man/man1/rcp.1 @@ -1,10 +1,10 @@ '\" te .\" Copyright 1989 AT&T -.\" Copyright (C) 2003, Sun Microsystems, Inc. All Rights Reserved +.\" Copyright (C) 2003, 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 rcp 1 "23 Dec 2008" "SunOS 5.11" "User Commands" +.TH RCP 1 "Dec 23, 2008" .SH NAME rcp \- remote file copy .SH SYNOPSIS @@ -112,12 +112,10 @@ to the home directory of the user named \fIusername\fR, on the remote host. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 12n -.rt This option explicitly enables Kerberos authentication and trusts the \fB\&.k5login\fR file for access-control. If the authorization check by \fBin.rshd\fR(1M) on the server-side succeeds and if the \fB\&.k5login\fR file @@ -126,43 +124,36 @@ permits access, the user is allowed to carry out the \fBrcp\fR transfer. .sp .ne 2 -.mk .na \fB\fB-k\fR \fIrealm\fR\fR .ad .RS 12n -.rt Causes \fBrcp\fR to obtain tickets for the remote host in \fIrealm\fR instead of the remote host's realm as determined by \fBkrb5.conf\fR(4). .RE .sp .ne 2 -.mk .na \fB\fB-K\fR \fIrealm\fR\fR .ad .RS 12n -.rt This option explicitly disables Kerberos authentication. It canbe used to override the \fBautologin\fR variable in\fBkrb5.conf\fR(4). .RE .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 12n -.rt Attempts to give each copy the same modification times, access times, modes, and \fBACL\fRs if applicable as the original file. .RE .sp .ne 2 -.mk .na \fB\fB-PO\fR\fR .ad @@ -171,7 +162,6 @@ and \fBACL\fRs if applicable as the original file. \fB\fB-PN\fR\fR .ad .RS 12n -.rt Explicitly requests new (\fB-PN\fR) or old (\fB-PO\fR) version of the Kerberos "\fBrcmd\fR" protocol. The new protocol avoids many security problems prevalant in the old one and is regarded much more secure, but is not interoperable with @@ -184,24 +174,20 @@ new, more secure "\fBrcmd\fR" protocol is used. .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 12n -.rt Copies each subtree rooted at \fIfilename\fR; in this case the destination must be a directory. .RE .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad .RS 12n -.rt Causes the information transferred between hosts to be encrypted. Notice that the command is sent unencrypted to the remote system. All subsequent transfers are encrypted. @@ -235,23 +221,19 @@ only when Kerberos authentication is being done. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt All files were copied successfully. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -264,23 +246,19 @@ See the NOTES section for caveats on the exit code. \fB$HOME/.profile\fR .sp .ne 2 -.mk .na \fB\fB$HOME/.k5login\fR\fR .ad .RS 23n -.rt File containing Kerberos principals that are allowed access .RE .sp .ne 2 -.mk .na \fB\fB/etc/krb5/krb5.conf\fR\fR .ad .RS 23n -.rt Kerberos configuration file .RE @@ -292,13 +270,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled .TE .SH SEE ALSO diff --git a/usr/src/man/man1/rdist.1 b/usr/src/man/man1/rdist.1 index b51e7c667d..db3adbd46f 100644 --- a/usr/src/man/man1/rdist.1 +++ b/usr/src/man/man1/rdist.1 @@ -1,21 +1,21 @@ '\" 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) 2008, Sun Microsystems, Inc. All Rights Reserved -.TH rdist 1 "23 Dec 2008" "SunOS 5.11" "User Commands" +.TH RDIST 1 "Dec 23, 2008" .SH NAME rdist \- remote file distribution program .SH SYNOPSIS .LP .nf -\fBrdist\fR [\fB-b\fR] [\fB-D\fR] [\fB-h\fR] [\fB-i\fR] [\fB-n\fR] [\fB-q\fR] [\fB-R\fR] [\fB-a\fR] [\fB-K\fR] [\fB-x\fR] - [\fB-PN\fR | \fB-PO\fR] [\fB-k\fR \fIrealm\fR] [\fB-v\fR] [\fB-w\fR] [\fB-y\fR] +\fBrdist\fR [\fB-b\fR] [\fB-D\fR] [\fB-h\fR] [\fB-i\fR] [\fB-n\fR] [\fB-q\fR] [\fB-R\fR] [\fB-a\fR] [\fB-K\fR] [\fB-x\fR] + [\fB-PN\fR | \fB-PO\fR] [\fB-k\fR \fIrealm\fR] [\fB-v\fR] [\fB-w\fR] [\fB-y\fR] [\fB-d\fR \fImacro\fR \fI=\fR \fIvalue\fR] [\fB-f\fR \fIdistfile\fR] [\fB-m\fR \fIhost\fR]... .fi .LP .nf -\fBrdist\fR [\fB-b\fR] [\fB-D\fR] [\fB-h\fR] [\fB-i\fR] [\fB-n\fR] [\fB-q\fR] [\fB-R\fR] [\fB-a\fR] [\fB-K\fR] [\fB-x\fR] - [\fB-PN\fR | \fB-PO\fR] [\fB-k\fR \fIrealm\fR] [\fB-v\fR] [\fB-w\fR] [\fB-y\fR] \fB-c\fR \fIpathname\fR... +\fBrdist\fR [\fB-b\fR] [\fB-D\fR] [\fB-h\fR] [\fB-i\fR] [\fB-n\fR] [\fB-q\fR] [\fB-R\fR] [\fB-a\fR] [\fB-K\fR] [\fB-x\fR] + [\fB-PN\fR | \fB-PO\fR] [\fB-k\fR \fIrealm\fR] [\fB-v\fR] [\fB-w\fR] [\fB-y\fR] \fB-c\fR \fIpathname\fR... [\fIlogin\fR @] \fIhostname\fR [: \fIdestpath\fR] .fi @@ -67,7 +67,6 @@ information. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad @@ -81,7 +80,6 @@ permits access, the user is allowed to carry out the \fBrdist\fR transfer. .sp .ne 2 -.mk .na \fB\fB-b\fR\fR .ad @@ -93,7 +91,6 @@ differ, rather than merely comparing dates and sizes. .sp .ne 2 -.mk .na \fB\fB-c\fR \fIpathname\fR .\|.\|.[\fIlogin\|\fR\fB@\fR]\fIhostname\fR[\fB:\fR\fIdestpath\|\fR]\fR @@ -110,7 +107,6 @@ pathname. .sp .ne 2 -.mk .na \fB\fB-d\fR \fImacro\fR\fB=\fR\fIvalue\fR\fR .ad @@ -124,7 +120,6 @@ white space. .sp .ne 2 -.mk .na \fB\fB-D\fR\fR .ad @@ -135,7 +130,6 @@ Enables debugging. .sp .ne 2 -.mk .na \fB\fB-f\fR \fIdistfile\fR\fR .ad @@ -147,7 +141,6 @@ Uses the description file \fIdistfile\fR. A `\fB\(mi\fR\&' as the .sp .ne 2 -.mk .na \fB\fB-h\fR\fR .ad @@ -159,7 +152,6 @@ link itself. .sp .ne 2 -.mk .na \fB\fB-i\fR\fR .ad @@ -172,7 +164,6 @@ be found. .sp .ne 2 -.mk .na \fB\fB-k\fR \fIrealm\fR\fR .ad @@ -184,7 +175,6 @@ of the remote host's realm as determined by \fBkrb5.conf\fR(4). .sp .ne 2 -.mk .na \fB\fB-K\fR\fR .ad @@ -196,7 +186,6 @@ override the \fBautologin\fR variable in \fBkrb5.conf\fR(4). .sp .ne 2 -.mk .na \fB\fB-m\fR \fIhost\fR\fR .ad @@ -208,7 +197,6 @@ given to limit updates to a subset of the hosts listed in the distfile. .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad @@ -220,7 +208,6 @@ a distfile. .sp .ne 2 -.mk .na \fB\fB-PO\fR\fR .ad @@ -242,7 +229,6 @@ new, more secure "\fBrcmd\fR" protocol is used. .sp .ne 2 -.mk .na \fB\fB-q\fR\fR .ad @@ -253,7 +239,6 @@ Quiet mode. Does not display the files being updated on the standard output. .sp .ne 2 -.mk .na \fB\fB-R\fR\fR .ad @@ -266,7 +251,6 @@ This is useful for maintaining truly identical copies of directories. .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad @@ -278,7 +262,6 @@ of date are displayed, but no files are updated, nor is any mail sent. .sp .ne 2 -.mk .na \fB\fB-w\fR\fR .ad @@ -296,7 +279,6 @@ directory is appended to the destination name. .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad @@ -309,7 +291,6 @@ are encrypted. .sp .ne 2 -.mk .na \fB\fB-y\fR\fR .ad @@ -342,8 +323,8 @@ formats: .sp .in +2 .nf -\fIvariable_name\fR '=' \fIname_list\fR -[ label: ] \fIsource_list\fR '\fB->\fR' \fIdestination_list\fR \fIcommand_list\fR +\fIvariable_name\fR '=' \fIname_list\fR +[ label: ] \fIsource_list\fR '\fB->\fR' \fIdestination_list\fR \fIcommand_list\fR [ label: ] \fIsource_list\fR '\fB::\fR' \fItime_stamp_file\fR \fIcommand_list\fR .fi .in -2 @@ -433,7 +414,6 @@ The following primitives can be used to specify actions \fBrdist\fR is to take when updating remote copies of each file. .sp .ne 2 -.mk .na \fB\fBinstall\fR [\fB-b\fR] [\fB-h\fR] [\fB-i\fR] [\fB-R\fR] [\fB-v\fR] [\fB-w\fR] [\fB-y\fR] [\fInewname\fR]\fR @@ -457,7 +437,6 @@ under the username \fIlogin\fR. .sp .ne 2 -.mk .na \fB\fBnotify\fR \fIaddress.\|.\|.\fR\fR .ad @@ -474,7 +453,6 @@ name of the destination host to complete the address. .sp .ne 2 -.mk .na \fB\fBexcept\fR \fIfilename .\|.\|.\fR\fR .ad @@ -485,7 +463,6 @@ Omit from updates the files named as arguments. .sp .ne 2 -.mk .na \fB\fBexcept_pat\fR \fIpattern .\|.\|.\fR\fR .ad @@ -500,7 +477,6 @@ expansion is not supported. .sp .ne 2 -.mk .na \fB\fBspecial\fR [\fIfilename\fR] .\|.\|. \fB"\fR\fIcommand-line\|\fR\fB"\fR\fR .ad @@ -555,56 +531,46 @@ ${FILES} :: /usr/local/lib/timestamp .SH FILES .sp .ne 2 -.mk .na \fB\fB~/.rhosts\fR\fR .ad .RS 23n -.rt User's trusted hosts and users .RE .sp .ne 2 -.mk .na \fB\fB/etc/host.equiv\fR\fR .ad .RS 23n -.rt system trusted hosts and users .RE .sp .ne 2 -.mk .na \fB\fB/tmp/rdist*\fR\fR .ad .RS 23n -.rt Temporary file for update lists .RE .sp .ne 2 -.mk .na \fB\fB$HOME/.k5login\fR\fR .ad .RS 23n -.rt File containing Kerberos principals that are allowed access .RE .sp .ne 2 -.mk .na \fB\fB/etc/krb5/krb5.conf\fR\fR .ad .RS 23n -.rt Kerberos configuration file .RE diff --git a/usr/src/man/man1/read.1 b/usr/src/man/man1/read.1 index 1e443939f0..ec5a1a8797 100644 --- a/usr/src/man/man1/read.1 +++ b/usr/src/man/man1/read.1 @@ -3,14 +3,14 @@ .\" Copyright 1989 AT&T .\" Portions Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved .\" Portions Copyright (c) 1982-2007 AT&T Knowledge Ventures -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 read 1 "18 Dec 2007" "SunOS 5.11" "User Commands" +.TH READ 1 "Dec 18, 2007" .SH NAME read \- read a line from standard input .SH SYNOPSIS @@ -173,12 +173,10 @@ displays a prompt on standard error when standard input is a terminal or pipe. The following option is supported by \fB/usr/bin/read\fR and \fBksh\fR: .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 6n -.rt Do not treat a backslash character in any special way. Considers each backslash to be part of the input line. .RE @@ -189,114 +187,94 @@ to be part of the input line. The following options are supported by \fBksh93\fR: .sp .ne 2 -.mk .na \fB\fB-A\fR\fR .ad .RS 14n -.rt Unset \fIvar\fR, and create an indexed array containing each field in the line starting at index \fB0\fR. .RE .sp .ne 2 -.mk .na \fB\fB-d\fR \fIdelim\fR\fR .ad .RS 14n -.rt Read until delimiter \fIdelim\fR instead of to the end of line. .RE .sp .ne 2 -.mk .na \fB\fB-n\fR \fInsize\fR\fR .ad .RS 14n -.rt Read at most \fInsize\fR bytes. Binary field size is in bytes. .RE .sp .ne 2 -.mk .na \fB\fB-N\fR \fInsize\fR\fR .ad .RS 14n -.rt Read exactly \fInsize\fR bytes. Binary field size is in bytes. .RE .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 14n -.rt Read from the current co-process instead of standard input. An end of file causes \fBread\fR to disconnect the co-process so that another can be created. .RE .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 14n -.rt Do not treat \fB\e\fR specially when processing the input line. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 14n -.rt Save a copy of the input as an entry in the shell history file. .RE .sp .ne 2 -.mk .na \fB\fB-t\fR \fItimeout\fR\fR .ad .RS 14n -.rt Specify a \fItimeout\fR in seconds when reading from a terminal or pipe. .RE .sp .ne 2 -.mk .na \fB\fB-u\fR \fIfd\fR\fR .ad .RS 14n -.rt Read from file descriptor number \fIfd\fR instead of standard input. The default value is \fB0\fR. .RE .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 14n -.rt When reading from a terminal, display the value of the first variable and use it as a default value. .RE @@ -307,12 +285,10 @@ it as a default value. The following operand is supported: .sp .ne 2 -.mk .na \fB\fIvar\fR\fR .ad .RS 7n -.rt The name of an existing or non-existing shell variable. .RE @@ -343,23 +319,19 @@ that affect the execution of \fBread\fR: \fBLANG\fR, \fBLC_ALL\fR, \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and \fBNLSPATH\fR. .sp .ne 2 -.mk .na \fB\fBIFS\fR\fR .ad .RS 7n -.rt Determines the internal field separators used to delimit fields. .RE .sp .ne 2 -.mk .na \fB\fBPS2\fR\fR .ad .RS 7n -.rt Provides the prompt string that an interactive shell writes to standard error when a line ending with a backslash is read and the \fB-r\fR option was not specified, or if a here-document is not terminated after a NEWLINE character is @@ -372,23 +344,19 @@ entered. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt End-of-file was detected or an error occurred. .RE @@ -401,15 +369,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .SS "ksh93" @@ -417,13 +384,12 @@ StandardSee \fBstandards\fR(5). .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityUncommitted +Interface Stability Uncommitted .TE .SH SEE ALSO diff --git a/usr/src/man/man1/readonly.1 b/usr/src/man/man1/readonly.1 index 8fab089559..40f6f7c0a5 100644 --- a/usr/src/man/man1/readonly.1 +++ b/usr/src/man/man1/readonly.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 readonly 1 "2 Nov 2007" "SunOS 5.11" "User Commands" +.TH READONLY 1 "Nov 2, 2007" .SH NAME readonly \- shell built-in function to protect the value of the given variable from reassignment @@ -135,12 +135,10 @@ splitting and pathname expansion are not performed on the arguments. Tilde expansion occurs on value. .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 6n -.rt Causes the output to be in a form of \fBreadonly\fR commands that can be used as input to the shell to recreate the current set of \fBreadonly\fR variables. .RE @@ -185,23 +183,19 @@ field splitting and file name generation are not performed. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE diff --git a/usr/src/man/man1/refer.1 b/usr/src/man/man1/refer.1 index 0977e24854..4170b58344 100644 --- a/usr/src/man/man1/refer.1 +++ b/usr/src/man/man1/refer.1 @@ -3,13 +3,13 @@ .\" 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 refer 1 "14 Sep 1992" "SunOS 5.11" "User Commands" +.TH REFER 1 "Sep 14, 1992" .SH NAME refer \- expand and insert references from a bibliographic database .SH SYNOPSIS .LP .nf -\fBrefer\fR [\fB-ben\fR] [\fB-a\fR\fIr\fR] [\fB-c\fR\fIstring\fR] [\fB-k\fR\fIx\fR] [\fB-l\fR\fIm,n\fR] [\fB-p\fR \fIfilename\fR] +\fBrefer\fR [\fB-ben\fR] [\fB-a\fR\fIr\fR] [\fB-c\fR\fIstring\fR] [\fB-k\fR\fIx\fR] [\fB-l\fR\fIm,n\fR] [\fB-p\fR \fIfilename\fR] [\fB-s\fR\fIkeys\fR] \fIfilename\fR... .fi @@ -34,23 +34,19 @@ data passed through pipes. .SH OPTIONS .sp .ne 2 -.mk .na \fB\fB-b\fR\fR .ad .RS 15n -.rt Bare mode \(em do not put any flags in text (neither numbers or labels). .RE .sp .ne 2 -.mk .na \fB\fB-e\fR\fR .ad .RS 15n -.rt Accumulate references instead of leaving the references where encountered, until a sequence of the form: .sp @@ -69,58 +65,48 @@ references to the same source. .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 15n -.rt Do not search the default file. .RE .sp .ne 2 -.mk .na \fB\fB-a\fR\fIr\fR\fR .ad .RS 15n -.rt Reverse the first \fIr\fR author names (Jones, J. A. instead of J. A. Jones). If \fIr\fR is omitted, all author names are reversed. .RE .sp .ne 2 -.mk .na \fB\fB-c\fR\fIstring\fR\fR .ad .RS 15n -.rt Capitalize (with SMALL CAPS) the fields whose key-letters are in \fIstring\fR. .RE .sp .ne 2 -.mk .na \fB\fB-k\fR\fIx\fR\fR .ad .RS 15n -.rt Instead of numbering references, use labels as specified in a reference data line beginning with the characters \fI%x\fR; By default, \fIx\fR is \fBL\fR. .RE .sp .ne 2 -.mk .na \fB\fB-l\fR\fIm,n\fR\fR .ad .RS 15n -.rt Instead of numbering references, use labels from the senior author's last name and the year of publication. Only the first \fIm\fR letters of the last name and the last \fIn\fR digits of the date are used. If either of \fIm\fR or @@ -129,24 +115,20 @@ and the last \fIn\fR digits of the date are used. If either of \fIm\fR or .sp .ne 2 -.mk .na \fB\fB-p\fR\fI filename\fR\fR .ad .RS 15n -.rt Take the next argument as a file of references to be searched. The default file is searched last. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fIkeys\fR\fR .ad .RS 15n -.rt Sort references by fields whose key-letters are in the \fIkeys\fR string, and permute reference numbers in the text accordingly. Using this option implies the \fB-e\fR option. The key-letters in \fIkeys\fR may be followed by a number @@ -159,23 +141,19 @@ the options `\fB-sA+T\fR'. .SH FILES .sp .ne 2 -.mk .na \fB\fB/usr/lib/refer\fR\fR .ad .RS 25n -.rt directory of programs .RE .sp .ne 2 -.mk .na \fB\fB/usr/lib/refer/papers\fR\fR .ad .RS 25n -.rt directory of default publication lists and indexes .RE diff --git a/usr/src/man/man1/regcmp.1 b/usr/src/man/man1/regcmp.1 index 0089b4e8c1..e016d17456 100644 --- a/usr/src/man/man1/regcmp.1 +++ b/usr/src/man/man1/regcmp.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 regcmp 1 "Dec 20 1996" "SunOS 5.11" "User Commands" +.TH REGCMP 1 "Dec 20, 1996" .SH NAME regcmp \- regular expression compile .SH SYNOPSIS @@ -23,12 +23,10 @@ places the output in \fIfilename\fR\fB\&.i\fR. .SH OPTIONS .sp .ne 2 -.mk .na \fB\fB\(mi\fR \fR .ad .RS 9n -.rt If the \fB\(mi\fR option is used, the output is placed in \fIfilename\fR\fB\&.c\fR. The format of entries in \fIfilename\fR is a name (C variable) followed by one or more blanks followed by one or more regular @@ -46,23 +44,19 @@ self-explanatory. \fBExample 1 \fRExamples of the \fBregcmp\fR command. .sp .ne 2 -.mk .na \fBname \fR .ad .RS 9n -.rt \fB"([A\(miZa\(miz][A\(miZa\(miz0\(mi9_]*)$0"\fR .RE .sp .ne 2 -.mk .na \fBtelno\fR .ad .RS 9n -.rt \fB"\|\e({0,1}([2\(mi9][01][1\(mi9])$0\e){0,1} *"\fR .sp \fB"([2\(mi9][0\(mi9]{2})$1[ \(mi]{0,1}"\fR @@ -97,12 +91,10 @@ A general description of the usage of the \fBLC_*\fR environmental variables can be found in \fBenviron\fR(5). .sp .ne 2 -.mk .na \fB\fBLC_CTYPE\fR \fR .ad .RS 16n -.rt Determines how \fBregcmp\fR handles characters. When \fBLC_CTYPE\fR is set to a valid value, \fBregcmp\fR can display and handle text and filenames containing valid characters for that locale. @@ -110,12 +102,10 @@ valid characters for that locale. .sp .ne 2 -.mk .na \fB\fBLC_MESSAGES\fR \fR .ad .RS 16n -.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 @@ -130,12 +120,11 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE -CSIEnabled +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE +CSI Enabled .TE .SH SEE ALSO diff --git a/usr/src/man/man1/renice.1 b/usr/src/man/man1/renice.1 index e1b70dbc61..1fe1692e92 100644 --- a/usr/src/man/man1/renice.1 +++ b/usr/src/man/man1/renice.1 @@ -1,14 +1,14 @@ '\" te .\" Copyright (c) 2004, Sun Microsystems, Inc. All Rights Reserved .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 renice 1 "9 Jan 2004" "SunOS 5.11" "User Commands" +.TH RENICE 1 "Jan 9, 2004" .SH NAME renice \- alter priority of running processes .SH SYNOPSIS @@ -24,19 +24,19 @@ renice \- alter priority of running processes .LP .nf -\fBrenice\fR \fIpriority\fR [\fB-p\fR] \fIpid\fR... [\fB-g\fR \fIgid\fR]... [\fB-p\fR \fIpid\fR]... +\fBrenice\fR \fIpriority\fR [\fB-p\fR] \fIpid\fR... [\fB-g\fR \fIgid\fR]... [\fB-p\fR \fIpid\fR]... [\fB-u\fR \fIuser\fR]... .fi .LP .nf -\fBrenice\fR \fIpriority\fR \fB-g\fR \fIgid\fR... [\fB-g\fR \fIgid\fR]... [\fB-p\fR \fIpid\fR]... +\fBrenice\fR \fIpriority\fR \fB-g\fR \fIgid\fR... [\fB-g\fR \fIgid\fR]... [\fB-p\fR \fIpid\fR]... [\fB-u\fR \fIuser\fR]... .fi .LP .nf -\fBrenice\fR \fIpriority\fR \fB-u\fR \fIuser\fR... [\fB-g\fR \fIgid\fR]... [\fB-p\fR \fIpid\fR]... +\fBrenice\fR \fIpriority\fR \fB-u\fR \fIuser\fR... [\fB-g\fR \fIgid\fR]... [\fB-p\fR \fIpid\fR]... [\fB-u\fR \fIuser\fR]... .fi @@ -101,24 +101,20 @@ list. This is preferred in specifying \fIID\fR type over the use of the The following options are supported: .sp .ne 2 -.mk .na \fB\fB-g\fR\fR .ad .RS 16n -.rt Interprets all operands or just the \fIgid\fR arguments as unsigned decimal integer process group IDs. .RE .sp .ne 2 -.mk .na \fB\fB-i\fR\fR .ad .RS 16n -.rt This option, together with the \fIID\fR list arguments, specifies a class of processes to which the \fBrenice\fR command is to apply. The interpretation of the \fBID\fR list depends on the value of \fIidtype\fR. The valid \fIidtype\fR @@ -128,12 +124,10 @@ arguments are: \fBpid\fR, \fBpgid\fR, \fBuid\fR, \fBgid\fR, \fBsid\fR, .sp .ne 2 -.mk .na \fB\fB-n\fR \fIincrement\fR\fR .ad .RS 16n -.rt Specifies how the system scheduling priority of the specified process or processes is to be adjusted. The \fIincrement\fR option-argument is a positive or negative decimal integer that will be used to modify the system scheduling @@ -145,12 +139,10 @@ priority. .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 16n -.rt Interprets all operands or just the \fIpid\fR arguments as unsigned decimal integer process \fBID\fRs. The \fB-p\fR option is the default if no options are specified. @@ -158,12 +150,10 @@ specified. .sp .ne 2 -.mk .na \fB\fB-u\fR\fR .ad .RS 16n -.rt Interprets all operands or just the \fIuser\fR argument as users. If a user exists with a user name equal to the operand, then the user \fBID\fR of that user will be used in further processing. Otherwise, if the operand represents @@ -177,24 +167,20 @@ the user. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIID\fR\fR .ad .RS 12n -.rt A process \fBID\fR, process group \fBID\fR, or user name/user \fBID\fR, depending on the option selected. .RE .sp .ne 2 -.mk .na \fB\fIpriority\fR\fR .ad .RS 12n -.rt The value specified is taken as the actual system scheduling priority, rather than as an increment to the existing system scheduling priority. Specifying a scheduling priority higher than that of the existing process may require @@ -260,35 +246,29 @@ that affect the execution of \fBrenice\fR: \fBLANG\fR, \fBLC_ALL\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB/etc/passwd\fR\fR .ad .RS 15n -.rt map user names to user \fBID\fRs .RE @@ -300,13 +280,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man1/rev.1 b/usr/src/man/man1/rev.1 index 3bc23eb1a9..e7f4321a6e 100644 --- a/usr/src/man/man1/rev.1 +++ b/usr/src/man/man1/rev.1 @@ -2,7 +2,7 @@ .\" Copyright (c) 1982-2007 AT&T Knowledge Ventures .\" To view license terms, see http://www.opensource.org/licenses/cpl1.0.txt .\" Portions Copyright (c) 2009, Sun Microsystems, Inc. All Rights Reserved. -.TH rev 1 "11 Aug 2009" "SunOS 5.11" "User Commands" +.TH REV 1 "Aug 11, 2009" .SH NAME rev \- reverse the characters or lines of one or more files .SH SYNOPSIS @@ -29,7 +29,6 @@ file if \fB-l\fR is specified The following options are supported: .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad @@ -38,7 +37,6 @@ The following options are supported: \fB\fB--line\fR\fR .ad .RS 10n -.rt Reverse the order of the lines of the file, instead of characters. .RE @@ -48,12 +46,10 @@ Reverse the order of the lines of the file, instead of characters. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIfile\fR\fR .ad .RS 8n -.rt Specifies the name of the file to use as input. .sp If \fIfile\fR is not specified, or if \fIfile\fR is a \fB-\fR, \fBrev\fR copies @@ -66,23 +62,19 @@ from standard input starting at the current offset. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt All files copied successfully. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt One or more files did not copy. .RE @@ -94,15 +86,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityCommitted +Interface Stability Committed .TE .SH SEE ALSO diff --git a/usr/src/man/man1/rlogin.1 b/usr/src/man/man1/rlogin.1 index 5fd3e724fa..81c471a1e1 100644 --- a/usr/src/man/man1/rlogin.1 +++ b/usr/src/man/man1/rlogin.1 @@ -1,16 +1,16 @@ '\" te .\" Copyright 1989 AT&T -.\" Copyright (C) 2008, Sun Microsystems, Inc. All Rights Reserved +.\" Copyright (C) 2008, 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 rlogin 1 "23 Dec 2008" "SunOS 5.11" "User Commands" +.TH RLOGIN 1 "Dec 23, 2008" .SH NAME rlogin \- remote login .SH SYNOPSIS .LP .nf -\fBrlogin\fR [\fB-8EL\fR] [\fB-e\fIc\fR\fR ] [\fB-A\fR] [\fB-K\fR] [\fB-x\fR] [\fB-PN\fR | \fB-PO\fR] [\fB-f\fR | \fB-F\fR] [\fB-a\fR] +\fBrlogin\fR [\fB-8EL\fR] [\fB-e\fIc\fR\fR ] [\fB-A\fR] [\fB-K\fR] [\fB-x\fR] [\fB-PN\fR | \fB-PO\fR] [\fB-f\fR | \fB-F\fR] [\fB-a\fR] [\fB-l\fR \fIusername\fR] [\fB-k\fR \fIrealm\fR] \fIhostname\fR .fi @@ -60,35 +60,29 @@ handled properly. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-8\fR\fR .ad .RS 15n -.rt Passes eight-bit data across the net instead of seven-bit data. .RE .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 15n -.rt Forces the remote machine to ask for a password by sending a null local username. .RE .sp .ne 2 -.mk .na \fB\fB-A\fR\fR .ad .RS 15n -.rt Explicitly enables Kerberos authentication and trusts the \fB\&.k5login\fR file for access-control. If the authorization check by \fBin.rlogind\fR(1M) on the server-side succeeds and if the \fB\&.k5login\fR file permits access, the user @@ -97,35 +91,29 @@ is allowed to login without supplying a password. .sp .ne 2 -.mk .na \fB\fB-e\fR\fIc\fR\fR .ad .RS 15n -.rt Specifies a different escape character, \fIc\fR, for the line used to disconnect from the remote host. .RE .sp .ne 2 -.mk .na \fB\fB-E\fR\fR .ad .RS 15n -.rt Stops any character from being recognized as an escape character. .RE .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 15n -.rt Forwards a copy of the local credentials (Kerberos Ticket Granting Ticket) to the remote system. This is a non-forwardable ticket granting ticket. You must forward a ticket granting ticket if you need to authenticate yourself to other @@ -137,12 +125,10 @@ directory. This option is mutually exclusive with the \fB-F\fR option. .sp .ne 2 -.mk .na \fB\fB-F\fR\fR .ad .RS 15n -.rt Forwards a forwardable copy of the local credentials (Kerberos Ticket Granting Ticket) to the remote system. The \fB-F\fR option provides a superset of the functionality offered by the \fB-f\fR option. For example, with the \fB-f\fR @@ -155,54 +141,45 @@ This option is mutually exclusive with the \fB-f\fR option. .sp .ne 2 -.mk .na \fB\fB-k\fR \fIrealm\fR\fR .ad .RS 15n -.rt Causes \fBrlogin\fR to obtain tickets for the remote host in \fIrealm\fR instead of the remote host's realm as determined by \fBkrb5.conf\fR(4). .RE .sp .ne 2 -.mk .na \fB\fB-K\fR\fR .ad .RS 15n -.rt This option explicitly disables Kerberos authentication. It can be used to override the \fBautologin\fR variable in \fBkrb5.conf\fR(4). .RE .sp .ne 2 -.mk .na \fB\fB-l\fR \fIusername\fR\fR .ad .RS 15n -.rt Specifies a different \fIusername\fR for the remote login. If you do not use this option, the remote username used is the same as your local username. .RE .sp .ne 2 -.mk .na \fB\fB-L\fR\fR .ad .RS 15n -.rt Allows the rlogin session to be run in "\fBlitout\fR" mode. .RE .sp .ne 2 -.mk .na \fB\fB-PN\fR\fR .ad @@ -211,7 +188,6 @@ Allows the rlogin session to be run in "\fBlitout\fR" mode. \fB\fB-PO\fR\fR .ad .RS 15n -.rt Explicitly requests the new (\fB-PN\fR) or old (\fB-PO\fR) version of the Kerberos `\fBrcmd\fR' protocol. The new protocol avoids many security problems prevalant in the old one and is considered much more secure, but is not @@ -225,12 +201,10 @@ protocol is used. .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad .RS 15n -.rt Turns on \fBDES\fR encryption for all data passed through the rlogin session. This reduces response time and increases \fBCPU\fR utilization. .RE @@ -242,36 +216,30 @@ Lines that you type which start with the tilde character (\fB~\fR) are "escape sequences." The escape character can be changed using the \fB-e\fR option. .sp .ne 2 -.mk .na \fB\fB~.\fR\fR .ad .RS 10n -.rt Disconnects from the remote host. This is not the same as a logout, because the local host breaks the connection with no warning to the remote end. .RE .sp .ne 2 -.mk .na \fB\fB~susp\fR\fR .ad .RS 10n -.rt Suspends the login session, but only if you are using a shell with Job Control. \fBsusp\fR is your "suspend" character, usually Control-Z. See \fBtty\fR(1). .RE .sp .ne 2 -.mk .na \fB\fB~dsusp\fR\fR .ad .RS 10n -.rt Suspends the input half of the login, but output is still able to be seen (only if you are using a shell with Job Control). \fBdsusp\fR is your "deferred suspend" character, usually Control-Y. See \fBtty\fR(1). @@ -280,12 +248,10 @@ suspend" character, usually Control-Y. See \fBtty\fR(1). .SH OPERANDS .sp .ne 2 -.mk .na \fB\fIhostname\fR\fR .ad .RS 12n -.rt The remote machine on which \fIrlogin\fR establishes the remote login session. .RE @@ -329,89 +295,73 @@ remote user or by root. .SH FILES .sp .ne 2 -.mk .na \fB\fB/etc/passwd\fR\fR .ad .RS 23n -.rt Contains information about users' accounts. .RE .sp .ne 2 -.mk .na \fB\fB/usr/hosts/*\fR\fR .ad .RS 23n -.rt For \fIhostname\fR version of the command. .RE .sp .ne 2 -.mk .na \fB\fB/etc/hosts.equiv\fR\fR .ad .RS 23n -.rt List of trusted hostnames with shared user names. .RE .sp .ne 2 -.mk .na \fB\fB/etc/nologin\fR\fR .ad .RS 23n -.rt Message displayed to users attempting to login during machine shutdown. .RE .sp .ne 2 -.mk .na \fB\fB$HOME/.rhosts\fR\fR .ad .RS 23n -.rt Private list of trusted hostname/username combinations. .RE .sp .ne 2 -.mk .na \fB\fB$HOME/.k5login\fR\fR .ad .RS 23n -.rt File containing Kerberos principals that are allowed access. .RE .sp .ne 2 -.mk .na \fB\fB/etc/krb5/krb5.conf\fR\fR .ad .RS 23n -.rt Kerberos configuration file. .RE .sp .ne 2 -.mk .na \fB\fB/etc/hosts\fR\fR .ad .RS 23n -.rt Hosts database. .RE diff --git a/usr/src/man/man1/rm.1 b/usr/src/man/man1/rm.1 index 97261f57a6..2759a344d9 100644 --- a/usr/src/man/man1/rm.1 +++ b/usr/src/man/man1/rm.1 @@ -3,14 +3,14 @@ .\" Copyright 1989 AT&T .\" Portions Copyright (c) 1982-2007 AT&T Knowledge Ventures .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 rm 1 "20 Nov 2007" "SunOS 5.11" "User Commands" +.TH RM 1 "Nov 20, 2007" .SH NAME rm, rmdir \- remove directory entries .SH SYNOPSIS @@ -96,12 +96,10 @@ The following options are supported for \fB/usr/bin/rm\fR and \fB/usr/xpg4/bin/rm\fR: .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 6n -.rt Recursively removes directories and subdirectories in the argument list. The directory is emptied of files and removed. The user is normally prompted for removal of any write-protected files which the directory contains. The @@ -118,12 +116,10 @@ error message. .sp .ne 2 -.mk .na \fB\fB-R\fR\fR .ad .RS 6n -.rt Same as \fB-r\fR option. .RE @@ -133,12 +129,10 @@ Same as \fB-r\fR option. The following options are supported for \fB/usr/bin/rm\fR only: .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 6n -.rt Removes all files (whether write-protected or not) in a directory without prompting the user. In a write-protected directory, however, files are never removed (whatever their permissions are), but no messages are displayed. If the @@ -148,12 +142,10 @@ suppress an error message. .sp .ne 2 -.mk .na \fB\fB-i\fR\fR .ad .RS 6n -.rt Interactive. With this option, \fBrm\fR prompts for confirmation before removing any files. It overrides the \fB-f\fR option and remains in effect even if the standard input is not a terminal. @@ -165,12 +157,10 @@ if the standard input is not a terminal. The following options are supported for \fB/usr/xpg4/bin/rm\fR only: .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 6n -.rt Does not prompt for confirmation. Does not write diagnostic messages or modify the exit status in the case of non-existent operands. Any previous occurrences of the \fB-i\fR option is ignored. @@ -178,12 +168,10 @@ of the \fB-i\fR option is ignored. .sp .ne 2 -.mk .na \fB\fB-i\fR\fR .ad .RS 6n -.rt Prompts for confirmation. Any occurrences of the \fB-f\fR option is ignored. .RE @@ -193,12 +181,10 @@ Prompts for confirmation. Any occurrences of the \fB-f\fR option is ignored. The following options are supported for \fB/usr/bin/rmdir\fR only: .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 6n -.rt Allows users to remove the directory \fIdirname\fR and its parent directories which become empty. A message is printed to standard error if all or part of the path could not be removed. @@ -206,12 +192,10 @@ the path could not be removed. .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 6n -.rt Suppresses the message printed on the standard error when \fB-p\fR is in effect. .RE @@ -223,7 +207,6 @@ The following options are supported for the \fBrmdir\fR built-in for \fBksh93\fR: .sp .ne 2 -.mk .na \fB\fB-e\fR\fR .ad @@ -232,13 +215,11 @@ The following options are supported for the \fBrmdir\fR built-in for \fB\fB--ignore-fail-on-non-empty\fR\fR .ad .RS 30n -.rt Ignore each non-empty directory failure. .RE .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad @@ -247,14 +228,12 @@ Ignore each non-empty directory failure. \fB\fB--parents\fR\fR .ad .RS 30n -.rt Remove each explicit directory argument directory that becomes empty after its child directories are removed. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad @@ -263,7 +242,6 @@ child directories are removed. \fB\fB--suppress\fR\fR .ad .RS 30n -.rt Suppress the message printed on the standard error when \fB-p\fR is in effect. .RE @@ -273,23 +251,19 @@ Suppress the message printed on the standard error when \fB-p\fR is in effect. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIfile\fR\fR .ad .RS 11n -.rt Specifies the pathname of a directory entry to be removed. .RE .sp .ne 2 -.mk .na \fB\fIdirname\fR\fR .ad .RS 11n -.rt Specifies the pathname of an empty directory to be removed. .RE @@ -373,24 +347,20 @@ expression defined for the \fByesexpr\fR. See \fBlocale\fR(5). The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt If the \fB-f\fR option was not specified, all the named directory entries were removed; otherwise, all the existing named directory entries were removed. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -400,23 +370,19 @@ An error occurred. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. All directories deleted successfully. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. One or more directories could not be deleted. .RE @@ -429,13 +395,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled .TE .SS "/usr/xpg4/bin/rm" @@ -443,17 +408,16 @@ CSIEnabled .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityCommitted +Interface Stability Committed _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .SS "ksh93" @@ -461,13 +425,12 @@ StandardSee \fBstandards\fR(5). .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilitySee below. +Interface Stability See below. .TE .sp diff --git a/usr/src/man/man1/rmformat.1 b/usr/src/man/man1/rmformat.1 index d2f5452380..36168e60ae 100644 --- a/usr/src/man/man1/rmformat.1 +++ b/usr/src/man/man1/rmformat.1 @@ -3,13 +3,13 @@ .\" 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 rmformat 1 "19 Feb 2009" "SunOS 5.11" "User Commands" +.TH RMFORMAT 1 "Feb 19, 2009" .SH NAME rmformat \- removable rewritable media format utility .SH SYNOPSIS .LP .nf -\fBrmformat\fR [\fB-DeHUv\fR] [\fB-b\fR \fIlabel\fR] [\fB-c\fR \fIblockno\fR] +\fBrmformat\fR [\fB-DeHUv\fR] [\fB-b\fR \fIlabel\fR] [\fB-c\fR \fIblockno\fR] [\fB-F\fRquick | long | force ] [\fB-s\fR \fIfilename\fR] [\fIdevname\fR] .fi @@ -46,7 +46,6 @@ information can be changed with the help of other options provided by The following options are supported: .sp .ne 2 -.mk .na \fB\fB-b\fR \fIlabel\fR\fR .ad @@ -59,7 +58,6 @@ writing a \fBDOS\fR Volume label, the user should use \fBmkfs_pcfs\fR(1M). .sp .ne 2 -.mk .na \fB\fB-c\fR \fIblockno\fR\fR .ad @@ -80,7 +78,6 @@ block management. .sp .ne 2 -.mk .na \fB\fB-D\fR\fR .ad @@ -93,7 +90,6 @@ extended-density type. .sp .ne 2 -.mk .na \fB\fB-e\fR\fR .ad @@ -105,7 +101,6 @@ drive does not support motorized eject. .sp .ne 2 -.mk .na \fB\fB-F\fR quick | long | force\fR .ad @@ -130,7 +125,6 @@ memory cards, all options start a long format. .sp .ne 2 -.mk .na \fB\fB-H\fR\fR .ad @@ -143,7 +137,6 @@ type. .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad @@ -157,7 +150,6 @@ shows the device pathname, vendor information, and the device type. .sp .ne 2 -.mk .na \fB\fB-s\fR \fIfilename\fR\fR .ad @@ -170,7 +162,7 @@ format providing byte offset, size required, tags, and flags, as follows: .sp .in +2 .nf -slices: \fIn\fR = \fIoffset\fR, \fIsize\fR [, \fIflags\fR, \fItags\fR] +slices: \fIn\fR = \fIoffset\fR, \fIsize\fR [, \fIflags\fR, \fItags\fR] .fi .in -2 .sp @@ -216,8 +208,8 @@ For example: .sp .in +2 .nf -slices: 0 = 0, 30MB, "wm", "home" : - 1 = 30MB, 51MB : +slices: 0 = 0, 30MB, "wm", "home" : + 1 = 30MB, 51MB : 2 = 0, 100MB, "wm", "backup" : 6 = 81MB, 19MB .fi @@ -240,7 +232,6 @@ cautious in using this option on such devices. .sp .ne 2 -.mk .na \fB\fB-U\fR\fR .ad @@ -253,7 +244,6 @@ format on the device requested. .sp .ne 2 -.mk .na \fB\fB-V\fR read | write\fR .ad @@ -277,7 +267,6 @@ repairing. The following operand is supported: .sp .ne 2 -.mk .na \fB\fIdevname\fR\fR .ad @@ -330,7 +319,7 @@ newfs: construct a new file system /dev/rdiskette: (y/n)? \fBy\fR 1.4MB in 5 cyl groups (16 c/g, 0.28MB/g, 128 i/g) super-block backups (for fsck -F ufs -o b=#) at: 32, 640, 1184, 1792, 2336, -# +# .fi .in -2 .sp @@ -402,7 +391,6 @@ Access permissions: Medium is not write protected. .SH FILES .sp .ne 2 -.mk .na \fB\fB/dev/diskette0\fR\fR .ad @@ -413,7 +401,6 @@ Directory providing block device access for the media in floppy drive 0. .sp .ne 2 -.mk .na \fB\fB/dev/rdiskette0\fR\fR .ad @@ -424,7 +411,6 @@ Directory providing character device access for the media in floppy drive 0. .sp .ne 2 -.mk .na \fB\fB/dev/aliases\fR\fR .ad @@ -436,7 +422,6 @@ media under the control of volume management using appropriate alias. .sp .ne 2 -.mk .na \fB\fB/dev/aliases/floppy0\fR\fR .ad @@ -447,7 +432,6 @@ Symbolic link to the character device for the media in floppy drive 0. .sp .ne 2 -.mk .na \fB\fB/dev/rdiskette\fR\fR .ad @@ -459,7 +443,6 @@ floppy drive, usually drive 0. .sp .ne 2 -.mk .na \fB\fB/dev/dsk\fR\fR .ad @@ -471,7 +454,6 @@ cards and removable media devices. .sp .ne 2 -.mk .na \fB\fB/dev/rdsk\fR\fR .ad @@ -483,7 +465,6 @@ cards and removable media devices. .sp .ne 2 -.mk .na \fB\fB/dev/aliases/pcmemS\fR\fR .ad @@ -495,7 +476,6 @@ socket S, where S represents a \fBPCMCIA\fR socket number. .sp .ne 2 -.mk .na \fB\fB/dev/aliases/rmdisk0\fR\fR .ad @@ -507,7 +487,6 @@ floppy, \fBDVD-ROM\fR, \fBPCMCIA\fR memory card, and so forth. .sp .ne 2 -.mk .na \fB\fB/dev/rdsk\fR\fR .ad @@ -519,7 +498,6 @@ cards and other removable devices. .sp .ne 2 -.mk .na \fB\fB/dev/dsk\fR\fR .ad diff --git a/usr/src/man/man1/rmmount.1 b/usr/src/man/man1/rmmount.1 index ab568518ca..dc854826db 100644 --- a/usr/src/man/man1/rmmount.1 +++ b/usr/src/man/man1/rmmount.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 rmmount 1 "18 Sep 2006" "SunOS 5.11" "User Commands" +.TH RMMOUNT 1 "Sep 18, 2006" .SH NAME rmmount, rmumount \- mounts and unmounts removable media .SH SYNOPSIS @@ -47,24 +47,20 @@ to optionally unmount and eject the media. The following options are supported for \fBrmmount\fR and \fBrmumount\fR: .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad .RS 6n -.rt Display the device path of the default device. This device is used if no arguments are supplied. .RE .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 6n -.rt Display the paths and nicknames of mountable devices. .RE @@ -73,24 +69,20 @@ Display the paths and nicknames of mountable devices. The following options are supported for \fBrmmount\fR only: .sp .ne 2 -.mk .na \fB\fB-o\fR \fIoptions\fR\fR .ad .RS 14n -.rt Display mount options. This option can only be used by users that have privileges to override the system default options. .RE .sp .ne 2 -.mk .na \fB\fB-u\fR\fR .ad .RS 14n -.rt Unmounts the volume as opposed to mounting it. .RE @@ -100,36 +92,30 @@ Unmounts the volume as opposed to mounting it. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIdevice\fR\fR .ad .RS 15n -.rt Specifies which device to mount or unmount, by the name it appears in the directory \fB/dev\fR. .RE .sp .ne 2 -.mk .na \fB\fImount_point\fR\fR .ad .RS 15n -.rt Specifies which device to mount or unmount, by the name it appears in the directory \fB/dev\fR. .RE .sp .ne 2 -.mk .na \fB\fInickname\fR\fR .ad .RS 15n -.rt Specifies which device to mount or unmount, by its nickname as known to this command. .RE @@ -169,35 +155,29 @@ example% rmumount /dev/dsk/c4t0d0p0:1 The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB>\fB0\fR\fR .ad .RS 6n -.rt An error occurred. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB/media\fR\fR .ad .RS 10n -.rt Default mount root. .RE @@ -209,13 +189,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityUncommitted +Interface Stability Uncommitted .TE .SH SEE ALSO diff --git a/usr/src/man/man1/roffbib.1 b/usr/src/man/man1/roffbib.1 index ce6aa27276..4ae604559e 100644 --- a/usr/src/man/man1/roffbib.1 +++ b/usr/src/man/man1/roffbib.1 @@ -3,13 +3,13 @@ .\" 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 roffbib 1 "14 Sep 1992" "SunOS 5.11" "User Commands" +.TH ROFFBIB 1 "Sep 14, 1992" .SH NAME roffbib \- format and print a bibliographic database .SH SYNOPSIS .LP .nf -\fBroffbib\fR [\fB-e\fR] [\fB-h\fR] [\fB-m\fR \fIfilename\fR] [\fB-n\fR\fIp\fR] [\fB-o\fR\fIlist\fR] [\fB-Q\fR] [\fB-r\fR\fIaN\fR] +\fBroffbib\fR [\fB-e\fR] [\fB-h\fR] [\fB-m\fR \fIfilename\fR] [\fB-n\fR\fIp\fR] [\fB-o\fR\fIlist\fR] [\fB-Q\fR] [\fB-r\fR\fIaN\fR] [\fB-s\fR\fIN\fR] [\fB-T\fR\fIterm\fR] [\fB-V\fR] [\fB-x\fR] [\fIfilename\fR] ... .fi @@ -29,23 +29,19 @@ in conjunction with \fBsortbib\fR(1): and \fB-q\fR. .sp .ne 2 -.mk .na \fB\fB-e\fR\fR .ad .RS 15n -.rt Produce equally-spaced words in adjusted lines using full terminal resolution. .RE .sp .ne 2 -.mk .na \fB\fB-h\fR\fR .ad .RS 15n -.rt Use output tabs during horizontal spacing to speed output and reduce output character count. \fBTAB\fR settings are assumed to be every 8 nominal character widths. @@ -53,12 +49,10 @@ widths. .sp .ne 2 -.mk .na \fB\fB-m\fR\fI filename\fR\fR .ad .RS 15n -.rt Prepend the macro file \fB/usr/share/lib/tmac/tmac.name\fR to the input files. There should be a space between the \fB-m\fR and the macro filename. This set of macros will replace the ones defined in \fB/usr/share/lib/tmac/tmac.bib\fR. @@ -66,23 +60,19 @@ of macros will replace the ones defined in \fB/usr/share/lib/tmac/tmac.bib\fR. .sp .ne 2 -.mk .na \fB\fB-n\fR\fIp\fR\fR .ad .RS 15n -.rt Number first generated page \fIp\fR. .RE .sp .ne 2 -.mk .na \fB\fB-o\fR\fIlist\fR\fR .ad .RS 15n -.rt Print only page numbers that appear in the comma-separated \fIlist\fR of numbers and ranges. A range \fIN\fR\fB\(mi\fR\fIM\fR means pages \fIN\fR through \fIM\fR; an initial \fB-\fR\fIN\fR means from the beginning to page @@ -91,23 +81,19 @@ through \fIM\fR; an initial \fB-\fR\fIN\fR means from the beginning to page .sp .ne 2 -.mk .na \fB\fB-Q\fR\fR .ad .RS 15n -.rt Queue output for the phototypesetter. Page offset is set to 1 inch. .RE .sp .ne 2 -.mk .na \fB\fB-r\fR\fIaN\fR\fR .ad .RS 15n -.rt Set register \fIa\fR (one-character) to \fIN\fR. The command-line argument \fB-rN1\fR will number the references starting at 1. .sp @@ -122,46 +108,38 @@ not zero). .sp .ne 2 -.mk .na \fB\fB-s\fR\fIN\fR\fR .ad .RS 15n -.rt Halt prior to every \fIN\fR pages for paper loading or changing (default \fIN\fR\|=1). To resume, enter \fBNEWLINE\fR or \fBRETURN.\fR .RE .sp .ne 2 -.mk .na \fB\fB-T\fR\fIterm\fR\fR .ad .RS 15n -.rt Specify \fIterm\fR as the terminal type. .RE .sp .ne 2 -.mk .na \fB\fB-V\fR\fR .ad .RS 15n -.rt Send output to the Versatec. Page offset is set to 1 inch. .RE .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad .RS 15n -.rt If abstracts or comments are entered following the \fB%X\fR field key, \fBroffbib\fR will format them into paragraphs for an annotated bibliography. Several \fB%X\fR fields may be given if several annotation paragraphs are @@ -171,7 +149,6 @@ desired. .SH FILES .sp .ne 2 -.mk .na \fB\fB/usr/share/lib/tmac/tmac.bib\fR\fR .ad diff --git a/usr/src/man/man1/roles.1 b/usr/src/man/man1/roles.1 index b1629c39ae..ac7ede705b 100644 --- a/usr/src/man/man1/roles.1 +++ b/usr/src/man/man1/roles.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 roles 1 "14 Feb 2001" "SunOS 5.11" "User Commands" +.TH ROLES 1 "Feb 14, 2001" .SH NAME roles \- print roles granted to a user .SH SYNOPSIS @@ -71,23 +71,19 @@ example% The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR \fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB1\fR \fR .ad .RS 6n -.rt An error occurred. .RE diff --git a/usr/src/man/man1/rpcgen.1 b/usr/src/man/man1/rpcgen.1 index 4bb9eb97e3..592d837964 100644 --- a/usr/src/man/man1/rpcgen.1 +++ b/usr/src/man/man1/rpcgen.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 rpcgen 1 "24 Aug 2009" "SunOS 5.11" "User Commands" +.TH RPCGEN 1 "Aug 24, 2009" .SH NAME rpcgen \- an RPC protocol compiler .SH SYNOPSIS @@ -15,14 +15,14 @@ rpcgen \- an RPC protocol compiler .LP .nf -\fBrpcgen\fR [\fB-a\fR] [\fB-A\fR] [\fB-b\fR] [\fB-C\fR] [\fB-D\fR \fIname\fR [= \fIvalue\fR]] [\fB-i\fR \fIsize\fR] - [\fB-I\fR [\fB-K\fR \fIseconds\fR]] [\fB-L\fR] [\fB-M\fR] [\fB-N\fR] [\fB- T\fR] [\fB-v\fR] +\fBrpcgen\fR [\fB-a\fR] [\fB-A\fR] [\fB-b\fR] [\fB-C\fR] [\fB-D\fR \fIname\fR [= \fIvalue\fR]] [\fB-i\fR \fIsize\fR] + [\fB-I\fR [\fB-K\fR \fIseconds\fR]] [\fB-L\fR] [\fB-M\fR] [\fB-N\fR] [\fB- T\fR] [\fB-v\fR] [\fB-Y\fR \fIpathname\fR] \fIinfile\fR .fi .LP .nf -\fBrpcgen\fR [\fB-c\fR | \fB-h\fR | \fB-l\fR | \fB-m\fR | \fB-t\fR | \fB-Sc\fR | \fB-Ss\fR | \fB-Sm\fR] +\fBrpcgen\fR [\fB-c\fR | \fB-h\fR | \fB-l\fR | \fB-m\fR | \fB-t\fR | \fB-Sc\fR | \fB-Ss\fR | \fB-Sm\fR] [\fB-o\fR \fIoutfile\fR] [\fIinfile\fR] .fi @@ -124,56 +124,46 @@ actually interpreted by \fBrpcgen\fR. For each type of output file, programmer: .sp .ne 2 -.mk .na \fB\fBRPC_HDR\fR\fR .ad .RS 12n -.rt defined when compiling into headers .RE .sp .ne 2 -.mk .na \fB\fBRPC_XDR\fR\fR .ad .RS 12n -.rt defined when compiling into \fBXDR\fR routines .RE .sp .ne 2 -.mk .na \fB\fBRPC_SVC\fR\fR .ad .RS 12n -.rt defined when compiling into server-side stubs .RE .sp .ne 2 -.mk .na \fB\fBRPC_CLNT\fR\fR .ad .RS 12n -.rt defined when compiling into client-side stubs .RE .sp .ne 2 -.mk .na \fB\fBRPC_TBL\fR\fR .ad .RS 12n -.rt defined when compiling into \fBRPC\fR dispatch tables .RE @@ -214,23 +204,19 @@ extern void RPC_MSGOUT(const char *fmt, ...); The following options are supported: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 18n -.rt Generates all files, including sample files. .RE .sp .ne 2 -.mk .na \fB\fB-A\fR\fR .ad .RS 18n -.rt Enables the Automatic \fBMT\fR mode in the server main program. In this mode, the \fBRPC\fR library automatically creates threads to service client requests. This option generates multithread-safe stubs by implicitly turning on the @@ -241,47 +227,39 @@ the default values for the Automatic \fBMT\fR mode. .sp .ne 2 -.mk .na \fB\fB-b\fR\fR .ad .RS 18n -.rt Backward compatibility mode. Generates transport-specific \fBRPC\fR code for older versions of the operating system. .RE .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad .RS 18n -.rt Compiles into \fBXDR\fR routines. .RE .sp .ne 2 -.mk .na \fB\fB-C\fR\fR .ad .RS 18n -.rt Generates header and stub files which can be used with ANSI C compilers. Headers generated with this flag can also be used with C++ programs. .RE .sp .ne 2 -.mk .na \fB\fB-D\fR\fIname\fR\fB[=\fR\fIvalue\fR\fB]\fR\fR .ad .RS 18n -.rt Defines a symbol \fIname\fR. Equivalent to the \fB#define\fR directive in the source. If no \fIvalue\fR is given, \fIvalue\fR is defined as \fB1\fR. This option can be specified more than once. @@ -289,12 +267,10 @@ option can be specified more than once. .sp .ne 2 -.mk .na \fB\fB-h\fR\fR .ad .RS 18n -.rt Compiles into \fBC\fR data-definitions (a header). The \fB-T\fR option can be used in conjunction to produce a header which supports \fBRPC\fR dispatch tables. @@ -302,24 +278,20 @@ tables. .sp .ne 2 -.mk .na \fB\fB-i\fR \fIsize\fR\fR .ad .RS 18n -.rt Size at which to start generating inline code. This option is useful for optimization. The default \fIsize\fR is 5. .RE .sp .ne 2 -.mk .na \fB\fB-I\fR\fR .ad .RS 18n -.rt Compiles support for \fBinetd\fR(1M) in the server side stubs. Such servers can be self-started or can be started by \fBinetd\fR. When the server is self-started, it backgrounds itself by default. A special define symbol @@ -339,12 +311,10 @@ compatibility code. By default (that is, when \fB-b\fR is not specified), .sp .ne 2 -.mk .na \fB\fB-K\fR \fIseconds\fR\fR .ad .RS 18n -.rt By default, services created using \fBrpcgen\fR and invoked through port monitors wait 120 seconds after servicing a request before exiting. That interval can be changed using the \fB-K\fR flag. To create a server that exits @@ -360,35 +330,29 @@ immediately on completion. For such servers, \fBrpcgen\fR should be used with .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 18n -.rt Compiles into client-side stubs. .RE .sp .ne 2 -.mk .na \fB\fB-L\fR\fR .ad .RS 18n -.rt When the servers are started in foreground, uses \fBsyslog\fR(3C) to log the server errors instead of printing them on the standard error. .RE .sp .ne 2 -.mk .na \fB\fB-m\fR\fR .ad .RS 18n -.rt Compiles into server-side stubs, but do not generate a "main" routine. This option is useful for doing callback-routines and for users who need to write their own "main" routine to do initialization. @@ -396,12 +360,10 @@ their own "main" routine to do initialization. .sp .ne 2 -.mk .na \fB\fB-M\fR\fR .ad .RS 18n -.rt Generates multithread-safe stubs for passing arguments and results between \fBrpcgen\fR-generated code and user written code. This option is useful for users who want to use threads in their code. @@ -409,12 +371,10 @@ users who want to use threads in their code. .sp .ne 2 -.mk .na \fB\fB-N\fR\fR .ad .RS 18n -.rt This option allows procedures to have multiple arguments. It also uses the style of parameter passing that closely resembles C. So, when passing an argument to a remote procedure, you do not have to pass a pointer to the @@ -425,12 +385,10 @@ this option is not the default. .sp .ne 2 -.mk .na \fB\fB-n\fR \fInetid\fR\fR .ad .RS 18n -.rt Compiles into server-side stubs for the transport specified by \fInetid\fR. There should be an entry for \fInetid\fR in the \fBnetconfig\fR database. This option can be specified more than once, so as to compile a server that serves @@ -439,12 +397,10 @@ multiple transports. .sp .ne 2 -.mk .na \fB\fB-o\fR \fIoutfile\fR\fR .ad .RS 18n -.rt Specifies the name of the output file. If none is specified, standard output is used (\fB-c\fR, \fB-h\fR, \fB-l\fR, \fB-m\fR, \fB-n\fR, \fB-s\fR, \fB-Sc\fR, \fB-Sm\fR, \fB-Ss\fR, and \fB-t\fR modes only). @@ -452,12 +408,10 @@ used (\fB-c\fR, \fB-h\fR, \fB-l\fR, \fB-m\fR, \fB-n\fR, \fB-s\fR, \fB-Sc\fR, .sp .ne 2 -.mk .na \fB\fB-s\fR \fInettype\fR\fR .ad .RS 18n -.rt Compiles into server-side stubs for all the transports belonging to the class \fInettype\fR. The supported classes are \fBnetpath\fR, \fBvisible\fR, \fBcircuit_n\fR, \fBcircuit_v\fR, \fBdatagram_n\fR, \fBdatagram_v\fR, @@ -468,56 +422,46 @@ transports are chosen at run time and not at compile time. .sp .ne 2 -.mk .na \fB\fB-Sc\fR\fR .ad .RS 18n -.rt Generates sample client code that uses remote procedure calls. .RE .sp .ne 2 -.mk .na \fB\fB-Sm\fR\fR .ad .RS 18n -.rt Generates a sample Makefile which can be used for compiling the application. .RE .sp .ne 2 -.mk .na \fB\fB-Ss\fR\fR .ad .RS 18n -.rt Generates sample server code that uses remote procedure calls. .RE .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad .RS 18n -.rt Compiles into \fBRPC\fR dispatch table. .RE .sp .ne 2 -.mk .na \fB\fB-T\fR\fR .ad .RS 18n -.rt Generates the code to support \fBRPC\fR dispatch tables. .sp The options \fB-c\fR, \fB-h\fR, \fB-l\fR, \fB-m\fR, \fB-s\fR, \fB-Sc\fR, @@ -528,23 +472,19 @@ can be used with the other options. .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 18n -.rt Displays the version number. .RE .sp .ne 2 -.mk .na \fB\fB-Y\fR \fIpathname\fR\fR .ad .RS 18n -.rt Gives the name of the directory where \fBrpcgen\fR starts looking for the C preprocessor. .RE @@ -555,12 +495,10 @@ preprocessor. The following operand is supported: .sp .ne 2 -.mk .na \fB\fIinfile\fR\fR .ad .RS 10n -.rt input file .RE @@ -632,23 +570,19 @@ example% \fBrpcgen -n tcp -o prot_svc.c prot.x\fR .SH EXIT STATUS .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful operation. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE diff --git a/usr/src/man/man1/rsh.1 b/usr/src/man/man1/rsh.1 index 410d26e1bc..e839e14c8d 100644 --- a/usr/src/man/man1/rsh.1 +++ b/usr/src/man/man1/rsh.1 @@ -4,37 +4,37 @@ .\" 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 rsh 1 "23 Dec 2008" "SunOS 5.11" "User Commands" +.TH RSH 1 "Dec 23, 2008" .SH NAME rsh, remsh, remote_shell \- remote shell .SH SYNOPSIS .LP .nf -\fBrsh\fR [\fB-n\fR] [\fB-a\fR] [\fB-K\fR] [\fB-PN\fR | \fB-PO\fR] [\fB-x\fR] [\fB-f\fR | \fB-F\fR] [\fB-l\fR \fIusername\fR] +\fBrsh\fR [\fB-n\fR] [\fB-a\fR] [\fB-K\fR] [\fB-PN\fR | \fB-PO\fR] [\fB-x\fR] [\fB-f\fR | \fB-F\fR] [\fB-l\fR \fIusername\fR] [\fB-k\fR \fIrealm\fR] \fIhostname\fR \fIcommand\fR .fi .LP .nf -\fBrsh\fR \fIhostname\fR [\fB-n\fR] [\fB-a\fR] [\fB-K\fR] [\fB-PN\fR | \fB-PO\fR] [\fB-x\fR] [\fB-f\fR | \fB-F\fR] +\fBrsh\fR \fIhostname\fR [\fB-n\fR] [\fB-a\fR] [\fB-K\fR] [\fB-PN\fR | \fB-PO\fR] [\fB-x\fR] [\fB-f\fR | \fB-F\fR] [\fB-l\fR \fIusername\fR] [\fB-k\fR \fIrealm\fR] \fIcommand\fR .fi .LP .nf -\fBremsh\fR [\fB-n\fR] [\fB-a\fR] [\fB-K\fR] [\fB-PN\fR | \fB-PO\fR] [\fB-x\fR] [\fB-f\fR | \fB-F\fR] [\fB-l\fR \fIusername\fR] +\fBremsh\fR [\fB-n\fR] [\fB-a\fR] [\fB-K\fR] [\fB-PN\fR | \fB-PO\fR] [\fB-x\fR] [\fB-f\fR | \fB-F\fR] [\fB-l\fR \fIusername\fR] [\fB-k\fR \fIrealm\fR] \fIhostname\fR \fIcommand\fR .fi .LP .nf -\fBremsh\fR \fIhostname\fR [\fB-n\fR] [\fB-a\fR] [\fB-K\fR] [\fB-PN\fR | \fB-PO\fR] [\fB-x\fR] [\fB-f\fR | \fB-F\fR] +\fBremsh\fR \fIhostname\fR [\fB-n\fR] [\fB-a\fR] [\fB-K\fR] [\fB-PN\fR | \fB-PO\fR] [\fB-x\fR] [\fB-f\fR | \fB-F\fR] [\fB-l\fR \fIusername\fR] [\fB-k\fR \fIrealm\fR] \fIcommand\fR .fi .LP .nf - \fIhostname\fR [\fB-n\fR] [\fB-a\fR] [\fB-PN\fR | \fB-PO\fR] [\fB-x\fR] [\fB-f\fR | \fB-F\fR] + \fIhostname\fR [\fB-n\fR] [\fB-a\fR] [\fB-PN\fR | \fB-PO\fR] [\fB-x\fR] [\fB-f\fR | \fB-F\fR] [\fB-l\fR \fIusername\fR] [\fB-k\fR \fIrealm\fR] \fIcommand\fR .fi @@ -91,12 +91,10 @@ session traffic is encrypted. See \fB-x\fR. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 15n -.rt Explicitly enable Kerberos authentication and trusts the \fB\&.k5login\fR file for access-control. If the authorization check by \fBin.rshd\fR(1M) on the server-side succeeds and if the \fB\&.k5login\fR file permits access, the user @@ -105,12 +103,10 @@ is allowed to carry out the command. .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 15n -.rt Forward a copy of the local credentials (Kerberos Ticket Granting Ticket) to the remote system. This is a non-forwardable ticket granting ticket. Forward a ticket granting ticket if you need to authenticate yourself to other Kerberized @@ -122,12 +118,10 @@ directory. This option is mutually exclusive with the \fB-F\fR option. .sp .ne 2 -.mk .na \fB\fB-F\fR\fR .ad .RS 15n -.rt Forward a forwardable copy of the local credentials (Kerberos Ticket Granting Ticket) to the remote system. The \fB-F\fR option provides a superset of the functionality offered by the \fB-f\fR option. For example, with the \fB-f\fR @@ -141,36 +135,30 @@ the \fB-f\fR option. .sp .ne 2 -.mk .na \fB\fB-k\fR \fIrealm\fR\fR .ad .RS 15n -.rt Causes \fBrsh\fR to obtain tickets for the remote host in \fIrealm\fR instead of the remote host's realm as determined by \fBkrb5.conf\fR(4). .RE .sp .ne 2 -.mk .na \fB\fB-K\fR\fR .ad .RS 15n -.rt This option explicitly disables Kerberos authentication. It can be used to override the \fBautologin\fR variable in \fBkrb5.conf\fR(4). .RE .sp .ne 2 -.mk .na \fB\fB\fR\fB-l\fR \fIusername\fR\fR .ad .RS 15n -.rt Uses \fIusername\fR as the remote username instead of your local username. In the absence of this option, the remote username is the same as your local username. @@ -178,12 +166,10 @@ username. .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 15n -.rt Redirect the input of \fBrsh\fR to \fB/dev/null\fR. You sometimes need this option to avoid unfortunate interactions between \fBrsh\fR and the shell which invokes it. For example, if you are running \fBrsh\fR and invoke a \fBrsh\fR in @@ -194,7 +180,6 @@ this. .sp .ne 2 -.mk .na \fB\fB-PO\fR\fR .ad @@ -203,7 +188,6 @@ this. \fB\fB-PN\fR\fR .ad .RS 15n -.rt Explicitly request new (\fB-PN\fR) or old (\fB-PO\fR) version of the Kerberos "\fBrcmd\fR" protocol. The new protocol avoids many security problems prevalant in the old one and is regarded much more secure, but is not interoperable with @@ -216,12 +200,10 @@ new, more secure "\fBrcmd\fR" protocol is used. .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad .RS 15n -.rt Cause the network session traffic to be encrypted. See \fBDESCRIPTION\fR. .RE @@ -235,12 +217,10 @@ user's entry in the file \fB/etc/passwd\fR on the remote system. The following operand is supported: .sp .ne 2 -.mk .na \fB\fIcommand\fR\fR .ad .RS 11n -.rt The command to be executed on the specified \fIhostname\fR. .RE @@ -351,79 +331,65 @@ example% \fBrsh lizard cat lizard.file ">>" lizard.file2\fR The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt An error occurred. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB/etc/hosts\fR\fR .ad .RS 23n -.rt Internet host table .RE .sp .ne 2 -.mk .na \fB\fB/etc/hosts.equiv\fR\fR .ad .RS 23n -.rt Trusted remote hosts and users .RE .sp .ne 2 -.mk .na \fB\fB/etc/passwd\fR\fR .ad .RS 23n -.rt System password file .RE .sp .ne 2 -.mk .na \fB\fB$HOME/.k5login\fR\fR .ad .RS 23n -.rt File containing Kerberos principals that are allowed access .RE .sp .ne 2 -.mk .na \fB\fB/etc/krb5/krb5.conf\fR\fR .ad .RS 23n -.rt Kerberos configuration file .RE @@ -435,13 +401,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled .TE .SH SEE ALSO diff --git a/usr/src/man/man1/runat.1 b/usr/src/man/man1/runat.1 index 795e97b688..cd644410d6 100644 --- a/usr/src/man/man1/runat.1 +++ b/usr/src/man/man1/runat.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 runat 1 "22 Jun 2001" "SunOS 5.11" "User Commands" +.TH RUNAT 1 "Jun 22, 2001" .SH NAME runat \- execute command in extended attribute name space .SH SYNOPSIS @@ -33,23 +33,19 @@ be prepared in any way, before invoking the \fBrunat\fR command. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIfile\fR\fR .ad .RS 12n -.rt Any file, including a directory, that can support extended attributes. .RE .sp .ne 2 -.mk .na \fB\fIcommand\fR \fR .ad .RS 12n -.rt The command to be executed in an attribute directory. .RE @@ -135,56 +131,46 @@ Recommended methods for performing basic attribute operations: .sp .ne 2 -.mk .na \fBdisplay\fR .ad .RS 22n -.rt \fBrunat \fIfile\fR ls [\fIoptions\fR]\fR .RE .sp .ne 2 -.mk .na \fBread\fR .ad .RS 22n -.rt \fBrunat \fIfile\fR cat \fIattribute\fR\fR .RE .sp .ne 2 -.mk .na \fBcreate/modify\fR .ad .RS 22n -.rt \fBrunat \fIfile\fR cp \fIabsolute-file-path\fR \fIattribute\fR\fR .RE .sp .ne 2 -.mk .na \fBdelete\fR .ad .RS 22n -.rt \fBrunat \fIfile\fR rm \fIattribute\fR\fR .RE .sp .ne 2 -.mk .na \fBpermission changes\fR .ad .RS 22n -.rt .sp .in +2 .nf @@ -199,12 +185,10 @@ runat \fIfile\fR chown \fIowner attribute\fR\fR .sp .ne 2 -.mk .na \fBinteractive shell\fR .ad .RS 22n -.rt .LP .nf \fBrunat \fIfile\fR /bin/sh\fR or set your $SHELL to /bin/sh and \fBrunat \fIfile\fR\fR @@ -274,12 +258,10 @@ example% \fB/bin/pwd\fR .SH ENVIRONMENT VARIABLES .sp .ne 2 -.mk .na \fB\fBSHELL\fR\fR .ad .RS 9n -.rt Specifies the command shell to be invoked by \fBrunat\fR. .RE @@ -289,24 +271,20 @@ Specifies the command shell to be invoked by \fBrunat\fR. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB125\fR \fR .ad .RS 8n -.rt The attribute directory of the file referenced by the \fIfile\fR argument cannot be accessed. .RE .sp .ne 2 -.mk .na \fB\fB126\fR \fR .ad .RS 8n -.rt The exec of the provided \fIcommand\fR argument failed. .RE @@ -322,15 +300,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityEvolving +Interface Stability Evolving .TE .SH SEE ALSO diff --git a/usr/src/man/man1/rup.1 b/usr/src/man/man1/rup.1 index a123607aba..dccc894b01 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 "7 Mar 2003" "SunOS 5.11" "User Commands" +.TH RUP 1 "Mar 7, 2003" .SH NAME rup \- show host status of remote machines (RPC version) .SH SYNOPSIS @@ -41,34 +41,28 @@ names as numeric IP addresses. .SH OPTIONS .sp .ne 2 -.mk .na \fB\fB-h\fR\fR .ad .RS 6n -.rt Sort the display alphabetically by host name. .RE .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 6n -.rt Sort the display by load average. .RE .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad .RS 6n -.rt Sort the display by up time. .RE diff --git a/usr/src/man/man1/ruptime.1 b/usr/src/man/man1/ruptime.1 index fdcc81ed02..0ae939308c 100644 --- a/usr/src/man/man1/ruptime.1 +++ b/usr/src/man/man1/ruptime.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 ruptime 1 "6 Nov 2000" "SunOS 5.11" "User Commands" +.TH RUPTIME 1 "Nov 6, 2000" .SH NAME ruptime \- show host status of local machines .SH SYNOPSIS @@ -35,66 +35,54 @@ specifying one of the options listed below. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 16n -.rt Counts even those users who have been idle for an hour or more. .RE .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 16n -.rt Reverses the sorting order. .RE .sp .ne 2 -.mk .na \fB\fB-l\fR | \fB-t\fR | \fB-u\fR\fR .ad .RS 16n -.rt These options are mutually exclusive. The use of one overrides the previous one(s). .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 6n -.rt Sorts the display by load average. .RE .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad .RS 6n -.rt Sorts the display by up time. .RE .sp .ne 2 -.mk .na \fB\fB-u\fR\fR .ad .RS 6n -.rt Sorts the display by number of users. .RE @@ -103,12 +91,10 @@ Sorts the display by number of users. .SH FILES .sp .ne 2 -.mk .na \fB\fB/var/spool/rwho/whod.*\fR\fR .ad .RS 26n -.rt data files .RE diff --git a/usr/src/man/man1/rusers.1 b/usr/src/man/man1/rusers.1 index 1549ffb0df..acc7a6d958 100644 --- a/usr/src/man/man1/rusers.1 +++ b/usr/src/man/man1/rusers.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 rusers 1 "7 Mar 2003" "SunOS 5.11" "User Commands" +.TH RUSERS 1 "Mar 7, 2003" .SH NAME rusers \- who is logged in on remote machines .SH SYNOPSIS @@ -47,56 +47,46 @@ host names as numeric IP addresses. .SH OPTIONS .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 6n -.rt Give a report for a machine even if no users are logged on. .RE .sp .ne 2 -.mk .na \fB\fB-h\fR\fR .ad .RS 6n -.rt Sort alphabetically by host name. .RE .sp .ne 2 -.mk .na \fB\fB-i\fR\fR .ad .RS 6n -.rt Sort by idle time. .RE .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 6n -.rt Give a longer listing in the style of \fBwho\fR(1). .RE .sp .ne 2 -.mk .na \fB\fB-u\fR\fR .ad .RS 6n -.rt Sort by number of users. .RE diff --git a/usr/src/man/man1/rwho.1 b/usr/src/man/man1/rwho.1 index 5083de256b..4137b0491d 100644 --- a/usr/src/man/man1/rwho.1 +++ b/usr/src/man/man1/rwho.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 rwho 1 "6 Nov 2000" "SunOS 5.11" "User Commands" +.TH RWHO 1 "Nov 6, 2000" .SH NAME rwho \- who is logged in on local machines .SH SYNOPSIS @@ -28,24 +28,20 @@ given. .SH OPTIONS .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 6n -.rt Report all users whether or not they have typed to the system in the past hour. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB/var/spool/rwho/whod.*\fR\fR .ad .RS 26n -.rt information about other machines .RE diff --git a/usr/src/man/man1/sar.1 b/usr/src/man/man1/sar.1 index c5f4ae5444..8ea0c0b20c 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 "24 Jul 2004" "SunOS 5.11" "User Commands" +.TH SAR 1 "Jul 24, 2004" .SH NAME sar \- system activity reporter .SH SYNOPSIS @@ -15,7 +15,7 @@ sar \- system activity reporter .LP .nf -\fBsar\fR [\fB-aAbcdgkmpqruvwy\fR] [\fB-e\fR \fItime\fR] [\fB-f\fR \fIfilename\fR] [\fB-i\fR \fIsec\fR] +\fBsar\fR [\fB-aAbcdgkmpqruvwy\fR] [\fB-e\fR \fItime\fR] [\fB-f\fR \fIfilename\fR] [\fB-i\fR \fIsec\fR] [\fB-s\fR \fItime\fR] .fi @@ -46,77 +46,63 @@ all intervals found in the data file are reported. The following options modify the subsets of information reported by \fBsar\fR. .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 15n -.rt Reports use of file access system routines: iget/s, namei/s, dirblk/s .RE .sp .ne 2 -.mk .na \fB\fB-A\fR\fR .ad .RS 15n -.rt Reports all data. Equivalent to \fB-abcdgkmpqruvwy\fR. .RE .sp .ne 2 -.mk .na \fB\fB-b\fR\fR .ad .RS 15n -.rt Reports buffer activity: .sp .ne 2 -.mk .na \fBbread/s, bwrit/s\fR .ad .RS 20n -.rt transfers per second of data between system buffers and disk or other block devices. .RE .sp .ne 2 -.mk .na \fBlread/s, lwrit/s\fR .ad .RS 20n -.rt accesses of system buffers. .RE .sp .ne 2 -.mk .na \fB%rcache, %wcache\fR .ad .RS 20n -.rt cache hit ratios, that is, (1\(mibread/lread) as a percentage. .RE .sp .ne 2 -.mk .na \fBpread/s, pwrit/s\fR .ad .RS 20n -.rt transfers using raw (physical) device mechanism. .RE @@ -127,16 +113,13 @@ the zone is bound. .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad .RS 15n -.rt Reports system calls: .sp .ne 2 -.mk .na \fBscall/s\fR .ad @@ -147,7 +130,6 @@ system calls of all types. .sp .ne 2 -.mk .na \fBsread/s, swrit/s, fork/s, exec/s\fR .ad @@ -158,7 +140,6 @@ specific system calls. .sp .ne 2 -.mk .na \fBrchar/s, wchar/s\fR .ad @@ -175,12 +156,10 @@ the zone is bound. .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad .RS 15n -.rt Reports activity for each block device (for example, disk or tape drive) with the exception of \fBXDC\fR disks and tape drives. When data is displayed, the device specification \fIdsk-\fR is generally used to represent a disk drive. @@ -188,47 +167,39 @@ The device specification used to represent a tape drive is machine dependent. The activity data reported is: .sp .ne 2 -.mk .na \fB%busy, avque\fR .ad .RS 27n -.rt portion of time device was busy servicing a transfer request, average number of requests outstanding during that time. .RE .sp .ne 2 -.mk .na \fBread/s, write/s, blks/s\fR .ad .RS 27n -.rt number of read/write transfers from or to device, number of bytes transferred in 512-byte units. .RE .sp .ne 2 -.mk .na \fBavwait\fR .ad .RS 27n -.rt average wait time in milliseconds. .RE .sp .ne 2 -.mk .na \fBavserv\fR .ad .RS 27n -.rt average service time in milliseconds. .RE @@ -241,88 +212,72 @@ conventions for disks. .sp .ne 2 -.mk .na \fB\fB-e\fR \fItime\fR\fR .ad .RS 15n -.rt Selects data up to \fBtime\fR. Default is \fB18:00\fR. .RE .sp .ne 2 -.mk .na \fB\fB-f\fR \fIfilename\fR\fR .ad .RS 15n -.rt Uses \fIfilename\fR as the data source for \fBsar\fR. Default is the current daily data file \fB/var/adm/sa/sa\fR\fIdd.\fR .RE .sp .ne 2 -.mk .na \fB\fB-g\fR\fR .ad .RS 15n -.rt Reports paging activities: .sp .ne 2 -.mk .na \fBpgout/s\fR .ad .RS 12n -.rt page-out requests per second. .RE .sp .ne 2 -.mk .na \fBppgout/s\fR .ad .RS 12n -.rt pages paged-out per second. .RE .sp .ne 2 -.mk .na \fBpgfree/s\fR .ad .RS 12n -.rt pages per second placed on the free list by the page stealing daemon. .RE .sp .ne 2 -.mk .na \fBpgscan/s\fR .ad .RS 12n -.rt pages per second scanned by the page stealing daemon. .RE .sp .ne 2 -.mk .na \fB%ufs_ipf\fR .ad .RS 12n -.rt the percentage of \fBUFS\fR inodes taken off the freelist by iget which had reusable pages associated with them. These pages are flushed and cannot be reclaimed by processes. Thus, this is the percentage of igets with page @@ -336,32 +291,26 @@ the zone is bound. .sp .ne 2 -.mk .na \fB\fB-i\fR \fIsec\fR\fR .ad .RS 15n -.rt Selects data at intervals as close as possible to \fIsec\fR seconds. .RE .sp .ne 2 -.mk .na \fB\fB-k\fR\fR .ad .RS 15n -.rt Reports kernel memory allocation (KMA) activities: .sp .ne 2 -.mk .na \fBsml_mem, alloc, fail\fR .ad .RS 24n -.rt information about the memory pool reserving and allocating space for small requests: the amount of memory in bytes \fBKMA\fR has for the small pool, the number of bytes allocated to satisfy requests for small amounts of memory, and @@ -371,24 +320,20 @@ the number of requests for small amounts of memory that were not satisfied .sp .ne 2 -.mk .na \fBlg_mem, alloc, fail\fR .ad .RS 24n -.rt information for the large memory pool (analogous to the information for the small memory pool). .RE .sp .ne 2 -.mk .na \fBovsz_alloc, fail\fR .ad .RS 24n -.rt the amount of memory allocated for oversize requests and the number of oversize requests which could not be satisfied (because oversized memory is allocated dynamically, there is not a pool). @@ -398,21 +343,17 @@ dynamically, there is not a pool). .sp .ne 2 -.mk .na \fB\fB-m\fR\fR .ad .RS 15n -.rt Reports message and semaphore activities: .sp .ne 2 -.mk .na \fBmsg/s, sema/s\fR .ad .RS 17n -.rt primitives per second. .RE @@ -423,89 +364,73 @@ the zone is bound. .sp .ne 2 -.mk .na \fB\fB-o\fR \fIfilename\fR\fR .ad .RS 15n -.rt Saves samples in file, \fIfilename\fR, in binary format. .RE .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 15n -.rt Reports paging activities: .sp .ne 2 -.mk .na \fBatch/s\fR .ad .RS 11n -.rt page faults per second that are satisfied by reclaiming a page currently in memory (attaches per second). .RE .sp .ne 2 -.mk .na \fBpgin/s\fR .ad .RS 11n -.rt page-in requests per second. .RE .sp .ne 2 -.mk .na \fBppgin/s\fR .ad .RS 11n -.rt pages paged-in per second. .RE .sp .ne 2 -.mk .na \fBpflt/s\fR .ad .RS 11n -.rt page faults from protection errors per second (illegal access to page) or "copy-on-writes". .RE .sp .ne 2 -.mk .na \fBvflt/s\fR .ad .RS 11n -.rt address translation page faults per second (valid page not in memory). .RE .sp .ne 2 -.mk .na \fBslock/s\fR .ad .RS 11n -.rt faults per second caused by software lock requests requiring physical \fBI/O\fR. .RE @@ -517,32 +442,26 @@ the zone is bound. .sp .ne 2 -.mk .na \fB\fB-q\fR\fR .ad .RS 15n -.rt Reports average queue length while occupied, and percent of time occupied: .sp .ne 2 -.mk .na \fBrunq-sz, %runocc\fR .ad .RS 20n -.rt Run queue of kernel threads in memory and runnable .RE .sp .ne 2 -.mk .na \fBswpq-sz, %swpocc\fR .ad .RS 20n -.rt Swap queue of processes .RE @@ -550,32 +469,26 @@ Swap queue of processes .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 15n -.rt Reports unused memory pages and disk blocks: .sp .ne 2 -.mk .na \fBfreemem\fR .ad .RS 12n -.rt average pages available to user processes. .RE .sp .ne 2 -.mk .na \fBfreeswap\fR .ad .RS 12n -.rt disk blocks available for page swapping. .RE @@ -583,33 +496,27 @@ disk blocks available for page swapping. .sp .ne 2 -.mk .na \fB\fB-s\fR \fItime\fR\fR .ad .RS 15n -.rt Selects data later than \fBtime\fR in the form \fIhh\fR[:\fImm\fR]. Default is \fB08:00\fR. .RE .sp .ne 2 -.mk .na \fB\fB-u\fR\fR .ad .RS 15n -.rt Reports \fBCPU\fR utilization (the default): .sp .ne 2 -.mk .na \fB%usr, %sys, %wio, %idle\fR .ad .RS 27n -.rt portion of time running in user mode, running in system mode, idle with some process waiting for block \fBI/O\fR, and otherwise idle. .RE @@ -621,16 +528,13 @@ the zone is bound. .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 15n -.rt Reports status of process, i-node, file tables: .sp .ne 2 -.mk .na \fBproc-sz, inod-sz, file-sz, lock-sz\fR .ad @@ -641,7 +545,6 @@ entries/size for each table, evaluated once at sampling point. .sp .ne 2 -.mk .na \fBov\fR .ad @@ -654,16 +557,13 @@ overflows that occur between sampling points for each table. .sp .ne 2 -.mk .na \fB\fB-w\fR\fR .ad .RS 15n -.rt Reports system swapping and switching activity: .sp .ne 2 -.mk .na \fBswpin/s, swpot/s, bswin/s, bswot/s\fR .ad @@ -675,7 +575,6 @@ swapouts (including initial loading of some programs). .sp .ne 2 -.mk .na \fBpswch/s\fR .ad @@ -691,33 +590,27 @@ the zone is bound. .sp .ne 2 -.mk .na \fB\fB-y\fR\fR .ad .RS 15n -.rt Reports TTY device activity: .sp .ne 2 -.mk .na \fBrawch/s, canch/s, outch/s\fR .ad .RS 29n -.rt input character rate, input character rate processed by canon, output character rate. .RE .sp .ne 2 -.mk .na \fBrcvin/s, xmtin/s, mdmin/s\fR .ad .RS 29n -.rt receive, transmit and modem interrupt rates. .RE @@ -772,12 +665,10 @@ example% sar -d -f temp .SH FILES .sp .ne 2 -.mk .na \fB\fB/var/adm/sa/sa\fIdd\fR\fR\fR .ad .RS 20n -.rt daily data file, where \fIdd\fR are digits representing the day of the month .RE diff --git a/usr/src/man/man1/scp.1 b/usr/src/man/man1/scp.1 index d065f4d7b4..c2b44aa6b9 100644 --- a/usr/src/man/man1/scp.1 +++ b/usr/src/man/man1/scp.1 @@ -2,14 +2,14 @@ .\" To view license terms, attribution, and copyright for OpenSSH, the default path is /var/sadm/pkg/SUNWsshdr/install/copyright. If the Solaris operating environment has been installed anywhere other than the default, modify the given path to access the file at the .\" installed location. .\" Portions Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved. -.TH scp 1 "22 Jun 2007" "SunOS 5.11" "User Commands" +.TH SCP 1 "Jun 22, 2007" .SH NAME scp \- secure copy (remote file copy program) .SH SYNOPSIS .LP .nf -\fBscp\fR [\fB-pqrvBC46\fR] [\fB-F\fR \fIssh_config\fR] [\fB-S\fR \fIprogram\fR] [\fB-P\fR \fIport\fR] - [\fB-c\fR \fIcipher\fR] [\fB-i\fR \fIidentity_file\fR] [\fB-o\fR \fIssh_option\fR] +\fBscp\fR [\fB-pqrvBC46\fR] [\fB-F\fR \fIssh_config\fR] [\fB-S\fR \fIprogram\fR] [\fB-P\fR \fIport\fR] + [\fB-c\fR \fIcipher\fR] [\fB-i\fR \fIidentity_file\fR] [\fB-o\fR \fIssh_option\fR] [ [\fIuser\fR@]\fIhost1\fR:]\fIfile1\fR []... [ [\fIuser\fR@]\fIhost2\fR:]\fIfile2\fR .fi @@ -31,114 +31,94 @@ permitted. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-4\fR\fR .ad .RS 20n -.rt Forces \fBscp\fR to use IPv4 addresses only. .RE .sp .ne 2 -.mk .na \fB\fB-6\fR\fR .ad .RS 20n -.rt Forces \fBscp\fR to use IPv6 addresses only. .RE .sp .ne 2 -.mk .na \fB\fB-B\fR\fR .ad .RS 20n -.rt Selects batch mode. (Prevents asking for passwords or passphrases.) .RE .sp .ne 2 -.mk .na \fB\fB-c\fR \fIcipher\fR\fR .ad .RS 20n -.rt Selects the cipher to use for encrypting the data transfer. This option is directly passed to \fBssh\fR(1). .RE .sp .ne 2 -.mk .na \fB\fB-C\fR\fR .ad .RS 20n -.rt Compression enable. Passes the \fB-C\fR flag to \fBssh\fR(1) to enable compression. .RE .sp .ne 2 -.mk .na \fB\fB-F\fR \fIssh_config\fR\fR .ad .RS 20n -.rt Specifies an alternative per-user configuration file for \fBssh\fR(1.). .RE .sp .ne 2 -.mk .na \fB\fB-i\fR \fIidentity_file\fR\fR .ad .RS 20n -.rt Selects the file from which the identity (private key) for \fBRSA\fR authentication is read. This option is directly passed to \fBssh\fR(1). .RE .sp .ne 2 -.mk .na \fB\fB-o\fR \fIssh_option\fR\fR .ad .RS 20n -.rt The given option is directly passed to \fBssh\fR(1). .RE .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 20n -.rt Preserves modification times, access times, and modes from the original file. .RE .sp .ne 2 -.mk .na \fB\fB-P\fR \fIport\fR\fR .ad .RS 20n -.rt Specifies the port to connect to on the remote host. Notice that this option is written with a capital `P', because \fB-p\fR is already reserved for preserving the times and modes of the file in \fBrcp\fR(1). @@ -146,46 +126,38 @@ the times and modes of the file in \fBrcp\fR(1). .sp .ne 2 -.mk .na \fB\fB-q\fR\fR .ad .RS 20n -.rt Disables the progress meter. .RE .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 20n -.rt Recursively copies entire directories. .RE .sp .ne 2 -.mk .na \fB\fB-S\fR \fIprogram\fR\fR .ad .RS 20n -.rt Specifies the name of the program to use for the encrypted connection. The program must understand \fBssh\fR(1) options. .RE .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 20n -.rt Verbose mode. Causes \fBscp\fR and \fBssh\fR(1) to print debugging messages about their progress. This is helpful in debugging connection, authentication, and configuration problems. @@ -197,23 +169,19 @@ and configuration problems. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIhost1, host2,\fR...\fR .ad .RS 20n -.rt The name(s) of the host from or to which the file is to be copied. .RE .sp .ne 2 -.mk .na \fB\fIfile1, file2,\fR...\fR .ad .RS 20n -.rt The file(s) to be copied. .RE @@ -223,23 +191,19 @@ The file(s) to be copied. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt An error occurred. .RE @@ -251,13 +215,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityEvolving +Interface Stability Evolving .TE .SH SEE ALSO diff --git a/usr/src/man/man1/script.1 b/usr/src/man/man1/script.1 index e7f655998f..8723c720cf 100644 --- a/usr/src/man/man1/script.1 +++ b/usr/src/man/man1/script.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 script 1 "30 Jan 2004" "SunOS 5.11" "User Commands" +.TH SCRIPT 1 "Jan 30, 2004" .SH NAME script \- make record of a terminal session .SH SYNOPSIS @@ -29,12 +29,10 @@ the forked shell exits or when Control-d is typed. The following option is supported: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 6n -.rt Appends the session record to \fIfilename\fR, rather than overwriting it. .RE @@ -51,13 +49,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled .TE .SH SEE ALSO diff --git a/usr/src/man/man1/sdiff.1 b/usr/src/man/man1/sdiff.1 index d4804e0af8..9212c1ecf4 100644 --- a/usr/src/man/man1/sdiff.1 +++ b/usr/src/man/man1/sdiff.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 sdiff 1 "20 Dec 1996" "SunOS 5.11" "User Commands" +.TH SDIFF 1 "Dec 20, 1996" .SH NAME sdiff \- print differences between two files side-by-side .SH SYNOPSIS @@ -24,34 +24,28 @@ lines that are different. (See the \fBEXAMPLES\fR section below.) .SH OPTIONS .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 14n -.rt Print only the left side of any lines that are identical.to .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 14n -.rt Do not print identical lines. .RE .sp .ne 2 -.mk .na \fB\fB-o\fR\fI output\fR \fR .ad .RS 14n -.rt Use the argument \fIoutput\fR as the name of a third file that is created as a user-controlled merge of \fIfilename1\fR and \fIfilename2\fR. Identical lines of \fIfilename1\fR and \fIfilename2\fR are copied to \fIoutput\fR. Sets of @@ -61,100 +55,82 @@ share a common gutter character. After printing each set of differences, user-typed commands: .sp .ne 2 -.mk .na \fB\fBl\fR\fR .ad .RS 7n -.rt Append the left column to the output file. .RE .sp .ne 2 -.mk .na \fB\fBr\fR\fR .ad .RS 7n -.rt Append the right column to the output file. .RE .sp .ne 2 -.mk .na \fB\fBs\fR\fR .ad .RS 7n -.rt Turn on silent mode; do not print identical lines. .RE .sp .ne 2 -.mk .na \fB\fBv\fR\fR .ad .RS 7n -.rt Turn off silent mode. .RE .sp .ne 2 -.mk .na \fB\fBe l\fR\fR .ad .RS 7n -.rt Call the editor with the left column. .RE .sp .ne 2 -.mk .na \fB\fBe r\fR\fR .ad .RS 7n -.rt Call the editor with the right column. .RE .sp .ne 2 -.mk .na \fB\fBe b\fR\fR .ad .RS 7n -.rt Call the editor with the concatenation of left and right. .RE .sp .ne 2 -.mk .na \fB\fBe\fR\fR .ad .RS 7n -.rt Call the editor with a zero length file. .RE .sp .ne 2 -.mk .na \fB\fBq\fR\fR .ad .RS 7n -.rt Exit from the program. .RE @@ -164,12 +140,10 @@ On exit from the editor, the resulting file is concatenated to the end of the .sp .ne 2 -.mk .na \fB\fB-w\fR\fI n\fR \fR .ad .RS 14n -.rt Use the argument \fIn\fR as the width of the output line. The default line length is 130 characters. .RE @@ -212,12 +186,10 @@ If none of the above variables is set in the environment, the "C" locale determines how \fBsdiff\fR behaves. .sp .ne 2 -.mk .na \fB\fBLC_CTYPE\fR \fR .ad .RS 13n -.rt Determines how \fBsdiff\fR handles characters. When \fBLC_CTYPE\fR is set to a valid value, \fBsdiff\fR can display and handle text and filenames containing valid characters for that locale. @@ -231,12 +203,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -lw(2.75i) lw(2.75i) -lw(2.75i) lw(2.75i) -. -\fBATTRIBUTE TYPE\fR\fBATTRIBUTE VALUE\fR -CSIEnabled +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE +_ +CSI Enabled .TE .SH SEE ALSO diff --git a/usr/src/man/man1/sed.1 b/usr/src/man/man1/sed.1 index 465225cc33..9ec2b67dd9 100644 --- a/usr/src/man/man1/sed.1 +++ b/usr/src/man/man1/sed.1 @@ -28,7 +28,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.TH SED 1 "May 24, 2009" "" +.TH SED 1 "May 24, 2009" .SH NAME \fBsed\fP \- stream editor @@ -198,7 +198,7 @@ option was specified); .IP \(bu a context address that consists of a regular expression preceded and followed by a -delimiter. The closing delimiter can also optionally be followed by the +delimiter. The closing delimiter can also optionally be followed by the ``I'' character, to indicate that the regular expression is to be matched in a case-insensitive way. diff --git a/usr/src/man/man1/set.1 b/usr/src/man/man1/set.1 index 069440b63a..e4bb3dfd3b 100644 --- a/usr/src/man/man1/set.1 +++ b/usr/src/man/man1/set.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 set 1 "20 Nov 2007" "SunOS 5.11" "User Commands" +.TH SET 1 "Nov 20, 2007" .SH NAME set, unset, setenv, unsetenv, export \- shell built-in functions to determine the characteristics for environmental variables of the current shell and its @@ -56,7 +56,7 @@ descendents .SS "ksh" .LP .nf -\fBset\fR [\(+-abCefhkmnopstuvx] [\(+-o \fIoption\fR]... [\(+-A \fIname\fR] +\fBset\fR [\(+-abCefhkmnopstuvx] [\(+-o \fIoption\fR]... [\(+-A \fIname\fR] [\fIarg\fR]... .fi @@ -78,7 +78,7 @@ descendents .SS "ksh93" .LP .nf -\fB+set\fR [\(+-abCefGhkmnoprstuvx] [\(+-o \fIoption\fR]... [\(+-A \fIvname\fR] +\fB+set\fR [\(+-abCefGhkmnoprstuvx] [\(+-o \fIoption\fR]... [\(+-A \fIvname\fR] [\fIarg\fR]... .fi @@ -99,125 +99,103 @@ descendents The \fBset\fR built-in command has the following options: .sp .ne 2 -.mk .na \fB\fB--\fR\fR .ad .RS 6n -.rt Does not change any of the flags. This option is useful in setting \fB$1\fR to \fB\(mi\fR\&. .RE .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 6n -.rt Marks variables which are modified or created for export. .RE .sp .ne 2 -.mk .na \fB\fB-e\fR\fR .ad .RS 6n -.rt Exits immediately if a command exits with a non-zero exit status. .RE .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 6n -.rt Disables file name generation. .RE .sp .ne 2 -.mk .na \fB\fB-h\fR\fR .ad .RS 6n -.rt Locates and remembers function commands as functions are defined. Function commands are normally located when the function is executed. .RE .sp .ne 2 -.mk .na \fB\fB-k\fR\fR .ad .RS 6n -.rt All keyword arguments are placed in the environment for a command, not just those that precede the command name. .RE .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 6n -.rt Reads commands but does not execute them. .RE .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad .RS 6n -.rt Exits after reading and executing one command. .RE .sp .ne 2 -.mk .na \fB\fB-u\fR\fR .ad .RS 6n -.rt Treats unset variables as an error when substituting. .RE .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 6n -.rt Prints shell input lines as they are read. .RE .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad .RS 6n -.rt Prints commands and their arguments as they are executed. .RE @@ -251,23 +229,19 @@ argument alone, \fBset\fR assigns an empty (null) value to the variable assigns \fIvalue\fR to \fIvar\fR, where \fIvalue\fR is one of: .sp .ne 2 -.mk .na \fB\fIword\fR\fR .ad .RS 14n -.rt A single word (or quoted string). .RE .sp .ne 2 -.mk .na \fB\fB(\fR\fIwordlist\fR\fB)\fR\fR .ad .RS 14n -.rt A space-separated list of words enclosed in parentheses. .RE @@ -311,12 +285,10 @@ environment variables. The flags for the \fBset\fR built-in have meaning as follows: .sp .ne 2 -.mk .na \fB\fB-A\fR\fR .ad .RS 13n -.rt Array assignment. Unsets the variable \fIname\fR and assigns values sequentially from the list \fIarg\fR. If \fB+A\fR is used, the variable \fIname\fR is not unset first. @@ -324,35 +296,29 @@ sequentially from the list \fIarg\fR. If \fB+A\fR is used, the variable .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 13n -.rt All subsequent variables that are defined are automatically exported. .RE .sp .ne 2 -.mk .na \fB\fB-b\fR\fR .ad .RS 13n -.rt Causes the shell to notify the user asynchronously of background job completions. .RE .sp .ne 2 -.mk .na \fB\fB-C\fR\fR .ad .RS 13n -.rt Prevents existing files from being overwritten by the shell's \fB>\fR redirection operator. The \fB>|\fR redirection operator overrides this noclobber option for an individual file. @@ -360,58 +326,48 @@ noclobber option for an individual file. .sp .ne 2 -.mk .na \fB\fB-e\fR\fR .ad .RS 13n -.rt If a command has a non-zero exit status, executes the \fBERR\fR trap, if set, and exits. This mode is disabled while reading profiles. .RE .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 13n -.rt Disables file name generation. .RE .sp .ne 2 -.mk .na \fB\fB-h\fR\fR .ad .RS 13n -.rt Each command becomes a tracked alias when first encountered. .RE .sp .ne 2 -.mk .na \fB\fB-k\fR\fR .ad .RS 13n -.rt All variable assignment arguments are placed in the environment for a command, not just those that precede the command name. .RE .sp .ne 2 -.mk .na \fB\fB-m\fR\fR .ad .RS 13n -.rt Background jobs run in a separate process group and a line prints upon completion. The exit status of background jobs is reported in a completion message. On systems with job control, this flag is turned on automatically for @@ -420,24 +376,20 @@ interactive shells. .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 13n -.rt Reads commands and checks them for syntax errors, but does not execute them. Ignored for interactive shells. .RE .sp .ne 2 -.mk .na \fB\fB+o\fR\fR .ad .RS 13n -.rt Writes the current option stettings to standard output in a format that is suitable for reinput to the shell as commands that achieve the same option settings. @@ -445,234 +397,192 @@ settings. .sp .ne 2 -.mk .na \fB\fB-o\fR \fIoption\fR\fR .ad .RS 13n -.rt The \fIoption\fR argument can be one of the following option names: .sp .ne 2 -.mk .na \fB\fBallexport\fR\fR .ad .RS 14n -.rt Same as \fB-a\fR. .RE .sp .ne 2 -.mk .na \fB\fBerrexit\fR\fR .ad .RS 14n -.rt Same as \fB-e\fR. .RE .sp .ne 2 -.mk .na \fB\fBbgnice\fR\fR .ad .RS 14n -.rt All background jobs are run at a lower priority. This is the default mode. \fBemacs\fR Puts you in an \fBemacs\fR style in-line editor for command entry. .RE .sp .ne 2 -.mk .na \fB\fBgmacs\fR\fR .ad .RS 14n -.rt Puts you in a \fBgmacs\fR style in-line editor for command entry. .RE .sp .ne 2 -.mk .na \fB\fBignoreeof\fR\fR .ad .RS 14n -.rt The shell does not exit on end-of-file. The command \fBexit\fR must be used. .RE .sp .ne 2 -.mk .na \fB\fBkeyword\fR\fR .ad .RS 14n -.rt Same as \fB-k\fR. .RE .sp .ne 2 -.mk .na \fB\fBmarkdirs\fR\fR .ad .RS 14n -.rt All directory names resulting from file name generation have a trailing \fB/\fR appended. .RE .sp .ne 2 -.mk .na \fB\fBmonitor\fR\fR .ad .RS 14n -.rt Same as \fB-m\fR. .RE .sp .ne 2 -.mk .na \fB\fBnoclobber\fR\fR .ad .RS 14n -.rt Prevents redirection operator \fB>\fR from truncating existing files. Requires the \fB>|\fR operator to truncate a file when turned on. Same as \fB-C\fR. .RE .sp .ne 2 -.mk .na \fB\fBnoexec\fR\fR .ad .RS 14n -.rt Same as \fB-n\fR. .RE .sp .ne 2 -.mk .na \fB\fBnoglob\fR\fR .ad .RS 14n -.rt Same as \fB-f\fR. .RE .sp .ne 2 -.mk .na \fB\fBnolog\fR\fR .ad .RS 14n -.rt Does not save function definitions in history file. .RE .sp .ne 2 -.mk .na \fB\fBnotify\fR\fR .ad .RS 14n -.rt Same as \fB-b\fR. .RE .sp .ne 2 -.mk .na \fB\fBnounset\fR\fR .ad .RS 14n -.rt Same as \fB-u\fR. .RE .sp .ne 2 -.mk .na \fB\fBprivileged\fR\fR .ad .RS 14n -.rt Same as \fB-p\fR. .RE .sp .ne 2 -.mk .na \fB\fBverbose\fR\fR .ad .RS 14n -.rt Same as \fB-v\fR. .RE .sp .ne 2 -.mk .na \fB\fBtrackall\fR\fR .ad .RS 14n -.rt Same as \fB-h\fR. .RE .sp .ne 2 -.mk .na \fB\fBvi\fR\fR .ad .RS 14n -.rt Puts you in insert mode of a \fBvi\fR style in-line editor until you hit escape character \fB033\fR. This puts you in control mode. A return sends the line. .RE .sp .ne 2 -.mk .na \fB\fBviraw\fR\fR .ad .RS 14n -.rt Each character is processed as it is typed in \fBvi\fR mode. .RE .sp .ne 2 -.mk .na \fB\fBxtrace\fR\fR .ad .RS 14n -.rt Same as \fB-x\fR. .RE @@ -683,12 +593,10 @@ Same as \fB-x\fR. If no option name is supplied then the current option settings are printed. .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 8n -.rt Disables processing of the \fB$HOME/.profile\fR file and uses the file \fB/etc/suid_profile\fR instead of the \fBENV\fR file. This mode is on whenever the effective uid is not equal to the real uid, or when the effective gid is @@ -698,78 +606,64 @@ be set to the real uid and gid. .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 8n -.rt Sorts the positional parameters lexicographically. .RE .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad .RS 8n -.rt Exits after reading and executing one command. .RE .sp .ne 2 -.mk .na \fB\fB-u\fR\fR .ad .RS 8n -.rt Treats unset parameters as an error when substituting. .RE .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 8n -.rt Prints shell input lines as they are read. .RE .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad .RS 8n -.rt Prints commands and their arguments as they are executed. .RE .sp .ne 2 -.mk .na \fB\fB\(mi\fR\fR .ad .RS 8n -.rt Turns off \fB-x\fR and \fB-v\fR flags and stops examining arguments for flags. .RE .sp .ne 2 -.mk .na \fB\fB-\fR\fR .ad .RS 8n -.rt Does not change any of the flags. This option is useful in setting \fB$1\fR to a value beginning with \fB\(mi\fR\&. If no arguments follow this flag then the positional parameters are unset. @@ -902,71 +796,59 @@ any additional arguments are specified, they replace the positional parameters. The options for set in \fBksh93\fR are: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 15n -.rt Set the export attribute for each variable whose name does not contain a . that you assign a value in the current shell environment. .RE .sp .ne 2 -.mk .na \fB\fB-A\fR \fIname\fR\fR .ad .RS 15n -.rt Assign the arguments sequentially to the array named by \fIname\fR starting at subscript \fB0\fR rather than to the positional parameters. .RE .sp .ne 2 -.mk .na \fB\fB-b\fR\fR .ad .RS 15n -.rt The shell writes a message to standard error as soon it detects that a background job completes rather than waiting until the next prompt. .RE .sp .ne 2 -.mk .na \fB\fB-B\fR\fR .ad .RS 15n -.rt Enable \fB{...}\fR group expansion. On by default. .RE .sp .ne 2 -.mk .na \fB\fB-C\fR\fR .ad .RS 15n -.rt Prevents existing regular files from being overwritten using the > redirection operator. The \fB>|\fR redirection overrides this \fBnoclobber\fR option. .RE .sp .ne 2 -.mk .na \fB\fB-e\fR\fR .ad .RS 15n -.rt A simple command that has a \fBnon-zero\fR exit status causes the shell to exit unless the simple command is: .RS +4 @@ -991,58 +873,48 @@ contained in the pipeline following \fB!\fR .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 15n -.rt Pathname expansion is disabled. .RE .sp .ne 2 -.mk .na \fB\fB-G\fR\fR .ad .RS 15n -.rt Causes \fB**\fR by itself to also match all sub-directories during pathname expansion. .RE .sp .ne 2 -.mk .na \fB\fB-h\fR\fR .ad .RS 15n -.rt Obsolete. Causes each command whose name has the syntax of an alias to become a tracked alias when it is first encountered. .RE .sp .ne 2 -.mk .na \fB\fB-H\fR\fR .ad .RS 15n -.rt Enable \fB!\fR-style history expansion similar to csh. .RE .sp .ne 2 -.mk .na \fB\fB-k\fR\fR .ad .RS 15n -.rt This is obsolete. All arguments of the form \fIname\fR\fB=\fR\fIvalue\fR are removed and placed in the variable assignment list for the command. Ordinarily, variable assignments must precede command arguments. @@ -1050,12 +922,10 @@ variable assignments must precede command arguments. .sp .ne 2 -.mk .na \fB\fB-m\fR\fR .ad .RS 15n -.rt When enabled, the shell runs background jobs in a separate process group and displays a line upon completion. This mode is enabled by default for interactive shells on systems that support job control. @@ -1063,24 +933,20 @@ interactive shells on systems that support job control. .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 15n -.rt The shell reads commands and checks for syntax errors, but does not execute the command. Usually specified on command invocation. .RE .sp .ne 2 -.mk .na \fB\fB-o\fR [\fIoption\fR]\fR .ad .RS 15n -.rt If option is not specified, the list of options and their current settings is written to standard output. When invoked with a \fB+\fR the options are written in a format that can be input again to the shell to restore the settings. This @@ -1089,223 +955,183 @@ option can be repeated to enable or disable multiple options. The value of \fIoption\fR must be one of the following: .sp .ne 2 -.mk .na \fB\fBallexport\fR\fR .ad .RS 15n -.rt Same as \fB-a\fR. .RE .sp .ne 2 -.mk .na \fB\fBbgnice\fR\fR .ad .RS 15n -.rt All background jobs are run at lower priorities. .RE .sp .ne 2 -.mk .na \fB\fBbraceexpand\fR\fR .ad .RS 15n -.rt Same as \fB-B\fR. .RE .sp .ne 2 -.mk .na \fB\fBemacs\fR\fR .ad .RS 15n -.rt Enables or disables \fBemacs\fR editing mode. .RE .sp .ne 2 -.mk .na \fB\fBerrexit\fR\fR .ad .RS 15n -.rt Same as \fB-e\fR. .RE .sp .ne 2 -.mk .na \fB\fBglobstar\fR\fR .ad .RS 15n -.rt Equivalent to \fB-\fRG. .RE .sp .ne 2 -.mk .na \fB\fBgmacs\fR\fR .ad .RS 15n -.rt Enables or disables \fBgmacs\fR. \fBgmacs\fR editing mode is the same as \fBemacs\fR editing mode, except for the handling of CTRL-T. .RE .sp .ne 2 -.mk .na \fB\fBhistexpand\fR\fR .ad .RS 15n -.rt Same as \fB-H\fR. .RE .sp .ne 2 -.mk .na \fB\fBignoreeof\fR\fR .ad .RS 15n -.rt The interactive shell does not exit on end-of-file. .RE .sp .ne 2 -.mk .na \fB\fBkeyword\fR\fR .ad .RS 15n -.rt Same as \fB-k\fR. .RE .sp .ne 2 -.mk .na \fB\fBmarkdirs\fR\fR .ad .RS 15n -.rt All directory names resulting from file name generation have a trailing \fB/\fR appended. .RE .sp .ne 2 -.mk .na \fB\fBmonitor\fR\fR .ad .RS 15n -.rt Same as \fB-m\fR. .RE .sp .ne 2 -.mk .na \fB\fBmultiline\fR\fR .ad .RS 15n -.rt Use multiple lines when editing lines that are longer than the window width. .RE .sp .ne 2 -.mk .na \fB\fBnoclobber\fR\fR .ad .RS 15n -.rt Same as \fB-C\fR. .RE .sp .ne 2 -.mk .na \fB\fBnoexec\fR\fR .ad .RS 15n -.rt Same as \fB-n\fR. .RE .sp .ne 2 -.mk .na \fB\fBnoglob\fR\fR .ad .RS 15n -.rt Same as \fB-f\fR. .RE .sp .ne 2 -.mk .na \fB\fBnolog\fR\fR .ad .RS 15n -.rt This has no effect. It is provided for backward compatibility. .RE .sp .ne 2 -.mk .na \fB\fBnotify\fR\fR .ad .RS 15n -.rt Same as \fB-b\fR. .RE .sp .ne 2 -.mk .na \fB\fBnounset\fR\fR .ad .RS 15n -.rt Same as \fB-u\fR. .RE .sp .ne 2 -.mk .na \fB\fBpipefail\fR\fR .ad .RS 15n -.rt A pipeline does not complete until all components of the pipeline have completed, and the exit status of the pipeline is the value of the last command to exit with \fBnon-zero\fR exit status, or is \fBzero\fR if all commands @@ -1314,79 +1140,65 @@ return zero exit status. .sp .ne 2 -.mk .na \fB\fBprivileged\fR\fR .ad .RS 15n -.rt Same as \fB-p\fR. .RE .sp .ne 2 -.mk .na \fB\fBshowme\fR\fR .ad .RS 15n -.rt Simple commands preceded by a ; are traced as if \fB-x\fR were enabled but not executed. .RE .sp .ne 2 -.mk .na \fB\fBtrackall\fR\fR .ad .RS 15n -.rt Same as \fB-h\fR. .RE .sp .ne 2 -.mk .na \fB\fBverbose\fR\fR .ad .RS 15n -.rt Same as \fB-v\fR. .RE .sp .ne 2 -.mk .na \fB\fBvi\fR\fR .ad .RS 15n -.rt Enables or disables \fBvi\fR editing mode. .RE .sp .ne 2 -.mk .na \fB\fBviraw\fR\fR .ad .RS 15n -.rt Does not use canonical input mode when using vi edit mode .RE .sp .ne 2 -.mk .na \fB\fBxtrace\fR\fR .ad .RS 15n -.rt Same as \fB-x\fR. .RE @@ -1394,12 +1206,10 @@ Same as \fB-x\fR. .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 15n -.rt Privileged mode. Disabling \fB-p\fR sets the effective user id to the real user id, and the effective group id to the real group id. Enabling \fB-p\fR restores the effective user and group ids to their values when the shell was invoked. @@ -1410,68 +1220,56 @@ processed when \fB-p\fR is enabled. .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 15n -.rt Restricted. Enables restricted shell. This option cannot be unset once enabled. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 15n -.rt Sort the positional parameters .RE .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad .RS 15n -.rt Obsolete. The shell reads one command and then exits. .RE .sp .ne 2 -.mk .na \fB\fB-u\fR\fR .ad .RS 15n -.rt If enabled, the shell displays an error message when it tries to expand a variable that is unset. .RE .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 15n -.rt Verbose. The shell displays its input onto standard error as it reads it. .RE .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad .RS 15n -.rt Execution trace. The shell displays each command after all expansion and before execution preceded by the expanded value of the \fBPS4\fR parameter. .RE @@ -1481,23 +1279,19 @@ execution preceded by the expanded value of the \fBPS4\fR parameter. The following exit values are returned by \fBset\fR in \fBksh93\fR: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -1511,24 +1305,20 @@ variables cannot be unset. The options for \fBunset\fR in \fBksh93\fR are: .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 6n -.rt Where \fIname\fR refers to a function name, the shell unsets the function definition. .RE .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 6n -.rt If \fIname\fR refers to variable that is a reference, the variable \fIname\fR is unset rather than the variable it references. Otherwise, this option is equivalent to the \fB-v\fR option. @@ -1536,12 +1326,10 @@ equivalent to the \fB-v\fR option. .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 6n -.rt Where \fIname\fR refers to a variable name, the shell unsets it and removes it from the environment. This is the default behavior. .RE @@ -1551,23 +1339,19 @@ from the environment. This is the default behavior. The following exit values are returned by \fBunset\fR in \fBksh93\fR: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. All names were successfully unset. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred, or one or more \fIname\fR operands could not be unset .RE @@ -1591,12 +1375,10 @@ expansion occurs on value. The options for \fBexport\fR in \fBksh93\fR are: .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 6n -.rt Causes the output to be in the form of \fBexport\fR commands that can be used as input to the shell to recreate the current exports. .RE @@ -1606,23 +1388,19 @@ as input to the shell to recreate the current exports. The following exit values are returned by \fBexport\fR in \fBksh93\fR: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE diff --git a/usr/src/man/man1/setfacl.1 b/usr/src/man/man1/setfacl.1 index 1b5dfae0f8..11c7b644f3 100644 --- a/usr/src/man/man1/setfacl.1 +++ b/usr/src/man/man1/setfacl.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 setfacl 1 "19 Dec 2006" "SunOS 5.11" "User Commands" +.TH SETFACL 1 "Dec 19, 2006" .SH NAME setfacl \- modify the Access Control List (ACL) for a file or files .SH SYNOPSIS @@ -72,12 +72,10 @@ comma-separated \fBACL\fR entries. An \fBACL\fR entry consists of the following fields separated by colons: .sp .ne 2 -.mk .na \fB\fIentry_type\fR\fR .ad .RS 14n -.rt Type of \fBACL\fR entry on which to set file permissions. For example, \fIentry_type\fR can be \fBuser\fR (the owner of a file) or \fBmask\fR (the \fBACL\fR mask). @@ -85,24 +83,20 @@ Type of \fBACL\fR entry on which to set file permissions. For example, .sp .ne 2 -.mk .na \fB\fIuid\fR or \fIgid\fR\fR .ad .RS 14n -.rt User name or user identification number. Or, group name or group identification number. .RE .sp .ne 2 -.mk .na \fB\fIperms\fR\fR .ad .RS 14n -.rt Represents the permissions that are set on \fIentry_type\fR. \fIperms\fR can be indicated by the symbolic characters \fBrwx\fR or a number (the same permissions numbers used with the \fBchmod\fR command). @@ -116,36 +110,34 @@ be specified for directories): .sp .TS -tab(); -cw(2i) cw(3.5i) -lw(2i) lw(3.5i) -. -\fBACL\fR EntryDescription +c c +l l . +\fBACL\fR Entry Description _ -u[ser]::\fIperms\fR File owner permissions. -g[roup]::\fIperms\fR File group owner permissions. -o[ther]:\fIperms\fR T{ +u[ser]::\fIperms\fR File owner permissions. +g[roup]::\fIperms\fR File group owner permissions. +o[ther]:\fIperms\fR T{ Permissions for users other than the file owner or members of file group owner. T} -m[ask]:\fIperms\fR T{ +m[ask]:\fIperms\fR T{ The \fBACL\fR mask. The mask entry indicates the maximum permissions allowed for users (other than the owner) and for groups. The mask is a quick way to change permissions on all the users and groups. T} -u[ser]:\fIuid:perms\fRT{ +u[ser]:\fIuid:perms\fR T{ Permissions for a specific user. For \fIuid\fR, you can specify either a user name or a numeric UID. T} -g[roup]:\fIgid:perms\fRT{ +g[roup]:\fIgid:perms\fR T{ Permissions for a specific group. For \fIgid\fR, you can specify either a group name or a numeric GID. T} -d[efault]:u[ser]::\fIperms\fR Default file owner permissions. -d[efault]:g[roup]::\fIperms\fR Default file group owner permissions. -d[efault]:o[ther]:\fIperms\fR T{ +d[efault]:u[ser]::\fIperms\fR Default file owner permissions. +d[efault]:g[roup]::\fIperms\fR Default file group owner permissions. +d[efault]:o[ther]:\fIperms\fR T{ Default permissions for users other than the file owner or members of the file group owner. T} -d[efault]:m[ask]:\fIperms\fR Default \fBACL\fR mask. -d[efault]:u[ser]:\fIuid\fR:\fIperms\fRT{ +d[efault]:m[ask]:\fIperms\fR Default \fBACL\fR mask. +d[efault]:u[ser]:\fIuid\fR:\fIperms\fR T{ Default permissions for a specific user. For \fIuid\fR, you can specify either a user name or a numeric UID. T} -d[efault]:g[roup]:\fIgid\fR:\fIperms\fRT{ +d[efault]:g[roup]:\fIgid\fR:\fIperms\fR T{ Default permissions for a specific group. For \fIgid\fR, you can specify either a group name or a numeric GID. T} .TE @@ -161,12 +153,10 @@ file group owner, \fBACL\fR mask, and others can not be deleted. The options have the following meaning: .sp .ne 2 -.mk .na \fB\fB-d\fR \fIacl_entries\fR\fR .ad .RS 18n -.rt Deletes one or more entries from the file. The entries for the file owner, the file group owner, and others can not be deleted from the \fBACL\fR. Notice that deleting an entry does not necessarily have the same effect as removing all @@ -175,12 +165,10 @@ permissions from the entry. .sp .ne 2 -.mk .na \fB\fB-f\fR \fIacl_file\fR\fR .ad .RS 18n -.rt Sets a file's \fBACL\fR with the \fBACL\fR entries contained in the file named \fIacl_file\fR. The same constraints on specified entries hold as with the \fB-s\fR option. The entries are not required to be in any specific order in @@ -196,12 +184,10 @@ are ignored. .sp .ne 2 -.mk .na \fB\fB-m\fR \fIacl_entries\fR\fR .ad .RS 18n -.rt Adds one or more new \fBACL\fR entries to the file, and/or modifies one or more existing \fBACL\fR entries on the file. If an entry already exists for a specified \fIuid\fR or \fIgid\fR, the specified permissions replace the current @@ -213,12 +199,10 @@ other, mask, and any additional entries) the first time. .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 18n -.rt Recalculates the permissions for the \fBACL\fR mask entry. The permissions specified in the \fBACL\fR mask entry are ignored and replaced by the maximum permissions necessary to grant the access to all additional user, file group @@ -229,12 +213,10 @@ unchanged. .sp .ne 2 -.mk .na \fB\fB-s\fR \fIacl_entries\fR\fR .ad .RS 18n -.rt Sets a file's \fBACL\fR. All old \fBACL\fR entries are removed and replaced with the newly specified \fBACL\fR. The entries need not be in any specific order. They are sorted by the command before being applied to the file. @@ -338,7 +320,7 @@ access. .sp .in +2 .nf -\fBsetfacl -s user:shea:rwx,user::rwx,group::rw-,mask:r--,other:--- abc\fR +\fBsetfacl -s user:shea:rwx,user::rwx,group::rw-,mask:r--,other:--- abc\fR .fi .in -2 .sp @@ -373,23 +355,19 @@ The following example sets the same \fBACL\fR on file \fBabc\fR as the file .SH FILES .sp .ne 2 -.mk .na \fB\fB/etc/passwd\fR\fR .ad .RS 15n -.rt password file .RE .sp .ne 2 -.mk .na \fB\fB/etc/group\fR\fR .ad .RS 15n -.rt group file .RE diff --git a/usr/src/man/man1/setlabel.1 b/usr/src/man/man1/setlabel.1 index 05f0d39ad1..30faacbbfe 100644 --- a/usr/src/man/man1/setlabel.1 +++ b/usr/src/man/man1/setlabel.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 setlabel 1 "20 Jul 2007" "SunOS 5.11" "User Commands" +.TH SETLABEL 1 "Jul 20, 2007" .SH NAME setlabel \- move files to zone with corresponding sensitivity label .SH SYNOPSIS @@ -40,34 +40,28 @@ to execute this command. \fBsetlabel\fR exits with one of the following values: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt Usage error. .RE .sp .ne 2 -.mk .na \fB\fB2\fR\fR .ad .RS 5n -.rt Error in getting, setting or translating the label. .RE @@ -173,13 +167,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed .TE .SH SEE ALSO diff --git a/usr/src/man/man1/setpgrp.1 b/usr/src/man/man1/setpgrp.1 index d1bdcbae9c..7528f8a7de 100644 --- a/usr/src/man/man1/setpgrp.1 +++ b/usr/src/man/man1/setpgrp.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 setpgrp 1 "5 Jan 2000" "SunOS 5.11" "User Commands" +.TH SETPGRP 1 "Jan 5, 2000" .SH NAME setpgrp \- set process group ID .SH SYNOPSIS @@ -26,23 +26,19 @@ if any. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIcommand\fR\fR .ad .RS 11n -.rt The name of a command to be invoked. .RE .sp .ne 2 -.mk .na \fB\fIarg\fR\fR .ad .RS 11n -.rt An option or argument to \fIcommand\fR. .RE @@ -52,12 +48,10 @@ An option or argument to \fIcommand\fR. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt Error executing the \fBsetpgrp\fR utility or during \fBexec()\fR of \fIcommand\fR. .RE diff --git a/usr/src/man/man1/sftp.1 b/usr/src/man/man1/sftp.1 index ae8d15b138..88222d1236 100644 --- a/usr/src/man/man1/sftp.1 +++ b/usr/src/man/man1/sftp.1 @@ -2,14 +2,14 @@ .\" To view license terms, attribution, and copyright for OpenSSH, the default path is /var/sadm/pkg/SUNWsshdr/install/copyright. If the Solaris operating environment has been installed anywhere other than the default, modify the specified path to access .\" the file at the installed location. .\" Portions Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved. -.TH sftp 1 "8 Nov 2007" "SunOS 5.11" "User Commands" +.TH SFTP 1 "Nov 8, 2007" .SH NAME sftp \- secure file transfer program .SH SYNOPSIS .LP .nf -\fBsftp\fR [\fB-1Cv\fR] [\fB-B\fR \fIbuffer_size\fR] [\fB-b\fR \fIbatchfile\fR] [\fB-F\fR \fIssh_config\fR] - [\fB-o\fR \fIssh_option\fR] [\fB-P\fR \fIsftp_server_path\fR] [\fB-R\fR \fInum_requests\fR] +\fBsftp\fR [\fB-1Cv\fR] [\fB-B\fR \fIbuffer_size\fR] [\fB-b\fR \fIbatchfile\fR] [\fB-F\fR \fIssh_config\fR] + [\fB-o\fR \fIssh_option\fR] [\fB-P\fR \fIsftp_server_path\fR] [\fB-R\fR \fInum_requests\fR] [\fB-S\fR \fIprogram\fR] [\fB-s\fR \fIsubsystem\fR | \fIsftp_server\fR] \fIhost\fR .fi @@ -58,12 +58,10 @@ specified \fBsftp\fR tries to log in as the specified user. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-b\fR \fIbatchfile\fR\fR .ad .RS 30n -.rt Batch mode reads a series of commands from an input \fIbatchfile\fR instead of \fBstdin\fR. Since it lacks user interaction, it should be used in conjunction with non-interactive authentication. A batchfile of \fB-\fR can be used to @@ -77,12 +75,10 @@ suppressed on a command by command basis by prefixing the command with a .sp .ne 2 -.mk .na \fB\fB-B\fR \fIbuffer_size\fR\fR .ad .RS 30n -.rt Specifies the size of the buffer that \fBsftp\fR uses when transferring files. Larger buffers require fewer round trips at the cost of higher memory consumption. The default is 32768 bytes. @@ -90,46 +86,38 @@ consumption. The default is 32768 bytes. .sp .ne 2 -.mk .na \fB\fB-C\fR\fR .ad .RS 30n -.rt Enables compression, using the \fB-C\fR flag in \fBssh\fR(1). .RE .sp .ne 2 -.mk .na \fB\fB-F\fR \fIssh_config\fR\fR .ad .RS 30n -.rt Specifies an alternative per-user configuration file for \fBssh\fR. This option is directly passed to \fBssh\fR(1). .RE .sp .ne 2 -.mk .na \fB\fB-o\fR \fIssh_option\fR\fR .ad .RS 30n -.rt Specifies an option to be directly passed to \fBssh\fR(1). .RE .sp .ne 2 -.mk .na \fB\fB-P\fR \fIsftp_server path\fR\fR .ad .RS 30n -.rt Executes the specified path as an \fIsftp-server\fR and uses a pipe, rather than an \fBssh\fR connection, to communicate with it. This option can be useful in debugging the \fBsftp\fR client and server. The \fB-P\fR and \fB-S\fR @@ -138,12 +126,10 @@ options are mutually exclusive. .sp .ne 2 -.mk .na \fB\fB-R\fR \fInum_requests\fR\fR .ad .RS 30n -.rt Specifies how many requests can be outstanding at any one time. Increasing this can slightly improve file transfer speed but increases memory usage. The default is 16 outstanding requests. @@ -151,12 +137,10 @@ default is 16 outstanding requests. .sp .ne 2 -.mk .na \fB\fB-s\fR \fIsubsystem\fR | \fIsftp_server\fR\fR .ad .RS 30n -.rt Specifies the \fBSSH2\fR subsystem or the path for an \fBsftp\fR server on the remote host. A path is useful for using \fBsftp\fR over protocol version 1, or when the remote \fBsshd\fR does not have an \fBsftp\fR subsystem configured. @@ -164,12 +148,10 @@ when the remote \fBsshd\fR does not have an \fBsftp\fR subsystem configured. .sp .ne 2 -.mk .na \fB\fB-S\fR \fIssh_program\fR \fIpath\fR\fR .ad .RS 30n -.rt Uses the specified program instead of \fBssh\fR(1) to connect to the \fBsftp\fR server. The \fB-P\fR and \fB-S\fR options are mutually exclusive. The program must understand \fBssh\fR(1) options. @@ -177,23 +159,19 @@ must understand \fBssh\fR(1) options. .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 30n -.rt Raises logging level. This option is also passed to \fBssh\fR(1). .RE .sp .ne 2 -.mk .na \fB\fB-1\fR\fR .ad .RS 30n -.rt Specifies the use of protocol version 1. .RE @@ -203,12 +181,10 @@ Specifies the use of protocol version 1. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIhostname\fR | \fIuser@hostname\fR\fR .ad .RS 28n -.rt The name of the host to which \fBsftp\fR connects and logs into. .RE @@ -220,7 +196,6 @@ those of \fBftp\fR(1). Commands are case insensitive and path names can be enclosed in quotes if they contain spaces. .sp .ne 2 -.mk .na \fB\fBbye\fR\fR .ad @@ -231,7 +206,6 @@ Quits \fBsftp\fR. .sp .ne 2 -.mk .na \fB\fBcd\fR \fIpath\fR\fR .ad @@ -242,7 +216,6 @@ Changes remote directory to \fIpath\fR. .sp .ne 2 -.mk .na \fB\fBchgrp\fR \fIgrp path\fR\fR .ad @@ -254,7 +227,6 @@ Changes group of file \fIpath\fR to \fIgrp\fR. \fIgrp\fR must be a numeric .sp .ne 2 -.mk .na \fB\fBchmod\fR \fImode path\fR\fR .ad @@ -265,7 +237,6 @@ Changes permissions of file \fIpath\fR to \fImode\fR. .sp .ne 2 -.mk .na \fB\fBchown\fR \fIown path\fR\fR .ad @@ -277,7 +248,6 @@ Changes owner of file \fIpath\fR to \fIown\fR. \fIown\fR must be a numeric .sp .ne 2 -.mk .na \fB\fBexit\fR\fR .ad @@ -288,7 +258,6 @@ Quits \fBsftp\fR. .sp .ne 2 -.mk .na \fB\fBget\fR [\fIflags\fR] \fIremote-path\fR [\fIlocal-path\fR]\fR .ad @@ -302,7 +271,6 @@ permission and access time are copied too. .sp .ne 2 -.mk .na \fB\fBhelp\fR\fR .ad @@ -315,7 +283,6 @@ Identical to the \fB?\fR command. .sp .ne 2 -.mk .na \fB\fBlcd\fR \fIpath\fR\fR .ad @@ -326,7 +293,6 @@ Changes local directory to \fIpath\fR. .sp .ne 2 -.mk .na \fB\fBlls\fR [\fIls-options\fR [\fIpath\fR]]\fR .ad @@ -338,7 +304,6 @@ Displays local directory listing of either \fIpath\fR or current directory if .sp .ne 2 -.mk .na \fB\fBlmkdir\fR \fIpath\fR\fR .ad @@ -349,7 +314,6 @@ Creates local directory specified by \fIpath\fR. .sp .ne 2 -.mk .na \fB\fBln\fR \fIoldpath\fR \fInewpath\fR\fR .ad @@ -360,7 +324,6 @@ Creates a link from \fIoldpath\fR to \fInewpath\fR. .sp .ne 2 -.mk .na \fB\fBlpwd\fR\fR .ad @@ -371,7 +334,6 @@ Prints local working directory. .sp .ne 2 -.mk .na \fB\fBls\fR [\fB-1aflnrSt\fR] [\fIpath\fR]\fR .ad @@ -383,89 +345,73 @@ Displays remote directory listing of either \fIpath\fR or current directory if The \fBls\fR supports the following options: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 6n -.rt Lists files beginning with a dot (\fB\&.\fR). .RE .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 6n -.rt Does not sort the listing. The default sort order is lexicographical. .RE .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 6n -.rt Displays additional details including permissions and ownership information. .RE .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 6n -.rt Produces a long listing with user and group information presented numerically. .RE .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 6n -.rt Reverses the sort order of the listing. .RE .sp .ne 2 -.mk .na \fB\fB-S\fR\fR .ad .RS 6n -.rt Sorts the listing by file size. .RE .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad .RS 6n -.rt Sorts the listing by last modification time. .RE .sp .ne 2 -.mk .na \fB\fB-1\fR\fR .ad .RS 6n -.rt Produces single column output. .RE @@ -473,7 +419,6 @@ Produces single column output. .sp .ne 2 -.mk .na \fB\fBlumask\fR \fIumask\fR\fR .ad @@ -484,7 +429,6 @@ Sets local \fBumask\fR to \fIumask\fR. .sp .ne 2 -.mk .na \fB\fBmkdir\fR \fIpath\fR\fR .ad @@ -495,7 +439,6 @@ Creates remote directory specified by \fIpath\fR. .sp .ne 2 -.mk .na \fB\fBput\fR [\fIflags\fR] \fIlocal-path\fR [\fIlocal-path\fR]\fR .ad @@ -509,7 +452,6 @@ access time are copied too. .sp .ne 2 -.mk .na \fB\fBpwd\fR\fR .ad @@ -520,7 +462,6 @@ Displays remote working directory. .sp .ne 2 -.mk .na \fB\fBquit\fR\fR .ad @@ -531,7 +472,6 @@ Quits \fBsftp\fR. .sp .ne 2 -.mk .na \fB\fBrename\fR \fIoldpath newpath\fR\fR .ad @@ -542,7 +482,6 @@ Renames remote file from \fIoldpath\fR to \fInewpath\fR. .sp .ne 2 -.mk .na \fB\fBrm\fR \fIpath\fR\fR .ad @@ -553,7 +492,6 @@ Deletes remote file specified by \fIpath\fR. .sp .ne 2 -.mk .na \fB\fBrmdir\fR \fIpath\fR\fR .ad @@ -564,7 +502,6 @@ Removes remote directory specified by \fIpath\fR. .sp .ne 2 -.mk .na \fB\fBsymlink\fR \fIoldpath\fR \fInewpath\fR\fR .ad @@ -575,7 +512,6 @@ Creates a symbolic link from \fIoldpath\fR to \fInewpath\fR. .sp .ne 2 -.mk .na \fB\fBversion\fR\fR .ad @@ -586,7 +522,6 @@ Displays the \fBsftp\fR protocol version. .sp .ne 2 -.mk .na \fB\fB#\fR [\fIcomment\fR]\fR .ad @@ -597,7 +532,6 @@ Include a comment. This is useful in batch files. .sp .ne 2 -.mk .na \fB\fB!\fR [\fIcommand\fR]\fR .ad @@ -610,7 +544,6 @@ If \fIcommand\fR is specified, executes \fIcommand\fR in the local shell. .sp .ne 2 -.mk .na \fB\fB?\fR\fR .ad @@ -627,23 +560,19 @@ Identical to the \fBhelp\fR command. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -655,13 +584,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed .TE .SH SEE ALSO diff --git a/usr/src/man/man1/shcomp.1 b/usr/src/man/man1/shcomp.1 index 6c29803983..6b3d85fee1 100644 --- a/usr/src/man/man1/shcomp.1 +++ b/usr/src/man/man1/shcomp.1 @@ -2,7 +2,7 @@ .\" Copyright (c) 1982-2007 AT&T Knowledge Ventures .\" To view license terms, see http://www.opensource.org/licenses/cpl1.0.txt .\" Portions Copyright (c) 2009, Sun Microsystems, Inc. -.TH shcomp 1 "27 Jan 2009" "SunOS 5.11" "User Commands" +.TH SHCOMP 1 "Jan 27, 2009" .SH NAME shcomp \- compile a ksh93 shell script .SH SYNOPSIS @@ -32,7 +32,6 @@ requires variable expansion will not work correctly. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-D\fR\fR .ad @@ -41,7 +40,6 @@ The following options are supported: \fB\fB--dictionary\fR\fR .ad .RS 16n -.rt Generate a list of strings that need to be placed in a message catalog for internationalization. .sp @@ -53,7 +51,6 @@ versions for internationalization. .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad @@ -62,13 +59,11 @@ versions for internationalization. \fB\fB--noexec\fR\fR .ad .RS 16n -.rt Display warning messages for obsolete or non-conforming constructs. .RE .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad @@ -77,7 +72,6 @@ Display warning messages for obsolete or non-conforming constructs. \fB\fB--verbose\fR\fR .ad .RS 16n -.rt Display input from \fIinfile\fR onto standard error as it reads it. .RE @@ -87,12 +81,10 @@ Display input from \fIinfile\fR onto standard error as it reads it. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIinfile\fR\fR .ad .RS 11n -.rt Specifies the name of the file that contains the shell script to be used as input. .sp @@ -101,12 +93,10 @@ If \fIinfile\fR is omitted, the shell script is read from standard input. .sp .ne 2 -.mk .na \fB\fIoutfile\fR\fR .ad .RS 11n -.rt Specifies the name of the output file. .sp If \fIoutfile\fR is omitted, both modes write their results to standard output. @@ -118,23 +108,19 @@ If \fIoutfile\fR is omitted, both modes write their results to standard output. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -146,15 +132,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilitySee below. +Interface Stability See below. .TE .sp diff --git a/usr/src/man/man1/shell_builtins.1 b/usr/src/man/man1/shell_builtins.1 index 6003b3f707..ab2575a8a6 100644 --- a/usr/src/man/man1/shell_builtins.1 +++ b/usr/src/man/man1/shell_builtins.1 @@ -1,11 +1,11 @@ '\" te -.\" Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved. +.\" Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved. .\" Copyright 1989 AT&T .\" Portions Copyright (c) 1982-2007 AT&T Knowledge Ventures .\" 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 shell_builtins 1 "20 Nov 2007" "SunOS 5.11" "User Commands" +.TH SHELL_BUILTINS 1 "Nov 20, 2007" .SH NAME shell_builtins, case, for, foreach, function, if, repeat, select, switch, until, while \- shell command interpreter built-in commands @@ -33,97 +33,95 @@ They are described on their respective manual pages. .sp .TS -tab(); -cw(2.75i) cw(2.75i) -lw(2.75i) lw(2.75i) -. -CommandShell +c c +l l . +Command Shell _ -\fB++**alias\fRcsh, ksh, ksh93 -\fBbg\fRcsh, ksh, ksh93, sh -\fB+*break\fRcsh, ksh, ksh93, sh -\fBbuiltin\fRksh93 -\fBcase\fRcsh, ksh, ksh93, sh -\fBcat\fRksh93 -\fBcd\fRcsh, ksh, ksh93, sh -\fBchdir\fRcsh, sh -\fBchown\fRksh93 -\fBcommand\fRksh93 -\fB+*continue\fRcsh, ksh, ksh93, sh -\fBdirs\fRcsh -\fBdisown\fRksh93 -\fBecho\fRcsh, ksh, ksh93, sh -\fB+*eval\fRcsh, ksh, ksh93, sh -\fB+*exec\fRcsh, ksh, ksh93, sh -\fB+*exit\fRcsh, ksh, ksh93, sh -\fB++**export\fRksh, ksh93, sh -\fBfalse\fRksh, ksh93 -\fBfc\fRksh, ksh93 -\fBfg\fRcsh, ksh, ksh93, sh -\fBfor\fRksh, ksh93, sh -\fBforeach\fRcsh -\fBfunction\fRksh, ksh93 -\fBgetconf\fRksh93 -\fBgetopts\fRksh, ksh93, sh -\fBglob\fRcsh -\fBgoto\fRcsh -\fBhash\fRksh, ksh93, sh -\fBhashstat\fRcsh -\fBhead\fRksh93 -\fBhist\fRksh93 -\fBhistory\fRcsh -\fBif\fRcsh, ksh, ksh93, sh -\fBjobs\fRcsh, ksh, ksh93, sh -\fBkill\fRcsh, ksh, ksh93, sh -\fBlet\fRksh, ksh93, -\fBlimit\fRcsh -\fBlogin\fRcsh, ksh, ksh93, sh -\fBlogout\fRcsh -\fBmkdir\fRksh93 -\fBnice\fRcsh -\fB+*newgrp\fRksh, ksh93, sh -\fBnohup\fRcsh -\fBnotify\fRcsh -\fBonintr\fRcsh -\fBpopd\fRcsh -\fBprint\fRksh, ksh93 -\fBprintf\fRksh93 -\fBpushd\fRcsh -\fBpwd\fRksh, ksh93, sh -\fBread\fRksh, ksh93, sh -\fB++**readonly\fRksh, ksh93, sh -\fBrehash\fRcsh -\fBrepeat\fRcsh -\fB+*return\fRksh, ksh93, sh -\fBselect\fRksh, ksh93 -\fB+set\fRcsh, ksh, ksh93, sh -\fBsetenv\fRcsh -\fBshift\fRcsh, ksh, ksh93, sh -\fBsleep\fRksh93 -\fBsource\fRcsh -\fBstop\fRcsh, ksh, ksh93, sh -\fBsuspend\fRcsh, ksh, sh -\fBswitch\fRcsh -\fBtee\fRksh93 -\fBtest\fRksh, ksh93, sh -\fBtime\fRcsh -\fB*times\fRksh, ksh93, sh -\fB*+trap\fRksh, ksh93, sh -\fBtrue\fRksh, ksh93 -\fBtype\fRksh, ksh93, sh -\fB++**typeset\fRksh, ksh93 -\fBulimit\fRksh, ksh93, sh -\fBumask\fRcsh, ksh, ksh93, sh -\fB+unalias\fRcsh, ksh, ksh93 -\fBunhash\fRcsh -\fBuniq\fRksh93 -\fBunlimit\fRcsh -\fB+unset\fRcsh, ksh, ksh93, sh -\fBunsetenv\fRcsh -\fBuntil\fRksh, ksh93, sh -\fB*wait\fRcsh, ksh, ksh93, sh -\fBwhence\fRksh, ksh93 -\fBwhile\fRcsh, ksh, ksh93, sh +\fB++**alias\fR csh, ksh, ksh93 +\fBbg\fR csh, ksh, ksh93, sh +\fB+*break\fR csh, ksh, ksh93, sh +\fBbuiltin\fR ksh93 +\fBcase\fR csh, ksh, ksh93, sh +\fBcat\fR ksh93 +\fBcd\fR csh, ksh, ksh93, sh +\fBchdir\fR csh, sh +\fBchown\fR ksh93 +\fBcommand\fR ksh93 +\fB+*continue\fR csh, ksh, ksh93, sh +\fBdirs\fR csh +\fBdisown\fR ksh93 +\fBecho\fR csh, ksh, ksh93, sh +\fB+*eval\fR csh, ksh, ksh93, sh +\fB+*exec\fR csh, ksh, ksh93, sh +\fB+*exit\fR csh, ksh, ksh93, sh +\fB++**export\fR ksh, ksh93, sh +\fBfalse\fR ksh, ksh93 +\fBfc\fR ksh, ksh93 +\fBfg\fR csh, ksh, ksh93, sh +\fBfor\fR ksh, ksh93, sh +\fBforeach\fR csh +\fBfunction\fR ksh, ksh93 +\fBgetconf\fR ksh93 +\fBgetopts\fR ksh, ksh93, sh +\fBglob\fR csh +\fBgoto\fR csh +\fBhash\fR ksh, ksh93, sh +\fBhashstat\fR csh +\fBhead\fR ksh93 +\fBhist\fR ksh93 +\fBhistory\fR csh +\fBif\fR csh, ksh, ksh93, sh +\fBjobs\fR csh, ksh, ksh93, sh +\fBkill\fR csh, ksh, ksh93, sh +\fBlet\fR ksh, ksh93, +\fBlimit\fR csh +\fBlogin\fR csh, ksh, ksh93, sh +\fBlogout\fR csh +\fBmkdir\fR ksh93 +\fBnice\fR csh +\fB+*newgrp\fR ksh, ksh93, sh +\fBnohup\fR csh +\fBnotify\fR csh +\fBonintr\fR csh +\fBpopd\fR csh +\fBprint\fR ksh, ksh93 +\fBprintf\fR ksh93 +\fBpushd\fR csh +\fBpwd\fR ksh, ksh93, sh +\fBread\fR ksh, ksh93, sh +\fB++**readonly\fR ksh, ksh93, sh +\fBrehash\fR csh +\fBrepeat\fR csh +\fB+*return\fR ksh, ksh93, sh +\fBselect\fR ksh, ksh93 +\fB+set\fR csh, ksh, ksh93, sh +\fBsetenv\fR csh +\fBshift\fR csh, ksh, ksh93, sh +\fBsleep\fR ksh93 +\fBsource\fR csh +\fBstop\fR csh, ksh, ksh93, sh +\fBsuspend\fR csh, ksh, sh +\fBswitch\fR csh +\fBtee\fR ksh93 +\fBtest\fR ksh, ksh93, sh +\fBtime\fR csh +\fB*times\fR ksh, ksh93, sh +\fB*+trap\fR ksh, ksh93, sh +\fBtrue\fR ksh, ksh93 +\fBtype\fR ksh, ksh93, sh +\fB++**typeset\fR ksh, ksh93 +\fBulimit\fR ksh, ksh93, sh +\fBumask\fR csh, ksh, ksh93, sh +\fB+unalias\fR csh, ksh, ksh93 +\fBunhash\fR csh +\fBuniq\fR ksh93 +\fBunlimit\fR csh +\fB+unset\fR csh, ksh, ksh93, sh +\fBunsetenv\fR csh +\fBuntil\fR ksh, ksh93, sh +\fB*wait\fR csh, ksh, ksh93, sh +\fBwhence\fR ksh, ksh93 +\fBwhile\fR csh, ksh, ksh93, sh .TE .SS "Bourne Shell, sh, Special Commands" @@ -137,23 +135,19 @@ is the default output location. When Job Control is enabled, additional In addition to these built-in reserved command words, \fBsh\fR also uses: .sp .ne 2 -.mk .na \fB\fB:\fR\fR .ad .RS 15n -.rt No effect; the command does nothing. A zero exit code is returned. .RE .sp .ne 2 -.mk .na \fB\fB\&.\fR\fIfilename\fR\fR .ad .RS 15n -.rt Read and execute commands from \fIfilename\fR and return. The search path specified by \fBPATH\fR is used to find the directory containing \fIfilename\fR. @@ -167,12 +161,10 @@ as any component of a pipeline except the last, it is executed in a subshell. In addition to these built-in reserved command words, \fBcsh\fR also uses: .sp .ne 2 -.mk .na \fB\fB:\fR\fR .ad .RS 5n -.rt Null command. This command is interpreted, but performs no action. .RE @@ -215,23 +207,19 @@ splitting and file name generation are not performed. In addition to these built-in reserved command words, \fBksh\fR also uses: .sp .ne 2 -.mk .na \fB* \fB:\fR [ \fIarg\fR .\|.\|. ]\fR .ad .RS 29n -.rt The command only expands parameters. .RE .sp .ne 2 -.mk .na \fB* \fB\&.\fR\fIfile\fR [ \fIarg\fR .\|.\|. ]\fR .ad .RS 29n -.rt Read the complete \fIfile\fR then execute the commands. The commands are executed in the current shell environment. The search path specified by \fBPATH\fR is used to find the directory containing \fIfile\fR. If any @@ -291,23 +279,19 @@ field splitting and file name generation are not performed. In addition to these built-in reserved command words, \fBksh93\fR also uses: .sp .ne 2 -.mk .na \fB\fB:\fR [ \fIarg\fR .\|.\|. ]\fR .ad .RS 27n -.rt The command only expands parameters. .RE .sp .ne 2 -.mk .na \fB\fB\&.\fR\fIname\fR [ \fIarg\fR .\|.\|. ]\fR .ad .RS 27n -.rt If \fIname\fR is a function defined with the function \fIname\fR reserved word syntax, the function is executed in the current environment (as if it had been defined with the \fBname()\fR syntax.) Otherwise if \fIname\fR refers to a diff --git a/usr/src/man/man1/shift.1 b/usr/src/man/man1/shift.1 index ac0b4d5e68..21406a4f33 100644 --- a/usr/src/man/man1/shift.1 +++ b/usr/src/man/man1/shift.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 shift 1 "20 Nov 2007" "SunOS 5.11" "User Commands" +.TH SHIFT 1 "Nov 20, 2007" .SH NAME shift \- shell built-in function to traverse either a shell's argument list or a list of field-separated words @@ -98,23 +98,19 @@ number of positional parameters or a negative number of places. The following exit values are returned by \fBshift\fR in \fBksh93\fR: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. The positional parameters were successfully shifted. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE diff --git a/usr/src/man/man1/size.1 b/usr/src/man/man1/size.1 index 7b4f59fc51..ce414e402d 100644 --- a/usr/src/man/man1/size.1 +++ b/usr/src/man/man1/size.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 size 1 "24 Aug 2009" "SunOS 5.11" "User Commands" +.TH SIZE 1 "Aug 24, 2009" .SH NAME size \- print section sizes in bytes of object files .SH SYNOPSIS @@ -48,12 +48,10 @@ prints an error message and stops processing the file. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 6n -.rt Prints out the size of each allocatable section, the name of the section, and the total of the section sizes. If there is no section data, \fBsize\fR prints out an error message and stops processing the file. @@ -61,12 +59,10 @@ out an error message and stops processing the file. .sp .ne 2 -.mk .na \fB\fB-F\fR\fR .ad .RS 6n -.rt Prints out the size of each loadable segment, the permission flags of the segment, then the total of the loadable segment sizes. If there is no segment data, \fBsize\fR prints an error message and stops processing the file. @@ -74,12 +70,10 @@ data, \fBsize\fR prints an error message and stops processing the file. .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 6n -.rt Prints out non-loadable segment or non-allocatable section sizes. If segment data exists, \fBsize\fR prints out the memory size of each loadable segment or file size of each non-loadable segment, the permission flags, and the total @@ -91,35 +85,29 @@ data, \fBsize\fR prints an error message and stops processing. .sp .ne 2 -.mk .na \fB\fB-o\fR\fR .ad .RS 6n -.rt Prints numbers in octal, not decimal. .RE .sp .ne 2 -.mk .na \fB\fB-V\fR\fR .ad .RS 6n -.rt Prints the version information for the \fBsize\fR command on the standard error output. .RE .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad .RS 6n -.rt Prints numbers in hexadecimal, not decimal. .RE @@ -133,7 +121,7 @@ The examples below are typical \fBsize\fR output. .in +2 .nf example% \fBsize \fIfilename\fR\fR -2724 + 88 + 0 = 2812 +2724 + 88 + 0 = 2812 .fi .in -2 .sp @@ -144,7 +132,7 @@ example% \fBsize \fIfilename\fR\fR .in +2 .nf example% \fBsize -f \fIfilename\fR\fR -26(.text) + 5(.init) + 5(.fini) = 36 +26(.text) + 5(.init) + 5(.fini) = 36 .fi .in -2 .sp diff --git a/usr/src/man/man1/sleep.1 b/usr/src/man/man1/sleep.1 index 3bb026d033..d5209a89e1 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 "20 Nov 2007" "SunOS 5.11" "User Commands" +.TH SLEEP 1 "Nov 20, 2007" .SH NAME sleep \- suspend execution for an interval .SH SYNOPSIS @@ -42,12 +42,10 @@ The following operands are supported for \fB/usr/bin/sleep\fR and \fBksh93\fR's \fBsleep\fR built-in command: .sp .ne 2 -.mk .na \fB\fIseconds\fR\fR .ad .RS 11n -.rt 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". @@ -59,12 +57,10 @@ required by C99/XPG6, including constants such as "Inf" or "infinite". The following operands are supported: .sp .ne 2 -.mk .na \fB\fItime\fR\fR .ad .RS 8n -.rt Specify \fItime\fR in seconds as a floating point number. The actual granularity depends on the underlying system, normally around 1 millisecond. .RE @@ -149,24 +145,20 @@ that affect the execution of \fBsleep\fR: \fBLANG\fR, \fBLC_ALL\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt The execution was successfully suspended for at least \fItime\fR seconds, or a \fBSIGALRM\fR signal was received (see NOTES). .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error has occurred. .RE @@ -179,15 +171,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .SS "ksh93" @@ -195,13 +186,12 @@ StandardSee \fBstandards\fR(5). .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityUncommitted +Interface Stability Uncommitted .TE .SH SEE ALSO diff --git a/usr/src/man/man1/smbutil.1 b/usr/src/man/man1/smbutil.1 index c6c08792c9..ad3cc6d8e4 100644 --- a/usr/src/man/man1/smbutil.1 +++ b/usr/src/man/man1/smbutil.1 @@ -1,12 +1,12 @@ '\" te -.\" Copyright (c) 2009, Sun Microsystems, Inc. All Right Reserved. -.\" Portions Copyright 1994-2008 The FreeBSD Project. All rights reserved. +.\" Copyright (c) 2009, Sun Microsystems, Inc. All Right Reserved. +.\" Portions Copyright 1994-2008 The FreeBSD Project. All rights reserved. .\" Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following .\" disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. THIS SOFTWARE IS PROVIDED BY THE FREEBSD PROJECT ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FREEBSD PROJECT OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT .\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -.TH smbutil 1 "24 Jun 2009" "SunOS 5.11" "User Commands" +.TH SMBUTIL 1 "Jun 24, 2009" .SH NAME smbutil \- Solaris CIFS client utility .SH SYNOPSIS @@ -76,7 +76,6 @@ commands. The \fBsmbutil\fR command supports the following subcommands: .sp .ne 2 -.mk .na \fB\fBcrypt\fR\fR .ad @@ -97,7 +96,6 @@ file (\fB400\fR or \fB600\fR), or the passwords are ignored. .sp .ne 2 -.mk .na \fB\fBlogin [-c] [ [[\fIdomain\fR/]\fIuser\fR] | [\fIuser\fR[@\fIdomain\fR] ]\fR\fR @@ -121,7 +119,6 @@ configured for "workgroup mode." .sp .ne 2 -.mk .na \fB\fBlogout [ [[\fIdomain\fR/]\fIuser\fR] | [\fIuser\fR[@\fIdomain\fR] ]\fR\fR .ad @@ -139,7 +136,6 @@ place of the domain name. .sp .ne 2 -.mk .na \fB\fBlogout -a\fR\fR .ad @@ -151,7 +147,6 @@ running the command. .sp .ne 2 -.mk .na \fB\fBlogoutall\fR\fR .ad @@ -165,7 +160,6 @@ This command must be run as superuser. .sp .ne 2 -.mk .na \fB\fBlookup \fIname\fR\fR\fR .ad @@ -178,7 +172,6 @@ This subcommand is only supported if an NBNS/WINS name server is available. .sp .ne 2 -.mk .na \fB\fBstatus \fIserver\fR\fR\fR .ad @@ -190,7 +183,6 @@ Resolves the specified server to the NetBIOS domain and system name. .sp .ne 2 -.mk .na \fB\fBview [-A | -U \fIuser\fR] //[\fIdomain\fR;][\fIuser\fR[:\fIpassword\fR]@]\fIserver\fR\fR\fR @@ -215,34 +207,28 @@ shell. For instance, surround the entire resource name with single quotes: The following global options are supported: .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad .RS 13n -.rt Produces debugging output. .RE .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 13n -.rt Produces verbose output. .RE .sp .ne 2 -.mk .na \fB\fB-?\fR\fR .ad .RS 13n -.rt Prints a short help message. .RE @@ -424,7 +410,6 @@ Server: EXAMPLE .SH FILES .sp .ne 2 -.mk .na \fB\fB$HOME/.nsmbrc\fR\fR .ad @@ -442,13 +427,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilitySee below. +Interface Stability See below. .TE .sp diff --git a/usr/src/man/man1/soelim.1 b/usr/src/man/man1/soelim.1 index 2c17d9f257..9183a0f526 100644 --- a/usr/src/man/man1/soelim.1 +++ b/usr/src/man/man1/soelim.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 soelim 1 "14 Sep 1992" "SunOS 5.11" "User Commands" +.TH SOELIM 1 "Sep 14, 1992" .SH NAME soelim \- resolve and eliminate .so requests from nroff or troff input .SH SYNOPSIS diff --git a/usr/src/man/man1/sort.1 b/usr/src/man/man1/sort.1 index 31a46ef55c..e270b4efdc 100644 --- a/usr/src/man/man1/sort.1 +++ b/usr/src/man/man1/sort.1 @@ -2,28 +2,28 @@ .\" Copyright 1989 AT&T .\" Copyright (c) 2001, Sun Microsystems, Inc. All Rights Reserved .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 sort 1 "19 Nov 2001" "SunOS 5.11" "User Commands" +.TH SORT 1 "Nov 19, 2001" .SH NAME sort \- sort, merge, or sequence check text files .SH SYNOPSIS .LP .nf -\fB/usr/bin/sort\fR [\fB-bcdfimMnru\fR] [\fB-k\fR \fIkeydef\fR] [\fB-o\fR \fIoutput\fR] - [\fB-S\fR \fIkmem\fR] [\fB-t\fR \fIchar\fR] [\fB-T\fR \fIdirectory\fR] [\fB-y\fR [\fIkmem\fR]] +\fB/usr/bin/sort\fR [\fB-bcdfimMnru\fR] [\fB-k\fR \fIkeydef\fR] [\fB-o\fR \fIoutput\fR] + [\fB-S\fR \fIkmem\fR] [\fB-t\fR \fIchar\fR] [\fB-T\fR \fIdirectory\fR] [\fB-y\fR [\fIkmem\fR]] [\fB-z\fR \fIrecsz\fR] [+\fIpos1\fR [-\fIpos2\fR]] [\fIfile\fR]... .fi .LP .nf -\fB/usr/xpg4/bin/sort\fR [\fB-bcdfimMnru\fR] [\fB-k\fR \fIkeydef\fR] [\fB-o\fR \fIoutput\fR] - [\fB-S\fR \fIkmem\fR] [\fB-t\fR \fIchar\fR] [\fB-T\fR \fIdirectory\fR] [\fB-y\fR [\fIkmem\fR]] +\fB/usr/xpg4/bin/sort\fR [\fB-bcdfimMnru\fR] [\fB-k\fR \fIkeydef\fR] [\fB-o\fR \fIoutput\fR] + [\fB-S\fR \fIkmem\fR] [\fB-t\fR \fIchar\fR] [\fB-T\fR \fIdirectory\fR] [\fB-y\fR [\fIkmem\fR]] [\fB-z\fR \fIrecsz\fR] [+\fIpos1\fR [-\fIpos2\fR]] [\fIfile\fR]... .fi @@ -44,12 +44,10 @@ The following options alter the default behavior: .SS "/usr/bin/sort" .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad .RS 6n -.rt Checks that the single input file is ordered as specified by the arguments and the collating sequence of the current locale. The exit code is set and no output is produced unless the file is out of sort. @@ -58,47 +56,39 @@ output is produced unless the file is out of sort. .SS "/usr/xpg4/bin/sort" .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad .RS 16n -.rt Same as \fB/usr/bin/sort\fR except no output is produced under any circumstances. .RE .sp .ne 2 -.mk .na \fB\fB-m\fR\fR .ad .RS 16n -.rt Merges only. The input files are assumed to be already sorted. .RE .sp .ne 2 -.mk .na \fB\fB-o\fR \fIoutput\fR\fR .ad .RS 16n -.rt Specifies the name of an output file to be used instead of the standard output. This file can be the same as one of the input files. .RE .sp .ne 2 -.mk .na \fB\fB-S\fR \fIkmem\fR\fR .ad .RS 16n -.rt Specifies the maximum amount of swap-based memory used for sorting, in kilobytes (the default unit). \fIkmem\fR can also be specified directly as a number of bytes (b), kilobytes (k), megabytes (m), gigabytes (g), or terabytes @@ -107,23 +97,19 @@ number of bytes (b), kilobytes (k), megabytes (m), gigabytes (g), or terabytes .sp .ne 2 -.mk .na \fB\fB-T\fR \fIdirectory\fR\fR .ad .RS 16n -.rt Specifies the \fIdirectory\fR in which to place temporary files. .RE .sp .ne 2 -.mk .na \fB\fB-u\fR\fR .ad .RS 16n -.rt Unique: suppresses all but one in each set of lines having equal keys. If used with the \fB-c\fR option, checks that there are no lines with duplicate keys in addition to checking that the input file is sorted. @@ -131,12 +117,10 @@ addition to checking that the input file is sorted. .sp .ne 2 -.mk .na \fB\fB-y\fR \fIkmem\fR\fR .ad .RS 16n -.rt (obsolete). This option was used to specify the amount of main memory initially used by \fBsort\fR. Its functionality is not appropriate for a virtual memory system; memory usage for \fBsort\fR is now specified using the \fB-S\fR option. @@ -144,12 +128,10 @@ system; memory usage for \fBsort\fR is now specified using the \fB-S\fR option. .sp .ne 2 -.mk .na \fB\fB-z\fR \fIrecsz\fR\fR .ad .RS 16n -.rt (obsolete). This option was used to prevent abnormal termination when lines longer than the system-dependent default buffer size are encountered. Because \fBsort\fR automatically allocates buffers large enough to hold the longest @@ -175,46 +157,38 @@ one or more of these options follows a \fI+pos1\fR option, it affects only the key field specified by that preceding option. .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad .RS 6n -.rt Dictionary order: only letters, digits, and blanks (spaces and tabs) are significant in comparisons. .RE .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 6n -.rt Folds lower-case letters into upper case. .RE .sp .ne 2 -.mk .na \fB\fB-i\fR\fR .ad .RS 6n -.rt Ignores non-printable characters. .RE .sp .ne 2 -.mk .na \fB\fB-M\fR\fR .ad .RS 6n -.rt Compares as months. The first three non-blank characters of the field are folded to upper case and compared. For example, in English the sorting order is \fB"JAN" < "FEB" < .\|.\|. < "DEC"\fR. Invalid fields compare low to @@ -223,12 +197,10 @@ folded to upper case and compared. For example, in English the sorting order is .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 6n -.rt Restricts the sort key to an initial numeric string, consisting of optional blank characters, optional minus sign, and zero or more digits with an optional radix character and thousands separators (as defined in the current locale), @@ -238,12 +210,10 @@ Leading zeros and signs on zeros do not affect ordering. .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 6n -.rt Reverses the sense of comparisons. .RE @@ -253,12 +223,10 @@ Reverses the sense of comparisons. The treatment of field separators can be altered using the following options: .sp .ne 2 -.mk .na \fB\fB-b\fR\fR .ad .RS 11n -.rt Ignores leading blank characters when determining the starting and ending positions of a restricted sort key. If the \fB-b\fR option is specified before the first sort key option, it is applied to all sort key options. Otherwise, @@ -269,12 +237,10 @@ option-argument (see below). .sp .ne 2 -.mk .na \fB\fB-t\fR \fIchar\fR\fR .ad .RS 11n -.rt Use \fIchar\fR as the field separator character. \fIchar\fR is not considered to be part of a field (although it can be included in a sort key). Each occurrence of \fIchar\fR is significant (for example, \fI<char><char>\fR @@ -289,12 +255,10 @@ characters that follows a non-blank character is a field separator. Sort keys can be specified using the options: .sp .ne 2 -.mk .na \fB\fB-k\fR \fIkeydef\fR\fR .ad .RS 19n -.rt The \fIkeydef\fR argument is a restricted sort key field definition. The format of this definition is: .sp @@ -308,7 +272,6 @@ of this definition is: where: .sp .ne 2 -.mk .na \fB\fIfield_start\fR and \fIfield_end\fR\fR .ad @@ -319,7 +282,6 @@ define a key field restricted to a portion of the line. .sp .ne 2 -.mk .na \fB\fItype\fR\fR .ad @@ -397,12 +359,10 @@ applies separately to \fIfirst_character\fR and \fIlast_character\fR.) .sp .ne 2 -.mk .na \fB[\fB+\fR\fIpos1\fR [\fB-\fR\fIpos2\fR]]\fR .ad .RS 19n -.rt (obsolete). Provide functionality equivalent to the \fB-k\fR\fIkeydef\fR option. .sp @@ -439,7 +399,7 @@ is equivalent to: .nf undefined (z==0 & U contains \fIb\fR & \fI-t\fR is present) -k w+1.x+1T,y.0U (z==0 otherwise) --k w+1.x+1T,y+1.zU (z > 0) +-k w+1.x+1T,y+1.zU (z > 0) .fi .in -2 .sp @@ -456,12 +416,10 @@ sort key is specified, a default sort key of the entire line is used. The following operand is supported: .sp .ne 2 -.mk .na \fB\fIfile\fR\fR .ad .RS 8n -.rt A path name of a file to be sorted, merged or checked. If no \fIfile\fR operands are specified, or if a \fIfile\fR operand is \fB\(mi\fR, the standard input is used. @@ -489,7 +447,7 @@ second field as the sort key: .in +2 .nf example% \fBsort -k 2,2 infile\fR -example% \fBsort +1 \(mi2 infile\fR +example% \fBsort +1 \(mi2 infile\fR .fi .in -2 .sp @@ -506,7 +464,7 @@ first character of the second field is the field separator): .sp .in +2 .nf -example% \fBsort -r -o outfile -k 2.2,2.2 infile1 infile2\fR +example% \fBsort -r -o outfile -k 2.2,2.2 infile1 infile2\fR example% \fBsort -r -o outfile +1.1 \(mi1.2 infile1 infile2\fR .fi .in -2 @@ -523,7 +481,7 @@ sort key: .sp .in +2 .nf -example% \fBsort -k 2.2b,2.2b infile1 infile2\fR +example% \fBsort -k 2.2b,2.2b infile1 infile2\fR example% \fBsort +1.1b \(mi1.2b infile1 infile2\fR .fi .in -2 @@ -539,7 +497,7 @@ database) sorted by the numeric user ID (the third colon-separated field): .sp .in +2 .nf -example% \fBsort -t : -k 3,3n /etc/passwd\fR +example% \fBsort -t : -k 3,3n /etc/passwd\fR example% \fBsort -t : +2 \(mi3n /etc/passwd\fR .fi .in -2 @@ -556,8 +514,8 @@ field: .sp .in +2 .nf -example% \fBsort -um -k 3.1,3.0 infile\fR -example% \fBsort -um +2.0 \(mi3.0 infile\fR +example% \fBsort -um -k 3.1,3.0 infile\fR +example% \fBsort -um +2.0 \(mi3.0 infile\fR .fi .in -2 .sp @@ -593,12 +551,10 @@ that affect the execution of \fBsort\fR: \fBLANG\fR, \fBLC_ALL\fR, \fBLC_COLLATE\fR, \fBLC_MESSAGES\fR, and \fBNLSPATH\fR. .sp .ne 2 -.mk .na \fB\fBLC_CTYPE\fR\fR .ad .RS 14n -.rt Determine the locale for the interpretation of sequences of bytes of text data as characters (for example, single- versus multi-byte characters in arguments and input files) and the behavior of character classification for the \fB-b\fR, @@ -607,12 +563,10 @@ and input files) and the behavior of character classification for the \fB-b\fR, .sp .ne 2 -.mk .na \fB\fBLC_NUMERIC\fR\fR .ad .RS 14n -.rt Determine the locale for the definition of the radix character and thousands separator for the \fB-n\fR option. .RE @@ -623,24 +577,20 @@ separator for the \fB-n\fR option. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt All input files were output successfully, or \fB-c\fR was specified and the input file was correctly sorted. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 6n -.rt Under the \fB-c\fR option, the file was not ordered as specified, or if the \fB-c\fR and \fB-u\fR options were both specified, two input lines were found with equal keys. @@ -648,24 +598,20 @@ with equal keys. .sp .ne 2 -.mk .na \fB\fB>1\fR\fR .ad .RS 6n -.rt An error occurred. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB/var/tmp/stm???\fR\fR .ad .RS 19n -.rt Temporary files .RE @@ -678,13 +624,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled .TE .SS "/usr/xpg4/bin/sort" @@ -692,15 +637,14 @@ CSIEnabled .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man1/sortbib.1 b/usr/src/man/man1/sortbib.1 index 3a10751ae2..f6f280fb89 100644 --- a/usr/src/man/man1/sortbib.1 +++ b/usr/src/man/man1/sortbib.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 sortbib 1 "14 Sep 1992" "SunOS 5.11" "User Commands" +.TH SORTBIB 1 "Sep 14, 1992" .SH NAME sortbib \- sort a bibliographic database .SH SYNOPSIS @@ -28,254 +28,208 @@ pipeline to read standard input. The most common key-letters and their meanings are given below. .sp .ne 2 -.mk .na \fB\fB%A\fR\fR .ad .RS 8n -.rt Author's name .RE .sp .ne 2 -.mk .na \fB\fB%B\fR\fR .ad .RS 8n -.rt Book containing article referenced .RE .sp .ne 2 -.mk .na \fB\fB%C\fR\fR .ad .RS 8n -.rt City (place of publication) .RE .sp .ne 2 -.mk .na \fB\fB%D\fR\fR .ad .RS 8n -.rt Date of publication .RE .sp .ne 2 -.mk .na \fB\fB%E\fR\fR .ad .RS 8n -.rt Editor of book containing article referenced .RE .sp .ne 2 -.mk .na \fB\fB%F\fR\fR .ad .RS 8n -.rt Footnote number or label (supplied by \fBrefer\fR) .RE .sp .ne 2 -.mk .na \fB\fB%G\fR\fR .ad .RS 8n -.rt Government order number .RE .sp .ne 2 -.mk .na \fB\fB%H\fR\fR .ad .RS 8n -.rt Header commentary, printed before reference .RE .sp .ne 2 -.mk .na \fB\fB%I\fR\fR .ad .RS 8n -.rt Issuer (publisher) .RE .sp .ne 2 -.mk .na \fB\fB%J\fR\fR .ad .RS 8n -.rt Journal containing article .RE .sp .ne 2 -.mk .na \fB\fB%K\fR\fR .ad .RS 8n -.rt Keywords to use in locating reference .RE .sp .ne 2 -.mk .na \fB\fB%L\fR\fR .ad .RS 8n -.rt Label field used by \fB-k\fR option of \fBrefer\fR .RE .sp .ne 2 -.mk .na \fB\fB%M\fR\fR .ad .RS 8n -.rt Bell Labs Memorandum (undefined) .RE .sp .ne 2 -.mk .na \fB\fB%N\fR\fR .ad .RS 8n -.rt Number within volume .RE .sp .ne 2 -.mk .na \fB\fB%O\fR\fR .ad .RS 8n -.rt Other commentary, printed at end of reference .RE .sp .ne 2 -.mk .na \fB\fB%P\fR\fR .ad .RS 8n -.rt Page number(s) .RE .sp .ne 2 -.mk .na \fB\fB%Q\fR\fR .ad .RS 8n -.rt Corporate or Foreign Author (unreversed) .RE .sp .ne 2 -.mk .na \fB\fB%R\fR\fR .ad .RS 8n -.rt Report, paper, or thesis (unpublished) .RE .sp .ne 2 -.mk .na \fB\fB%S\fR\fR .ad .RS 8n -.rt Series title .RE .sp .ne 2 -.mk .na \fB\fB%T\fR\fR .ad .RS 8n -.rt Title of article or book .RE .sp .ne 2 -.mk .na \fB\fB%V\fR\fR .ad .RS 8n -.rt Volume number .RE .sp .ne 2 -.mk .na \fB\fB%X\fR\fR .ad .RS 8n -.rt Abstract \(em used by \fBroffbib\fR, not by \fBrefer\fR .RE .sp .ne 2 -.mk .na \fB\fB%Y,Z\fR\fR .ad .RS 8n -.rt Ignored by \fBrefer\fR .RE @@ -304,12 +258,10 @@ than 4096 characters will be truncated. .SH OPTIONS .sp .ne 2 -.mk .na \fB\fB-s\fR\fIKEYS\fR\fR .ad .RS 10n -.rt Specify new \fIKEYS\fR. For instance, \fB-sATD\fR will sort by author, title, and date, while \fB-sA+D\fR will sort by all authors, and date. Sort keys past the fourth are not meaningful. diff --git a/usr/src/man/man1/sotruss.1 b/usr/src/man/man1/sotruss.1 index a9a5c4b25f..1fb9d8c410 100644 --- a/usr/src/man/man1/sotruss.1 +++ b/usr/src/man/man1/sotruss.1 @@ -3,13 +3,13 @@ .\" 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 sotruss 1 "12 May 1997" "SunOS 5.11" "User Commands" +.TH SOTRUSS 1 "May 12, 1997" .SH NAME sotruss \- trace shared library procedure calls .SH SYNOPSIS .LP .nf -\fB/usr/bin/sotruss\fR [\fB-f\fR] [\fB-F\fR \fIbindfromlist\fR] [\fB-T\fR \fIbindtolist\fR] +\fB/usr/bin/sotruss\fR [\fB-f\fR] [\fB-F\fR \fIbindfromlist\fR] [\fB-T\fR \fIbindtolist\fR] [\fB-o\fR \fIoutputfile\fR] executable [executable arguments...] .fi @@ -26,12 +26,10 @@ traced. See \fILinker and Libraries Guide\fR .SH OPTIONS .sp .ne 2 -.mk .na \fB\fB-F\fR\fI bindfromlist\fR\fR .ad .RS 19n -.rt A colon-separated list of libraries that are to be traced. Only calls from these libraries will be traced. The default is to trace calls from the main executable only. @@ -39,24 +37,20 @@ executable only. .sp .ne 2 -.mk .na \fB\fB-T\fR\fI bindtolist\fR\fR .ad .RS 19n -.rt A colon-separated list of libraries that are to be traced. Only calls to these libraries will be traced. The default is to trace all calls. .RE .sp .ne 2 -.mk .na \fB\fB-o\fR\fI outputfile\fR\fR .ad .RS 19n -.rt \fBsotruss\fR output will be directed to the \fIoutputfile\fR. If this option is combined with the \fB-f\fR option then the \fIpid\fR of the executing program will be placed at the end of the filename. By default \fBsotruss\fR @@ -65,12 +59,10 @@ output is placed on \fBstderr\fR. .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 19n -.rt Follow all children created by \fBfork()\fR and print \fBtruss\fR output on each child process. This option will also cause a \fIpid\fR to be output on each \fBtruss\fR output line. diff --git a/usr/src/man/man1/spell.1 b/usr/src/man/man1/spell.1 index 6e87a3d54a..5aaf1d5929 100644 --- a/usr/src/man/man1/spell.1 +++ b/usr/src/man/man1/spell.1 @@ -1,13 +1,13 @@ '\" te .\" Copyright 1989 AT&T Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 spell 1 "23 " "SunOS 5.11" "User Commands" +.TH SPELL 1 "Sep 15, 2011" .SH NAME spell, hashmake, spellin, hashcheck \- report spelling errors .SH SYNOPSIS @@ -18,7 +18,7 @@ spell, hashmake, spellin, hashcheck \- report spelling errors .LP .nf -\fB/usr/lib/spell/hashmake\fR +\fB/usr/lib/spell/hashmake\fR .fi .LP @@ -61,36 +61,30 @@ biology, medicine and chemistry is light. Three programs help maintain and check the hash lists used by \fBspell\fR: .sp .ne 2 -.mk .na \fB\fBhashmake\fR\fR .ad .RS 13n -.rt Reads a list of words from the standard input and writes the corresponding nine-digit hash code on the standard output. .RE .sp .ne 2 -.mk .na \fB\fBspellin\fR\fR .ad .RS 13n -.rt Reads \fIn\fR hash codes from the standard input and writes a compressed spelling list on the standard output. .RE .sp .ne 2 -.mk .na \fB\fBhashcheck\fR\fR .ad .RS 13n -.rt Reads a compressed \fIspelling_list\fR and recreates the nine-digit hash codes for all the words in it. It writes these codes on the standard output. .RE @@ -101,12 +95,10 @@ for all the words in it. It writes these codes on the standard output. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-b\fR\fR .ad .RS 15n -.rt Check British spelling. Besides preferring \fBcentre\fR, \fBcolour\fR, \fBprogramme\fR, \fBspeciality\fR, \fBtravelled\fR, and so forth, this option insists upon \fI\(miise\fR in words like \fBstandardise\fR. @@ -114,58 +106,48 @@ insists upon \fI\(miise\fR in words like \fBstandardise\fR. .sp .ne 2 -.mk .na \fB\fB-i\fR\fR .ad .RS 15n -.rt Cause \fBderoff\fR(1) to ignore \fB\&.so\fR and \fB\&.nx\fR commands. If \fBderoff\fR(1) is not present on the system, then this option is ignored. .RE .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 15n -.rt Follow the chains of \fIall\fR included files. .RE .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 15n -.rt Print all words not literally in the spelling list, as well as plausible derivations from the words in the spelling list. .RE .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad .RS 15n -.rt Print every plausible stem, one per line, with \fB=\fR preceding each word. .RE .sp .ne 2 -.mk .na \fB\fB+\fR\fIlocal_file\fR\fR .ad .RS 15n -.rt Specify a set of words that are correct spellings (in addition to \fBspell\fR's own spelling list) for each job. \fIlocal_file\fR is the name of a user-provided file that contains a sorted list of words, one per line. Words @@ -180,12 +162,10 @@ ordering is not followed, some entries in \fIlocal_file\fR might be ignored. The following operands are supported: .sp .ne 2 -.mk .na \fB\fBfile\fR\fR .ad .RS 8n -.rt A path name of a text file to check for spelling errors. If no files are named, words are collected from the standard input. .RE @@ -202,30 +182,25 @@ and \fBNLSPATH\fR. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fBD_SPELL=/usr/lib/spell/hlist[ab]\fR\fR .ad @@ -236,7 +211,6 @@ hashed spelling lists, American & British .sp .ne 2 -.mk .na \fB\fBS_SPELL=/usr/lib/spell/hstop\fR\fR .ad @@ -247,7 +221,6 @@ hashed stop list .sp .ne 2 -.mk .na \fB\fBH_SPELL=/var/adm/spellhist\fR\fR .ad @@ -258,7 +231,6 @@ history file .sp .ne 2 -.mk .na \fB\fB/usr/share/lib/dict/words\fR\fR .ad diff --git a/usr/src/man/man1/split.1 b/usr/src/man/man1/split.1 index 790482c571..d85821751e 100644 --- a/usr/src/man/man1/split.1 +++ b/usr/src/man/man1/split.1 @@ -2,20 +2,20 @@ .\" Copyright 1989 AT&T .\" Copyright (c) 1999, Sun Microsystems, Inc. All Rights Reserved .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 split 1 "16 Apr 1999" "SunOS 5.11" "User Commands" +.TH SPLIT 1 "Apr 16, 1999" .SH NAME split \- split a file into pieces .SH SYNOPSIS .LP .nf -\fBsplit\fR [\fB-linecount\fR | \fB-l\fR \fIlinecount\fR] [\fB-a\fR \fIsuffixlength\fR] +\fBsplit\fR [\fB-linecount\fR | \fB-l\fR \fIlinecount\fR] [\fB-a\fR \fIsuffixlength\fR] [\fIfile\fR [\fIname\fR]] .fi @@ -40,7 +40,6 @@ than the maximum filename length allowed by the filesystem. See The following options are supported: .sp .ne 2 -.mk .na \fB\fB\(mi\fR\fIlinecount\fR \fB|\fR \fB-l\fR \fIlinecount\fR\fR .ad @@ -51,7 +50,6 @@ Number of lines in each piece. Defaults to \fB1000\fR lines. .sp .ne 2 -.mk .na \fB\fB-a\fR \fIsuffixlength\fR\fR .ad @@ -67,7 +65,6 @@ will be created. .sp .ne 2 -.mk .na \fB\fB-b\fR \fIn\fR\fR .ad @@ -78,7 +75,6 @@ Splits a file into pieces \fIn\fR bytes in size. .sp .ne 2 -.mk .na \fB\fB-b\fR \fIn\fR\fBk\fR\fR .ad @@ -89,7 +85,6 @@ Splits a file into pieces \fIn\fR\fB*1024\fR bytes in size. .sp .ne 2 -.mk .na \fB\fB-b\fR \fIn\fR\fBm\fR\fR .ad @@ -104,24 +99,20 @@ Splits a file into pieces \fIn\fR\fB*1\|048\|576\fR bytes in size. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIfile\fR\fR .ad .RS 8n -.rt The path name of the ordinary file to be split. If no input file is given or \fIfile\fR is \fB\(mi\fR, the standard input will be used. .RE .sp .ne 2 -.mk .na \fB\fIname\fR\fR .ad .RS 8n -.rt The prefix to be used for each of the files resulting from the \fBsplit\fR operation. If no \fIname\fR argument is given, \fBx\fR will be used as the prefix of the output files. The combined length of the basename of \fIprefix\fR @@ -145,23 +136,19 @@ that affect the execution of \fBsplit\fR: \fBLANG\fR, \fBLC_ALL\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -173,17 +160,16 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityCommitted +Interface Stability Committed _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .SH SEE ALSO diff --git a/usr/src/man/man1/srchtxt.1 b/usr/src/man/man1/srchtxt.1 index 77a5b1842b..886d82f681 100644 --- a/usr/src/man/man1/srchtxt.1 +++ b/usr/src/man/man1/srchtxt.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 srchtxt 1 "20 Dec 1996" "SunOS 5.11" "User Commands" +.TH SRCHTXT 1 "Dec 20, 1996" .SH NAME srchtxt \- display contents of, or search for a text string in, message data bases @@ -39,23 +39,19 @@ message sequence numbers. The message sequence numbers are enclosed in angle brackets: \fB<\fR\fImsgfile\fR\fB:\fR\fImsgnum\fR\fB>.\fR .sp .ne 2 -.mk .na \fB\fImsgfile\fR \fR .ad .RS 12n -.rt name of the file where the displayed text occurred .RE .sp .ne 2 -.mk .na \fB\fImsgnum\fR \fR .ad .RS 12n -.rt sequence number in \fImsgfile\fR where the displayed text occurred .RE @@ -65,24 +61,20 @@ This display is in the format used by \fBgettxt\fR(1) and \fBgettxt\fR(3C). .SH OPTIONS .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 14n -.rt Suppress printing of the message sequence numbers of the messages being displayed. .RE .sp .ne 2 -.mk .na \fB\fB-l\fR\fI locale\fR \fR .ad .RS 14n -.rt Access files in the directory \fB/usr/lib/locale/\fIlocale\fR/LC_MESSAGES\fR. If \fB-m\fR \fImsgfile\fR is also supplied, \fIlOCALE\fR is ignored for \fImsgfile\fRs containing a \fB/\fR. @@ -90,12 +82,10 @@ If \fB-m\fR \fImsgfile\fR is also supplied, \fIlOCALE\fR is ignored for .sp .ne 2 -.mk .na \fB\fB-m\fR\fI msgfile\fR\fR .ad .RS 14n -.rt Access files specified by one or more \fImsgfile\fRs. If \fImsgfile\fR contains a \fB/\fR character, then \fImsgfile\fR \fIis\fR interpreted as a pathname; otherwise, it will be assumed to be in the directory determined as described @@ -105,12 +95,10 @@ commas. .sp .ne 2 -.mk .na \fB\fItext\fR \fR .ad .RS 14n -.rt Search for the text string specified by \fItext\fR and display each one that matches. \fItext\fR can take the form of a regular expression; see \fBregexp\fR(5). @@ -218,7 +206,6 @@ variable that affects the execution of \fBsrchtxt\fR. .SH FILES .sp .ne 2 -.mk .na \fB\fB/usr/lib/locale/C/LC_MESSAGES/* \fR\fR .ad @@ -229,7 +216,6 @@ default files created by \fBmkmsgs\fR(1) .sp .ne 2 -.mk .na \fB\fB/usr/lib/locale/locale/LC_MESSAGES/* \fR\fR .ad diff --git a/usr/src/man/man1/ssh-add.1 b/usr/src/man/man1/ssh-add.1 index ff26f6163b..fc7ec94c4a 100644 --- a/usr/src/man/man1/ssh-add.1 +++ b/usr/src/man/man1/ssh-add.1 @@ -2,7 +2,7 @@ .\" To view license terms, attribution, and copyright for OpenSSH, the default path is /var/sadm/pkg/SUNWsshdr/install/copyright. If the Solaris operating environment has been installed anywhere other than the default, modify the given path to access the file at the .\" installed location. .\" Portions Copyright (c) 2009, Sun Microsystems, Inc. All Rights Reserved. -.TH ssh-add 1 "20 May 2009" "SunOS 5.11" "User Commands" +.TH SSH-ADD 1 "May 20, 2009" .SH NAME ssh-add \- add RSA or DSA identities to the authentication agent .SH SYNOPSIS @@ -31,88 +31,73 @@ The authentication agent must be running. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad .RS 11n -.rt Instead of adding the identity, this option \fBremoves\fR the identity from the agent. .RE .sp .ne 2 -.mk .na \fB\fB-D\fR\fR .ad .RS 11n -.rt Deletes all identities from the agent. .RE .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 11n -.rt Lists fingerprints of all identities currently represented by the agent. .RE .sp .ne 2 -.mk .na \fB\fB-L\fR\fR .ad .RS 11n -.rt Lists public key parameters of all identities currently represented by the agent. .RE .sp .ne 2 -.mk .na \fB\fB-t\fR \fIlife\fR\fR .ad .RS 11n -.rt Sets a maximum lifetime when adding identities to an agent. The lifetime can be specified in seconds or in a time format specified in \fBsshd\fR(1M). .RE .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad .RS 11n -.rt Locks the agent with a password. .RE .sp .ne 2 -.mk .na \fB\fB-X\fR\fR .ad .RS 11n -.rt Unlocks the agent. .RE .SH ENVIRONMENT VARIABLES .sp .ne 2 -.mk .na \fB\fBDISPLAY\fR\fR .ad @@ -121,7 +106,6 @@ Unlocks the agent. \fB\fBSSH_ASKPASS\fR\fR .ad .RS 17n -.rt If \fBssh-add\fR needs a passphrase, it reads the passphrase from the current terminal if it was run from a terminal. If \fBssh-add\fR does not have a terminal associated with it but \fBDISPLAY\fR and \fBSSH_ASKPASS\fR are set, it @@ -134,12 +118,10 @@ from a .Xsession or related script. The system is shipped with .sp .ne 2 -.mk .na \fB\fBSSH_AUTH_SOCK\fR\fR .ad .RS 17n -.rt Identifies the path of a unix-domain socket used to communicate with the agent. .RE @@ -149,23 +131,19 @@ Identifies the path of a unix-domain socket used to communicate with the agent. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt An error occurred. .RE @@ -188,80 +166,66 @@ media or locally on the relevant hosts. Recommended names for the \fBDSA\fR and \fBRSA\fR key files: .sp .ne 2 -.mk .na \fB\fB$HOME/.ssh/identity\fR\fR .ad .RS 28n -.rt Contains the \fBRSA\fR authentication identity of the user for protocol version 1. .RE .sp .ne 2 -.mk .na \fB\fB$HOME/.ssh/identity.pub\fR\fR .ad .RS 28n -.rt Contains the public part of the \fBRSA\fR authentication identity of the user for protocol version 1. .RE .sp .ne 2 -.mk .na \fB\fB$HOME/.ssh/id_dsa\fR\fR .ad .RS 28n -.rt Contains the private \fBDSA\fR authentication identity of the user. .RE .sp .ne 2 -.mk .na \fB\fB$HOME/.ssh/id_dsa.pub\fR\fR .ad .RS 28n -.rt Contains the public part of the DSA authentication identity of the user. .RE .sp .ne 2 -.mk .na \fB\fB$HOME/.ssh/id_rsa\fR\fR .ad .RS 28n -.rt Contains the private \fBRSA\fR authentication identity of the user. .RE .sp .ne 2 -.mk .na \fB\fB$HOME/.ssh/id_rsa.pub\fR\fR .ad .RS 28n -.rt Contains the public part of the \fBRSA\fR authentication identity of the user. .RE .sp .ne 2 -.mk .na \fB\fB/usr/lib/ssh/ssh-askpass\fR\fR .ad .RS 28n -.rt Contains the default value for SSH_ASKPASS. .RE @@ -273,13 +237,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed .TE .SH SEE ALSO diff --git a/usr/src/man/man1/ssh-agent.1 b/usr/src/man/man1/ssh-agent.1 index d16953b23e..08efc225d8 100644 --- a/usr/src/man/man1/ssh-agent.1 +++ b/usr/src/man/man1/ssh-agent.1 @@ -2,13 +2,13 @@ .\" To view license terms, attribution, and copyright for OpenSSH, the default path is /var/sadm/pkg/SUNWsshdr/install/copyright. If the Solaris operating environment has been installed anywhere other than the default, modify the given path to access the file at the .\" installed location. .\" Portions Copyright (c) 2009, Sun Microsystems, Inc. All Rights Reserved. -.TH ssh-agent 1 "17 Aug 2009" "SunOS 5.11" "User Commands" +.TH SSH-AGENT 1 "Aug 17, 2009" .SH NAME ssh-agent \- authentication agent .SH SYNOPSIS .LP .nf -\fBssh-agent\fR [\fB-a\fR \fIbind_address\fR] [\fB-c\fR | \fB-s\fR ] [\fB-d\fR] +\fBssh-agent\fR [\fB-a\fR \fIbind_address\fR] [\fB-c\fR | \fB-s\fR ] [\fB-d\fR] [-t \fIlife\fR] [\fIcommand\fR [\fIargs\fR]...] .fi @@ -72,71 +72,59 @@ terminates. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-a\fR \fIbind_address\fR\fR .ad .RS 19n -.rt Binds the agent to the unix-domain socket bind_address. The default is \fB/tmp/ssh-XXXXXXXX/agent.\fIpid\fR\fR. .RE .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad .RS 19n -.rt Generates C-shell commands on stdout. This is the default if \fBSHELL\fR indicates that it is a csh style of shell. .RE .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad .RS 19n -.rt Debug mode. When this option is specified, \fBssh-agent\fR does not fork. .RE .sp .ne 2 -.mk .na \fB\fB-k\fR\fR .ad .RS 19n -.rt Kills the current agent (given by the \fBSSH_AGENT_PID\fR environment variable). .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 19n -.rt Generates Bourne shell commands on stdout. This is the default if \fBSHELL\fR does not indicate that it is a csh style of shell. .RE .sp .ne 2 -.mk .na \fB\fB-t\fR \fIlife\fR\fR .ad .RS 19n -.rt Set a default value for the maximum lifetime (\fIlife\fR) of identities added to the agent. \fIlife\fR can be specified in seconds or in a time format specified in \fBsshd_config\fR(4). \fIlife\fR specified for an identity with @@ -150,30 +138,25 @@ specified in \fBsshd_config\fR(4). \fIlife\fR specified for an identity with The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt An error occurred. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB/tmp/ssh-XXXXXXXX/agent.\fIpid\fR\fR\fR .ad @@ -192,13 +175,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed .TE .SH SEE ALSO diff --git a/usr/src/man/man1/ssh-http-proxy-connect.1 b/usr/src/man/man1/ssh-http-proxy-connect.1 index 962886ed1d..51468d54d3 100644 --- a/usr/src/man/man1/ssh-http-proxy-connect.1 +++ b/usr/src/man/man1/ssh-http-proxy-connect.1 @@ -1,15 +1,15 @@ '\" te -.\" Copyright (c) 2001, Sun Microsystems, Inc. All Rights Reserved +.\" 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 ssh-http-proxy-connect 1 "24 Oct 2001" "SunOS 5.11" "User Commands" +.TH SSH-HTTP-PROXY-CONNECT 1 "Oct 24, 2001" .SH NAME ssh-http-proxy-connect \- Secure Shell proxy for HTTP .SH SYNOPSIS .LP .nf -\fB/usr/lib/ssh/ssh-http-proxy-connect\fR [\fB-h\fR \fIhttp_proxy_host\fR] +\fB/usr/lib/ssh/ssh-http-proxy-connect\fR [\fB-h\fR \fIhttp_proxy_host\fR] [\fB-p\fR \fIhttp_proxy_port\fR] \fIconnect_host\fR \fIconnect_port\fR .fi @@ -24,24 +24,20 @@ connections external to a network are only allowed via a proxy web server. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-h\fR \fIhttp_proxy_host\fR\fR .ad .RS 22n -.rt Specifies the proxy web server through which to connect. Overrides the \fBHTTPPROXY\fR and \fBhttp_proxy\fR environment variables if they are set. .RE .sp .ne 2 -.mk .na \fB\fB-p\fR \fIhttp_proxy_port\fR\fR .ad .RS 22n -.rt Specifies the port on which the proxy web server runs. If not specified, port 80 is assumed. Overrides the \fBHTTPPROXYPORT\fR and \fBhttp_proxy\fR environment variables if they are set. @@ -53,45 +49,37 @@ environment variables if they are set. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIhttp_proxy_host\fR\fR .ad .RS 19n -.rt The host name or IP address (IPv4 or IPv6) of the proxy. .RE .sp .ne 2 -.mk .na \fB\fIhttp_proxy_port\fR\fR .ad .RS 19n -.rt The numeric port number to connect to on \fIhttp_proxy_host\fR. .RE .sp .ne 2 -.mk .na \fB\fIconnect_host\fR\fR .ad .RS 19n -.rt The name of the remote host to which the proxy web server is to connect you. .RE .sp .ne 2 -.mk .na \fB\fIconnect_port\fR\fR .ad .RS 19n -.rt The numeric port number of the proxy web server to connect you to on \fIhttp_proxy_host\fR. .RE @@ -156,36 +144,30 @@ example$ \fBssh -o'ProxyCommand="/usr/lib/ssh/ssh-http-proxy-connect \e .SH ENVIRONMENT VARIABLES .sp .ne 2 -.mk .na \fB\fBHTTPPROXY\fR\fR .ad .RS 17n -.rt Takes the \fIhttp_proxy_host\fR operand to specify the default proxy host. Overrides \fBhttp_proxy\fR if both are set. .RE .sp .ne 2 -.mk .na \fB\fBHTTPPROXYPORT\fR\fR .ad .RS 17n -.rt Takes the \fIhttp_proxy_port\fR operand to specify the default proxy port. Ignored if \fBHTTPPROXY\fR is not set. .RE .sp .ne 2 -.mk .na \fB\fBhttp_proxy\fR\fR .ad .RS 17n -.rt \fBURL\fR format for specifying proxy host and port. .RE @@ -195,23 +177,19 @@ Ignored if \fBHTTPPROXY\fR is not set. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR \fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB1\fR \fR .ad .RS 6n -.rt An error occurred. .RE @@ -223,13 +201,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStable +Interface Stability Stable .TE .SH SEE ALSO diff --git a/usr/src/man/man1/ssh-keygen.1 b/usr/src/man/man1/ssh-keygen.1 index d1a4419538..ef8927f664 100644 --- a/usr/src/man/man1/ssh-keygen.1 +++ b/usr/src/man/man1/ssh-keygen.1 @@ -2,19 +2,19 @@ .\" To view license terms, attribution, and copyright for OpenSSH, the default path is /var/sadm/pkg/SUNWsshdr/install/copyright. If the Solaris operating environment has been installed anywhere other than the default, modify the given path to access the file at the .\" installed location. .\" Portions Copyright (c) 2009, Sun Microsystems, Inc. All Rights Reserved. -.TH ssh-keygen 1 "17 Feb 2009" "SunOS 5.11" "User Commands" +.TH SSH-KEYGEN 1 "Feb 17, 2009" .SH NAME ssh-keygen \- authentication key generation .SH SYNOPSIS .LP .nf -\fBssh-keygen\fR [\fB-q\fR] [\fB-b\fR \fIbits\fR ] \fB-t\fR \fItype\fR [\fB-N\fR \fInew_passphrase\fR] +\fBssh-keygen\fR [\fB-q\fR] [\fB-b\fR \fIbits\fR ] \fB-t\fR \fItype\fR [\fB-N\fR \fInew_passphrase\fR] [\fB-C\fR \fIcomment\fR] [\fB-f\fR \fIoutput_keyfile\fR] .fi .LP .nf -\fBssh-keygen\fR \fB-p\fR [\fB-P\fR \fIold_passphrase\fR] [\fB-N\fR \fInew_passphrase\fR] +\fBssh-keygen\fR \fB-p\fR [\fB-P\fR \fIold_passphrase\fR] [\fB-N\fR \fInew_passphrase\fR] [\fB-f\fR \fIkeyfile\fR] .fi @@ -113,12 +113,10 @@ activate them. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-b\fR \fIbits\fR\fR .ad .RS 21n -.rt Specifies the number of bits in the key to create. The minimum number is 512 bits. Generally, 1024 bits is considered sufficient. Key sizes above that no longer improve security but make things slower. The default is 1024 bits. @@ -126,23 +124,19 @@ longer improve security but make things slower. The default is 1024 bits. .sp .ne 2 -.mk .na \fB\fB-B\fR\fR .ad .RS 21n -.rt Shows the bubblebabble digest of the specified private or public key file. .RE .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad .RS 21n -.rt Requests changing the comment in the private and public key files. The program prompts for the file containing the private keys, for the passphrase if the key has one, and for the new comment. @@ -152,23 +146,19 @@ This option only applies to \fBrsa1\fR (\fBSSHv1\fR) keys. .sp .ne 2 -.mk .na \fB\fB-C\fR \fIcomment\fR\fR .ad .RS 21n -.rt Provides the new comment. .RE .sp .ne 2 -.mk .na \fB\fB-e\fR\fR .ad .RS 21n -.rt This option reads a private or public OpenSSH key file and prints the key in a "SECSH" Public Key File Format to stdout. This option allows exporting keys for use by several other SSH implementations. @@ -176,23 +166,19 @@ use by several other SSH implementations. .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 21n -.rt Specifies the filename of the key file. .RE .sp .ne 2 -.mk .na \fB\fB-F\fR\fR .ad .RS 21n -.rt Search for the specified \fIhostname\fR in a \fBknown_hosts\fR file, listing any occurrences found. This option is useful to find hashed host names or addresses and can also be used in conjunction with the \fB-H\fR option to print @@ -201,12 +187,10 @@ found keys in a hashed format. .sp .ne 2 -.mk .na \fB\fB-H\fR\fR .ad .RS 21n -.rt Hash a \fBknown_hosts\fR file. This replaces all host names and addresses with hashed representations within the specified file. The original content is moved to a file with a \fB\&.old\fR suffix. These hashes may be used normally by @@ -218,12 +202,10 @@ names. .sp .ne 2 -.mk .na \fB\fB-i\fR\fR .ad .RS 21n -.rt This option reads an unencrypted private (or public) key file in SSH2-compatible format and prints an OpenSSH compatible private (or public) key to stdout. \fBssh-keygen\fR also reads the "SECSH" Public Key File Format. This @@ -232,34 +214,28 @@ option allows importing keys from several other SSH implementations. .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 21n -.rt Shows the fingerprint of the specified private or public key file. .RE .sp .ne 2 -.mk .na \fB\fB-N\fR \fInew_passphrase\fR\fR .ad .RS 21n -.rt Provides the new passphrase. .RE .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 21n -.rt Requests changing the passphrase of a private key file instead of creating a new private key. The program prompts for the file containing the private key, for the old passphrase, and prompts twice for the new passphrase. @@ -267,80 +243,66 @@ for the old passphrase, and prompts twice for the new passphrase. .sp .ne 2 -.mk .na \fB\fB-P\fR \fIpassphrase\fR\fR .ad .RS 21n -.rt Provides the (old) passphrase. .RE .sp .ne 2 -.mk .na \fB\fB-q\fR\fR .ad .RS 21n -.rt Silences \fBssh-keygen\fR. .RE .sp .ne 2 -.mk .na \fB\fB-t\fR \fItype\fR\fR .ad .RS 21n -.rt Specifies the algorithm used for the key, where \fItype\fR is one of \fBrsa\fR, \fBdsa\fR, and \fBrsa1\fR. Type \fBrsa1\fR is used only for the SSHv1 protocol. .RE .sp .ne 2 -.mk .na \fB\fB-R\fR \fIhostname\fR\fR .ad .RS 21n -.rt Removes all keys belonging to \fIhostname\fR from a \fBknown_hosts\fR file. This option is useful to delete hashed hosts. See \fB-H\fR. .RE .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad .RS 21n -.rt Obsolete. Replaced by the \fB-e\fR option. .RE .sp .ne 2 -.mk .na \fB\fB-X\fR\fR .ad .RS 21n -.rt Obsolete. Replaced by the \fB-i\fR option. .RE .sp .ne 2 -.mk .na \fB\fB-y\fR\fR .ad .RS 21n -.rt This option reads a private OpenSSH format file and prints an OpenSSH public key to stdout. .RE @@ -351,35 +313,29 @@ key to stdout. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt An error occurred. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB$HOME/.ssh/identity\fR\fR .ad .RS 27n -.rt This file contains the RSA private key for the SSHv1 protocol. This file should not be readable by anyone but the user. It is possible to specify a passphrase when generating the key; that passphrase is used to encrypt the private part of @@ -390,12 +346,10 @@ this file using 3DES. This file is not automatically accessed by .sp .ne 2 -.mk .na \fB\fB$HOME/.ssh/identity.pub\fR\fR .ad .RS 27n -.rt This file contains the RSA public key for the SSHv1 protocol. The contents of this file should be added to \fB$HOME/.ssh/authorized_keys\fR on all machines where you wish to log in using \fBRSA\fR authentication. There is no need to @@ -404,7 +358,6 @@ keep the contents of this file secret. .sp .ne 2 -.mk .na \fB\fB$HOME/.ssh/id_dsa\fR\fR .ad @@ -413,7 +366,6 @@ keep the contents of this file secret. \fB\fB$HOME/.ssh/id_rsa\fR\fR .ad .RS 27n -.rt These files contain, respectively, the DSA or RSA private key for the SSHv2 protocol. These files should not be readable by anyone but the user. It is possible to specify a passphrase when generating the key; that passphrase is @@ -425,7 +377,6 @@ is made. .sp .ne 2 -.mk .na \fB\fB$HOME/.ssh/id_dsa.pub\fR\fR .ad @@ -434,7 +385,6 @@ is made. \fB\fB$HOME/.ssh/id_rsa.pub\fR\fR .ad .RS 27n -.rt These files contain, respectively, the DSA or RSA public key for the SSHv2 protocol. The contents of these files should be added, respectively, to \fB$HOME/.ssh/authorized_keys\fR on all machines where you wish to log in using @@ -450,13 +400,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed .TE .SH SEE ALSO diff --git a/usr/src/man/man1/ssh-keyscan.1 b/usr/src/man/man1/ssh-keyscan.1 index 6cda7c0a7a..0b59558624 100644 --- a/usr/src/man/man1/ssh-keyscan.1 +++ b/usr/src/man/man1/ssh-keyscan.1 @@ -3,13 +3,13 @@ .\" 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 ssh-keyscan 1 "24 Jul 2004" "SunOS 5.11" "User Commands" +.TH SSH-KEYSCAN 1 "Jul 24, 2004" .SH NAME ssh-keyscan \- gather public ssh host keys of a number of hosts .SH SYNOPSIS .LP .nf -\fBssh-keyscan\fR [\fB-v46\fR] [\fB-p\fR \fIport\fR] [\fB-T\fR \fItimeout\fR] [\fB-t\fR \fItype\fR] +\fBssh-keyscan\fR [\fB-v46\fR] [\fB-p\fR \fIport\fR] [\fB-T\fR \fItimeout\fR] [\fB-t\fR \fItype\fR] [\fB-f\fR \fIfile\fR] [\fB-\fR] [\fIhost\fR... | \fIaddrlist\fR \fInamelist\fR] [...] .fi @@ -71,12 +71,10 @@ Output format for \fBrsa\fR and \fBdsa\fR keys, where \fIkeytype\fR is either The following options are supported: .sp .ne 2 -.mk .na \fB\fB-f\fR \fIfilename\fR\fR .ad .RS 28n -.rt Read hosts or addrlist namelist pairs from this file, one per line. If you specity - instead of a filename, \fBssh-keyscan\fR reads hosts or addrlist namelist pairs from the standard input. @@ -84,23 +82,19 @@ namelist pairs from the standard input. .sp .ne 2 -.mk .na \fB\fB-p\fR \fIport\fR\fR .ad .RS 28n -.rt Port to connect to on the remote host. .RE .sp .ne 2 -.mk .na \fB\fB-T\fR \fItimeout\fR\fR .ad .RS 28n -.rt Set the timeout for connection attempts. If \fItimeout\fR seconds have elapsed since a connection was initiated to a host or since the last time anything was read from that host, the connection is closed and the host in question is @@ -109,12 +103,10 @@ considered unavailable. The default is for \fItimeout\fR is 5 seconds. .sp .ne 2 -.mk .na \fB\fB-t\fR \fItype\fR\fR .ad .RS 28n -.rt Specify the type of the key to fetch from the scanned hosts. The possible values for \fItype\fR are \fBrsa1\fR for protocol version 1 and \fBrsa\fR or \fBdsa\fR for protocol version 2. Specify multiple values by separating them @@ -123,34 +115,28 @@ with commas. The default is \fBrsa1\fR. .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 28n -.rt Specify verbose mode. Print debugging messages about progress. .RE .sp .ne 2 -.mk .na \fB\fB-4\fR\fR .ad .RS 28n -.rt Force to use IPv4 addresses only. .RE .sp .ne 2 -.mk .na \fB\fB-6\fR\fR .ad .RS 28n -.rt Forces to use IPv6 addresses only. .RE @@ -197,12 +183,10 @@ $ ssh-keyscan -t rsa,dsa -f ssh_hosts | \e .SH FILES .sp .ne 2 -.mk .na \fB\fB/etc/ssh_known_hosts\fR \fR .ad .RS 25n -.rt .RE @@ -212,24 +196,20 @@ $ ssh-keyscan -t rsa,dsa -f ssh_hosts | \e The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR \fR .ad .RS 6n -.rt No usage errors. \fBssh-keyscan\fR might or might not have succeeded or failed to scan one, more or all of the given hosts. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 6n -.rt Usage error. .RE @@ -241,13 +221,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityEvolving +Interface Stability Evolving .TE .SH SEE ALSO diff --git a/usr/src/man/man1/ssh-socks5-proxy-connect.1 b/usr/src/man/man1/ssh-socks5-proxy-connect.1 index 58dccc3871..c0bcd51d1d 100644 --- a/usr/src/man/man1/ssh-socks5-proxy-connect.1 +++ b/usr/src/man/man1/ssh-socks5-proxy-connect.1 @@ -1,16 +1,16 @@ '\" te -.\" Copyright (c) 2002, Sun Microsystems, Inc. All Rights Reserved +.\" Copyright (c) 2002, 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 ssh-socks5-proxy-connect 1 "30 Oct 2002" "SunOS 5.11" "User Commands" +.TH SSH-SOCKS5-PROXY-CONNECT 1 "Oct 30, 2002" .SH NAME ssh-socks5-proxy-connect \- Secure Shell proxy for SOCKS5 .SH SYNOPSIS .LP .nf -\fB/usr/lib/ssh/ssh-socks5-proxy-connect\fR - [\fB-h\fR \fIsocks5_proxy_host\fR] +\fB/usr/lib/ssh/ssh-socks5-proxy-connect\fR + [\fB-h\fR \fIsocks5_proxy_host\fR] [\fB-p\fR \fIsocks5_proxy_port\fR] \fIconnect_host\fR \fIconnect_port\fR .fi @@ -30,24 +30,20 @@ defined in RFC 1928. Only anonymous connections are possible. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-h\fR \fIsocks5_proxy_host\fR\fR .ad .RS 24n -.rt Specifies the proxy web server through which to connect. Overrides the \fBSOCKS5_SERVER\fR environment variable. .RE .sp .ne 2 -.mk .na \fB\fB-p\fR \fIsocks5_proxy_port\fR\fR .ad .RS 24n -.rt Specifies the port on which the proxy web server runs. If not specified, port 80 is assumed. Overrides the \fBSOCKS5_PORT\fR environment variable. .RE @@ -58,45 +54,37 @@ Specifies the port on which the proxy web server runs. If not specified, port The following operands are supported: .sp .ne 2 -.mk .na \fB\fIsocks5_proxy_host\fR\fR .ad .RS 21n -.rt The host name or IP address (IPv4 or IPv6) of the proxy. .RE .sp .ne 2 -.mk .na \fB\fIsocks5_proxy_port\fR\fR .ad .RS 21n -.rt The numeric port number to connect to on \fIsocks5_proxy_host\fR. .RE .sp .ne 2 -.mk .na \fB\fIconnect_host\fR\fR .ad .RS 21n -.rt The name of the remote host to which the socks gateway is to connect you. .RE .sp .ne 2 -.mk .na \fB\fIconnect_port\fR\fR .ad .RS 21n -.rt The numeric port number of the socks gateway to connect you to on \fIconnect_host\fR. .RE @@ -161,23 +149,19 @@ example$ \fBssh -o'ProxyCommand=/usr/lib/ssh/ssh-socks5-proxy-connect \e .SH ENVIRONMENT VARIABLES .sp .ne 2 -.mk .na \fB\fBSOCKS5_SERVER\fR\fR .ad .RS 17n -.rt Takes \fIsocks5_proxy_host\fR operand to specify the default proxy host. .RE .sp .ne 2 -.mk .na \fB\fBSOCKS5_PORT\fR\fR .ad .RS 17n -.rt Takes \fIsocks5_proxy_port \fR operand to specify the default proxy port. .RE @@ -187,23 +171,19 @@ Takes \fIsocks5_proxy_port \fR operand to specify the default proxy port. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR \fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB1\fR \fR .ad .RS 6n -.rt An error occurred. .RE @@ -215,13 +195,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStable +Interface Stability Stable .TE .SH SEE ALSO diff --git a/usr/src/man/man1/ssh.1 b/usr/src/man/man1/ssh.1 index 1bbf10cf95..281f44fb4a 100644 --- a/usr/src/man/man1/ssh.1 +++ b/usr/src/man/man1/ssh.1 @@ -2,7 +2,7 @@ .\" To view license terms, attribution, and copyright for OpenSSH, the default path is /var/sadm/pkg/SUNWsshdr/install/copyright. If the Solaris operating environment has been installed anywhere other than the default, modify the specified path to access the file at .\" the installed location. .\" Portions Copyright (c) 2009, Sun Microsystems, Inc. All Rights Reserved. -.TH ssh 1 "20 May 2009" "SunOS 5.11" "User Commands" +.TH SSH 1 "May 20, 2009" .SH NAME ssh \- secure shell client (remote login program) .SH SYNOPSIS @@ -13,9 +13,9 @@ ssh \- secure shell client (remote login program) .LP .nf -\fBssh\fR [\fB-afgknqstvxACNTX1246\fR] [\fB-b\fR \fIbind_address\fR] [\fB-m\fR \fImac_spec\fR] - [\fB-c\fR \fIcipher_spec\fR] [\fB-e\fR \fIescape_char\fR] [\fB-i\fR \fIidentity_file\fR] - [\fB-l\fR \fIlogin_name\fR] [\fB-F\fR \fIconfigfile\fR] [\fB-o\fR \fIoption\fR] [\fB-p\fR \fIport\fR] +\fBssh\fR [\fB-afgknqstvxACNTX1246\fR] [\fB-b\fR \fIbind_address\fR] [\fB-m\fR \fImac_spec\fR] + [\fB-c\fR \fIcipher_spec\fR] [\fB-e\fR \fIescape_char\fR] [\fB-i\fR \fIidentity_file\fR] + [\fB-l\fR \fIlogin_name\fR] [\fB-F\fR \fIconfigfile\fR] [\fB-o\fR \fIoption\fR] [\fB-p\fR \fIport\fR] [\fB-L\fR [\fIbind_address\fR\fB:\fR]\fIport\fR\fB:\fR\fIhost\fR\fB:\fR\fIhostport\fR] [\fB-R\fR [\fIbind_address\fR\fB:\fR]\fIport\fR\fB:\fR\fIhost\fR\fB:\fR\fIhostport\fR] [\fB-D\fR [\fIbind_address\fR\fB:\fR]\fIport\fR] \fIhostname\fR | \fIuser\fR\fB@\fR\fIhostname\fR [\fIcommand\fR] @@ -193,92 +193,76 @@ directive or on the command line by the \fB-e\fR option. The supported escapes, assuming the default \fB~\fR, are: .sp .ne 2 -.mk .na \fB\fB~.\fR\fR .ad .RS 7n -.rt Disconnect. .RE .sp .ne 2 -.mk .na \fB\fB~^Z\fR\fR .ad .RS 7n -.rt Background \fBssh\fR. .RE .sp .ne 2 -.mk .na \fB\fB~#\fR\fR .ad .RS 7n -.rt List forwarded connections. .RE .sp .ne 2 -.mk .na \fB\fB~&\fR\fR .ad .RS 7n -.rt Background \fBssh\fR at logout when waiting for forwarded connection / X11 sessions to terminate. .RE .sp .ne 2 -.mk .na \fB\fB~?\fR\fR .ad .RS 7n -.rt Display a list of escape characters. .RE .sp .ne 2 -.mk .na \fB\fB~B\fR\fR .ad .RS 7n -.rt Send a break to the remote system. Only useful for SSH protocol version 2 and if the peer supports it. .RE .sp .ne 2 -.mk .na \fB\fB~C\fR\fR .ad .RS 7n -.rt Open command line. Only useful for adding port forwardings using the \fB-L\fR and \fB-R\fR options). .RE .sp .ne 2 -.mk .na \fB\fB~R\fR\fR .ad .RS 7n -.rt Request rekeying of the connection. Only useful for SSH protocol version 2 and if the peer supports it. .RE @@ -383,7 +367,6 @@ Rekeying can be used to redelegate credentials when \fBGssKeyEx\fR is The following options are supported: .sp .ne 2 -.mk .na \fB\fB-1\fR\fR .ad @@ -394,7 +377,6 @@ Forces \fBssh\fR to try protocol version 1 only. .sp .ne 2 -.mk .na \fB\fB-2\fR\fR .ad @@ -405,7 +387,6 @@ Forces \fBssh\fR to try protocol version 2 only. .sp .ne 2 -.mk .na \fB\fB-4\fR\fR .ad @@ -416,7 +397,6 @@ Forces \fBssh\fR to use IPv4 addresses only. .sp .ne 2 -.mk .na \fB\fB-6\fR\fR .ad @@ -427,7 +407,6 @@ Forces \fBssh\fR to use IPv6 addresses only. .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad @@ -438,7 +417,6 @@ Disables forwarding of the authentication agent connection. .sp .ne 2 -.mk .na \fB\fB-A\fR\fR .ad @@ -457,7 +435,6 @@ identities loaded into the agent. .sp .ne 2 -.mk .na \fB\fB-b\fR \fIbind_address\fR\fR .ad @@ -469,7 +446,6 @@ or aliased addresses. .sp .ne 2 -.mk .na \fB\fB-c\fR \fIcipher_spec\fR\fR .ad @@ -487,7 +463,6 @@ listed in order of preference. See the \fICiphers\fR option in .sp .ne 2 -.mk .na \fB\fB-C\fR\fR .ad @@ -505,7 +480,6 @@ configuration files. See the \fBCompression\fR option in \fBssh_config\fR(4). .sp .ne 2 -.mk .na \fB\fB-D\fR [\fIbind_address\fR\fB:\fR]\fIport\fR\fR .ad @@ -533,7 +507,6 @@ from all interfaces. .sp .ne 2 -.mk .na \fB\fB-e\fR \fIch\fR | ^\fIch\fR | none\fR .ad @@ -549,7 +522,6 @@ disables any escapes and makes the session fully transparent. .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad @@ -564,7 +536,6 @@ way to start X11 programs at a remote site is with something like \fBssh\fR .sp .ne 2 -.mk .na \fB\fB-F\fR \fIconfigfile\fR\fR .ad @@ -578,7 +549,6 @@ file is \fB$HOME/.ssh/config\fR. .sp .ne 2 -.mk .na \fB\fB-g\fR\fR .ad @@ -589,7 +559,6 @@ Allows remote hosts to connect to local forwarded ports. .sp .ne 2 -.mk .na \fB\fB-i\fR \fIidentity_file\fR\fR .ad @@ -605,7 +574,6 @@ multiple identities specified in configuration files). .sp .ne 2 -.mk .na \fB\fB-l\fR \fIlogin_name\fR\fR .ad @@ -617,7 +585,6 @@ specified on a per-host basis in the configuration file. .sp .ne 2 -.mk .na \fB\fB-L\fR [\fIbind_address:\fR]\fIport\fR:\fIhost\fR:\fIhostport\fR\fR .ad @@ -644,7 +611,6 @@ interfaces. .sp .ne 2 -.mk .na \fB\fB-m\fR \fImac_spec\fR\fR .ad @@ -657,7 +623,6 @@ preference. See the MACs keyword for more information. .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad @@ -683,7 +648,6 @@ or passphrase. See also the \fB-f\fR option. .sp .ne 2 -.mk .na \fB\fB-N\fR\fR .ad @@ -695,7 +659,6 @@ ports (protocol version 2 only). .sp .ne 2 -.mk .na \fB\fB-o\fR \fIoption\fR\fR .ad @@ -708,7 +671,6 @@ flag. The option has the same format as a line in the configuration file. .sp .ne 2 -.mk .na \fB\fB-p\fR \fIport\fR\fR .ad @@ -720,7 +682,6 @@ per-host basis in the configuration file. .sp .ne 2 -.mk .na \fB\fB-P\fR\fR .ad @@ -731,7 +692,6 @@ Obsoleted option. SSHv1 connections from privileged ports are not supported. .sp .ne 2 -.mk .na \fB\fB-q\fR\fR .ad @@ -743,7 +703,6 @@ fatal errors are displayed. .sp .ne 2 -.mk .na \fB\fB-R\fR [\fIbind_address\fR:]\fIport\fR:\fIhost\fR:\fIhostport\fR\fR .ad @@ -772,7 +731,6 @@ only succeeds if the server's \fBGatewayPorts\fR option is enabled. See .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad @@ -786,7 +744,6 @@ subsystem is specified as the remote command. .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad @@ -800,7 +757,6 @@ allocation, even if \fBssh\fR has no local \fBtty\fR. .sp .ne 2 -.mk .na \fB\fB-T\fR\fR .ad @@ -811,7 +767,6 @@ Disables pseudo-tty allocation (protocol version 2 only). .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad @@ -824,7 +779,6 @@ problems. Multiple \fB-v\fR options increase the verbosity. Maximum is 3. .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad @@ -835,7 +789,6 @@ Disables X11 forwarding. .sp .ne 2 -.mk .na \fB\fB-X\fR\fR .ad @@ -863,7 +816,6 @@ means that they have full access to the original X11 display. \fBssh\fR normally sets the following environment variables: .sp .ne 2 -.mk .na \fB\fBDISPLAY\fR\fR .ad @@ -874,7 +826,6 @@ The \fBDISPLAY\fR variable must be set for X11 display forwarding to work. .sp .ne 2 -.mk .na \fB\fBSSH_ASKPASS\fR\fR .ad @@ -892,7 +843,6 @@ from \fB/dev/null\fR to make this work. The system is shipped with .sp .ne 2 -.mk .na \fB\fBSSH_AUTH_SOCK\fR\fR .ad @@ -903,7 +853,6 @@ Indicates the path of a unix-domain socket used to communicate with the agent. .sp .ne 2 -.mk .na \fB\fBSSH_LANGS\fR\fR .ad @@ -916,7 +865,6 @@ on the server. .sp .ne 2 -.mk .na \fB\fBLANG\fR, \fBLC_ALL\fR, \fBLC_COLLATE\fR, \fBLC_CTYPE\fR,\fR .ad @@ -946,19 +894,16 @@ connection, including the initial key exchange. .SH FILES .sp .ne 2 -.mk .na \fB\fB$HOME/.ssh/known_hosts\fR\fR .ad .RS 26n -.rt Records host keys for all hosts the user has logged into that are not in \fB/etc/ssh/ssh_known_hosts\fR. See \fBsshd\fR(1M). .RE .sp .ne 2 -.mk .na \fB\fB$HOME/.ssh/identity\fR\fR .ad @@ -971,7 +916,6 @@ Records host keys for all hosts the user has logged into that are not in \fB\fB$HOME/.ssh/id_ssa\fR\fR .ad .RS 26n -.rt Contains the authentication identity of the user. These files are for protocol 1 \fBRSA\fR, protocol 2 \fBDSA\fR, and protocol 2 \fBRSA\fR, respectively. These files contain sensitive data and should be readable by the user but not @@ -983,12 +927,10 @@ this file using \fB3DES\fR. .sp .ne 2 -.mk .na \fB\fB/etc/ssh/sshrc\fR\fR .ad .RS 26n -.rt Commands in this file are executed by \fBssh\fR when the user logs in just before the user's shell or command is started. See \fBsshd\fR(1M) for more information. @@ -996,12 +938,10 @@ information. .sp .ne 2 -.mk .na \fB\fB$HOME/.ssh/rc\fR\fR .ad .RS 26n -.rt Commands in this file are executed by \fBssh\fR when the user logs in just before the user's shell or command is started. See \fBsshd\fR(1M) for more information. @@ -1009,12 +949,10 @@ information. .sp .ne 2 -.mk .na \fB\fB$HOME/.ssh/environment\fR\fR .ad .RS 26n -.rt Contains additional definitions for environment variables. See ENVIRONMENT VARIABLES. .RE @@ -1027,13 +965,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilitySee below. +Interface Stability See below. .TE .sp diff --git a/usr/src/man/man1/strchg.1 b/usr/src/man/man1/strchg.1 index b341222b5a..55b1e3d7f4 100644 --- a/usr/src/man/man1/strchg.1 +++ b/usr/src/man/man1/strchg.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 strchg 1 "24 Mar 2005" "SunOS 5.11" "User Commands" +.TH STRCHG 1 "Mar 24, 2005" .SH NAME strchg, strconf \- change or query stream configuration .SH SYNOPSIS @@ -48,7 +48,6 @@ The following options apply to \fBstrchg\fR and, \fB\fR\fB-h\fR\fB,\fR \fB\fR\fB-f\fR\fB,\fR and \fB-p\fR are mutually exclusive. .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad @@ -60,7 +59,6 @@ requires the \fB-p\fR option. .sp .ne 2 -.mk .na \fB\fB-f\fR\fI filename\fR \fR .ad @@ -76,7 +74,6 @@ necessary modules in order to end up with the desired configuration. .sp .ne 2 -.mk .na \fB\fB-h\fR\fI module1\fR [\|,\|\fImodule2\fR.\|.\|.\|]\fR .ad @@ -90,7 +87,6 @@ etc. .sp .ne 2 -.mk .na \fB\fB-p\fR \fR .ad @@ -102,7 +98,6 @@ alone, \fBstrchg\fR pops the topmost module from the stream. .sp .ne 2 -.mk .na \fB\fB-u\fR\fI module\fR \fR .ad @@ -118,12 +113,10 @@ The following options apply to \fBstrconf\fR and, \fB-m\fR and \fB-t\fR are mutually exclusive. .sp .ne 2 -.mk .na \fB\fB-m\fR\fI module\fR \fR .ad .RS 14n -.rt Determine if the named \fImodule\fR is present on a stream. If it is, \fBstrconf\fR prints the message \fByes\fR and returns zero. If not, \fBstrconf\fR prints the message \fBno\fR and returns a non-zero value. The @@ -132,12 +125,10 @@ Determine if the named \fImodule\fR is present on a stream. If it is, .sp .ne 2 -.mk .na \fB\fB-t\fR\fI module\fR \fR .ad .RS 14n -.rt Print only the topmost module (if one exists). The \fB-t\fR and \fB-m\fR options are mutually exclusive. .RE diff --git a/usr/src/man/man1/strings.1 b/usr/src/man/man1/strings.1 index df5776837a..b4b3043553 100644 --- a/usr/src/man/man1/strings.1 +++ b/usr/src/man/man1/strings.1 @@ -1,19 +1,19 @@ '\" te .\" Copyright 1989 AT&T Copyright (c) 1992, X/Open Company Limited All Rights Reserved Portions Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 strings 1 "13 Apr 2007" "SunOS 5.11" "User Commands" +.TH STRINGS 1 "Apr 13, 2007" .SH NAME strings \- find printable strings in an object or binary file .SH SYNOPSIS .LP .nf -\fBstrings\fR [\fB-a\fR | \fB-\fR] +\fBstrings\fR [\fB-a\fR | \fB-\fR] [\fB-t\fR \fIformat\fR | \fB-o\fR] [\fB-n\fR \fInumber\fR | \fB-number\fR] [\fB-N\fR \fIname\fR] [\fIfile\fR]... .fi @@ -44,35 +44,29 @@ be inspected with the \fB-N\fR option. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-a\fR | \fB\(mi\fR\fR .ad .RS 23n -.rt Look everywhere in the file for strings. .RE .sp .ne 2 -.mk .na \fB\fB-n\fR \fInumber\fR \fB|\fR \fB-\fR\fInumber\fR\fR .ad .RS 23n -.rt Use a \fInumber\fR as the minimum string length rather than the default, which is \fB4\fR. .RE .sp .ne 2 -.mk .na \fB\fB-N\fR \fIname\fR\fR .ad .RS 23n -.rt Look only in ELF section name. See \fBelfdump\fR(1). Multiple \fB-N\fR options can be specified to inspect multiple sections. .sp @@ -82,56 +76,46 @@ ignored . .sp .ne 2 -.mk .na \fB\fB-o\fR\fR .ad .RS 23n -.rt Equivalent to \fB\fR\fB-t\fR \fBd\fR option. .RE .sp .ne 2 -.mk .na \fB\fB-t\fR \fBformat\fR\fR .ad .RS 23n -.rt Write each string preceded by its byte offset from the start of the file. The format is dependent on the single character used as the \fIformat\fR option-argument: .sp .ne 2 -.mk .na \fB\fBd\fR\fR .ad .RS 5n -.rt The offset is written in decimal. .RE .sp .ne 2 -.mk .na \fB\fBo\fR\fR .ad .RS 5n -.rt The offset is written in octal. .RE .sp .ne 2 -.mk .na \fB\fBx\fR\fR .ad .RS 5n -.rt The offset is written in hexadecimal. .RE @@ -143,12 +127,10 @@ The offset is written in hexadecimal. The following operand is supported: .sp .ne 2 -.mk .na \fB\fB\fIfile\fR\fR\fR .ad .RS 8n -.rt A path name of a regular file to be used as input. If no \fIfile\fR operand is specified, the \fBstrings\fR utility reads from the standard input. .RE @@ -165,23 +147,19 @@ that affect the execution of \fBstrings\fR: \fBLANG\fR, \fBLC_ALL\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -193,15 +171,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilitySee below. +Interface Stability See below. .TE .sp diff --git a/usr/src/man/man1/strip.1 b/usr/src/man/man1/strip.1 index 5140c89928..3b0196be60 100644 --- a/usr/src/man/man1/strip.1 +++ b/usr/src/man/man1/strip.1 @@ -2,14 +2,14 @@ .\" Copyright 1989 AT&T .\" Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 strip 1 "5 Oct 2007" "SunOS 5.11" "User Commands" +.TH STRIP 1 "Oct 5, 2007" .SH NAME strip \- strip symbol table, debugging and line number information from an object file @@ -61,35 +61,29 @@ controlled by using any of the following options. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 6n -.rt Strip line number information only.Does not strip the symbol table or debugging information. .RE .sp .ne 2 -.mk .na \fB\fB-V\fR\fR .ad .RS 6n -.rt Prints, on standard error, the version number of \fBstrip\fR. .RE .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad .RS 6n -.rt Does not strip the symbol table. Debugging and line number information might be stripped. .RE @@ -100,12 +94,10 @@ stripped. The following operand is supported: .sp .ne 2 -.mk .na \fB\fIfile\fR\fR .ad .RS 8n -.rt A path name referring to an executable file. .RE @@ -121,35 +113,29 @@ that affect the execution of \fBstrip\fR: \fBLANG\fR, \fBLC_ALL\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB/tmp/strp*\fR\fR .ad .RS 14n -.rt Temporary files .RE @@ -161,13 +147,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man1/stty.1 b/usr/src/man/man1/stty.1 index 6f5da12fe2..e3cb5c7d70 100644 --- a/usr/src/man/man1/stty.1 +++ b/usr/src/man/man1/stty.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 stty 1 "20 May 2009" "SunOS 5.11" "User Commands" +.TH STTY 1 "May 20, 2009" .SH NAME stty \- set the options for a terminal .SH SYNOPSIS @@ -74,23 +74,19 @@ modes options might not be supported by all hardware interfaces. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 6n -.rt Writes to standard output all of the option settings for the terminal. .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. Emits termios-type output if the underlying driver supports it. Otherwise, it emits termio-type output. @@ -103,112 +99,92 @@ The following \fImode\fR operands are supported: .SS "Control Modes" .sp .ne 2 -.mk .na \fB\fBparenb\fR(\fB-parenb\fR)\fR .ad .RS 24n -.rt Enable (disable) parity generation and detection. .RE .sp .ne 2 -.mk .na \fB\fBparext\fR(\fB-parext\fR)\fR .ad .RS 24n -.rt 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 .RS 24n -.rt Select odd (even) parity, or mark (space) parity if \fBparext\fR is enabled. .RE .sp .ne 2 -.mk .na \fB\fBcs5\fR \fBcs6\fR \fBcs7\fR \fBcs8\fR\fR .ad .RS 24n -.rt Select character size (see \fBtermio\fR(7I)). .RE .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 24n -.rt Hang up line immediately. .RE .sp .ne 2 -.mk .na \fB\fBhupcl\fR (\fB-hupcl\fR)\fR .ad .RS 24n -.rt Hang up (do not hang up) connection on last close. .RE .sp .ne 2 -.mk .na \fB\fBhup\fR (\fB-hup\fR)\fR .ad .RS 24n -.rt Same as \fBhupcl\fR(\fB-hupcl\fR). .RE .sp .ne 2 -.mk .na \fB\fBcstopb\fR (\fB-cstopb\fR)\fR .ad .RS 24n -.rt Use two (one) stop bits per character. .RE .sp .ne 2 -.mk .na \fB\fBcread\fR (\fB-cread\fR)\fR .ad .RS 24n -.rt Enable (disable) the receiver. .RE .sp .ne 2 -.mk .na \fB\fBcrtscts\fR (\fB-crtscts\fR)\fR .ad .RS 24n -.rt Enable output hardware flow control. Raise the \fBRTS\fR (Request to Send) modem control line. Suspends output until the CTS (Clear to Send) line is raised. @@ -216,35 +192,29 @@ raised. .sp .ne 2 -.mk .na \fB\fBcrtsxoff\fR (\fB-crtsxoff\fR)\fR .ad .RS 24n -.rt Enable input hardware flow control. Raise the \fBRTS\fR (Request to Send) modem control line to receive data. Suspends input when RTS is low. .RE .sp .ne 2 -.mk .na \fB\fBclocal\fR (\fB-clocal\fR)\fR .ad .RS 24n -.rt Assume a line without (with) modem control. .RE .sp .ne 2 -.mk .na \fB\fBdefeucw\fR\fR .ad .RS 24n -.rt Set the widths of multibyte characters to the values defined in the current locale specified by \fBLC_CTYPE\fR. Internally, width is expressed in terms of bytes per character, and screen or display columns per character. @@ -252,7 +222,6 @@ bytes per character, and screen or display columns per character. .sp .ne 2 -.mk .na \fB110 300 600 1200 1800\fR .ad @@ -276,7 +245,6 @@ supported by all hardware interfaces.) .sp .ne 2 -.mk .na \fBispeed 0 110 300 600 1200\fR .ad @@ -301,7 +269,6 @@ the input baud rate is specified by the value of the output baud rate. .sp .ne 2 -.mk .na \fBospeed 0 110 300 600 1200\fR .ad @@ -327,157 +294,129 @@ the line is hung up immediately. .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 STOP control character and started by sending the START control character. .RE .sp .ne 2 -.mk .na \fB\fBixany\fR (\fB-ixany\fR)\fR .ad .RS 22n -.rt Allow any character (only DC1) to restart output. .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\fBimaxbel\fR (\fB-imaxbel\fR)\fR .ad .RS 22n -.rt Echo (do not echo) \fBBEL\fR when the input line is too long. If \fBimaxbel\fR is set, the \fBASCII BEL\fR character (\fB07 hex\fR) is echoed if the input stream overflows. Further input is not stored, but any input already present @@ -489,168 +428,138 @@ stream overflows. .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 22n -.rt Enable (disable) the checking of characters against the special control characters INTR, QUIT, SWTCH, and SUSP. For information on \fBSWTCH\fR, see \fBNOTES\fR. @@ -658,46 +567,38 @@ characters INTR, QUIT, SWTCH, and SUSP. For information on \fBSWTCH\fR, see .sp .ne 2 -.mk .na \fB\fBicanon\fR (\fB-icanon\fR)\fR .ad .RS 22n -.rt Enable (disable) canonical input (ERASE and KILL processing). Does not set \fBMIN\fR or \fBTIME\fR. .RE .sp .ne 2 -.mk .na \fB\fBxcase\fR (\fB-xcase\fR)\fR .ad .RS 22n -.rt Canonical (unprocessed) upper/lower-case presentation. .RE .sp .ne 2 -.mk .na \fB\fBecho\fR (\fB-echo\fR)\fR .ad .RS 22n -.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 22n -.rt Echo (do not echo) ERASE character as a backspace-space-backspace string. This mode erases the ERASEed character on many CRT terminals; however, it does not keep track of column position and, as a result, it might be confusing for @@ -706,135 +607,111 @@ escaped characters, tabs, and backspaces. .sp .ne 2 -.mk .na \fB\fBechok\fR(\fB-echok\fR)\fR .ad .RS 22n -.rt Echo (do not echo) NL after KILL character. .RE .sp .ne 2 -.mk .na \fB\fBlfkc\fR (\fB-lfkc\fR)\fR .ad .RS 22n -.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 22n -.rt Echo (do not echo) NL. .RE .sp .ne 2 -.mk .na \fB\fBnoflsh\fR (\fB-noflsh\fR)\fR .ad .RS 22n -.rt Disable (enable) flush after INTR, QUIT, or SUSP. .RE .sp .ne 2 -.mk .na \fB\fBstwrap\fR (\fB-stwrap\fR)\fR .ad .RS 22n -.rt Disable (enable) truncation of lines longer than \fB79\fR characters on a synchronous line. .RE .sp .ne 2 -.mk .na \fB\fBtostop\fR (\fB-tostop\fR)\fR .ad .RS 22n -.rt Send (do not send) \fBSIGTTOU\fR when background processes write to the terminal. .RE .sp .ne 2 -.mk .na \fB\fBechoctl\fR \fB(\fR\fB-echoctl\fR\fB)\fR\fR .ad .RS 22n -.rt Echo (do not echo) control characters as \fB^\fR\fIchar,\fR delete as \fB^?\fR. .RE .sp .ne 2 -.mk .na \fB\fBechoprt\fR \fB(\fR\fB-echoprt\fR\fB)\fR\fR .ad .RS 22n -.rt Echo (do not echo) erase character as character is ``erased''. .RE .sp .ne 2 -.mk .na \fB\fBechoke\fR \fB(\fR\fB-echoke\fR\fB)\fR\fR .ad .RS 22n -.rt BS-SP-BS erase (do not BS-SP-BS erase) entire line on line kill. .RE .sp .ne 2 -.mk .na \fB\fBflusho\fR \fB(\fR\fB-flusho\fR\fB)\fR\fR .ad .RS 22n -.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 22n -.rt Retype (do not retype) pending input at next read or input character. .RE .sp .ne 2 -.mk .na \fB\fBiexten\fR \fB(\fR\fB-iexten\fR\fB)\fR\fR .ad .RS 22n -.rt Enable (disable) special control characters not currently controlled by \fBicanon\fR, \fBisig\fR, \fBixon\fR, or \fBixoff\fR: \fBVEOL\fR, \fBVSWTCH\fR, \fBVREPRINT\fR, \fBVDISCARD\fR, \fBVDSUSP\fR, \fBVWERASE\fR, \fBand\fR @@ -843,267 +720,221 @@ Enable (disable) special control characters not currently controlled by .sp .ne 2 -.mk .na \fB\fBstflush\fR \fB(\fR\fB-stflush\fR)\fR .ad .RS 22n -.rt Enable (disable) flush on a synchronous line after every \fBwrite\fR(2). .RE .sp .ne 2 -.mk .na \fB\fBstappl\fR \fB(\fR\fB-stappl\fR)\fR .ad .RS 22n -.rt Use application mode (use line mode) on a synchronous line. .RE .SS "Hardware Flow Control Modes" .sp .ne 2 -.mk .na \fB\fBrtsxoff\fR (\fB-rtsxoff\fR)\fR .ad .RS 22n -.rt Enable (disable) RTS hardware flow control on input. .RE .sp .ne 2 -.mk .na \fB\fBctsxon\fR (\fB-ctsxon\fR)\fR .ad .RS 22n -.rt Enable (disable) CTS hardware flow control on output. .RE .sp .ne 2 -.mk .na \fB\fBdtrxoff\fR (\fB-dtrxoff\fR)\fR .ad .RS 22n -.rt Enable (disable) DTR hardware flow control on input. .RE .sp .ne 2 -.mk .na \fB\fBcdxon\fR (\fB-cdxon\fR)\fR .ad .RS 22n -.rt Enable (disable) CD hardware flow control on output. .RE .sp .ne 2 -.mk .na \fB\fBisxoff\fR (\fB-isxoff\fR)\fR .ad .RS 22n -.rt Enable (disable) isochronous hardware flow control on input. .RE .SS "Clock Modes" .sp .ne 2 -.mk .na \fB\fBxcibrg\fR\fR .ad .RS 13n -.rt Get transmit clock from internal baud rate generator. .RE .sp .ne 2 -.mk .na \fB\fBxctset\fR\fR .ad .RS 13n -.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 13n -.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 13n -.rt Get receive clock from internal baud rate generator. .RE .sp .ne 2 -.mk .na \fB\fBrctset\fR\fR .ad .RS 13n -.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 13n -.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 13n -.rt Transmitter signal element timing clock not provided. .RE .sp .ne 2 -.mk .na \fB\fBtsetcrbrg\fR\fR .ad .RS 13n -.rt Output receive baud rate generator on transmitter signal element timing (DTE source) lead, CCITT V.24 circuit 113, EIA-232-D pin 24. .RE .sp .ne 2 -.mk .na \fB\fBtsetctbrg\fR\fR .ad .RS 13n -.rt Output transmit baud rate generator on transmitter signal element timing (DTE source) lead, CCITT V.24 circuit 113, EIA-232-D pin 24. .RE .sp .ne 2 -.mk .na \fB\fBtsetctset\fR\fR .ad .RS 13n -.rt Output transmitter signal element timing (DCE source) on transmitter signal element timing (DTE source) lead, CCITT V.24 circuit 113, EIA-232-D pin 24. .RE .sp .ne 2 -.mk .na \fB\fBtsetcrset\fR\fR .ad .RS 13n -.rt Output receiver signal element timing (DCE source) on transmitter signal element timing (DTE source) lead, CCITT V.24 circuit 113, EIA-232-D pin 24. .RE .sp .ne 2 -.mk .na \fB\fBrsetcoff\fR\fR .ad .RS 13n -.rt Receiver signal element timing clock not provided. .RE .sp .ne 2 -.mk .na \fB\fBrsetcrbrg\fR\fR .ad .RS 13n -.rt Output receive baud rate generator on receiver signal element timing (DTE source) lead, CCITT V.24 circuit 128, no EIA-232-D pin. .RE .sp .ne 2 -.mk .na \fB\fBrsetctbrg\fR\fR .ad .RS 13n -.rt Output transmit baud rate generator on receiver signal element timing (DTE source) lead, CCITT V.24 circuit 128, no EIA-232-D pin. .RE .sp .ne 2 -.mk .na \fB\fBrsetctset\fR\fR .ad .RS 13n -.rt Output transmitter signal element timing (DCE source) on receiver signal element timing (DTE source) lead, CCITT V.24 circuit 128, no EIA-232-D pin. .RE .sp .ne 2 -.mk .na \fB\fBrsetcrset\fR\fR .ad .RS 13n -.rt Output receiver signal element timing (DCE source) on receiver signal element timing (DTE source) lead, CCITT V.24 circuit 128, no EIA-232-D pin. .RE @@ -1111,7 +942,6 @@ timing (DTE source) lead, CCITT V.24 circuit 128, no EIA-232-D pin. .SS "Control Assignments" .sp .ne 2 -.mk .na \fB\fIcontrol-character\fR \fIc\fR\fR .ad @@ -1120,12 +950,10 @@ timing (DTE source) lead, CCITT V.24 circuit 128, no EIA-232-D pin. Set \fIcontrol-character\fR to \fIc\fR, where: .sp .ne 2 -.mk .na \fB\fIcontrol-character\fR\fR .ad .RS 21n -.rt is \fBctab\fR, \fBdiscard\fR, \fBdsusp\fR, \fBeof\fR, \fBeol\fR, \fBeol2\fR, \fBerase\fR, \fBintr\fR, \fBkill\fR, \fBlnext\fR, \fBquit\fR, \fBreprint\fR, \fBstart\fR, \fBstop\fR, \fBsusp\fR, \fBswtch\fR, or \fBwerase\fR (\fBctab\fR @@ -1135,12 +963,10 @@ is used with \fB-stappl\fR, see \fBtermio\fR(7I)). For information on .sp .ne 2 -.mk .na \fB\fIc\fR\fR .ad .RS 21n -.rt If \fIc\fR is a single character, the control character is set to that character. .sp @@ -1157,27 +983,25 @@ interpreted as DEL and ``\fB^\(mi\fR'' is interpreted as undefined. .sp .TS -tab() box; -cw(.92i) cw(.92i) cw(.92i) cw(.92i) cw(.92i) cw(.92i) -lw(.92i) lw(.92i) lw(.92i) lw(.92i) lw(.92i) lw(.92i) -. -\fB^\fR\fIc\fR\fBValue\fR\fB^\fR\fIc\fR\fBValue\fR\fB^\fR\fIc\fR\fBValue\fR -\fBa\fR, A<SOH>\fBl\fR, L<FF>\fBw\fR, W<ETB> -\fBb\fR, B<STX>\fBm\fR, M<CR>\fBx\fR, X<CAN> -\fBc\fR, C<ETX>\fBn\fR, N<SO>\fBy\fR, Y<EM> -\fBd\fR, D<EOT>\fBo\fR, O<SI>\fBz\fR, Z<SUB> -\fBe\fR, E<ENQ>\fBp\fR, P<DLE>\fB[\fR<ESC> -\fBf\fR, F<ACK>\fBq\fR, Q<DC1>\fB\e\fR<FS> -\fBg\fR, G<BEL>\fBr\fR, R<DC2>\fB]\fR<GS> -\fBh\fR, H<BS>\fBs\fR, S<DC3>\fB^\fR<RS> -\fBi\fR, I<HT>\fBt\fR, T<DC4>\fB_\fR<US> -\fBj\fR, J<LF>\fBu\fR, U<NAK>\fB?\fR<DEL> -\fBk\fR, K<VT>\fBv\fR, V<SYN> +box; +c c c c c c +l l l l l l . +\fB^\fR\fIc\fR \fBValue\fR \fB^\fR\fIc\fR \fBValue\fR \fB^\fR\fIc\fR \fBValue\fR +\fBa\fR, A <SOH> \fBl\fR, L <FF> \fBw\fR, W <ETB> +\fBb\fR, B <STX> \fBm\fR, M <CR> \fBx\fR, X <CAN> +\fBc\fR, C <ETX> \fBn\fR, N <SO> \fBy\fR, Y <EM> +\fBd\fR, D <EOT> \fBo\fR, O <SI> \fBz\fR, Z <SUB> +\fBe\fR, E <ENQ> \fBp\fR, P <DLE> \fB[\fR <ESC> +\fBf\fR, F <ACK> \fBq\fR, Q <DC1> \fB\e\fR <FS> +\fBg\fR, G <BEL> \fBr\fR, R <DC2> \fB]\fR <GS> +\fBh\fR, H <BS> \fBs\fR, S <DC3> \fB^\fR <RS> +\fBi\fR, I <HT> \fBt\fR, T <DC4> \fB_\fR <US> +\fBj\fR, J <LF> \fBu\fR, U <NAK> \fB?\fR <DEL> +\fBk\fR, K <VT> \fBv\fR, V <SYN> .TE .sp .ne 2 -.mk .na \fB\fBmin\fR \fInumber\fR\fR .ad @@ -1186,131 +1010,108 @@ lw(.92i) lw(.92i) lw(.92i) lw(.92i) lw(.92i) lw(.92i) \fB\fBtime\fR \fInumber\fR\fR .ad .RS 15n -.rt Set the value of \fBmin\fR or \fBtime\fR to \fInumber\fR. \fBMIN\fR and \fBTIME\fR are used in Non-Canonical mode input processing (\fB-icanon\fR). .RE .sp .ne 2 -.mk .na \fB\fBline\fR \fIi\fR\fR .ad .RS 15n -.rt Set line discipline to \fIi\fR ( \fB0\fR< \fIi\fR <\fB127\fR). .RE .SS "Combination Modes" .sp .ne 2 -.mk .na \fB\fIsaved\fR \fIsettings\fR\fR .ad .RS 24n -.rt Set the current terminal characteristics to the saved settings produced by the \fB-g\fR option. .RE .sp .ne 2 -.mk .na \fB\fBevenp\fR or \fBparity\fR\fR .ad .RS 24n -.rt Enable \fBparenb\fR and \fBcs7\fR, or disable \fBparodd\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\fBspacep\fR\fR .ad .RS 24n -.rt Enable \fBparenb\fR, \fBcs7\fR, and \fBparext\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-parity\fR, or \fB-evenp\fR\fR .ad .RS 24n -.rt Disable \fBparenb\fR, and set \fBcs8\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\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\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. Raw mode is equivalent to setting: .sp .in +2 @@ -1325,12 +1126,10 @@ stty cs8 -icanon min 1 time 0 -isig -xcase \e .SS "/usr/bin/stty, /usr/xpg6/bin/stty" .sp .ne 2 -.mk .na \fB\fBnl\fR (\fB-nl\fR)\fR .ad .RS 12n -.rt Unset (set) \fBicrnl\fR, \fBonlcr\fR. In addition \fB-nl\fR unsets \fBinlcr\fR, \fBigncr\fR, \fBocrnl\fR, and \fBonlret\fR. .RE @@ -1338,12 +1137,10 @@ Unset (set) \fBicrnl\fR, \fBonlcr\fR. In addition \fB-nl\fR unsets \fBinlcr\fR, .SS "/usr/xpg4/bin/stty" .sp .ne 2 -.mk .na \fB\fBnl\fR (\fB-nl\fR)\fR .ad .RS 24n -.rt Set (unset) \fBicrnl\fR. In addition, \fB-nl\fR unsets \fBinlcr\fR, \fBigncr\fR, \fBocrnl\fR, and \fBonlret\fR; \fB-nl\fR sets \fBonlcr\fR, and \fBnl\fR unsets \fBonlcr\fR. @@ -1351,67 +1148,55 @@ Set (unset) \fBicrnl\fR. In addition, \fB-nl\fR unsets \fBinlcr\fR, .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\fIterm\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. @@ -1419,12 +1204,10 @@ one of \fBtty33\fR, \fBtty37\fR, \fBvt05\fR, \fBtn300\fR, \fBti700\fR, or .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 @@ -1432,57 +1215,47 @@ Set normal asynchronous communications where clock settings are \fBxcibrg\fR, .SS "Window Size" .sp .ne 2 -.mk .na \fB\fBrows\fR \fIn\fR\fR .ad .RS 13n -.rt Set window size to \fIn\fR rows. .RE .sp .ne 2 -.mk .na \fB\fBcolumns\fR \fIn\fR\fR .ad .RS 13n -.rt Set window size to \fIn\fR columns. .RE .sp .ne 2 -.mk .na \fB\fBcols\fR \fIn\fR\fR .ad .RS 13n -.rt Set window size to \fIn\fR columns. \fBcols\fR is a shorthand alias for columns. .RE .sp .ne 2 -.mk .na \fB\fBypixels\fR \fIn\fR\fR .ad .RS 13n -.rt Set vertical window size to \fIn\fR pixels. .RE .sp .ne 2 -.mk .na \fB\fBxpixels\fR \fIn\fR\fR .ad .RS 13n -.rt Set horizontal window size to \fIn\fR pixels. .RE @@ -1518,23 +1291,19 @@ that affect the execution of \fBstty\fR: \fBLANG\fR, \fBLC_ALL\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -1547,15 +1316,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .SS "/usr/xpg6/bin/stty" @@ -1563,15 +1331,14 @@ StandardSee \fBstandards\fR(5). .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .SH SEE ALSO diff --git a/usr/src/man/man1/sum.1 b/usr/src/man/man1/sum.1 index ac143d4e0c..01c8405f94 100644 --- a/usr/src/man/man1/sum.1 +++ b/usr/src/man/man1/sum.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 sum 1 "11 Aug 2009" "SunOS 5.11" "User Commands" +.TH SUM 1 "Aug 11, 2009" .SH NAME sum \- print checksum and block count for a file .SH SYNOPSIS @@ -48,34 +48,28 @@ This can be explicitly overridden by the \fB--logical\fR, \fB--metaphysical\fR, and \fB--physical\fR options below. \fBPATH_RESOLVE\fR can be one of: .sp .ne 2 -.mk .na \fB\fB--logical\fR\fR .ad .RS 18n -.rt Follow all symbolic links. .RE .sp .ne 2 -.mk .na \fB\fB--metaphysical\fR\fR .ad .RS 18n -.rt Follow command argument symbolic links, otherwise do not follow. .RE .sp .ne 2 -.mk .na \fB\fB--physical\fR\fR .ad .RS 18n -.rt Do not follow symbolic links. .RE @@ -85,7 +79,6 @@ Do not follow symbolic links. The following options are supported for \fB/usr/bin/sum\fR: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad @@ -101,7 +94,6 @@ and total checksums and block counts. .sp .ne 2 -.mk .na \fB\fB-b\fR\fR .ad @@ -116,7 +108,6 @@ Read files in binary mode. This is the default. .sp .ne 2 -.mk .na \fB\fB-B\fR\fR .ad @@ -132,7 +123,6 @@ the output. The default is method-specific. .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad @@ -152,7 +142,6 @@ lines, lines starting with #<space>, or the line # are ignored. Lines containing no blanks are interpreted as [no]name[=\fIvalue\fR] options: .sp .ne 2 -.mk .na \fB\fBmethod=name\fR\fR .ad @@ -163,7 +152,6 @@ Checksum method to apply to subsequent lines. .sp .ne 2 -.mk .na \fB\fBpermissions\fR\fR .ad @@ -176,7 +164,6 @@ Subsequent lines were generated with \fB--permissions\fR. .sp .ne 2 -.mk .na \fB\fB-h\fR\fR .ad @@ -192,7 +179,6 @@ Print the checksum method as the first output line. Used with \fB--check\fR and .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad @@ -207,7 +193,6 @@ Each file is interpreted as a list of files, one per line, that is checksummed. .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad @@ -226,7 +211,6 @@ the standard error for each changed file. .sp .ne 2 -.mk .na \fB\fB-R\fR\fR .ad @@ -241,7 +225,6 @@ Recursively checksum the contents of directories. .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad @@ -260,7 +243,6 @@ separately. .sp .ne 2 -.mk .na \fB\fB-T\fR\fR .ad @@ -275,7 +257,6 @@ Read files in text mode (for example, treat \r\n as \n). .sp .ne 2 -.mk .na \fB\fB-w\fR\fR .ad @@ -291,7 +272,6 @@ Warn about invalid \fB--check\fR lines. On by default; \fB-w\fR means .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad @@ -305,7 +285,6 @@ Specifies the checksum method to apply. Parenthesized method options are readonly implementation details. .sp .ne 2 -.mk .na \fB\fBatt\fR|\fBsys5\fR|\fBs5\fR|\fBdefault\fR\fR .ad @@ -318,7 +297,6 @@ methods are order dependent. .sp .ne 2 -.mk .na \fB\fBast4\fR|\fB32x4\fR|\fBtw\fR\fR .ad @@ -330,7 +308,6 @@ The \fBast\fR 128 bit \fBPRNG\fR hash generated by catenating 4 separate 32 bit .sp .ne 2 -.mk .na \fB\fBbsd\fR|\fBucb\fR\fR .ad @@ -341,7 +318,6 @@ The BSD checksum. .sp .ne 2 -.mk .na \fB\fBcrc\fR\fR .ad @@ -350,7 +326,6 @@ The BSD checksum. 32 bit CRC (cyclic redundancy check). .sp .ne 2 -.mk .na \fB\fBpolynomial\fR=\fImask\fR\fR .ad @@ -362,7 +337,6 @@ is 0xedb88320. .sp .ne 2 -.mk .na \fB\fBdone\fR[=\fInumber\fR]\fR .ad @@ -374,7 +348,6 @@ omitted. The option value may be omitted. The default value is 0. .sp .ne 2 -.mk .na \fB\fBinit\fR[=\fInumber\fR]\fR .ad @@ -386,7 +359,6 @@ option value may be omitted. The default value is 0. .sp .ne 2 -.mk .na \fB\fBrotate\fR\fR .ad @@ -398,7 +370,6 @@ order). .sp .ne 2 -.mk .na \fB\fBsize\fR[=\fInumber\fR]\fR .ad @@ -412,7 +383,6 @@ XOR'd into the size. The option value may be omitted. The default value is 0. .sp .ne 2 -.mk .na \fB\fBprng\fR\fR .ad @@ -421,34 +391,28 @@ XOR'd into the size. The option value may be omitted. The default value is 0. 32 bit \fBPRNG\fR (pseudo random number generator) hash. .sp .ne 2 -.mk .na \fB\fBmpy\fR=\fInumber\fR\fR .ad .RS 17n -.rt The 32 bit \fBPRNG\fR multiplier. The default value is 0x01000193. .RE .sp .ne 2 -.mk .na \fB\fBadd\fR=\fInumber\fR\fR .ad .RS 17n -.rt The 32 bit \fBPRNG\fR addend. The default value is 0. .RE .sp .ne 2 -.mk .na \fB\fBinit\fR[=\fInumber\fR]\fR .ad .RS 17n -.rt The \fBPRNG\fR initial value. 0xffffffff is used if number is omitted. The option value may be omitted. The default value is 0x811c9dc5. .RE @@ -457,7 +421,6 @@ option value may be omitted. The default value is 0x811c9dc5. .sp .ne 2 -.mk .na \fB\fBmd4\fR|\fBMD4\fR\fR .ad @@ -469,7 +432,6 @@ is not printed. (version) \fBmd4\fR (\fBsolaris\fR \fB-lmd\fR) 2005-07-26 .sp .ne 2 -.mk .na \fB\fBmd5\fR|\fBMD5\fR\fR .ad @@ -481,7 +443,6 @@ is not printed. (version) \fBmd5\fR (\fBsolaris\fR \fB-lmd\fR) 2005-07-26 .sp .ne 2 -.mk .na \fB\fBsha1\fR|\fBSHA1\fR|\fBsha-1\fR|\fBSHA-1\fR\fR .ad @@ -494,7 +455,6 @@ Cryptographically weak. The block count is not printed. (version) \fBsha1\fR .sp .ne 2 -.mk .na \fB\fBsha256\fR|\fBsha-256\fR|\fBSHA256\fR|\fBSHA-256\fR\fR .ad @@ -506,7 +466,6 @@ printed. (version) \fBsha256\fR (\fBsolaris\fR \fB-lmd\fR) 2005-07-26 .sp .ne 2 -.mk .na \fB\fBsha384\fR|\fBsha-384\fR|\fBSHA384\fR|\fBSHA-384\fR\fR .ad @@ -518,7 +477,6 @@ printed. (version) \fBsha384\fR (\fBsolaris\fR \fB-lmd\fR) 2005-07-26 .sp .ne 2 -.mk .na \fB\fBsha512\fR|\fBsha-512\fR|\fBSHA512\fR|\fBSHA-512\fR\fR .ad @@ -530,7 +488,6 @@ printed. (version) \fBsha512\fR (\fBsolaris\fR \fB-lmd\fR) 2005-07-26 .sp .ne 2 -.mk .na \fB\fBposix\fR|\fBcksum\fR|\fBstd\fR|\fBstandard\fR\fR .ad @@ -542,7 +499,6 @@ The \fBposix 1003.2-1992\fR 32 bit \fBcrc\fR checksum. This is the default .sp .ne 2 -.mk .na \fB\fBzip\fR\fR .ad @@ -553,7 +509,6 @@ The \fBzip\fR(1) \fBcrc\fR. Shorthand for \fBcrc-0xedb88320-init-done\fR. .sp .ne 2 -.mk .na \fB\fBfddi\fR\fR .ad @@ -565,7 +520,6 @@ The \fBFDDI\fR \fBcrc\fR. Shorthand for .sp .ne 2 -.mk .na \fB\fBfnv\fR|\fBfnv1\fR\fR .ad @@ -577,7 +531,6 @@ The \fBFowler-Noll-Vo\fR 32 bit \fBPRNG\fR hash with non-zero initializer .sp .ne 2 -.mk .na \fB\fBast\fR|\fBstrsum\fR\fR .ad @@ -591,7 +544,6 @@ The \fBast\fR \fBstrsum\fR \fBPRNG\fR hash. Shorthand for .sp .ne 2 -.mk .na \fB\fB-L\fR\fR .ad @@ -607,7 +559,6 @@ Follow symbolic links when traversing directories. The default is determined by .sp .ne 2 -.mk .na \fB\fB-H\fR\fR .ad @@ -624,7 +575,6 @@ when traversing directories. The default is determined by \fBgetconf\fR .sp .ne 2 -.mk .na \fB\fB-P\fR\fR .ad @@ -640,7 +590,6 @@ determined by \fBgetconf\fR \fBPATH_RESOLVE\fR. .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad @@ -656,7 +605,6 @@ sum implementations. .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad @@ -672,7 +620,6 @@ implementations. .sp .ne 2 -.mk .na \fB\fB-S\fR\fR .ad @@ -692,12 +639,10 @@ at least one sum failed to match. Ignored for \fB--permissions\fR. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIfile\fR\fR .ad .RS 8n -.rt A path name of a file. If no files are named, the standard input is used. .RE @@ -718,23 +663,19 @@ that affect the execution of \fBsum\fR: \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and The following exit values are returned. .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -746,13 +687,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled .TE .SH SEE ALSO diff --git a/usr/src/man/man1/suspend.1 b/usr/src/man/man1/suspend.1 index 0480218315..8e1944b430 100644 --- a/usr/src/man/man1/suspend.1 +++ b/usr/src/man/man1/suspend.1 @@ -3,26 +3,26 @@ .\" 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 suspend 1 "15 Apr 1994" "SunOS 5.11" "User Commands" +.TH SUSPEND 1 "Apr 15, 1994" .SH NAME suspend \- shell built-in function to halt the current shell .SH SYNOPSIS .SS "sh" .LP .nf -\fBsuspend\fR +\fBsuspend\fR .fi .SS "csh" .LP .nf -\fBsuspend\fR +\fBsuspend\fR .fi .SS "ksh" .LP .nf -\fBsuspend\fR +\fBsuspend\fR .fi .SH DESCRIPTION diff --git a/usr/src/man/man1/svcprop.1 b/usr/src/man/man1/svcprop.1 index 86609956b7..a1be45b9fa 100644 --- a/usr/src/man/man1/svcprop.1 +++ b/usr/src/man/man1/svcprop.1 @@ -3,14 +3,14 @@ .\" 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 svcprop 1 "13 Sep 2007" "SunOS 5.11" "User Commands" +.TH SVCPROP 1 "Sep 13, 2007" .SH NAME svcprop \- retrieve values of service configuration properties .SH SYNOPSIS .LP .nf \fBsvcprop\fR [\fB-fqtv\fR] [\fB-C\fR | \fB-c\fR | \fB-s\fR \fIsnapshot\fR] - [\fB-z\fR \fIzone\fR] [\fB-p\fR [\fIname\fR/]\fIname\fR]... + [\fB-z\fR \fIzone\fR] [\fB-p\fR [\fIname\fR/]\fIname\fR]... {\fIFMRI\fR | \fIpattern\fR}... .fi @@ -69,46 +69,38 @@ Error messages are printed to the standard error stream. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-C\fR\fR .ad .RS 14n -.rt Uses the directly attached properties, without composition. .RE .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad .RS 14n -.rt For service instances, uses the composed view of their directly attached properties. .RE .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 14n -.rt Selects the multi-property output format, with full FMRIs as designators. .RE .sp .ne 2 -.mk .na \fB\fB-p\fR \fIname\fR\fR .ad .RS 14n -.rt For each service or service instance specified by the operands, selects all properties in the \fIname\fR property group. For property groups specified by the operands, selects the \fIname\fR property. @@ -116,69 +108,57 @@ the operands, selects the \fIname\fR property. .sp .ne 2 -.mk .na \fB\fB-p\fR \fIpg\fR/\fIprop\fR\fR .ad .RS 14n -.rt Selects property \fIprop\fR in property group \fIpg\fR for each of the services or service instances specified by the operands. .RE .sp .ne 2 -.mk .na \fB\fB-q\fR\fR .ad .RS 14n -.rt Quiet. Produces no output. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR \fIname\fR\fR .ad .RS 14n -.rt Uses the composed view of the \fIname\fR snapshot for service instances. .RE .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad .RS 14n -.rt Selects the multi-property output format. .RE .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 14n -.rt Verbose. Prints error messages for nonexistent properties, even if option -q is also used. .RE .sp .ne 2 -.mk .na \fB\fB-w\fR\fR .ad .RS 14n -.rt Waits until the specified property group or the property group containing the specified property changes before printing. .sp @@ -189,12 +169,10 @@ message is printed and no action is taken. The -C option is implied. .sp .ne 2 -.mk .na \fB-z\fR \fIzone\fR .ad .RS 14n -.rt Uses properties from the service or instance in the specified \fIzone\fR. This option is only applicable from the global zone, see \fBzones\fR(5). @@ -204,12 +182,10 @@ This option is only applicable from the global zone, see \fBzones\fR(5). The following operands are supported: .sp .ne 2 -.mk .na \fB\fIFMRI\fR\fR .ad .RS 11n -.rt The FMRI of a service, a service instance, a property group, or a property. .sp Instances and services can be abbreviated by specifying the instance name, or @@ -254,12 +230,10 @@ other permanent tools. If an abbreviation matches multiple instances, .sp .ne 2 -.mk .na \fBpattern\fR .ad .RS 11n -.rt A glob pattern which is matched against the FMRIs of services and instances in the repository. See \fBfnmatch\fR(5). If a pattern matches multiple services or instances, \fBsvcprop\fR acts on each service or instance. @@ -362,7 +336,7 @@ The following example retrieves the value of a boolean property in a script: set -- `svcprop -c -t -p general/enabled service` code=$? if [ $code -ne 0 ]; then - echo "svcprop failed with exit code $code" + echo "svcprop failed with exit code $code" return 1 fi if [ $2 != boolean ]; then @@ -402,34 +376,28 @@ svcprop -p $1 $2 | ( The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt An error occurred. .RE .sp .ne 2 -.mk .na \fB\fB2\fR\fR .ad .RS 5n -.rt Invalid command line options were specified. .RE diff --git a/usr/src/man/man1/svcs.1 b/usr/src/man/man1/svcs.1 index 647c198241..807722ef84 100644 --- a/usr/src/man/man1/svcs.1 +++ b/usr/src/man/man1/svcs.1 @@ -3,19 +3,19 @@ .\" 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 svcs 1 "17 Apr 2011" "SunOS 5.11" "User Commands" +.TH SVCS 1 "Apr 17, 2011" .SH NAME svcs \- report service status .SH SYNOPSIS .LP .nf -\fBsvcs\fR [\fB-aHpv?\fR] [\fB-Z\fR | \fB-z\fR \fIzone\fR] [\fB-o\fR \fIcol\fR[,\fIcol\fR]]... [\fB-R\fR \fIFMRI-instance\fR]... +\fBsvcs\fR [\fB-aHpv?\fR] [\fB-Z\fR | \fB-z\fR \fIzone\fR] [\fB-o\fR \fIcol\fR[,\fIcol\fR]]... [\fB-R\fR \fIFMRI-instance\fR]... [\fB-sS\fR \fIcol\fR]... [\fIFMRI\fR | \fIpattern\fR]... .fi .LP .nf -\fBsvcs\fR {\fB-d\fR | \fB-D\fR} [\fB-Hpv?\fR] [\fB-Z\fR | \fB-z\fR \fIzone\fR] [\fB-o\fR \fIcol\fR[,\fIcol\fR]]... [\fB-sS\fR \fIcol\fR]... +\fBsvcs\fR {\fB-d\fR | \fB-D\fR} [\fB-Hpv?\fR] [\fB-Z\fR | \fB-z\fR \fIzone\fR] [\fB-o\fR \fIcol\fR[,\fIcol\fR]]... [\fB-sS\fR \fIcol\fR]... [\fIFMRI\fR | \fIpattern\fR] ... .fi @@ -67,70 +67,58 @@ The output of this command can be used appropriately as input to the The following options are supported: .sp .ne 2 -.mk .na \fB\fB-?\fR\fR .ad .RS 20n -.rt Displays an extended usage message, including column specifiers. .RE .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 20n -.rt Show all services, even disabled ones. This option has no effect if services are selected. .RE .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad .RS 20n -.rt Lists the services or service instances upon which the given service instances depend. .RE .sp .ne 2 -.mk .na \fB\fB-D\fR\fR .ad .RS 20n -.rt Lists the service instances that depend on the given services or service instances. .RE .sp .ne 2 -.mk .na \fB\fB-H\fR\fR .ad .RS 20n -.rt Omits the column headers. .RE .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 20n -.rt (The letter ell.) Displays all available information about the selected services and service instances, with one service attribute displayed for each line. Information for different instances are separated by blank lines. @@ -138,12 +126,10 @@ line. Information for different instances are separated by blank lines. The following specific attributes require further explanation: .sp .ne 2 -.mk .na \fB\fBdependency\fR\fR .ad .RS 14n -.rt Information about a dependency. The grouping and \fBrestart_on\fR properties are displayed first and are separated by a forward slash (\fB/\fR). Next, each entity and its state is listed. See \fBsmf\fR(5) for information about states. @@ -151,57 +137,47 @@ In addition to the standard states, each service dependency can have the following state descriptions: .sp .ne 2 -.mk .na \fB\fBabsent\fR\fR .ad .RS 12n -.rt No such service is defined on the system. .RE .sp .ne 2 -.mk .na \fB\fBinvalid\fR\fR .ad .RS 12n -.rt The fault management resource identifier (FMRI) is invalid (see \fBsmf\fR(5)). .RE .sp .ne 2 -.mk .na \fB\fBmultiple\fR\fR .ad .RS 12n -.rt The entity is a service with multiple instances. .RE File dependencies can only have one of the following state descriptions: .sp .ne 2 -.mk .na \fB\fBabsent\fR\fR .ad .RS 11n -.rt No such file on the system. .RE .sp .ne 2 -.mk .na \fB\fBonline\fR\fR .ad .RS 11n -.rt The file exists. .sp If the file did not exist the last time that \fBsvc.startd\fR evaluated the @@ -211,12 +187,10 @@ service's dependencies, it can consider the dependency to be unsatisfied. .sp .ne 2 -.mk .na \fB\fBunknown\fR\fR .ad .RS 11n -.rt \fBstat\fR(2) failed for a reason other than \fBENOENT\fR. .RE @@ -226,12 +200,10 @@ See \fBsmf\fR(5) for additional details about dependencies, grouping, and .sp .ne 2 -.mk .na \fB\fBenabled\fR\fR .ad .RS 14n -.rt Whether the service is enabled or not, and whether it is enabled or disabled temporarily (until the next system reboot). The former is specified as either \fBtrue\fR or \fBfalse\fR, and the latter is designated by the presence of @@ -246,36 +218,30 @@ specific milestone. See \fBsvcadm\fR(1M) for details. .sp .ne 2 -.mk .na \fB-L\fR .ad .RS 20n -.rt Display the log file of the selected services and service instances, one per-line. -.RE +.RE .sp .ne 2 -.mk .na \fB\fB-o\fR \fIcol\fR[,\fIcol\fR]...\fR .ad .RS 20n -.rt Prints the specified columns. Each \fIcol\fR should be a column name. See \fBCOLUMNS\fR below for available columns. .RE .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 20n -.rt Lists processes associated with each service instance. A service instance can have no associated processes. The process ID, start time, and command name (\fBPID\fR, \fBSTIME\fR, and \fBCMD\fR fields from \fBps\fR(1)) are displayed @@ -284,47 +250,39 @@ for each process. .sp .ne 2 -.mk .na \fB\fB-R\fR \fIFMRI-instance\fR\fR .ad .RS 20n -.rt Selects service instances that have the given service instance as their restarter. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR \fIcol\fR\fR .ad .RS 20n -.rt Sorts output by column. \fIcol\fR should be a column name. See \fBCOLUMNS\fR below for available columns. Multiple \fB-s\fR options behave additively. .RE .sp .ne 2 -.mk .na \fB\fB-S\fR \fIcol\fR\fR .ad .RS 20n -.rt Sorts by \fIcol\fR in the opposite order as option \fB-s\fR. .RE .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 20n -.rt Without \fB-x\fR or \fB-l\fR, displays verbose columns: \fBSTATE\fR, \fBNSTATE\fR, \fBSTIME\fR, \fBCTID\fR, and \fBFMRI\fR. .sp @@ -336,12 +294,10 @@ With \fB-l\fR, displays user-visible properties in property groups of type .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad .RS 20n -.rt Displays explanations for service states. .sp Without arguments, the \fB-x\fR option explains the states of services which: @@ -361,24 +317,20 @@ are preventing another enabled service from running. .sp .ne 2 -.mk .na \fB-z \fIzone\fR .ad .RS 20n -.rt Display only the services in the \fIzone\fR. This option is only applicable in the global zone, see \fBzones\fR(5). .RE .sp .ne 2 -.mk .na \fB-Z\fR .ad .RS 20n -.rt Display services from all zones, with an additional column indicating in which zone the service is running. This option is only applicable in the global zone, see \fBzones\fR(5). @@ -390,12 +342,10 @@ zone, see \fBzones\fR(5). The following operands are supported: .sp .ne 2 -.mk .na \fB\fIFMRI\fR\fR .ad .RS 17n -.rt A fault management resource identifier (FMRI) that specifies one or more instances (see \fBsmf\fR(5)). FMRIs can be abbreviated by specifying the instance name, or the trailing portion of the service name. For example, given @@ -441,12 +391,10 @@ other permanent tools. .sp .ne 2 -.mk .na \fB\fIpattern\fR\fR .ad .RS 17n -.rt A pattern that is matched against the \fIFMRI\fRs of service instances according to the "globbing" rules described by \fBfnmatch\fR(5). If the pattern does not begin with \fBsvc:\fR, then \fBsvc:/\fR is prepended. The following is @@ -465,12 +413,10 @@ disabled Aug_02 svc:/network/rpc/keyserv:default .sp .ne 2 -.mk .na \fB\fIFMRI-instance\fR\fR .ad .RS 17n -.rt An FMRI that specifies an instance. .RE @@ -482,24 +428,20 @@ Column names are case insensitive. The default output format is equivalent to \fBSTIME\fR, \fBFMRI\fR. .sp .ne 2 -.mk .na \fB\fBCTID\fR\fR .ad .RS 10n -.rt The primary contract ID for the service instance. Not all instances have valid primary contract IDs. .RE .sp .ne 2 -.mk .na \fB\fBDESC\fR\fR .ad .RS 10n -.rt A brief description of the service, from its template element. A service might not have a description available, in which case a hyphen (\fB\(hy\fR) is used to denote an empty value. @@ -507,34 +449,28 @@ to denote an empty value. .sp .ne 2 -.mk .na \fB\fBFMRI\fR\fR .ad .RS 10n -.rt The \fIFMRI\fR of the service instance. .RE .sp .ne 2 -.mk .na \fB\fBINST\fR\fR .ad .RS 10n -.rt The instance name of the service instance. .RE .sp .ne 2 -.mk .na \fB\fBNSTA\fR\fR .ad .RS 10n -.rt The abbreviated next state of the service instance, as given in the \fBSTA\fR column description. A hyphen denotes that the instance is not transitioning. Same as \fBSTA\fR otherwise. @@ -542,121 +478,99 @@ Same as \fBSTA\fR otherwise. .sp .ne 2 -.mk .na \fB\fBNSTATE\fR\fR .ad .RS 10n -.rt The next state of the service. A hyphen is used to denote that the instance is not transitioning. Same as \fBSTATE\fR otherwise. .RE .sp .ne 2 -.mk .na \fB\fBSCOPE\fR\fR .ad .RS 10n -.rt The scope name of the service instance. .RE .sp .ne 2 -.mk .na \fB\fBSVC\fR\fR .ad .RS 10n -.rt The service name of the service instance. .RE .sp .ne 2 -.mk .na \fB\fBSTA\fR\fR .ad .RS 10n -.rt The abbreviated state of the service instance (see \fBsmf\fR(5)): .sp .ne 2 -.mk .na \fB\fBDGD\fR\fR .ad .RS 7n -.rt degraded .RE .sp .ne 2 -.mk .na \fB\fBDIS\fR\fR .ad .RS 7n -.rt disabled .RE .sp .ne 2 -.mk .na \fB\fBLRC\fR\fR .ad .RS 7n -.rt legacy \fBrc*.d\fR script-initiated instance .RE .sp .ne 2 -.mk .na \fB\fBMNT\fR\fR .ad .RS 7n -.rt maintenance .RE .sp .ne 2 -.mk .na \fB\fBOFF\fR\fR .ad .RS 7n -.rt offline .RE .sp .ne 2 -.mk .na \fB\fBON\fR\fR .ad .RS 7n -.rt online .RE .sp .ne 2 -.mk .na \fB\fBUN\fR\fR .ad .RS 7n -.rt uninitialized .RE @@ -669,12 +583,10 @@ See \fBsmf\fR(5) for an explanation of service states. .sp .ne 2 -.mk .na \fB\fBSTATE\fR\fR .ad .RS 10n -.rt The state of the service instance. An asterisk is appended for instances in transition, unless the \fBNSTA\fR or \fBNSTATE\fR column is also being displayed. @@ -684,12 +596,10 @@ See \fBsmf\fR(5) for an explanation of service states. .sp .ne 2 -.mk .na \fB\fBSTIME\fR\fR .ad .RS 10n -.rt If the service instance entered the current state within the last 24 hours, this column indicates the time that it did so. Otherwise, this column indicates the date on which it did so, printed with underscores (\fB_\fR) in place of @@ -787,7 +697,7 @@ example% svcs -p sendmail STATE STIME FMRI online 13:25:13 svc:/network/smtp:sendmail 13:25:15 100939 sendmail -13:25:15 100940 sendmail +13:25:15 100940 sendmail .fi .in -2 .sp @@ -862,34 +772,28 @@ Impact: This service is not running. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt Successful command invocation. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt Fatal error. .RE .sp .ne 2 -.mk .na \fB\fB2\fR\fR .ad .RS 5n -.rt Invalid command line options were specified. .RE @@ -901,13 +805,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilitySee below. +Interface Stability See below. .TE .sp diff --git a/usr/src/man/man1/symorder.1 b/usr/src/man/man1/symorder.1 index 88dd6cfe06..03b67bc818 100644 --- a/usr/src/man/man1/symorder.1 +++ b/usr/src/man/man1/symorder.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 symorder 1 "16 Oct 1996" "SunOS 5.11" "User Commands" +.TH SYMORDER 1 "Oct 16, 1996" .SH NAME symorder \- rearrange a list of symbols .SH SYNOPSIS diff --git a/usr/src/man/man1/sys-suspend.1 b/usr/src/man/man1/sys-suspend.1 index f75ddb79bf..763699c036 100644 --- a/usr/src/man/man1/sys-suspend.1 +++ b/usr/src/man/man1/sys-suspend.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 sys-suspend 1 "10 Mar 2009" "SunOS 5.11" "User Commands" +.TH SYS-SUSPEND 1 "Mar 10, 2009" .SH NAME sys-suspend \- suspend or shutdown the system and power off .SH SYNOPSIS @@ -55,57 +55,47 @@ need to include these authorizations or include the Suspend profile. The following operands are supported: .sp .ne 2 -.mk .na \fB\fB-d\fR \fIdisplayname\fR\fR .ad .RS 18n -.rt Connect to the X server specified by \fIdisplayname\fR. .RE .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 6n -.rt Force suspend. Causes a \fBpoweroff\fR(1M) to occur if the suspend fails. System state are not be saved, and a normal boot follows. .RE .sp .ne 2 -.mk .na \fB\fB-h\fR\fR .ad .RS 6n -.rt Change the default from suspend to shutdown. .RE .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 6n -.rt Do not display messages or request user intervention. .RE .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad .RS 6n -.rt Disable \fBlockscreen\fR. This flag disables the execution of \fBlockscreen\fR at resume time. .RE @@ -118,13 +108,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed .TE .SH SEE ALSO diff --git a/usr/src/man/man1/tabs.1 b/usr/src/man/man1/tabs.1 index cf2f1ba446..2154338547 100644 --- a/usr/src/man/man1/tabs.1 +++ b/usr/src/man/man1/tabs.1 @@ -1,13 +1,13 @@ '\" te .\" Copyright 1989 AT&T Copyright (c) 1992, X/Open Company Limited All Rights Reserved Portions Copyright (c) 1995, Sun Microsystems, Inc. All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 tabs 1 "1 Feb 1995" "SunOS 5.11" "User Commands" +.TH TABS 1 "Feb 1, 1995" .SH NAME tabs \- set tabs on a terminal .SH SYNOPSIS @@ -36,12 +36,10 @@ The following options are supported. If a given flag occurs more than once, the last value given takes effect: .sp .ne 2 -.mk .na \fB\fB-T\fR \fItype\fR \fR .ad .RS 12n -.rt \fBtabs\fR needs to know the type of terminal in order to set tabs and margins. \fItype\fR is a name listed in \fBterm\fR(5). If no \fB-T\fR flag is supplied, \fBtabs\fR uses the value of the environment variable \fBTERM\fR. If the value @@ -52,12 +50,10 @@ provide a sequence that will work for many terminals. .sp .ne 2 -.mk .na \fB\fB+m[\fR\fIn\fR\fB]\fR \fR .ad .RS 12n -.rt The margin argument may be used for some terminals. It causes all tabs to be moved over \fIn\fR columns by making column \fIn\fR\fB+1\fR the left margin. If \fB+m\fR is given without a value of \fIn\fR, the value assumed is \fB10\fR. @@ -88,23 +84,19 @@ one code is specified, the last code option will be used. The legal codes and their meanings are as follows: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 7n -.rt \fB1,10,16,36,72\fR Assembler, IBM S/370, first format .RE .sp .ne 2 -.mk .na \fB\fB-a2\fR\fR .ad .RS 7n -.rt \fB1,10,16,40,72\fR .sp Assembler, IBM S/370, second format @@ -112,12 +104,10 @@ Assembler, IBM S/370, second format .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad .RS 7n -.rt \fB1,8,12,16,20,55\fR .sp COBOL, normal format @@ -125,12 +115,10 @@ COBOL, normal format .sp .ne 2 -.mk .na \fB\fB-c2\fR\fR .ad .RS 7n -.rt \fB1,6,10,14,49\fR .sp COBOL compact format (columns 1-6 omitted). Using this code, the first typed @@ -148,12 +136,10 @@ specification as follows (see \fBfspec\fR(4)): .sp .ne 2 -.mk .na \fB\fB-c3\fR\fR .ad .RS 7n -.rt \fB1,6,10,14,18,22,26,30,34,38,42,46,50,54,58,62,67\fR .sp COBOL compact format (columns 1-6 omitted), with more tabs than @@ -170,12 +156,10 @@ appropriate format specification is (see \fBfspec\fR(4)): .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 7n -.rt \fB1,7,11,15,19,23\fR .sp FORTRAN @@ -183,12 +167,10 @@ FORTRAN .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 7n -.rt \fB1,5,9,13,17,21,25,29,33,37,41,45,49,53,57,61\fR .sp PL/I @@ -196,12 +178,10 @@ PL/I .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 7n -.rt \fB1,10,55\fR .sp SNOBOL @@ -209,12 +189,10 @@ SNOBOL .sp .ne 2 -.mk .na \fB\fB-u\fR\fR .ad .RS 7n -.rt \fB1,12,20,44\fR .sp UNIVAC 1100 Assembler @@ -223,12 +201,10 @@ UNIVAC 1100 Assembler .SS "\fIRepetitive\fR" .sp .ne 2 -.mk .na \fB\fB-\fR\fIn\fR \fR .ad .RS 7n -.rt A \fIrepetitive\fR specification requests tabs at columns 1+\fIn\fR, 1+2*\fIn\fR, etc., where \fIn\fR is a single-digit decimal number. Of particular importance is the value \fB8\fR: this represents the UNIX system @@ -244,12 +220,10 @@ See OPERANDS. .SS "\fIFile\fR" .sp .ne 2 -.mk .na \fB\fB-\fR\fIfile\fR\fR .ad .RS 9n -.rt If the name of a \fIfile\fR is given, \fBtabs\fR reads the first line of the file, searching for a format specification (see \fBfspec\fR(4)). If it finds one there, it sets the tab stops according to it, otherwise it sets them as @@ -275,12 +249,10 @@ Tab and margin setting is performed via the standard output. The following operand is supported: .sp .ne 2 -.mk .na \fB\fIn1\fR[,\fIn2\fR,\|.\|.\|.] \fR .ad .RS 22n -.rt The \fIarbitrary\fR format consists of tab-stop values separated by commas or spaces. The tab-stop values must be positive decimal integers in ascending order. Up to 40 numbers are allowed. If any number (except the first one) is @@ -356,12 +328,10 @@ that affect the execution of \fBtabs\fR: \fBLANG\fR, \fBLC_ALL\fR, \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and \fBNLSPATH\fR. .sp .ne 2 -.mk .na \fB\fBTERM\fR \fR .ad .RS 9n -.rt Determine the terminal type. If this variable is unset or null, and if the \fB-T\fR option is not specified, terminal type \fBansi+tabs\fR will be used. .RE @@ -372,23 +342,19 @@ Determine the terminal type. If this variable is unset or null, and if the The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR \fR .ad .RS 7n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR \fR .ad .RS 7n -.rt An error occurred. .RE @@ -400,15 +366,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man1/tail.1 b/usr/src/man/man1/tail.1 index ca8914b122..aca819269e 100644 --- a/usr/src/man/man1/tail.1 +++ b/usr/src/man/man1/tail.1 @@ -1,13 +1,13 @@ '\" te .\" Copyright 1989 AT&T Copyright (c) 1992, X/Open Company Limited All Rights Reserved Portions Copyright (c) 2005, Sun Microsystems, Inc. All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 tail 1 "13 Jul 2005" "SunOS 5.11" "User Commands" +.TH TAIL 1 "Jul 13, 2005" .SH NAME tail \- deliver the last part of a file .SH SYNOPSIS @@ -70,34 +70,28 @@ exclusive. If both are specified on the command line, the \fB-f\fR option is ignored. .sp .ne 2 -.mk .na \fB\fB-b\fR \fR .ad .RS 7n -.rt Units of blocks. .RE .sp .ne 2 -.mk .na \fB\fB-c\fR \fR .ad .RS 7n -.rt Units of bytes. .RE .sp .ne 2 -.mk .na \fB\fB-f\fR \fR .ad .RS 7n -.rt Follow. If the input-file is not a pipe, the program does not terminate after the line of the input-file has been copied, but enters an endless loop, wherein it sleeps for a second and then attempts to read and copy further records from @@ -107,23 +101,19 @@ being written by some other process. .sp .ne 2 -.mk .na \fB\fB-l\fR \fR .ad .RS 7n -.rt Units of lines. .RE .sp .ne 2 -.mk .na \fB\fB-r\fR \fR .ad .RS 7n -.rt Reverse. Copies lines from the specified starting point in the file in reverse order. The default for \fBr\fR is to print the entire file in reverse order. .RE @@ -134,44 +124,36 @@ order. The default for \fBr\fR is to print the entire file in reverse order. The following options are supported for \fB/usr/xpg4/bin/tail\fR only: .sp .ne 2 -.mk .na \fB\fB-c\fR \fInumber\fR \fR .ad .RS 14n -.rt The \fInumber\fR option-argument must be a decimal integer whose sign affects the location in the file, measured in bytes, to begin the copying: .sp .ne 2 -.mk .na \fB\fB+\fR \fR .ad .RS 9n -.rt Copying starts relative to the beginning of the file. .RE .sp .ne 2 -.mk .na \fB\fB\(mi\fR \fR .ad .RS 9n -.rt Copying starts relative to the end of the file. .RE .sp .ne 2 -.mk .na \fBnone\fR .ad .RS 9n -.rt Copying starts relative to the end of the file. .RE @@ -181,12 +163,10 @@ first byte of the file, \fB\fR\fB-c\fR\fB\(mi1\fR the last. .sp .ne 2 -.mk .na \fB\fB-n\fR \fInumber\fR \fR .ad .RS 14n -.rt Equivalent to \fB-c\fR\fInumber,\fR except the starting location in the file is measured in lines instead of bytes. The origin for counting is \fB1\fR. That is, \fB-n\fR\fB+1\fR represents the first line of the file, \fB-n\fR\fB\(mi1\fR @@ -199,12 +179,10 @@ the last. The following operand is supported: .sp .ne 2 -.mk .na \fB\fIfile\fR \fR .ad .RS 9n -.rt A path name of an input file. If no \fIfile\fR operands are specified, the standard input is used. .RE @@ -257,23 +235,19 @@ that affect the execution of \fBtail\fR: \fBLANG\fR, \fBLC_ALL\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR \fR .ad .RS 7n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR \fR .ad .RS 7n -.rt An error occurred. .RE @@ -286,13 +260,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled .TE .SS "/usr/xpg4/bin/tail" @@ -300,15 +273,14 @@ CSIEnabled .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man1/talk.1 b/usr/src/man/man1/talk.1 index 1006de4318..98665b743c 100644 --- a/usr/src/man/man1/talk.1 +++ b/usr/src/man/man1/talk.1 @@ -2,14 +2,14 @@ .\" Copyright 1989 AT&T .\" Copyright (c) 2000, Sun Microsystems, Inc. All Rights Reserved .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 talk 1 "6 Nov 2000" "SunOS 5.11" "User Commands" +.TH TALK 1 "Nov 6, 2000" .SH NAME talk \- talk to another user .SH SYNOPSIS @@ -129,12 +129,10 @@ may report an error describing the terminal-related deficiency. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIaddress\fR\fR .ad .RS 12n -.rt The recipient of the \fBtalk\fR session. One form of \fIaddress\fR is the \fIusername\fR, as returned by the \fBwho\fR(1) utility. If you wish to talk to someone on your own machine, then \fIusername\fR is just the person's login @@ -146,7 +144,7 @@ of the following forms: \fIhost\fR\fB!\fR\fIuser\fR \fIhost\fR\fB\&.\fR\fIuser\fR \fIhost\fR\fB:\fR\fIuser\fR -\fIuser\fR\fB@\fR\fIhost\fR +\fIuser\fR\fB@\fR\fIhost\fR .fi .in -2 .sp @@ -156,12 +154,10 @@ although \fIuser\fR\fB@\fR\fIhost\fR is perhaps preferred. .sp .ne 2 -.mk .na \fB\fIterminal\fR\fR .ad .RS 12n -.rt If the recipient is logged in more than once, \fIterminal\fR can be used to indicate the appropriate terminal name. If \fIterminal\fR is not specified, the \fBtalk\fR message will be displayed on one or more accessible terminals in use @@ -177,12 +173,10 @@ that affect the execution of \fBtalk\fR: \fBLANG\fR, \fBLC_ALL\fR, \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and \fBNLSPATH\fR. .sp .ne 2 -.mk .na \fB\fBTERM\fR\fR .ad .RS 8n -.rt Determine the name of the invoker's terminal type. If this variable is unset or null, an unspecified terminal type will be used. .RE @@ -193,23 +187,19 @@ or null, an unspecified terminal type will be used. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred, or \fBtalk\fR was invoked on a terminal incapable of supporting it. .RE @@ -217,23 +207,19 @@ supporting it. .SH FILES .sp .ne 2 -.mk .na \fB\fB/etc/hosts\fR\fR .ad .RS 18n -.rt host name database .RE .sp .ne 2 -.mk .na \fB\fB/var/adm/utmpx\fR\fR .ad .RS 18n -.rt user and accounting information for \fBtalk\fR .RE @@ -245,13 +231,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man1/tar.1 b/usr/src/man/man1/tar.1 index 3205d961c8..cbf3aebccc 100644 --- a/usr/src/man/man1/tar.1 +++ b/usr/src/man/man1/tar.1 @@ -2,46 +2,46 @@ .\" Copyright 1989 AT&T .\" Copyright (c) 2006, Sun Microsystems, Inc. All Rights Reserved .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 tar 1 "26 Oct 2007" "SunOS 5.11" "User Commands" +.TH TAR 1 "Oct 26, 2007" .SH NAME tar \- create tape archives and add or extract files .SH SYNOPSIS .LP .nf -\fBtar\fR c[BDeEFhilnopPqTvw@/[0-7]][bfk][X...] [\fIblocksize\fR] - [\fItarfile\fR] [\fIsize\fR] [\fIexclude-file\fR]... +\fBtar\fR c[BDeEFhilnopPqTvw@/[0-7]][bfk][X...] [\fIblocksize\fR] + [\fItarfile\fR] [\fIsize\fR] [\fIexclude-file\fR]... {\fIfile\fR | \(miI \fIinclude-file\fR | \(miC \fIdirectory\fR \fIfile\fR}... .fi .LP .nf -\fBtar\fR r[BDeEFhilnqTvw@/[0-7]][bfk] [\fIblocksize\fR] [\fItarfile\fR] - [\fIsize\fR] +\fBtar\fR r[BDeEFhilnqTvw@/[0-7]][bfk] [\fIblocksize\fR] [\fItarfile\fR] + [\fIsize\fR] {\fIfile\fR | \(miI \fIinclude-file\fR | \(miC \fIdirectory\fR \fIfile\fR}... .fi .LP .nf -\fBtar\fR t[BeFhilnqTv[0-7]][fk][X...] [\fItarfile\fR] [\fIsize\fR] +\fBtar\fR t[BeFhilnqTv[0-7]][fk][X...] [\fItarfile\fR] [\fIsize\fR] [\fIexclude-file\fR]... {\fIfile\fR | \(miI \fIinclude-file\fR}... .fi .LP .nf -\fBtar\fR u[BDeEFhilnqTvw@/[0-7]][bfk] [\fIblocksize\fR] [\fItarfile\fR] +\fBtar\fR u[BDeEFhilnqTvw@/[0-7]][bfk] [\fIblocksize\fR] [\fItarfile\fR] [\fIsize\fR] \fIfile\fR... .fi .LP .nf -\fBtar\fR x[BeFhilmnopqTvw@/[0-7]][fk][X...] [\fItarfile\fR] [\fIsize\fR] +\fBtar\fR x[BeFhilmnopqTvw@/[0-7]][fk][X...] [\fItarfile\fR] [\fIsize\fR] [\fIexclude-file\fR]... [\fIfile\fR]... .fi @@ -70,7 +70,6 @@ braces (\fB{ }\fR) indicate that one of the arguments must be specified. The following operands are supported: .sp .ne 2 -.mk .na \fB\fB\(miC\fR \fIdirectory file\fR\fR .ad @@ -85,7 +84,6 @@ multiple directories not related by a close common parent. .sp .ne 2 -.mk .na \fB\fB\(miI\fR \fIinclude-file\fR\fR .ad @@ -104,7 +102,6 @@ excluded. .sp .ne 2 -.mk .na \fB\fIfile\fR\fR .ad @@ -135,7 +132,6 @@ positions 151-156. The function portion of the key is specified by one of the following letters: .sp .ne 2 -.mk .na \fB\fBc\fR\fR .ad @@ -146,7 +142,6 @@ Create. Writing begins at the beginning of the tarfile, instead of at the end. .sp .ne 2 -.mk .na \fB\fBr\fR\fR .ad @@ -160,7 +155,6 @@ headers cannot be modified with extended headers. .sp .ne 2 -.mk .na \fB\fBt\fR\fR .ad @@ -175,7 +169,6 @@ is displayed. .sp .ne 2 -.mk .na \fB\fBu\fR\fR .ad @@ -192,7 +185,6 @@ extended headers. .sp .ne 2 -.mk .na \fB\fBx\fR\fR .ad @@ -248,7 +240,6 @@ The characters below can be used in conjunction with the letter that selects the desired function. .sp .ne 2 -.mk .na \fB\fBb\fR \fIblocksize\fR\fR .ad @@ -271,7 +262,6 @@ nominal blocking factor, a read error results. See Example 5 in EXAMPLES. .sp .ne 2 -.mk .na \fB\fBB\fR\fR .ad @@ -287,7 +277,6 @@ from short reads. .sp .ne 2 -.mk .na \fB\fBD\fR\fR .ad @@ -302,7 +291,6 @@ affected. .sp .ne 2 -.mk .na \fB\fBe\fR\fR .ad @@ -315,7 +303,6 @@ occur. The \fBSYSV3\fR environment variable overrides the default behavior. .sp .ne 2 -.mk .na \fB\fBE\fR\fR .ad @@ -334,7 +321,6 @@ of microseconds is desired. .sp .ne 2 -.mk .na \fB\fBf\fR\fR .ad @@ -374,7 +360,6 @@ example% \fBcd fromdir; tar cf \(mi .| (cd todir; tar xfBp \(mi)\fR .sp .ne 2 -.mk .na \fB\fBF\fR\fR .ad @@ -390,7 +375,6 @@ ENVIRONMENT VARIABLES section below.) .sp .ne 2 -.mk .na \fB\fBh\fR\fR .ad @@ -402,7 +386,6 @@ Follow symbolic links as if they were normal files or directories. Normally, .sp .ne 2 -.mk .na \fB\fBi\fR\fR .ad @@ -413,7 +396,6 @@ Ignore directory checksum errors. .sp .ne 2 -.mk .na \fB\fBk\fR \fIsize\fR\fR .ad @@ -427,7 +409,6 @@ fit in the specified size. .sp .ne 2 -.mk .na \fB\fBl\fR\fR .ad @@ -439,7 +420,6 @@ archived. If \fBl\fR is not specified, no error messages are printed. .sp .ne 2 -.mk .na \fB\fBm\fR\fR .ad @@ -451,7 +431,6 @@ function modifier is valid only with the \fBx\fR function. .sp .ne 2 -.mk .na \fB\fBn\fR\fR .ad @@ -463,7 +442,6 @@ since \fBtar\fR can randomly seek around the archive. .sp .ne 2 -.mk .na \fB\fBo\fR\fR .ad @@ -479,7 +457,6 @@ function modifier is only valid with the \fBx\fR function. .sp .ne 2 -.mk .na \fB\fBp\fR\fR .ad @@ -497,7 +474,6 @@ tarfile with \fBACL\fRs is extracted by previous versions of \fBtar\fR. .sp .ne 2 -.mk .na \fB\fBP\fR\fR .ad @@ -509,7 +485,6 @@ archive. .sp .ne 2 -.mk .na \fB\fBq\fR\fR .ad @@ -521,7 +496,6 @@ normally continues reading the archive after finding an occurrence of a file. .sp .ne 2 -.mk .na \fB\fBT\fR\fR .ad @@ -559,7 +533,6 @@ archived label matches the destination label. .sp .ne 2 -.mk .na \fB\fBv\fR\fR .ad @@ -573,7 +546,6 @@ of the \fBls\fR(1) command. .sp .ne 2 -.mk .na \fB\fBw\fR\fR .ad @@ -587,7 +559,6 @@ with the \fBt\fR function. .sp .ne 2 -.mk .na \fB\fBX\fR\fR .ad @@ -617,7 +588,6 @@ included files. If a file is specified in both the \fIexclude-file\fR and the .sp .ne 2 -.mk .na \fB\fB@\fR\fR .ad @@ -636,7 +606,6 @@ ignored. .sp .ne 2 -.mk .na \fB\fB/\fR\fR .ad @@ -655,7 +624,6 @@ explicitly extract attribute records are ignored. .sp .ne 2 -.mk .na \fB\fB[0-7]\fR\fR .ad @@ -700,7 +668,7 @@ directory on a tape mounted on drive \fB/dev/rmt/0\fR: .nf example% \fBcd\fR example% \fBtar cvf /dev/rmt/0\fR . -\fImessages from\fR tar +\fImessages from\fR tar .fi .in -2 .sp @@ -842,10 +810,10 @@ following: .sp .in +2 .nf -include/ +include/ include/a.out.h \fIand all the other files in\fR \fB/usr/include ...\fR -\&./chown \fIand all the other files in\fR /etc +\&./chown \fIand all the other files in\fR /etc .fi .in -2 .sp @@ -858,7 +826,7 @@ To extract all files in the \fBinclude\fR directory: .in +2 .nf example% \fBtar xv include -x include/, 0 bytes, 0 tape blocks \e +x include/, 0 bytes, 0 tape blocks \e \fIand all files under\fR include ...\fR .fi .in -2 @@ -985,7 +953,6 @@ tar: tape read error .SH ENVIRONMENT VARIABLES .sp .ne 2 -.mk .na \fB\fBSYSV3\fR\fR .ad @@ -997,7 +964,6 @@ and should not be used in new scripts. (It is intended for compatibility purposes only.) When set, the following function modifiers behave differently: .sp .ne 2 -.mk .na \fB\fBF\fR \fIfilename\fR\fR .ad @@ -1009,7 +975,6 @@ which to operate. .sp .ne 2 -.mk .na \fB\fBe\fR\fR .ad @@ -1043,7 +1008,6 @@ expression defined for the \fByesexpr\fR. See \fBlocale\fR(5). The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad @@ -1054,7 +1018,6 @@ Successful completion. .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad @@ -1066,73 +1029,66 @@ An error occurred. .SH FILES .sp .ne 2 -.mk .na \fB\fB/dev/rmt/[0-7][b][n]\fR\fR .ad .sp .6 .RS 4n - + .RE .sp .ne 2 -.mk .na \fB\fB/dev/rmt/[0-7]l[b][n]\fR\fR .ad .sp .6 .RS 4n - + .RE .sp .ne 2 -.mk .na \fB\fB/dev/rmt/[0-7]m[b][n]\fR\fR .ad .sp .6 .RS 4n - + .RE .sp .ne 2 -.mk .na \fB\fB/dev/rmt/[0-7]h[b][n]\fR\fR .ad .sp .6 .RS 4n - + .RE .sp .ne 2 -.mk .na \fB\fB/dev/rmt/[0-7]u[b][n]\fR\fR .ad .sp .6 .RS 4n - + .RE .sp .ne 2 -.mk .na \fB\fB/dev/rmt/[0-7]c[b][n]\fR\fR .ad .sp .6 .RS 4n - + .RE .sp .ne 2 -.mk .na \fB\fB/etc/default/tar\fR\fR .ad @@ -1175,13 +1131,12 @@ Settings might look like this: .sp .ne 2 -.mk .na \fB\fB/tmp/tar*\fR\fR .ad .sp .6 .RS 4n - + .RE .SH ATTRIBUTES @@ -1192,15 +1147,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityCommitted +Interface Stability Committed .TE .SH SEE ALSO diff --git a/usr/src/man/man1/tbl.1 b/usr/src/man/man1/tbl.1 index 46111d5038..6d3eb54d30 100644 --- a/usr/src/man/man1/tbl.1 +++ b/usr/src/man/man1/tbl.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 tbl 1 "2 Aug 1994" "SunOS 5.11" "User Commands" +.TH TBL 1 "Aug 2, 1994" .SH NAME tbl \- format tables for nroff or troff .SH SYNOPSIS @@ -28,34 +28,28 @@ through pipes. .SH OPTIONS .sp .ne 2 -.mk .na \fB\fB-me\fR \fR .ad .RS 8n -.rt Copy the \fB-me\fR macro package to the front of the output file. .RE .sp .ne 2 -.mk .na \fB\fB-mm\fR \fR .ad .RS 8n -.rt Copy the \fB-mm\fR macro package to the front of the output file. .RE .sp .ne 2 -.mk .na \fB\fB-ms\fR \fR .ad .RS 8n -.rt Copy the \fB-ms\fR macro package to the front of the output file. .RE @@ -96,51 +90,43 @@ yields .sp .TS -tab(); -lw(1.83i) lw(1.83i) lw(1.83i) -lw(1.83i) lw(1.83i) lw(1.83i) -. +l l l +l l l . \fBHousehold Population\fR -\fBTown\fR\fBHouseholds\fR -\fBNumber\fR\fBSize\fR -\fBBedminster\fR\fB789\fR\fB3.26\fR -\fBBernards Twp.\fR\fB3087\fR\fB3.74\fR -\fBBernardsville\fR\fB2018\fR\fB3.30\fR -\fBBound Brook\fR\fB3425\fR\fB3.04\fR -\fBBranchburg\fR\fB1644\fR\fB3.49\fR +\fBTown\fR \fBHouseholds\fR + \fBNumber\fR \fBSize\fR +\fBBedminster\fR \fB789\fR \fB3.26\fR +\fBBernards Twp.\fR \fB3087\fR \fB3.74\fR +\fBBernardsville\fR \fB2018\fR \fB3.30\fR +\fBBound Brook\fR \fB3425\fR \fB3.04\fR +\fBBranchburg\fR \fB1644\fR \fB3.49\fR .TE .SH FILES .sp .ne 2 -.mk .na \fB\fB/usr/share/lib/tmac/e\fR \fR .ad .RS 26n -.rt \fB-me\fR macros .RE .sp .ne 2 -.mk .na \fB\fB/usr/share/lib/tmac/m\fR \fR .ad .RS 26n -.rt \fB-mm\fR macros .RE .sp .ne 2 -.mk .na \fB\fB/usr/share/lib/tmac/s\fR \fR .ad .RS 26n -.rt \fB-ms\fR macros .RE diff --git a/usr/src/man/man1/tcopy.1 b/usr/src/man/man1/tcopy.1 index de760fc2f8..67e27b7a9d 100644 --- a/usr/src/man/man1/tcopy.1 +++ b/usr/src/man/man1/tcopy.1 @@ -1,10 +1,10 @@ '\" 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. +.\" specifies the terms and conditions for redistribution. .\" Copyright (c) 2000, Sun Microsystems, Inc. -.\" All Rights Reserved -.TH tcopy 1 "10 Mar 2000" "SunOS 5.11" "User Commands" +.\" All Rights Reserved +.TH TCOPY 1 "Mar 10, 2000" .SH NAME tcopy \- copy a magnetic tape .SH SYNOPSIS diff --git a/usr/src/man/man1/tee.1 b/usr/src/man/man1/tee.1 index 82aed5fd4d..bd80935517 100644 --- a/usr/src/man/man1/tee.1 +++ b/usr/src/man/man1/tee.1 @@ -1,16 +1,16 @@ '\" te -.\" Copyright 1989 AT&T +.\" Copyright 1989 AT&T .\" Copyright (c) 1992, X/Open Company Limited All Rights Reserved .\" Portions Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 tee 1 "20 Nov 2007" "SunOS 5.11" "User Commands" +.TH TEE 1 "Nov 20, 2007" .SH NAME tee \- replicate the standard output .SH SYNOPSIS @@ -58,23 +58,19 @@ underlying operating system. The following options are supported by \fB/usr/bin/tee\fR: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 6n -.rt Appends the output to the files rather than overwriting them. .RE .sp .ne 2 -.mk .na \fB\fB-i\fR\fR .ad .RS 6n -.rt Ignores interrupts. .RE @@ -85,7 +81,6 @@ The following options are supported by the \fBtee\fR built-in command in \fBksh93\fR: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad @@ -94,13 +89,11 @@ The following options are supported by the \fBtee\fR built-in command in \fB\fB--append\fR\fR .ad .RS 23n -.rt Appends the output to the files rather than overwriting them. .RE .sp .ne 2 -.mk .na \fB\fB-i\fR\fR .ad @@ -109,13 +102,11 @@ Appends the output to the files rather than overwriting them. \fB\fB--ignore-interrupts\fR\fR .ad .RS 23n -.rt Ignores \fBSIGINT\fR signal. .RE .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad @@ -124,7 +115,6 @@ Ignores \fBSIGINT\fR signal. \fB\fB--line-buffer\fR\fR .ad .RS 23n -.rt Sets the standard output to be line buffered. .RE @@ -134,12 +124,10 @@ Sets the standard output to be line buffered. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIfile\fR\fR .ad .RS 8n -.rt A path name of an output file. Processing of at least 13 \fIfile\fR operands are supported. .RE @@ -162,23 +150,19 @@ that affect the execution of \fBtee\fR: \fBLANG\fR, \fBLC_ALL\fR, The following exit values are returned by \fB/usr/bin/tee\fR: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt The standard input was successfully copied to all output files. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt The number of files that could not be opened or whose status could not be obtained. .RE @@ -189,23 +173,19 @@ obtained. The following exit values are returned by \fBtee\fR in \fBksh93\fR: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -218,17 +198,16 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityCommitted +Interface Stability Committed _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .SS "ksh93" @@ -236,13 +215,12 @@ StandardSee \fBstandards\fR(5). .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilitySee below. +Interface Stability See below. .TE .sp diff --git a/usr/src/man/man1/telnet.1 b/usr/src/man/man1/telnet.1 index ad41b369a1..22e1ed2ee2 100644 --- a/usr/src/man/man1/telnet.1 +++ b/usr/src/man/man1/telnet.1 @@ -1,15 +1,15 @@ '\" te .\" Copyright 1989 AT&T -.\" Copyright (C) 2004, Sun Microsystems, Inc. All Rights Reserved +.\" Copyright (C) 2004, Sun Microsystems, Inc. All Rights Reserved .\" Copyright (c) 1983, 1990, 1993 The Regents of the University of California. All rights reserved. -.TH telnet 1 "17 Aug 2006" "SunOS 5.11" "User Commands" +.TH TELNET 1 "Aug 17, 2006" .SH NAME telnet \- user interface to a remote system using the TELNET protocol .SH SYNOPSIS .LP .nf -\fBtelnet\fR [\fB-8EFKLacdfrx\fR] [\fB-X\fR \fIatype\fR] [\fB-e\fR \fIescape_char\fR] - [\fB-k\fR \fIrealm\fR] [\fB-l\fR \fIuser\fR] [\fB-n\fR \fIfile\fR] +\fBtelnet\fR [\fB-8EFKLacdfrx\fR] [\fB-X\fR \fIatype\fR] [\fB-e\fR \fIescape_char\fR] + [\fB-k\fR \fIrealm\fR] [\fB-l\fR \fIuser\fR] [\fB-n\fR \fIfile\fR] [ [ [!] @hop1 [@hop2...] @] \fIhost\fR [\fIport\fR]] .fi @@ -76,7 +76,6 @@ mode. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-8\fR\fR .ad @@ -88,7 +87,6 @@ attempted for both input and output. .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad @@ -103,7 +101,6 @@ with the user \fBID\fR. .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad @@ -115,7 +112,6 @@ Disables the reading of the user's \fBtelnetrc\fR file. (See the \fBtoggle\fR .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad @@ -126,7 +122,6 @@ Sets the initial value of the \fBdebug\fR toggle to \fBTRUE\fR. .sp .ne 2 -.mk .na \fB\fB-e\fR \fIescape_char\fR\fR .ad @@ -144,7 +139,6 @@ character, use the \fB-E\fR option. .sp .ne 2 -.mk .na \fB\fB-E\fR\fR .ad @@ -155,7 +149,6 @@ Stops any character from being recognized as an escape character. .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad @@ -166,7 +159,6 @@ Forwards a copy of the local credentials to the remote system. .sp .ne 2 -.mk .na \fB\fB-F\fR\fR .ad @@ -177,7 +169,6 @@ Forwards a forwardable copy of the local credentials to the remote system. .sp .ne 2 -.mk .na \fB\fB-k\fR \fIrealm\fR\fR .ad @@ -190,7 +181,6 @@ realm as determined in\fBkrb5.conf\fR(4). .sp .ne 2 -.mk .na \fB\fB-K\fR\fR .ad @@ -201,7 +191,6 @@ Specifies no automatic login to the remote system. .sp .ne 2 -.mk .na \fB\fB-l\fR \fIuser\fR\fR .ad @@ -214,7 +203,6 @@ then \fIuser\fR will be sent to the remote system as the value for the .sp .ne 2 -.mk .na \fB\fB-L\fR\fR .ad @@ -226,7 +214,6 @@ be negotiated on output. .sp .ne 2 -.mk .na \fB\fB-n\fR \fItracefile\fR\fR .ad @@ -238,7 +225,6 @@ Opens \fItracefile\fR for recording trace information. See the \fBset\fR .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad @@ -257,7 +243,6 @@ future. .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad @@ -270,7 +255,6 @@ if encryption cannot be turned on. .sp .ne 2 -.mk .na \fB\fB-X\fR \fIatype\fR\fR .ad @@ -289,7 +273,6 @@ also true for arguments to the \fBmode\fR, \fBset\fR, \fBtoggle\fR, \fBunset\fR, \fBenviron\fR, and \fBdisplay\fR commands.) .sp .ne 2 -.mk .na \fB\fBauth\fR \fIargument\fR ...\fR .ad @@ -300,7 +283,6 @@ The \fBauth\fR command manipulates the information sent through the command are as follows: .sp .ne 2 -.mk .na \fB\fBdisable\fR \fItype\fR\fR .ad @@ -312,7 +294,6 @@ types, use the \fBauth\fR \fBdisable ?\fR command. .sp .ne 2 -.mk .na \fB\fBenable\fR \fItype\fR\fR .ad @@ -324,7 +305,6 @@ types, use the \fBauth\fR \fBenable ?\fR command. .sp .ne 2 -.mk .na \fB\fBstatus\fR\fR .ad @@ -337,7 +317,6 @@ Lists the current status of the various types of authentication. .sp .ne 2 -.mk .na \fB\fBopen\fR [\fB\fR\fB-l\fR \fIuser\fR ] [ [!] @\fIhop1\fR [@\fIhop2\fR ...]@\fIhost\fR [ \fIport\fR ]\fR @@ -360,7 +339,6 @@ variable \fBUSER\fR to the remote system. .sp .ne 2 -.mk .na \fB\fBclose\fR\fR .ad @@ -372,7 +350,6 @@ command mode) will also close a session and exit. .sp .ne 2 -.mk .na \fB\fBencrypt\fR\fR .ad @@ -384,7 +361,6 @@ The encrypt command manipulates the information sent through the \fBTELNET\fR Valid arguments for the encrypt command are as follows: .sp .ne 2 -.mk .na \fB\fBdisable\fR \fItype\fR [\fBinput\fR|\fBoutput\fR]\fR .ad @@ -397,7 +373,6 @@ the \fBencrypt\fR \fBdisable ?\fR command. .sp .ne 2 -.mk .na \fB\fBenable\fR \fItype\fR [\fBinput\fR|\fBoutput\fR]\fR .ad @@ -410,7 +385,6 @@ input and output are enabled. To obtain a list of available types, use the .sp .ne 2 -.mk .na \fB\fBinput\fR\fR .ad @@ -421,7 +395,6 @@ This is the same as the \fBencrypt\fR \fBstart input\fR command. .sp .ne 2 -.mk .na \fB\fB-input\fR\fR .ad @@ -432,7 +405,6 @@ This is the same as the \fBencrypt\fR \fBstop input\fR command. .sp .ne 2 -.mk .na \fB\fBoutput\fR\fR .ad @@ -443,7 +415,6 @@ This is the same as the \fBencrypt\fR \fBstart output\fR command. .sp .ne 2 -.mk .na \fB\fB-output\fR\fR .ad @@ -454,7 +425,6 @@ This is the same as the \fBencrypt\fR \fBstop output\fR command. .sp .ne 2 -.mk .na \fB\fBstart\fR [\fBinput\fR|\fBoutput\fR]\fR .ad @@ -467,7 +437,6 @@ output are enabled. To obtain a list of available types, use the \fBencrypt\fR .sp .ne 2 -.mk .na \fB\fBstatus\fR\fR .ad @@ -478,7 +447,6 @@ Lists the current status of encryption. .sp .ne 2 -.mk .na \fB\fBstop\fR [\fBinput\fR|\fBoutput\fR]\fR .ad @@ -490,7 +458,6 @@ output. .sp .ne 2 -.mk .na \fB\fBtype\fR \fItype\fR\fR .ad @@ -504,7 +471,6 @@ Sets the default type of encryption to be used with later \fBencrypt\fR .sp .ne 2 -.mk .na \fB\fBquit\fR\fR .ad @@ -515,7 +481,6 @@ Same as \fBclose\fR. .sp .ne 2 -.mk .na \fB\fBz\fR\fR .ad @@ -527,7 +492,6 @@ that supports job control, such as \fBsh\fR(1). .sp .ne 2 -.mk .na \fB\fBmode\fR \fItype\fR\fR .ad @@ -538,7 +502,6 @@ remote host is capable of entering that mode, the requested mode will be entered. The argument \fItype\fR is one of the following: .sp .ne 2 -.mk .na \fB\fBcharacter\fR\fR .ad @@ -550,7 +513,6 @@ understand the \fBLINEMODE\fR option, then enter "character at a time" mode. .sp .ne 2 -.mk .na \fB\fBline\fR\fR .ad @@ -563,7 +525,6 @@ mode. .sp .ne 2 -.mk .na \fB\fBisig\fR (\fB-isig\fR)\fR .ad @@ -575,7 +536,6 @@ option. This requires that the \fBLINEMODE\fR option be enabled. .sp .ne 2 -.mk .na \fB\fBedit\fR (\fB-edit\fR)\fR .ad @@ -587,7 +547,6 @@ This requires that the \fBLINEMODE\fR option be enabled. .sp .ne 2 -.mk .na \fB\fBsofttabs\fR (\fB-softtabs\fR)\fR .ad @@ -599,7 +558,6 @@ option. This requires that the \fBLINEMODE\fR option be enabled. .sp .ne 2 -.mk .na \fB\fBlitecho\fR (\fB-litecho\fR)\fR .ad @@ -611,7 +569,6 @@ option. This requires that the \fBLINEMODE\fR option be enabled. .sp .ne 2 -.mk .na \fB\fB?\fR\fR .ad @@ -624,7 +581,6 @@ Prints out help information for the \fBmode\fR command. .sp .ne 2 -.mk .na \fB\fBstatus\fR\fR .ad @@ -636,7 +592,6 @@ connected to, as well as the current mode. .sp .ne 2 -.mk .na \fB\fBdisplay\fR\fR .ad @@ -648,7 +603,6 @@ connected to, as well as the current mode. .sp .ne 2 -.mk .na \fB\fB?\fR\fR .ad @@ -661,7 +615,6 @@ information for just that command. .sp .ne 2 -.mk .na \fB\fBsend\fR \fIargument\fR\fB\|.\|.\|.\fR\fR .ad @@ -672,7 +625,6 @@ are the arguments that can be specified (more than one argument may be specified at a time): .sp .ne 2 -.mk .na \fB\fBescape\fR\fR .ad @@ -683,7 +635,6 @@ Send the current \fBtelnet\fR escape character (initially \fB^]\fR). .sp .ne 2 -.mk .na \fB\fBsynch\fR\fR .ad @@ -697,7 +648,6 @@ system. If it does not work, a lowercase "r" may be echoed on the terminal. .sp .ne 2 -.mk .na \fB\fBbrk\fR or \fBbreak\fR\fR .ad @@ -709,7 +659,6 @@ remote system. .sp .ne 2 -.mk .na \fB\fBip\fR\fR .ad @@ -721,7 +670,6 @@ currently running process on the remote system. .sp .ne 2 -.mk .na \fB\fBabort\fR\fR .ad @@ -732,7 +680,6 @@ Send the \fBTELNET ABORT\fR (Abort Process) sequence. .sp .ne 2 -.mk .na \fB\fBao\fR\fR .ad @@ -744,7 +691,6 @@ the remote system to the user's terminal. .sp .ne 2 -.mk .na \fB\fBayt\fR\fR .ad @@ -756,7 +702,6 @@ may or may not respond. .sp .ne 2 -.mk .na \fB\fBec\fR\fR .ad @@ -768,7 +713,6 @@ character entered. .sp .ne 2 -.mk .na \fB\fBel\fR\fR .ad @@ -780,7 +724,6 @@ system to erase the line currently being entered. .sp .ne 2 -.mk .na \fB\fBeof\fR\fR .ad @@ -791,7 +734,6 @@ Send the \fBTELNET EOF\fR (End Of File) sequence. .sp .ne 2 -.mk .na \fB\fBeor\fR\fR .ad @@ -802,7 +744,6 @@ Send the \fBTELNET EOR\fR (End Of Record) sequence. .sp .ne 2 -.mk .na \fB\fBga\fR\fR .ad @@ -814,7 +755,6 @@ significance for the remote system. .sp .ne 2 -.mk .na \fB\fBgetstatus\fR\fR .ad @@ -827,7 +767,6 @@ status. .sp .ne 2 -.mk .na \fB\fBnop\fR\fR .ad @@ -838,7 +777,6 @@ Send the \fBTELNET NOP\fR (No Operation) sequence. .sp .ne 2 -.mk .na \fB\fBsusp\fR\fR .ad @@ -849,7 +787,6 @@ Send the \fBTELNET SUSP\fR (Suspend Process) sequence. .sp .ne 2 -.mk .na \fB\fBdo\fR \fIoption\fR\fR .ad @@ -877,7 +814,6 @@ useful for unusual debugging situations. .sp .ne 2 -.mk .na \fB\fB?\fR\fR .ad @@ -890,7 +826,6 @@ Print out help information for the \fBsend\fR command. .sp .ne 2 -.mk .na \fB\fBset\fR \fIargument\fR [\fIvalue\fR]\fR .ad @@ -908,7 +843,6 @@ The values of variables may be interrogated with the \fBdisplay\fR command. If variables that may be specified are: .sp .ne 2 -.mk .na \fB\fBecho\fR\fR .ad @@ -921,7 +855,6 @@ suppressing echoing of entered characters, for example, entering a password. .sp .ne 2 -.mk .na \fB\fBescape\fR\fR .ad @@ -933,7 +866,6 @@ This is the \fBtelnet\fR escape character (initially \fB^]\fR) that enters .sp .ne 2 -.mk .na \fB\fBinterrupt\fR\fR .ad @@ -948,7 +880,6 @@ character. .sp .ne 2 -.mk .na \fB\fBquit\fR\fR .ad @@ -962,7 +893,6 @@ terminal's \fBquit\fR character. .sp .ne 2 -.mk .na \fB\fBflushoutput\fR\fR .ad @@ -976,7 +906,6 @@ terminal's \fBflush\fR character. .sp .ne 2 -.mk .na \fB\fBerase\fR\fR .ad @@ -991,7 +920,6 @@ initial value for the \fBerase\fR character is taken to be the terminal's .sp .ne 2 -.mk .na \fB\fBkill\fR\fR .ad @@ -1006,7 +934,6 @@ character. .sp .ne 2 -.mk .na \fB\fBeof\fR\fR .ad @@ -1020,7 +947,6 @@ character. .sp .ne 2 -.mk .na \fB\fBayt\fR\fR .ad @@ -1034,7 +960,6 @@ for \fBayt\fR is the terminal's status character. .sp .ne 2 -.mk .na \fB\fBforw1\fR\fR .ad @@ -1052,7 +977,6 @@ from the terminal's \fBeol\fR and \fBeol2\fR characters. .sp .ne 2 -.mk .na \fB\fBlnext\fR\fR .ad @@ -1066,7 +990,6 @@ terminal's \fBlnext\fR character. .sp .ne 2 -.mk .na \fB\fBreprint\fR\fR .ad @@ -1080,7 +1003,6 @@ character. The initial value for \fBreprint\fR is taken to be the terminal's .sp .ne 2 -.mk .na \fB\fBrlogin\fR\fR .ad @@ -1096,7 +1018,6 @@ is to disable the \fBrlogin\fR escape character. .sp .ne 2 -.mk .na \fB\fBstart\fR\fR .ad @@ -1110,7 +1031,6 @@ initial value for the \fBkill\fR character is taken to be the terminal's .sp .ne 2 -.mk .na \fB\fBstop\fR\fR .ad @@ -1124,7 +1044,6 @@ initial value for the \fBkill\fR character is taken to be the terminal's .sp .ne 2 -.mk .na \fB\fBsusp\fR\fR .ad @@ -1139,7 +1058,6 @@ character. .sp .ne 2 -.mk .na \fB\fBtracefile\fR\fR .ad @@ -1153,7 +1071,6 @@ default). .sp .ne 2 -.mk .na \fB\fBworderase\fR\fR .ad @@ -1167,7 +1084,6 @@ initial value for the \fBworderase\fR character is taken to be the terminal's .sp .ne 2 -.mk .na \fB\fB?\fR\fR .ad @@ -1180,7 +1096,6 @@ Displays the legal \fBset\fR and \fBunset\fR commands. .sp .ne 2 -.mk .na \fB\fBslc\fR \fIstate\fR\fR .ad @@ -1194,7 +1109,6 @@ sequences (like \fBip\fR or \fBquit\fR) or line editing characters (like exported. The following values for \fIstate\fR are valid: .sp .ne 2 -.mk .na \fB\fBcheck\fR\fR .ad @@ -1208,7 +1122,6 @@ values. .sp .ne 2 -.mk .na \fB\fBexport\fR\fR .ad @@ -1221,7 +1134,6 @@ started. .sp .ne 2 -.mk .na \fB\fBimport\fR\fR .ad @@ -1234,7 +1146,6 @@ connection was established. .sp .ne 2 -.mk .na \fB\fB?\fR\fR .ad @@ -1247,7 +1158,6 @@ Prints out help information for the \fBslc\fR command. .sp .ne 2 -.mk .na \fB\fBtoggle\fR \fIargument\fR...\fR .ad @@ -1259,23 +1169,19 @@ state of these flags may be interrogated with the \fBdisplay\fR command. Valid arguments are: .sp .ne 2 -.mk .na \fB\fBauthdebug\fR\fR .ad .RS 20n -.rt Turns on debugging information for the authentication code. .RE .sp .ne 2 -.mk .na \fB\fBautodecrypt\fR\fR .ad .RS 20n -.rt When the \fBTELNET\fR \fBENCRYPT\fR option is negotiated, by default the actual encryption (decryption) of the data stream does not start automatically. The autoencrypt (autodecrypt) command states that encryption of the output (input) @@ -1284,12 +1190,10 @@ stream should be enabled as soon as possible. .sp .ne 2 -.mk .na \fB\fBautologin\fR\fR .ad .RS 20n -.rt If the remote side supports the \fBTELNET\fR \fBAUTHENTICATION\fR option, \fBtelnet\fR attempts to use it to perform automatic authentication. If the \fBAUTHENTICATION\fR option is not supported, the user's login name is @@ -1299,12 +1203,10 @@ same as specifying the \fB-a\fR option on the \fBopen\fR command. .sp .ne 2 -.mk .na \fB\fBautoflush\fR\fR .ad .RS 20n -.rt If \fBautoflush\fR and \fBlocalchars\fR are both \fBTRUE,\fR then when the \fBao\fR, \fBintr\fR, or \fBquit\fR characters are recognized (and transformed into \fBTELNET\fR sequences; see \fBset\fR for details), \fBtelnet\fR refuses @@ -1317,12 +1219,10 @@ terminal user has not done an "stty noflsh". Otherwise, the value is .sp .ne 2 -.mk .na \fB\fBautosynch\fR\fR .ad .RS 20n -.rt If \fBautosynch\fR and \fBlocalchars\fR are both \fBTRUE\fR, then when either the \fBinterrupt\fR or \fBquit\fR characters are typed (see \fBset\fR for descriptions of \fBinterrupt\fR and \fBquit\fR), the resulting \fBTELNET\fR @@ -1334,45 +1234,37 @@ upon. The initial value of this toggle is \fBFALSE\fR. .sp .ne 2 -.mk .na \fB\fBbinary\fR\fR .ad .RS 20n -.rt Enable or disable the \fBTELNET BINARY\fR option on both input and output. .RE .sp .ne 2 -.mk .na \fB\fBinbinary\fR\fR .ad .RS 20n -.rt Enable or disable the \fBTELNET BINARY\fR option on input. .RE .sp .ne 2 -.mk .na \fB\fBoutbinary\fR\fR .ad .RS 20n -.rt Enable or disable the \fBTELNET BINARY\fR option on output. .RE .sp .ne 2 -.mk .na \fB\fBcrlf\fR\fR .ad .RS 20n -.rt Determines how carriage returns are sent. If the value is \fBTRUE\fR, then carriage returns will be sent as \fB<CR><LF>\fR\&. If the value is \fBFALSE\fR, then carriage returns will be send as \fB<CR><NUL>\fR\&. The initial value for @@ -1381,12 +1273,10 @@ this toggle is \fBFALSE\fR. .sp .ne 2 -.mk .na \fB\fBcrmod\fR\fR .ad .RS 20n -.rt Toggle RETURN mode. When this mode is enabled, most RETURN characters received from the remote host will be mapped into a RETURN followed by a line feed. This mode does not affect those characters typed by the user, only those received @@ -1397,35 +1287,29 @@ RETURN but never send LINEFEED. The initial value for this toggle is .sp .ne 2 -.mk .na \fB\fBdebug\fR\fR .ad .RS 20n -.rt Toggle socket level debugging (only available to the super-user). The initial value for this toggle is \fBFALSE\fR. .RE .sp .ne 2 -.mk .na \fB\fBencdebug\fR\fR .ad .RS 20n -.rt Turns on debugging information for the encryption code. .RE .sp .ne 2 -.mk .na \fB\fBlocalchars\fR\fR .ad .RS 20n -.rt If this toggle is \fBTRUE\fR, then the \fBflush\fR, \fBinterrupt\fR, \fBquit\fR, \fBerase\fR, and \fBkill\fR characters (see \fBset\fR) are recognized locally, and transformed into appropriate \fBTELNET\fR control @@ -1440,24 +1324,20 @@ assumed always to be \fBTRUE\fR. If \fBLINEMODE\fR has ever been enabled, then .sp .ne 2 -.mk .na \fB\fBnetdata\fR\fR .ad .RS 20n -.rt Toggle the display of all network data (in hexadecimal format). The initial value for this toggle is \fBFALSE\fR. .RE .sp .ne 2 -.mk .na \fB\fBoptions\fR\fR .ad .RS 20n -.rt Toggle the display of some internal \fBTELNET\fR protocol processing (having to do with \fBtelnet\fR options). The initial value for this toggle is \fBFALSE\fR. @@ -1465,12 +1345,10 @@ do with \fBtelnet\fR options). The initial value for this toggle is .sp .ne 2 -.mk .na \fB\fBprettydump\fR\fR .ad .RS 20n -.rt When the \fBnetdata\fR toggle is enabled, if \fBprettydump\fR is enabled, the output from the \fBnetdata\fR command will be formatted in a more user readable format. Spaces are put between each character in the output. The beginning of @@ -1480,12 +1358,10 @@ locating them. .sp .ne 2 -.mk .na \fB\fBskiprc\fR\fR .ad .RS 20n -.rt When the \fBskiprc\fR toggle is \fBTRUE\fR, \fBTELNET\fR skips the reading of the \fB\&.telnetrc\fR file in the user's home directory when connections are opened. The initial value for this toggle is \fBFALSE\fR. @@ -1493,24 +1369,20 @@ opened. The initial value for this toggle is \fBFALSE\fR. .sp .ne 2 -.mk .na \fB\fBtermdata\fR\fR .ad .RS 20n -.rt Toggles the display of all terminal data (in hexadecimal format). The initial value for this toggle is \fBFALSE\fR. .RE .sp .ne 2 -.mk .na \fB\fBverbose_encrypt\fR\fR .ad .RS 20n -.rt When the \fBverbose_encrypt\fR flag is \fBTRUE\fR, \fBTELNET\fR prints out a message each time encryption is enabled or disabled. The initial value for this toggle is \fBFALSE\fR. @@ -1518,12 +1390,10 @@ toggle is \fBFALSE\fR. .sp .ne 2 -.mk .na \fB\fB?\fR\fR .ad .RS 20n -.rt Display the legal \fBtoggle\fR commands. .RE @@ -1531,7 +1401,6 @@ Display the legal \fBtoggle\fR commands. .sp .ne 2 -.mk .na \fB\fBenviron\fR \fIargument\|.\|.\|.\fR\fR .ad @@ -1543,7 +1412,6 @@ from the users environment. Only the \fBDISPLAY\fR and \fBPRINTER\fR variables are exported by default. Valid arguments for the \fBenviron\fR command are: .sp .ne 2 -.mk .na \fB\fBdefine\fR \fIvariable value\fR\fR .ad @@ -1556,7 +1424,6 @@ single or double quotes, so that tabs and spaces may be included. .sp .ne 2 -.mk .na \fB\fBundefine\fR \fIvariable\fR\fR .ad @@ -1567,7 +1434,6 @@ Remove \fIvariable\fR from the list of environment variables. .sp .ne 2 -.mk .na \fB\fBexport\fR \fIvariable\fR\fR .ad @@ -1578,7 +1444,6 @@ Mark the \fIvariable\fR to be exported to the remote side. .sp .ne 2 -.mk .na \fB\fBunexport\fR \fIvariable\fR\fR .ad @@ -1590,7 +1455,6 @@ remote side. .sp .ne 2 -.mk .na \fB\fBlist\fR\fR .ad @@ -1603,7 +1467,6 @@ explicitly requested. .sp .ne 2 -.mk .na \fB\fB?\fR\fR .ad @@ -1616,7 +1479,6 @@ Prints out help information for the \fBenviron\fR command. .sp .ne 2 -.mk .na \fB\fBlogout\fR\fR .ad @@ -1635,12 +1497,10 @@ immediately. .SH FILES .sp .ne 2 -.mk .na \fB\fB$HOME/.telnetrc\fR\fR .ad .RS 19n -.rt file that contains commands to be executed before initiating a \fBtelnet\fR session .RE @@ -1654,7 +1514,6 @@ session .SH DIAGNOSTICS .sp .ne 2 -.mk .na \fB\fBNO LOGINS: System going down in\fR \fIN\fR \fBminutes\fR\fR .ad diff --git a/usr/src/man/man1/test.1 b/usr/src/man/man1/test.1 index 098c7062f8..411b3fa6b2 100644 --- a/usr/src/man/man1/test.1 +++ b/usr/src/man/man1/test.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 test 1 "11 Aug 2009" "SunOS 5.11" "User Commands" +.TH TEST 1 "Aug 11, 2009" .SH NAME test \- evaluate condition(s) .SH SYNOPSIS @@ -171,67 +171,55 @@ primaries. The following primaries can be used to construct \fIcondition\fR: .sp .ne 2 -.mk .na \fB\fB-a\fR \fIfile\fR\fR .ad .RS 28n -.rt True if \fIfile\fR exists. (Not available in \fBsh\fR.) .RE .sp .ne 2 -.mk .na \fB\fB-b\fR \fIfile\fR\fR .ad .RS 28n -.rt True if \fIfile\fR exists and is a block special file. .RE .sp .ne 2 -.mk .na \fB\fB-c\fR \fIfile\fR\fR .ad .RS 28n -.rt True if \fIfile\fR exists and is a character special file. .RE .sp .ne 2 -.mk .na \fB\fB-d\fR \fIfile\fR\fR .ad .RS 28n -.rt True if \fIfile\fR exists and is a directory. .RE .sp .ne 2 -.mk .na \fB\fB-e\fR \fIfile\fR\fR .ad .RS 28n -.rt True if \fIfile\fR exists. (Not available in \fBsh\fR.) .RE .sp .ne 2 -.mk .na \fB\fB-f\fR \fIfile\fR\fR .ad .RS 28n -.rt True if \fIfile\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 returns true if \fIfile\fR @@ -241,148 +229,122 @@ exists and is (\fBnot\(mia\(midirectory\fR). The \fBcsh\fR \fBtest\fR and .sp .ne 2 -.mk .na \fB\fB-g\fR \fIfile\fR\fR .ad .RS 28n -.rt True if \fIfile\fR exists and its set group \fBID\fR flag is set. .RE .sp .ne 2 -.mk .na \fB\fB-G\fR \fIfile\fR\fR .ad .RS 28n -.rt True if \fIfile\fR exists and its group matches the effective group \fBID\fR of this process. (Not available in \fBsh\fR.) .RE .sp .ne 2 -.mk .na \fB\fB-h\fR \fIfile\fR\fR .ad .RS 28n -.rt True if \fIfile\fR exists and is a symbolic link. .RE .sp .ne 2 -.mk .na \fB\fB-k\fR \fIfile\fR\fR .ad .RS 28n -.rt True if \fIfile\fR exists and has its sticky bit set. .RE .sp .ne 2 -.mk .na \fB\fB-L\fR \fIfile\fR\fR .ad .RS 28n -.rt True if \fIfile\fR exists and is a symbolic link. .RE .sp .ne 2 -.mk .na \fB\fB-n\fR \fIstring\fR\fR .ad .RS 28n -.rt True if the length of \fIstring\fR is non-zero. .RE .sp .ne 2 -.mk .na \fB\fB-o\fR \fIoption\fR\fR .ad .RS 28n -.rt True if option named \fIoption\fR is on. This option is not available in \fBcsh\fR or \fBsh\fR. .RE .sp .ne 2 -.mk .na \fB\fB-O\fR \fIfile\fR\fR .ad .RS 28n -.rt True if \fIfile\fR exists and is owned by the effective user \fBID\fR of this process. This option is not available in \fBsh\fR. .RE .sp .ne 2 -.mk .na \fB\fB-p\fR \fIfile\fR\fR .ad .RS 28n -.rt True if \fIfile\fR is a named pipe (\fBFIFO\fR). .RE .sp .ne 2 -.mk .na \fB\fB-r\fR \fIfile\fR\fR .ad .RS 28n -.rt True if \fIfile\fR exists and is readable. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR \fIfile\fR\fR .ad .RS 28n -.rt True if \fIfile\fR exists and has a size greater than zero. .RE .sp .ne 2 -.mk .na \fB\fB-S\fR \fIfile\fR\fR .ad .RS 28n -.rt True if \fIfile\fR exists and is a socket. This option is not available in \fBsh\fR. .RE .sp .ne 2 -.mk .na \fB\fB-t\fR [\fIfile_descriptor\fR]\fR .ad .RS 28n -.rt True if the file whose file descriptor number is \fIfile_descriptor\fR is open and is associated with a terminal. If \fIfile_descriptor\fR is not specified, \fB1\fR is used as a default value. @@ -390,23 +352,19 @@ and is associated with a terminal. If \fIfile_descriptor\fR is not specified, .sp .ne 2 -.mk .na \fB\fB-u\fR \fIfile\fR\fR .ad .RS 28n -.rt True if \fIfile\fR exists and its set-user-ID flag is set. .RE .sp .ne 2 -.mk .na \fB\fB-w\fR \fIfile\fR\fR .ad .RS 28n -.rt True if \fIfile\fR exists and is writable. True indicates only that the write flag is on. The \fIfile\fR is not writable on a read-only file system even if this test indicates true. @@ -414,12 +372,10 @@ this test indicates true. .sp .ne 2 -.mk .na \fB\fB-x\fR \fIfile\fR\fR .ad .RS 28n -.rt True if \fIfile\fR exists and is executable. True indicates only that the execute flag is on. If \fIfile\fR is a directory, true indicates that \fIfile\fR can be searched. @@ -427,92 +383,76 @@ execute flag is on. If \fIfile\fR is a directory, true indicates that .sp .ne 2 -.mk .na \fB\fB-z\fR \fIstring\fR\fR .ad .RS 28n -.rt True if the length of string \fIstring\fR is zero. .RE .sp .ne 2 -.mk .na \fB\fIfile1\fR \fB-nt\fR \fIfile2\fR\fR .ad .RS 28n -.rt True if \fIfile1\fR exists and is newer than \fIfile2\fR. This option is not available in \fBsh\fR. .RE .sp .ne 2 -.mk .na \fB\fIfile1\fR \fB-ot\fR \fIfile2\fR\fR .ad .RS 28n -.rt True if \fIfile1\fR exists and is older than \fIfile2\fR. This option is not available in \fBsh\fR. .RE .sp .ne 2 -.mk .na \fB\fIfile1\fR \fB-ef\fR \fIfile2\fR\fR .ad .RS 28n -.rt True if \fIfile1\fR and \fIfile2\fR exist and refer to the same file. This option is not available in \fBsh\fR. .RE .sp .ne 2 -.mk .na \fB\fIstring\fR\fR .ad .RS 28n -.rt True if the string \fIstring\fR is not the null string. .RE .sp .ne 2 -.mk .na \fB\fIstring1\fR \fB=\fR \fIstring2\fR\fR .ad .RS 28n -.rt True if the strings \fIstring1\fR and \fIstring2\fR are identical. .RE .sp .ne 2 -.mk .na \fB\fIstring1\fR \fB!=\fR \fIstring2\fR\fR .ad .RS 28n -.rt True if the strings \fIstring1\fR and \fIstring2\fR are not identical. .RE .sp .ne 2 -.mk .na \fB\fIn1\fR \fB-eq\fR \fIn2\fR\fR .ad .RS 28n -.rt True if the numbers \fIn1\fR and \fIn2\fR are algebraically equal. A number may be integer, floating point or floating-point constant (such as [+/-]Inf, [+/-]NaN) in any format specified by C99/XPG6/SUS. @@ -520,12 +460,10 @@ be integer, floating point or floating-point constant (such as [+/-]Inf, .sp .ne 2 -.mk .na \fB\fIn1\fR \fB-ne\fR \fIn2\fR\fR .ad .RS 28n -.rt True if the numbers \fIn1\fR and \fIn2\fR are not algebraically equal. A number may be integer, floating point or floating-point constant (such as [+/-]Inf, [+/-]NaN) in any format specified by C99/XPG6/SUS. @@ -533,12 +471,10 @@ may be integer, floating point or floating-point constant (such as [+/-]Inf, .sp .ne 2 -.mk .na \fB\fIn1\fR \fB-gt\fR \fIn2\fR\fR .ad .RS 28n -.rt True if the number \fIn1\fR is algebraically greater than the number \fIn2\fR. A number may be integer, floating point or floating-point constant (such as [+/-]Inf, [+/-]NaN) in any format specified by C99/XPG6/SUS. @@ -546,12 +482,10 @@ A number may be integer, floating point or floating-point constant (such as .sp .ne 2 -.mk .na \fB\fIn1\fR \fB-ge\fR \fIn2\fR\fR .ad .RS 28n -.rt True if the number \fIn1\fR is algebraically greater than or equal to the number \fIn2\fR. A number may be integer, floating point or floating-point constant (such as [+/-]Inf, [+/-]NaN) in any format specified by C99/XPG6/SUS. @@ -559,12 +493,10 @@ constant (such as [+/-]Inf, [+/-]NaN) in any format specified by C99/XPG6/SUS. .sp .ne 2 -.mk .na \fB\fIn1\fR \fB-lt\fR \fIn2\fR\fR .ad .RS 28n -.rt True if the number \fIn1\fR is algebraically less than the number \fIn2\fR. A number may be integer, floating point or floating-point constant (such as [+/-]Inf, [+/-]NaN) in any format specified by C99/XPG6/SUS. @@ -572,12 +504,10 @@ number may be integer, floating point or floating-point constant (such as .sp .ne 2 -.mk .na \fB\fIn1\fR \fB-le\fR \fIn2\fR\fR .ad .RS 28n -.rt True if the number \fIn1\fR is algebraically less than or equal to the number \fIn2\fR. A number may be integer, floating point or floating-point constant (such as [+/-]Inf, [+/-]NaN) in any format specified by C99/XPG6/SUS. @@ -585,12 +515,10 @@ True if the number \fIn1\fR is algebraically less than or equal to the number .sp .ne 2 -.mk .na \fB\fIcondition1\fR \fB-a\fR \fIcondition2\fR\fR .ad .RS 28n -.rt True if both \fIcondition1\fR and \fIcondition2\fR are true. The \fB-a\fR binary primary is left associative and has higher precedence than the \fB-o\fR binary primary. @@ -598,12 +526,10 @@ binary primary. .sp .ne 2 -.mk .na \fB\fIcondition1\fR \fB-o\fR \fIcondition2\fR\fR .ad .RS 28n -.rt True if either \fIcondition1\fR or \fIcondition2\fR is true. The \fB-o\fR binary primary is left associative. .RE @@ -613,23 +539,19 @@ binary primary is left associative. These primaries can be combined with the following operators: .sp .ne 2 -.mk .na \fB\fB!\fR \fIcondition\fR\fR .ad .RS 17n -.rt True if \fIcondition\fR is false. .RE .sp .ne 2 -.mk .na \fB( \fIcondition\fR )\fR .ad .RS 17n -.rt True if condition is true. The parentheses ( ) can be used to alter the normal precedence and associativity. The parentheses are meaningful to the shell and, therefore, must be quoted. @@ -648,34 +570,28 @@ arguments presented to \fBtest\fR as a \fIcondition\fR, \fIcondition1\fR, or \fIcondition2\fR. .sp .ne 2 -.mk .na \fB\fI0 arguments:\fR\fR .ad .RS 16n -.rt Exit false (1). .RE .sp .ne 2 -.mk .na \fB\fI1 argument:\fR\fR .ad .RS 16n -.rt Exit true (0) if \fB$1\fR is not null. Otherwise, exit false. .RE .sp .ne 2 -.mk .na \fB\fI2 arguments:\fR\fR .ad .RS 16n -.rt .RS +4 .TP .ie t \(bu @@ -700,12 +616,10 @@ Otherwise, produce unspecified results. .sp .ne 2 -.mk .na \fB\fI3 arguments:\fR\fR .ad .RS 16n -.rt .RS +4 .TP .ie t \(bu @@ -729,12 +643,10 @@ Otherwise, produce unspecified results. .sp .ne 2 -.mk .na \fB\fI4 arguments:\fR\fR .ad .RS 16n -.rt .RS +4 .TP .ie t \(bu @@ -1004,7 +916,7 @@ then else - echo "At least one of the three test conditions is false" + echo "At least one of the three test conditions is false" fi .fi .in -2 @@ -1018,7 +930,7 @@ Examples of the \fBtest\fR built-in: .sp .in +2 .nf -test \(gagrep $ROOT /etc/passwd >&1 /dev/null\(ga \fI# discard output\fR +test \(gagrep $ROOT /etc/passwd >&1 /dev/null\(ga \fI# discard output\fR echo $? \fI# test for success\fR [ \(gagrep nosuchname /etc/passwd >&1 /dev/null\(ga ] @@ -1034,8 +946,8 @@ echo $? \fI# test for failure\fR .in +2 .nf @ ZERO = 0; @ ONE = 1; @ TWO = 2; set ROOT = root -grep $ROOT /etc/passwd >&1 /dev/null \fI# discard output\fR - \fI# $status must be tested for immediately following grep\fR +grep $ROOT /etc/passwd >&1 /dev/null \fI# discard output\fR + \fI# $status must be tested for immediately following grep\fR if ( "$status" == "0" && $ONE > $ZERO && $TWO == 2 ) then echo "$ONE is greater than 0, $TWO equals 2, and $ROOT is" \e "a user-name in the password file" @@ -1049,11 +961,11 @@ if ( "$status" == "0" && $ONE > $ZERO && $TWO == 2 ) then .sp .in +2 .nf -ZERO=0 ONE=1 TWO=$((ONE+ONE)) ROOT=root +ZERO=0 ONE=1 TWO=$((ONE+ONE)) ROOT=root if ((ONE > ZERO)) \fI# arithmetical comparison\fR [[ $TWO = 2 ]] \fI# string comparison\fR - [ \(gagrep $ROOT /etc/passwd >&1 /dev/null\(ga ] \fI# discard output\fR -then + [ \(gagrep $ROOT /etc/passwd >&1 /dev/null\(ga ] \fI# discard output\fR +then echo "$ONE is greater than 0, $TWO equals 2, and $ROOT is" \e "a user-name in the password file" @@ -1075,34 +987,28 @@ that affect the execution of \fBtest\fR: \fBLANG\fR, \fBLC_ALL\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt \fIcondition\fR evaluated to true. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 6n -.rt \fIcondition\fR evaluated to false or \fIcondition\fR was missing. .RE .sp .ne 2 -.mk .na \fB\fB>1\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -1115,15 +1021,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .SS "ksh93" @@ -1131,13 +1036,12 @@ StandardSee \fBstandards\fR(5). .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityUncommitted +Interface Stability Uncommitted .TE .SH SEE ALSO diff --git a/usr/src/man/man1/tftp.1 b/usr/src/man/man1/tftp.1 index 04a0a938e2..d6349cf83a 100644 --- a/usr/src/man/man1/tftp.1 +++ b/usr/src/man/man1/tftp.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 tftp 1 "7 May 2007" "SunOS 5.11" "User Commands" +.TH TFTP 1 "May 7, 2007" .SH NAME tftp \- trivial file transfer program .SH SYNOPSIS @@ -30,7 +30,6 @@ following commands: .SS "Commands" .sp .ne 2 -.mk .na \fB\fBconnect\fR \fIhost-name\fR [ \fIport\fR ]\fR .ad @@ -46,7 +45,6 @@ part of the \fBget\fR or \fBput\fR commands. .sp .ne 2 -.mk .na \fB\fBmode\fR \fItransfer-mode\fR\fR .ad @@ -58,7 +56,6 @@ Set the mode for transfers; \fItransfer-mode\fR may be one of \fBascii\fR or .sp .ne 2 -.mk .na \fB\fBput\fR \fIfilename\fR\fR .ad @@ -106,7 +103,6 @@ Files may be written only if they already exist and are publicly writable. See .sp .ne 2 -.mk .na \fB\fBget\fR \fIfilename\fR\fR .ad @@ -137,7 +133,6 @@ used, the last host specified becomes the default for future transfers. See the .sp .ne 2 -.mk .na \fB\fBquit\fR\fR .ad @@ -148,7 +143,6 @@ Exit \fBtftp\fR. An \fBEOF\fR also exits. .sp .ne 2 -.mk .na \fB\fBverbose\fR\fR .ad @@ -159,7 +153,6 @@ Toggle verbose mode. .sp .ne 2 -.mk .na \fB\fBtrace\fR\fR .ad @@ -170,7 +163,6 @@ Toggle packet tracing. .sp .ne 2 -.mk .na \fB\fBstatus\fR\fR .ad @@ -181,7 +173,6 @@ Show current status. .sp .ne 2 -.mk .na \fB\fBrexmt\fR\fIretransmission-timeout\fR\fR .ad @@ -192,7 +183,6 @@ Set the per-packet retransmission timeout, in seconds. .sp .ne 2 -.mk .na \fB\fBtimeout\fR\fItotal-transmission-timeout\fR\fR .ad @@ -203,7 +193,6 @@ Set the total transmission timeout, in seconds. .sp .ne 2 -.mk .na \fB\fBascii\fR\fR .ad @@ -214,7 +203,6 @@ Shorthand for \fBmode ascii\fR. .sp .ne 2 -.mk .na \fB\fBbinary\fR\fR .ad @@ -225,7 +213,6 @@ Shorthand for \fBmode binary\fR. .sp .ne 2 -.mk .na \fB\fBblksize\fR \fItransfer-blocksize\fR\fR .ad @@ -237,7 +224,6 @@ value of \fB0\fR disables the negotiation of this option. .sp .ne 2 -.mk .na \fB\fBsrexmt\fR \fIserver-retransmission-timeout\fR\fR .ad @@ -249,7 +235,6 @@ A value of 0 disables the negotiation of this option. .sp .ne 2 -.mk .na \fB\fBtsize\fR\fR .ad @@ -262,7 +247,6 @@ request when the \fItransfer-mode\fR is \fBascii\fR. .sp .ne 2 -.mk .na \fB\fB? [\fR \fIcommand-name\fR .\|.\|. ]\fR .ad diff --git a/usr/src/man/man1/time.1 b/usr/src/man/man1/time.1 index addd7bae63..30991b1bb9 100644 --- a/usr/src/man/man1/time.1 +++ b/usr/src/man/man1/time.1 @@ -1,13 +1,13 @@ '\" te .\" Copyright (c) 1992, X/Open Company Limited All Rights Reserved Portions Copyright (c) 1995, Sun Microsystems, Inc. All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 time 1 "1 Feb 1995" "SunOS 5.11" "User Commands" +.TH TIME 1 "Feb 1, 1995" .SH NAME time \- time a simple command .SH SYNOPSIS @@ -65,12 +65,10 @@ a | b | time c a | b | (time c) The following option is supported: .sp .ne 2 -.mk .na \fB\fB-p\fR \fR .ad .RS 7n -.rt Writes the timing output to standard error in the following format: .sp .in +2 @@ -89,23 +87,19 @@ real %f\enuser %f\ensys %f\en < \fIreal seconds\fR>, <\fIuser seconds\fR>, The following operands are supported: .sp .ne 2 -.mk .na \fB\fIutility\fR \fR .ad .RS 13n -.rt The name of the utility that is to be invoked. .RE .sp .ne 2 -.mk .na \fB\fIargument\fR \fR .ad .RS 13n -.rt Any string to be supplied as an argument when invoking \fIutility\fR. .RE @@ -191,34 +185,28 @@ status of \fIutility\fR. Otherwise, the \fBtime\fR utility will exit with one of the following values: .sp .ne 2 -.mk .na \fB\fB1\(mi125\fR \fR .ad .RS 13n -.rt An error occurred in the \fBtime\fR utility. .RE .sp .ne 2 -.mk .na \fB\fB126\fR \fR .ad .RS 13n -.rt \fIutility\fR was found but could not be invoked. .RE .sp .ne 2 -.mk .na \fB\fB127\fR \fR .ad .RS 13n -.rt \fIutility\fR could not be found. .RE @@ -230,13 +218,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man1/times.1 b/usr/src/man/man1/times.1 index fb10a45d2f..9979a8865f 100644 --- a/usr/src/man/man1/times.1 +++ b/usr/src/man/man1/times.1 @@ -3,20 +3,20 @@ .\" 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 times 1 "15 Apr 1994" "SunOS 5.11" "User Commands" +.TH TIMES 1 "Apr 15, 1994" .SH NAME times \- shell built-in function to report time usages of the current shell .SH SYNOPSIS .SS "sh" .LP .nf -\fBtimes\fR +\fBtimes\fR .fi .SS "ksh" .LP .nf -\fBtimes\fR +\fBtimes\fR .fi .SH DESCRIPTION diff --git a/usr/src/man/man1/timex.1 b/usr/src/man/man1/timex.1 index c0f558174e..f43e19844c 100644 --- a/usr/src/man/man1/timex.1 +++ b/usr/src/man/man1/timex.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 timex 1 "14 Sep 1992" "SunOS 5.11" "User Commands" +.TH TIMEX 1 "Sep 14, 1992" .SH NAME timex \- time a command; report process data and system activity .SH SYNOPSIS @@ -28,12 +28,10 @@ The output of \fBtimex\fR is written on standard error. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-o\fR\fR .ad .RS 6n -.rt Report the total number of blocks read or written and total characters transferred by \fBcommand\fR and all its children. This option works only if the process accounting software is installed. @@ -41,36 +39,30 @@ the process accounting software is installed. .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 6n -.rt List process accounting records for \fBcommand\fR and all its children. This option works only if the process accounting software is installed. Suboptions \fBf\fR, \fBh\fR, \fBk\fR, \fBm\fR, \fBr\fR, and \fBt\fR modify the data items reported. The options are as follows: .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 6n -.rt Print the \fBfork\fR(2)/ \fBexec\fR(2) flag and system exit status columns in the output. .RE .sp .ne 2 -.mk .na \fB\fB-h\fR\fR .ad .RS 6n -.rt Instead of mean memory size, show the fraction of total available CPU time consumed by the process during its execution. This ``hog factor'' is computed as (total CPU time)/(elapsed time). @@ -78,45 +70,37 @@ as (total CPU time)/(elapsed time). .sp .ne 2 -.mk .na \fB\fB-k\fR\fR .ad .RS 6n -.rt Instead of memory size, show total kcore-minutes. .RE .sp .ne 2 -.mk .na \fB\fB-m\fR\fR .ad .RS 6n -.rt Show mean core size (the default). .RE .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 6n -.rt Show CPU factor (user time/(system-time + user-time)). .RE .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad .RS 6n -.rt Show separate system and user CPU times. The number of blocks read or written and the number of characters transferred are always reported. .RE @@ -125,12 +109,10 @@ and the number of characters transferred are always reported. .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 6n -.rt Report total system activity (not just that due to \fBcommand\fR) that occurred during the execution interval of \fBcommand\fR. All the data items listed in \fBsar\fR(1) are reported. diff --git a/usr/src/man/man1/tip.1 b/usr/src/man/man1/tip.1 index 5919c958a0..f10639a1ff 100644 --- a/usr/src/man/man1/tip.1 +++ b/usr/src/man/man1/tip.1 @@ -1,6 +1,6 @@ '\" 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) 2001, Sun Microsystems, Inc. All Rights Reserved -.TH tip 1 "28 Nov 2001" "SunOS 5.11" "User Commands" +.TH TIP 1 "Nov 28, 2001" .SH NAME tip \- connect to remote system .SH SYNOPSIS @@ -70,12 +70,10 @@ your home directory. .SH OPTIONS .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 6n -.rt Display commands from the \fB\&.tiprc\fR file as they are executed. .RE @@ -98,7 +96,6 @@ signal which directs \fBtip\fR to perform some special action. \fBtip\fR recognizes the following escape sequences: .sp .ne 2 -.mk .na \fB\fB~^D\fR\fR .ad @@ -107,7 +104,6 @@ recognizes the following escape sequences: \fB\fB~.\fR\fR .ad .RS 18n -.rt Drop the connection and exit (you may still be logged in on the remote machine). \fBNote:\fR If you rlogin and then run \fBtip\fR on the remote host, you must type \fB~~.\fR (tilde tilde dot) to end the \fBtip\fR session. If you @@ -116,58 +112,48 @@ type \fB~.\fR (tilde dot), it terminates the rlogin. .sp .ne 2 -.mk .na \fB\fB~c\fR [\fIname\fR]\fR .ad .RS 18n -.rt Change directory to \fIname\fR. No argument implies change to your home directory. .RE .sp .ne 2 -.mk .na \fB\fB~!\fR\fR .ad .RS 18n -.rt Escape to an interactive shell on the local machine. Exiting the shell returns you to \fBtip\fR. .RE .sp .ne 2 -.mk .na \fB\fB~>\fR\fR .ad .RS 18n -.rt Copy file from local to remote. .RE .sp .ne 2 -.mk .na \fB\fB~<\fR\fR .ad .RS 18n -.rt Copy file from remote to local. .RE .sp .ne 2 -.mk .na \fB\fB~p\fR\fI from\fR [\fI to \fR]\fR .ad .RS 18n -.rt Send a file to a remote host running the UNIX system. When you use the put command, the remote system runs the command string .sp @@ -185,12 +171,10 @@ UNIX-system-specific version of the `\fB~>\fR' command. .sp .ne 2 -.mk .na \fB\fB~t\fR\fI from\fR [\fI to \fR]\fR .ad .RS 18n -.rt Take a file from a remote host running the UNIX system. As in the put command the \fIto\fR file defaults to the \fIfrom\fR file name if it is not specified. The remote host executes the command string @@ -207,24 +191,20 @@ to send the file to \fBtip\fR. .sp .ne 2 -.mk .na \fB\fB~|\fR\fR .ad .RS 18n -.rt Pipe the output from a remote command to a local process. The command string sent to the local system is processed by the shell. .RE .sp .ne 2 -.mk .na \fB\fB~C\fR\fR .ad .RS 18n -.rt Connect a program to the remote machine. The command string sent to the program is processed by the shell. The program inherits file descriptors 0 as remote line input, 1 as remote line output, and 2 as tty standard error. @@ -232,58 +212,48 @@ line input, 1 as remote line output, and 2 as tty standard error. .sp .ne 2 -.mk .na \fB\fB~$\fR\fR .ad .RS 18n -.rt Pipe the output from a local process to the remote host. The command string sent to the local system is processed by the shell. .RE .sp .ne 2 -.mk .na \fB\fB~#\fR\fR .ad .RS 18n -.rt Send a \fBBREAK\fR to the remote system. .RE .sp .ne 2 -.mk .na \fB\fB~s\fR\fR .ad .RS 18n -.rt Set a variable (see the discussion below). .RE .sp .ne 2 -.mk .na \fB\fB~^Z\fR\fR .ad .RS 18n -.rt Stop \fBtip\fR. Only available when run under a shell that supports job control, such as the C shell. .RE .sp .ne 2 -.mk .na \fB\fB~^Y\fR\fR .ad .RS 18n -.rt Stop only the "local side" of \fBtip\fR. Only available when run under a shell that supports job control, such as the C shell. The "remote side" of \fBtip\fR, that is, the side that displays output from the remote host, is left running. @@ -291,12 +261,10 @@ that is, the side that displays output from the remote host, is left running. .sp .ne 2 -.mk .na \fB\fB~?\fR\fR .ad .RS 18n -.rt Get a summary of the tilde escapes. .RE @@ -402,12 +370,10 @@ abbreviation may be given. The following list details those variables known to \fBtip\fR. .sp .ne 2 -.mk .na \fB\fBbeautify\fR\fR .ad .RS 16n -.rt (bool) Discard unprintable characters when a session is being scripted; abbreviated \fBbe\fR. If the \fBnb\fR capability is present, \fBbeautify\fR is initially set to \fBoff\fR. Otherwise, \fBbeautify\fR is initially set to @@ -416,12 +382,10 @@ initially set to \fBoff\fR. Otherwise, \fBbeautify\fR is initially set to .sp .ne 2 -.mk .na \fB\fBbaudrate\fR\fR .ad .RS 16n -.rt (num) The baud rate at which the connection was established; abbreviated \fBba\fR. If a baud rate was specified on the command line, \fBbaudrate\fR is initially set to the specified value. Or, if the \fBbr\fR capability is @@ -432,12 +396,10 @@ Otherwise, \fBbaudrate\fR is set to 300 baud. Once \fBtip\fR has been started, .sp .ne 2 -.mk .na \fB\fBdialtimeout\fR\fR .ad .RS 16n -.rt (num) When dialing a phone number, the time (in seconds) to wait for a connection to be established; abbreviated \fBdial\fR. \fBdialtimeout\fR is initially set to 60 seconds, and can only changed by the super-user. @@ -445,12 +407,10 @@ initially set to 60 seconds, and can only changed by the super-user. .sp .ne 2 -.mk .na \fB\fBdisconnect\fR\fR .ad .RS 16n -.rt (str) The string to send to the remote host to disconnect from it; abbreviated \fBdi\fR. If the \fBdi\fR capability is present, \fBdisconnect\fR is initially set to the value of that capability. Otherwise, \fBdisconnect\fR is set to a @@ -459,12 +419,10 @@ null string (\fB""\fR). .sp .ne 2 -.mk .na \fB\fBechocheck\fR\fR .ad .RS 16n -.rt (bool) Synchronize with the remote host during file transfer by waiting for the echo of the last character transmitted; abbreviated \fBec\fR. If the \fBec\fR capability is present, \fBechocheck\fR is initially set to \fBon\fR. Otherwise, @@ -473,12 +431,10 @@ capability is present, \fBechocheck\fR is initially set to \fBon\fR. Otherwise, .sp .ne 2 -.mk .na \fB\fBeofread\fR\fR .ad .RS 16n -.rt (str) The set of characters which signify an end-of-transmission during a \fB~<\fR file transfer command; abbreviated \fBeofr\fR. If the \fBie\fR capability is present, \fBeofread\fR is initially set to the value of that @@ -487,12 +443,10 @@ capability. Otherwise, \fBeofread\fR is set to a null string (\fB""\fR). .sp .ne 2 -.mk .na \fB\fBeofwrite\fR\fR .ad .RS 16n -.rt (str) The string sent to indicate end-of-transmission during a \fB~>\fR file transfer command; abbreviated \fBeofw\fR. If the \fBoe\fR capability is present, \fBeofread\fR is initially set to the value of that capability. @@ -501,12 +455,10 @@ Otherwise, \fBeofread\fR is set to a null string (\fB""\fR). .sp .ne 2 -.mk .na \fB\fBeol\fR\fR .ad .RS 16n -.rt (str) The set of characters which indicate an end-of-line. \fBtip\fR will recognize escape characters only after an end-of-line. If the \fBel\fR capability is present, \fBeol\fR is initially set to the value of that @@ -515,12 +467,10 @@ capability. Otherwise, \fBeol\fR is set to a null string (\fB""\fR). .sp .ne 2 -.mk .na \fB\fBescape\fR\fR .ad .RS 16n -.rt (char) The command prefix (escape) character; abbreviated \fBes\fR. If the \fBes\fR capability is present, \fBescape\fR is initially set to the value of that capability. Otherwise, \fBescape\fR is set to `\fB\|~\|\fR\&'. @@ -528,12 +478,10 @@ that capability. Otherwise, \fBescape\fR is set to `\fB\|~\|\fR\&'. .sp .ne 2 -.mk .na \fB\fBetimeout\fR\fR .ad .RS 16n -.rt (num) The amount of time, in seconds, that \fBtip\fR should wait for the echo-check response when \fBechocheck\fR is set; abbreviated \fBet\fR. If the \fBet\fR capability is present, \fBetimeout\fR is initially set to the value of @@ -542,12 +490,10 @@ that capability. Otherwise, \fBetimeout\fR is set to 10 seconds. .sp .ne 2 -.mk .na \fB\fBexceptions\fR\fR .ad .RS 16n -.rt (str) The set of characters which should not be discarded due to the beautification switch; abbreviated \fBex\fR. If the \fBex\fR capability is present, \fBexceptions\fR is initially set to the value of that capability. @@ -556,12 +502,10 @@ Otherwise, \fBexceptions\fR is set to `\fB\et\en\ef\eb\fR\&'. .sp .ne 2 -.mk .na \fB\fBforce\fR\fR .ad .RS 16n -.rt (char) The character used to force literal data transmission; abbreviated \fBfo\fR. If the \fBfo\fR capability is present, \fBforce\fR is initially set to the value of that capability. Otherwise, \fBforce\fR is set to \fB\e377\fR @@ -570,12 +514,10 @@ to the value of that capability. Otherwise, \fBforce\fR is set to \fB\e377\fR .sp .ne 2 -.mk .na \fB\fBframesize\fR\fR .ad .RS 16n -.rt (num) The amount of data (in bytes) to buffer between file system writes when receiving files; abbreviated \fBfr\fR. If the \fBfs\fR capability is present, \fBframesize\fR is initially set to the value of that capability. Otherwise, @@ -584,12 +526,10 @@ receiving files; abbreviated \fBfr\fR. If the \fBfs\fR capability is present, .sp .ne 2 -.mk .na \fB\fBhalfduplex\fR\fR .ad .RS 16n -.rt (bool) Do local echoing because the host is half-duplex; abbreviated \fBhdx\fR. If the \fBhd\fR capability is present, \fBhalfduplex\fR is initially set to \fBon\fR. Otherwise, \fBhalfduplex\fR is initially set to \fBoff\fR. @@ -597,12 +537,10 @@ If the \fBhd\fR capability is present, \fBhalfduplex\fR is initially set to .sp .ne 2 -.mk .na \fB\fBhardwareflow\fR\fR .ad .RS 16n -.rt (bool) Do hardware flow control; abbreviated \fBhf\fR. If the \fBhf\fR capability is present, \fBhardwareflow\fR is initially set to \fBon\fR. Otherwise, \fBhardwareflowcontrol\fR is initially set to \fBoff\fR. @@ -610,12 +548,10 @@ Otherwise, \fBhardwareflowcontrol\fR is initially set to \fBoff\fR. .sp .ne 2 -.mk .na \fB\fBhost\fR\fR .ad .RS 16n -.rt (str) The name of the host to which you are connected; abbreviated \fBho\fR. \fBhost\fR is permanently set to the name given on the command line or in the \fBHOST\fR environment variable. @@ -623,23 +559,19 @@ Otherwise, \fBhardwareflowcontrol\fR is initially set to \fBoff\fR. .sp .ne 2 -.mk .na \fB\fBlocalecho\fR\fR .ad .RS 16n -.rt (bool) A synonym for \fBhalfduplex\fR; abbreviated \fBle\fR. .RE .sp .ne 2 -.mk .na \fB\fBlog\fR\fR .ad .RS 16n -.rt (str) The name of the file to which to log information about outgoing phone calls. \fBlog\fR is initially set to \fB/var/adm/aculog\fR, and can only be inspected or changed by the super-user. @@ -647,17 +579,14 @@ inspected or changed by the super-user. .sp .ne 2 -.mk .na \fB\fBparity\fR\fR .ad .RS 16n -.rt (str) The parity to be generated and checked when talking to the remote host; abbreviated \fBpar\fR. The possible values are: .sp .ne 2 -.mk .na \fB\fBnone\fR>\fR .ad @@ -666,40 +595,33 @@ abbreviated \fBpar\fR. The possible values are: \fB\fBzero\fR\fR .ad .RS 9n -.rt Parity is not checked on input, and the parity bit is set to zero on output. .RE .sp .ne 2 -.mk .na \fB\fBone\fR\fR .ad .RS 9n -.rt Parity is not checked on input, and the parity bit is set to one on output. .RE .sp .ne 2 -.mk .na \fB\fBeven\fR\fR .ad .RS 9n -.rt Even parity is checked for on input and generated on output. .RE .sp .ne 2 -.mk .na \fB\fBodd\fR\fR .ad .RS 9n -.rt Odd parity is checked for on input and generated on output. .RE @@ -709,12 +631,10 @@ value of that capability; otherwise, \fBparity\fR is set to \fBnone\fR. .sp .ne 2 -.mk .na \fB\fBphones\fR\fR .ad .RS 16n -.rt The file in which to find hidden phone numbers. If the environment variable \fBPHONES\fR is set, \fBphones\fR is set to the value of \fBPHONES\fR. Otherwise, \fBphones\fR is set to \fB/etc/phones\fR. The value of \fBphones\fR @@ -723,12 +643,10 @@ cannot be changed from within \fBtip\fR. .sp .ne 2 -.mk .na \fB\fBprompt\fR\fR .ad .RS 16n -.rt (char) The character which indicates an end-of-line on the remote host; abbreviated \fBpr\fR. This value is used to synchronize during data transfers. The count of lines transferred during a file transfer command is based on @@ -739,12 +657,10 @@ set to \fB\en\fR\&. .sp .ne 2 -.mk .na \fB\fBraise\fR\fR .ad .RS 16n -.rt (bool) Upper case mapping mode; abbreviated \fBra\fR. When this mode is enabled, all lower case letters will be mapped to upper case by \fBtip\fR for transmission to the remote machine. If the \fBra\fR capability is present, @@ -754,12 +670,10 @@ set to \fBoff\fR. .sp .ne 2 -.mk .na \fB\fBraisechar\fR\fR .ad .RS 16n -.rt (char) The input character used to toggle upper case mapping mode; abbreviated \fBrc\fR. If the \fBrc\fR capability is present, \fBraisechar\fR is initially set to the value of that capability. Otherwise, \fBraisechar\fR is set to @@ -768,12 +682,10 @@ set to the value of that capability. Otherwise, \fBraisechar\fR is set to .sp .ne 2 -.mk .na \fB\fBrawftp\fR\fR .ad .RS 16n -.rt (bool) Send all characters during file transfers; do not filter non-printable characters, and do not do translations like \fB\en\fR to \fB\er\fR\&. Abbreviated \fBraw\fR. If the \fBrw\fR capability is present, \fBrawftp\fR is @@ -783,12 +695,10 @@ initially set to \fBon\fR. Otherwise, \fBrawftp\fR is initially set to .sp .ne 2 -.mk .na \fB\fBrecord\fR\fR .ad .RS 16n -.rt (str) The name of the file in which a session script is recorded; abbreviated \fBrec\fR. If the \fBre\fR capability is present, \fBrecord\fR is initially set to the value of that capability. Otherwise, \fBrecord\fR is set to @@ -797,12 +707,10 @@ to the value of that capability. Otherwise, \fBrecord\fR is set to .sp .ne 2 -.mk .na \fB\fBremote\fR\fR .ad .RS 16n -.rt The file in which to find descriptions of remote systems. If the environment variable \fBREMOTE\fR is set, \fBremote\fR is set to the value of \fBREMOTE\fR. Otherwise, \fBremote\fR is set to \fB/etc/remote\fR. The value of \fBremote\fR @@ -811,12 +719,10 @@ cannot be changed from within \fBtip\fR. .sp .ne 2 -.mk .na \fB\fBscript\fR\fR .ad .RS 16n -.rt (bool) Session scripting mode; abbreviated \fBsc\fR. When \fBscript\fR is \fBon\fR, \fBtip\fR will record everything transmitted by the remote machine in the script record file specified in \fBrecord\fR. If the \fBbeautify\fR switch @@ -829,12 +735,10 @@ rules. If the \fBsc\fR capability is present, \fBscript\fR is initially set to .sp .ne 2 -.mk .na \fB\fBtabexpand\fR\fR .ad .RS 16n -.rt (bool) Expand \fBTAB\fR characters to \fBSPACE\fR characters during file transfers; abbreviated \fBtab\fR. When \fBtabexpand\fR is \fBon\fR, each tab is expanded to eight SPACE characters. If the \fBtb\fR capability is present, @@ -844,12 +748,10 @@ initially set to \fBoff\fR. .sp .ne 2 -.mk .na \fB\fBtandem\fR\fR .ad .RS 16n -.rt (bool) Use \fBXON\fR/\fBXOFF\fR flow control to limit the rate that data is sent by the remote host; abbreviated \fBta\fR. If the \fBnt\fR capability is present, \fBtandem\fR is initially set to \fBoff\fR. Otherwise, \fBtandem\fR is @@ -858,12 +760,10 @@ initially set to \fBon\fR. .sp .ne 2 -.mk .na \fB\fBverbose\fR\fR .ad .RS 16n -.rt (bool) Verbose mode; abbreviated \fBverb\fR; When verbose mode is enabled, \fBtip\fR prints messages while dialing, shows the current number of lines transferred during a file transfer operations, and more. If the \fBnv\fR @@ -873,24 +773,20 @@ capability is present, \fBverbose\fR is initially set to \fBoff\fR. Otherwise, .sp .ne 2 -.mk .na \fB\fBSHELL\fR\fR .ad .RS 16n -.rt (str) The name of the shell to use for the \fB~!\fR command; default value is \fB/bin/sh\fR, or taken from the environment. .RE .sp .ne 2 -.mk .na \fB\fBHOME\fR\fR .ad .RS 16n -.rt (str) The home directory to use for the \fB~c\fR command. Default value is taken from the environment. .RE @@ -932,7 +828,7 @@ monet% ~|Local command: pr h sylvester.c | lpr List command for remote host: cat sylvester.c monet% ~^D [EOT] -\&...(back on the local system)... +\&...(back on the local system)... .fi .in -2 .sp @@ -943,112 +839,92 @@ monet% ~^D The following environment variables are read by \fBtip\fR. .sp .ne 2 -.mk .na \fB\fBREMOTE\fR\fR .ad .RS 10n -.rt The location of the \fBremote\fR file. .RE .sp .ne 2 -.mk .na \fB\fBPHONES\fR\fR .ad .RS 10n -.rt The location of the file containing private phone numbers. .RE .sp .ne 2 -.mk .na \fB\fBHOST\fR\fR .ad .RS 10n -.rt A default host to connect to. .RE .sp .ne 2 -.mk .na \fB\fBHOME\fR\fR .ad .RS 10n -.rt One's log-in directory (for chdirs). .RE .sp .ne 2 -.mk .na \fB\fBSHELL\fR\fR .ad .RS 10n -.rt The shell to fork on a `\fB~!\fR' escape. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB/etc/phones\fR\fR .ad .RS 29n -.rt .RE .sp .ne 2 -.mk .na \fB\fB/etc/remote\fR\fR .ad .RS 29n -.rt .RE .sp .ne 2 -.mk .na \fB\fB/var/spool/locks/LCK.\|.*\fR\fR .ad .RS 29n -.rt lock file to avoid conflicts with \fBUUCP\fR .RE .sp .ne 2 -.mk .na \fB\fB/var/adm/aculog\fR\fR .ad .RS 29n -.rt file in which outgoing calls are logged .RE .sp .ne 2 -.mk .na \fB\fB~/.tiprc\fR\fR .ad .RS 29n -.rt initialization file .RE diff --git a/usr/src/man/man1/tnfdump.1 b/usr/src/man/man1/tnfdump.1 index 8679dedb0e..5f594a98cc 100644 --- a/usr/src/man/man1/tnfdump.1 +++ b/usr/src/man/man1/tnfdump.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 tnfdump 1 "22 Jan 2001" "SunOS 5.11" "User Commands" +.TH TNFDUMP 1 "Jan 22, 2001" .SH NAME tnfdump \- convert binary TNF file to ASCII .SH SYNOPSIS @@ -26,12 +26,10 @@ only. It also orders the events by time. The following option is supported: .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 6n -.rt Does a raw conversion of \fBTNF\fR to \fBASCII\fR. The output is a literal transalation of the binary \fBTNF\fR file and includes all the records in the file. This output is useful only if you have a good understanding of @@ -40,12 +38,10 @@ file. This output is useful only if you have a good understanding of .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad .RS 6n -.rt Prints all \fBTNF\fR unsigned type argument values in hexadecimal format instead of decimal format. .RE @@ -309,8 +305,8 @@ probe tnf_name: "final" tnf_string: "keys cookie main final;file test17.c;line 32;sunw%debug in the final" ------------ ----------- ---- ----- --- --------- --------------------- Elapsed Delta PID LWPID TID CPU Probe Data/Description ... - (ms) (ms) Name ------------- ----------- ---- ----- --- --------- --------------------- + (ms) (ms) Name +------------ ----------- ---- ----- --- --------- --------------------- 0.000000 0.000000 6280 1 1 - start 2455.211311 2455.211311 6280 1 1 - inloop loop_count: 0x0 total_iterations: 0x0 diff --git a/usr/src/man/man1/tnfxtract.1 b/usr/src/man/man1/tnfxtract.1 index 107fd6f153..415c8e1fdf 100644 --- a/usr/src/man/man1/tnfxtract.1 +++ b/usr/src/man/man1/tnfxtract.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 tnfxtract 1 "19 Aug 2003" "SunOS 5.11" "User Commands" +.TH TNFXTRACT 1 "Aug 19, 2003" .SH NAME tnfxtract \- extract kernel probes output into a trace file .SH SYNOPSIS @@ -45,12 +45,10 @@ which will generate an \fBASCII\fR file. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-d\fR \fIdumpfile\fR\fR .ad .RS 15n -.rt Uses \fIdumpfile\fR as the system memory image, instead of the running kernel. The \fIdumpfile\fR is normally the path name of a file generated by the \fBsavecore\fR utility. @@ -58,12 +56,10 @@ The \fIdumpfile\fR is normally the path name of a file generated by the .sp .ne 2 -.mk .na \fB\fB-n\fR \fInamelist\fR\fR .ad .RS 15n -.rt Uses \fInamelist\fR as the file containing the symbol table information for the given \fIdumpfile\fR. .RE @@ -74,12 +70,10 @@ given \fIdumpfile\fR. The following operand is supported: .sp .ne 2 -.mk .na \fB\fItnf_file\fR\fR .ad .RS 12n -.rt Output file generated by \fBtnfxtract\fR based on kernel trace output from an in-core buffer in the Solaris kernel. .RE @@ -120,23 +114,19 @@ example% \fBtnfxtract -d /var/crash/`uname -n`/vmcore.0 \e The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE diff --git a/usr/src/man/man1/touch.1 b/usr/src/man/man1/touch.1 index 3498cb4b6c..087ef10a9e 100644 --- a/usr/src/man/man1/touch.1 +++ b/usr/src/man/man1/touch.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 touch 1 "9 Sep 2009" "SunOS 5.11" "User Commands" +.TH TOUCH 1 "Sep 9, 2009" .SH NAME touch, settime \- change file access and modification times .SH SYNOPSIS @@ -65,7 +65,6 @@ utilities: The following options are supported for the \fBtouch\fR utility: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad @@ -77,7 +76,6 @@ unless \fB-m\fR is also specified. .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad @@ -89,7 +87,6 @@ diagnostic messages concerning this condition. .sp .ne 2 -.mk .na \fB\fB-d\fR \fIdate_time\fR\fR .ad @@ -154,7 +151,6 @@ value of the \fBTZ\fR environment variable .sp .ne 2 -.mk .na \fB\fB-m\fR\fR .ad @@ -166,7 +162,6 @@ unless \fB-a\fR is also specified. .sp .ne 2 -.mk .na \fB\fB-r\fR \fIref_file\fR\fR .ad @@ -178,7 +173,6 @@ current time. .sp .ne 2 -.mk .na \fB\fB-t\fR \fItime\fR\fR .ad @@ -197,7 +191,6 @@ decimal number of the form: where each two digits represent the following: .sp .ne 2 -.mk .na \fB\fIMM\fR\fR .ad @@ -208,7 +201,6 @@ The month of the year [01-12]. .sp .ne 2 -.mk .na \fB\fIDD\fR\fR .ad @@ -219,7 +211,6 @@ The day of the month [01-31]. .sp .ne 2 -.mk .na \fB\fIhh\fR\fR .ad @@ -230,7 +221,6 @@ The hour of the day [00-23]. .sp .ne 2 -.mk .na \fB\fImm\fR\fR .ad @@ -241,7 +231,6 @@ The minute of the hour [00-59]. .sp .ne 2 -.mk .na \fB\fICC\fR\fR .ad @@ -252,7 +241,6 @@ The first two digits of the year. .sp .ne 2 -.mk .na \fB\fIYY\fR\fR .ad @@ -263,7 +251,6 @@ The second two digits of the year. .sp .ne 2 -.mk .na \fB\fISS\fR\fR .ad @@ -279,15 +266,14 @@ as follows: .sp .TS -tab() box; -cw(2.75i) cw(2.75i) -lw(2.75i) lw(2.75i) -. -If YY is:CC becomes: +box; +c c +l l . +If YY is: CC becomes: _ -69-9919 -00-3820 -39-68ERROR +69-99 19 +00-38 20 +39-68 ERROR .TE The resulting time is affected by the value of the \fBTZ\fR environment @@ -308,7 +294,6 @@ it is assumed to be 0. The following option is supported for the \fBsettime\fR utility: .sp .ne 2 -.mk .na \fB\fB-f\fR \fIref_file\fR\fR .ad @@ -325,7 +310,6 @@ The following operands are supported for the \fBtouch\fR and \fBsettime\fR utilities: .sp .ne 2 -.mk .na \fB\fIfile\fR\fR .ad @@ -336,7 +320,6 @@ A path name of a file whose times are to be modified. .sp .ne 2 -.mk .na \fB\fItime_spec\fR\fR .ad @@ -355,7 +338,6 @@ a decimal number of the form: where each two digits represent the following: .sp .ne 2 -.mk .na \fB\fIMM\fR\fR .ad @@ -366,7 +348,6 @@ The month of the year [01-12]. .sp .ne 2 -.mk .na \fB\fIDD\fR\fR .ad @@ -377,7 +358,6 @@ The day of the month [01-31]. .sp .ne 2 -.mk .na \fB\fIhh\fR\fR .ad @@ -388,7 +368,6 @@ The hour of the day [00-23]. .sp .ne 2 -.mk .na \fB\fImm\fR\fR .ad @@ -399,7 +378,6 @@ The minute of the hour [00-59]. .sp .ne 2 -.mk .na \fB\fIYY\fR\fR .ad @@ -415,14 +393,13 @@ The second two digits of the year. .sp .TS -tab() box; -cw(2.75i) cw(2.75i) -lw(2.75i) lw(2.75i) -. -YYCorresponding Year -69-991969-1999 -00-382000-2038 -39-68ERROR +box; +c c +l l . +YY Corresponding Year +69-99 1969-1999 +00-38 2000-2038 +39-68 ERROR .TE If no \fB-d\fR, \fB-r\fR, or \fB-t\fRoption is specified, at least two operands @@ -444,7 +421,6 @@ that affect the execution of \fBtouch\fR: \fBLANG\fR, \fBLC_ALL\fR, \fBLANG\fR, \fBLC_ALL\fR, \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and \fBNLSPATH\fR. .sp .ne 2 -.mk .na \fB\fBTZ\fR\fR .ad @@ -460,7 +436,6 @@ Determine the timezone to be used for interpreting the \fItime\fR or The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad @@ -472,7 +447,6 @@ made. .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad @@ -490,17 +464,16 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityCommitted +Interface Stability Committed _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .SH SEE ALSO diff --git a/usr/src/man/man1/tput.1 b/usr/src/man/man1/tput.1 index 5aed5f8452..973a35b088 100644 --- a/usr/src/man/man1/tput.1 +++ b/usr/src/man/man1/tput.1 @@ -1,13 +1,13 @@ '\" te .\" Copyright 1989 AT&T Copyright (c) 1992, X/Open Company Limited All Rights Reserved Portions Copyright (c) 1995, Sun Microsystems, Inc. All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 tput 1 "1 Feb 1995" "SunOS 5.11" "User Commands" +.TH TPUT 1 "Feb 1, 1995" .SH NAME tput \- initialize a terminal or query terminfo database .SH SYNOPSIS @@ -41,12 +41,10 @@ STATUS section. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-T\fR\fItype\fR \fR .ad .RS 11n -.rt Indicates the \fItype\fR of terminal. Normally this option is unnecessary, because the default is taken from the environment variable \fBTERM\fR. If \fB-T\fR is specified, then the shell variables \fBLINES\fR and \fBCOLUMNS\fR @@ -55,12 +53,10 @@ and the layer size will not be referenced. .sp .ne 2 -.mk .na \fB\fB-S\fR \fR .ad .RS 11n -.rt Allows more than one capability per invocation of \fBtput\fR. The capabilities must be passed to \fBtput\fR from the standard input instead of from the command line (see the example in the EXAMPLES section). Only one \fIcapname\fR @@ -74,12 +70,10 @@ is allowed per line. The \fB-S\fR option changes the meaning of the \fB0\fR and The following operands are supported: .sp .ne 2 -.mk .na \fB\fIcapname\fR \fR .ad .RS 12n -.rt Indicates the capability attribute from the \fBterminfo\fR database. See \fBterminfo\fR(4) for a complete list of capabilities and the \fIcapname\fR associated with each. @@ -88,23 +82,19 @@ The following strings will be supported as operands by the implementation in the "C" locale: .sp .ne 2 -.mk .na \fB\fBclear\fR \fR .ad .RS 13n -.rt Display the clear-screen sequence. .RE .sp .ne 2 -.mk .na \fB\fBinit\fR \fR .ad .RS 13n -.rt If the \fBterminfo\fR database is present and an entry for the user's terminal exists (see \fB-T\fR\fItype\fR, above), the following will occur: .RS +4 @@ -136,12 +126,10 @@ activities, that activity will silently be skipped. .sp .ne 2 -.mk .na \fB\fBreset\fR \fR .ad .RS 13n -.rt Instead of putting out initialization strings, the terminal's reset strings will be output if present (\fBrs1\fR, \fBrs2\fR, \fBrs3\fR, \fBrf\fR). If the reset strings are not present, but initialization strings are, the @@ -151,12 +139,10 @@ to \fBinit\fR. .sp .ne 2 -.mk .na \fB\fBlongname\fR \fR .ad .RS 13n -.rt If the \fBterminfo\fR database is present and an entry for the user's terminal exists (see \fB-T\fR\fItype\fR above), then the long name of the terminal will be put out. The long name is the last name in the first line of the terminal's @@ -167,12 +153,10 @@ description in the \fBterminfo\fR database (see \fBterm\fR(5)). .sp .ne 2 -.mk .na \fB\fIparm\fR \fR .ad .RS 12n -.rt If the attribute is a string that takes parameters, the argument \fIparm\fR will be instantiated into the string. An all numeric argument will be passed to the attribute as a number. @@ -291,7 +275,7 @@ terminal. This might be followed by a prompt: .sp .in +2 .nf -\fBecho "${bold}Please type in your name: ${offbold}\ec"\fR +\fBecho "${bold}Please type in your name: ${offbold}\ec"\fR example% \fBbold='tput smso'\fR example% \fBoffbold='tput rmso'\fR .fi @@ -340,10 +324,10 @@ terminated by an exclamation mark (\fB!\fR) on a line by itself. .sp .in +2 .nf -example% \fBtput -S <<! -> clear +example% \fBtput -S <<! +> clear > cup 10 10 -> bold +> bold > !\fR .fi .in -2 @@ -357,12 +341,10 @@ that affect the execution of \fBtput\fR: \fBLANG\fR, \fBLC_ALL\fR, \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and \fBNLSPATH\fR. .sp .ne 2 -.mk .na \fB\fBTERM\fR \fR .ad .RS 9n -.rt Determine the terminal type. If this variable is unset or null, and if the \fB-T\fR option is not specified, an unspecified default terminal type will be used. @@ -374,12 +356,10 @@ used. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR \fR .ad .RS 10n -.rt .RS +4 .TP .ie t \(bu @@ -417,12 +397,10 @@ The requested string was written successfully. .sp .ne 2 -.mk .na \fB\fB1\fR \fR .ad .RS 10n -.rt .RS +4 .TP .ie t \(bu @@ -441,56 +419,46 @@ that \fIcapname\fR is not defined for this terminal type. .sp .ne 2 -.mk .na \fB\fB2\fR \fR .ad .RS 10n -.rt Usage error. .RE .sp .ne 2 -.mk .na \fB\fB3\fR \fR .ad .RS 10n -.rt No information is available about the specified terminal type. .RE .sp .ne 2 -.mk .na \fB\fB4\fR \fR .ad .RS 10n -.rt The specified operand is invalid. .RE .sp .ne 2 -.mk .na \fB\fB>4\fR \fR .ad .RS 10n -.rt An error occurred. .RE .sp .ne 2 -.mk .na \fB\fB\(mi1\fR \fR .ad .RS 10n -.rt \fIcapname\fR is a numeric variable that is not specified in the \fBterminfo\fR database. For instance, \fBtput\fR \fB-T450\fR lines and \fBtput\fR \fB-T2621\fR xmc. @@ -499,7 +467,6 @@ database. For instance, \fBtput\fR \fB-T450\fR lines and \fBtput\fR .SH FILES .sp .ne 2 -.mk .na \fB\fB/usr/include/curses.h\fR \fR .ad @@ -510,7 +477,6 @@ database. For instance, \fBtput\fR \fB-T450\fR lines and \fBtput\fR .sp .ne 2 -.mk .na \fB\fB/usr/include/term.h\fR \fR .ad @@ -521,7 +487,6 @@ database. For instance, \fBtput\fR \fB-T450\fR lines and \fBtput\fR .sp .ne 2 -.mk .na \fB\fB/usr/lib/tabset/*\fR \fR .ad @@ -534,7 +499,6 @@ see the "Tabs and Initialization" section of \fBterminfo\fR(4) .sp .ne 2 -.mk .na \fB\fB/usr/share/lib/terminfo/?/*\fR \fR .ad @@ -551,13 +515,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man1/tr.1 b/usr/src/man/man1/tr.1 index 84076272a8..e9b58da3e8 100644 --- a/usr/src/man/man1/tr.1 +++ b/usr/src/man/man1/tr.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 tr 1 "3 Mar 2009" "SunOS 5.11" "User Commands" +.TH TR 1 "Mar 3, 2009" .SH NAME tr \- translate characters .SH SYNOPSIS @@ -66,46 +66,38 @@ copying characters and single-character collating elements. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad .RS 6n -.rt Complements the set of values specified by \fIstring1\fR. .RE .sp .ne 2 -.mk .na \fB\fB-C\fR\fR .ad .RS 6n -.rt Complements the set of characters specified by \fIstring1\fR. .RE .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad .RS 6n -.rt Deletes all occurrences of input characters that are specified by \fIstring1\fR. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 6n -.rt Replaces instances of repeated characters with a single character. .RE @@ -222,7 +214,6 @@ results. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIstring1\fR\fR .ad @@ -231,7 +222,6 @@ The following operands are supported: \fB\fIstring2\fR\fR .ad .RS 11n -.rt Translation control strings. Each string represents a set of characters to be converted into an array of characters used for the translation. .RE @@ -245,23 +235,19 @@ result in multi-character collating elements, \fBtr\fR excludes, without a diagnostic, those multi-character elements from the resulting array. .sp .ne 2 -.mk .na \fB\fIcharacter\fR\fR .ad .RS 15n -.rt Any character not described by one of the conventions below represents itself. .RE .sp .ne 2 -.mk .na \fB\fB\e\fR\fIoctal\fR\fR .ad .RS 15n -.rt Octal sequences can be used to represent characters with specific coded values. An octal sequence consists of a backslash followed by the longest sequence of one-, two-, or three-octal-digit characters (01234567). The sequence causes the @@ -273,12 +259,10 @@ byte. .sp .ne 2 -.mk .na \fB\fB\e\fR\fIcharacter\fR\fR .ad .RS 15n -.rt The backslash-escape sequences \fB\ea\fR, \fB\eb\fR, \fB\ef\fR, \fB\en\fR, \fB\er\fR, \fB\et\fR, and \fB\ev\fR are supported. The results of using any other character, other than an octal digit, following the backslash are @@ -288,24 +272,20 @@ unspecified. .SS "/usr/xpg4/bin/tr" .sp .ne 2 -.mk .na \fB\fIc-c\fR\fR .ad .RS 7n -.rt - + .RE .SS "/usr/bin/tr" .sp .ne 2 -.mk .na \fB[\fIc-c\fR]\fR .ad .RS 13n -.rt In the POSIX locale, this construct represents the range of collating elements between the range endpoints (as long as neither endpoint is an octal sequence of the form \fB\e\fR\fIoctal\fR), inclusively, as defined by the collation @@ -323,12 +303,10 @@ between two range endpoints, inclusively. .sp .ne 2 -.mk .na \fB\fB[:\fR\fIclass\fR\fB:]\fR\fR .ad .RS 13n -.rt Represents all characters belonging to the defined character class, as defined by the current setting of the \fBLC_CTYPE\fR locale category. The following character class names are accepted when specified in \fIstring1\fR: @@ -369,12 +347,10 @@ in the current locale, the behavior is undefined. .sp .ne 2 -.mk .na \fB\fB[=\fR\fIequiv\fR\fB=]\fR\fR .ad .RS 13n -.rt Represents all characters or collating elements belonging to the same equivalence class as \fIequiv\fR, as defined by the current setting of the \fBLC_COLLATE\fR locale category. An equivalence class expression is allowed @@ -385,12 +361,10 @@ equivalence class are placed in the array in an unspecified order. .sp .ne 2 -.mk .na \fB[\fIx*n\fR]\fR .ad .RS 13n -.rt Represents \fIn\fR repeated occurrences of the character \fIx\fR. Because this expression is used to map multiple characters to one, it is only valid when it occurs in \fIstring2\fR. If \fIn\fR has a leading \fB0\fR, it is interpreted @@ -473,23 +447,19 @@ that affect the execution of \fBtr\fR: \fBLANG\fR, \fBLC_ALL\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt All input was processed successfully. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -502,13 +472,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled .TE .SS "/usr/xpg4/bin/tr" @@ -516,17 +485,16 @@ CSIEnabled .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityCommitted +Interface Stability Committed _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .SS "/usr/xpg6/bin/tr" @@ -534,17 +502,16 @@ StandardSee \fBstandards\fR(5). .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityCommitted +Interface Stability Committed _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .SH SEE ALSO diff --git a/usr/src/man/man1/trap.1 b/usr/src/man/man1/trap.1 index 1ef0702417..86d32516de 100644 --- a/usr/src/man/man1/trap.1 +++ b/usr/src/man/man1/trap.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 trap 1 "20 Nov 2007" "SunOS 5.11" "User Commands" +.TH TRAP 1 "Nov 20, 2007" .SH NAME trap, onintr \- shell built-in functions to respond to (hardware) signals .SH SYNOPSIS @@ -124,12 +124,10 @@ altered by the trap execution. \fIcondition\fR can be the name or number of a signal, or one of the following: .sp .ne 2 -.mk .na \fB\fBEXIT\fR\fR .ad .RS 9n -.rt Execute this trap when the shell exits. If defined within a function with the \fBfunction\fR reserved word, executes the trap in the caller's environment when the function returns. The trap action is restored to the value it had when @@ -138,46 +136,38 @@ it called the function. .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 9n -.rt Same as \fBEXIT\fR. .RE .sp .ne 2 -.mk .na \fB\fBDEBUG\fR\fR .ad .RS 9n -.rt Execute before each simple command is executed but after the arguments are expanded. .RE .sp .ne 2 -.mk .na \fB\fBERR\fR\fR .ad .RS 9n -.rt Execute whenever \fBset -e\fR would cause the shell to exit. .RE .sp .ne 2 -.mk .na \fB\fBKEYBD\fR\fR .ad .RS 9n -.rt Execute when a key is entered from a terminal device. .RE @@ -202,12 +192,10 @@ The following options are supported by the \fBtrap\fR built-in command in \fBksh93\fR: .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 6n -.rt Causes the current traps to be output in a format that can be processed as input to the shell to recreate the current traps. .RE @@ -217,23 +205,19 @@ input to the shell to recreate the current traps. The trap built-in in \fBksh93\fR exits with one of the following values: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE diff --git a/usr/src/man/man1/troff.1 b/usr/src/man/man1/troff.1 index bd3bba6d23..cf8863409d 100644 --- a/usr/src/man/man1/troff.1 +++ b/usr/src/man/man1/troff.1 @@ -3,13 +3,13 @@ .\" 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 troff 1 "24 Aug 2009" "SunOS 5.11" "User Commands" +.TH TROFF 1 "Aug 24, 2009" .SH NAME troff \- typeset or format documents .SH SYNOPSIS .LP .nf -\fBtroff\fR [\fB-a\fR] [\fB-f\fR] [\fB-F\fR\fIdir\fR] [\fB-i\fR] [\fB-m\fR\fIname\fR] [\fB-n\fR\fIN\fR] [\fB-o\fR\fIlist\fR] [\fB-r\fR\fIaN\fR] +\fBtroff\fR [\fB-a\fR] [\fB-f\fR] [\fB-F\fR\fIdir\fR] [\fB-i\fR] [\fB-m\fR\fIname\fR] [\fB-n\fR\fIN\fR] [\fB-o\fR\fIlist\fR] [\fB-r\fR\fIaN\fR] [\fB-s\fR\fIN\fR] [\fB-T\fR\fIdest\fR] [\fB-u\fR\fIN\fR] [\fB-z\fR] [\fIfilename\fR]... .fi @@ -33,12 +33,10 @@ The following options are supported. They may appear in any order, but all must appear before the first \fIfilename\fR. .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 10n -.rt Send an \fBASCII\fR approximation of formatted output to standard output. (Note: a rough \fBASCII\fR version can also be printed out on ordinary terminals with an old and rarely used command, \fB/usr/bin/ta\fR.) @@ -46,47 +44,39 @@ terminals with an old and rarely used command, \fB/usr/bin/ta\fR.) .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 10n -.rt Do not print a trailer after the final page of output or cause the postprocessor to relinquish control of the device. .RE .sp .ne 2 -.mk .na \fB\fB-F\fR\fIdir\fR\fR .ad .RS 10n -.rt Search directory \fIdir\fR for font width or terminal tables instead of the system default directory. .RE .sp .ne 2 -.mk .na \fB\fB-i\fR\fR .ad .RS 10n -.rt Read standard input after all input files are exhausted. .RE .sp .ne 2 -.mk .na \fB\fB-m\fR\fIname\fR\fR .ad .RS 10n -.rt Prepend the macro file \fB/usr/share/lib/tmac/\fR\fIname\fR to the input \fIfilename\fRs. Note: most references to macro packages include the leading \fIm\fR as part of the name; for example, the \fBman\fR(5) macros reside in @@ -97,23 +87,19 @@ the trailing '\|/\|' (slash) at the end of the path. .sp .ne 2 -.mk .na \fB\fB-n\fR\fIN\fR\fR .ad .RS 10n -.rt Number the first generated page \fIN\fR. .RE .sp .ne 2 -.mk .na \fB\fB-o\fR\fIlist\fR\fR .ad .RS 10n -.rt Print only pages whose page numbers appear in the comma-separated \fIlist\fR of numbers and ranges. A range \fIN\fR\fB\(mi\fR\fIM\fR means pages \fIN\fR through \fIM\fR; an initial \fB\(mi\fR\fIN\fR means from the beginning to page @@ -122,34 +108,28 @@ through \fIM\fR; an initial \fB\(mi\fR\fIN\fR means from the beginning to page .sp .ne 2 -.mk .na \fB\fB-q\fR\fR .ad .RS 10n -.rt Quiet mode in \fBnroff\fR; ignored in \fBtroff\fR. .RE .sp .ne 2 -.mk .na \fB\fB-r\fR\fIaN\fR\fR .ad .RS 10n -.rt Set register \fIa\fR (one-character names only) to \fIN\fR. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fIN\fR\fR .ad .RS 10n -.rt Stop the phototypesetter every \fIN\fR pages. On some devices, \fBtroff\fR produces a trailer so you can change cassettes; resume by pressing the typesetter's start button. @@ -157,22 +137,18 @@ typesetter's start button. .sp .ne 2 -.mk .na \fB\fB-T\fR\fIdest\fR\fR .ad .RS 10n -.rt Prepare output for typesetter \fIdest\fR. The following values can be supplied for \fIdest\fR: .sp .ne 2 -.mk .na \fB\fBpost\fR\fR .ad .RS 8n -.rt A PostScript printer; this is the default value. The output of the \fB-T\fR option must go through \fBdpost\fR(1) before it is sent to a PostScript printer to obtain the proper output. @@ -182,24 +158,20 @@ to obtain the proper output. .sp .ne 2 -.mk .na \fB\fB-u\fR\fIN\fR\fR .ad .RS 10n -.rt Set the emboldening factor for the font mounted in position 3 to \fIN\fR. If \fIN\fR is missing, then set the emboldening factor to 0. .RE .sp .ne 2 -.mk .na \fB\fB-z\fR\fR .ad .RS 10n -.rt Suppress formatted output. Only diagnostic messages and messages output using the \fB\&.tm\fR request are output. .RE @@ -210,12 +182,10 @@ the \fB\&.tm\fR request are output. The following operand is supported: .sp .ne 2 -.mk .na \fB\fIfilename\fR\fR .ad .RS 12n -.rt The file containing text to be processed by \fBtroff\fR. .RE @@ -240,45 +210,37 @@ tbl mytext | eqn | troff -ms | dpost | lp .SH FILES .sp .ne 2 -.mk .na \fB\fB/tmp/trtmp\fR\fR .ad .RS 26n -.rt temporary file .RE .sp .ne 2 -.mk .na \fB\fB/usr/share/lib/tmac/*\fR\fR .ad .RS 26n -.rt standard macro files .RE .sp .ne 2 -.mk .na \fB\fB/usr/lib/font/*\fR\fR .ad .RS 26n -.rt font width tables for alternate mounted \fBtroff\fR fonts .RE .sp .ne 2 -.mk .na \fB\fB/usr/share/lib/nterm/*\fR\fR .ad .RS 26n -.rt terminal driving tables for \fBnroff\fR .RE diff --git a/usr/src/man/man1/true.1 b/usr/src/man/man1/true.1 index 730bfb4ca8..f3e56a0b75 100644 --- a/usr/src/man/man1/true.1 +++ b/usr/src/man/man1/true.1 @@ -1,24 +1,24 @@ '\" te .\" Copyright 1989 AT&T Copyright (c) 1995, Sun Microsystems, Inc. All Rights Reserved Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 true 1 "1 Feb 1995" "SunOS 5.11" "User Commands" +.TH TRUE 1 "Feb 1, 1995" .SH NAME true, false \- provide truth values .SH SYNOPSIS .LP .nf -\fBtrue\fR +\fBtrue\fR .fi .LP .nf -\fBfalse\fR +\fBfalse\fR .fi .SH DESCRIPTION @@ -54,13 +54,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man1/truss.1 b/usr/src/man/man1/truss.1 index d01e4ff74c..dffd1f61ad 100644 --- a/usr/src/man/man1/truss.1 +++ b/usr/src/man/man1/truss.1 @@ -4,16 +4,16 @@ .\" 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 truss 1 "31 Jul 2004" "SunOS 5.11" "User Commands" +.TH TRUSS 1 "Jul 31, 2004" .SH NAME truss \- trace system calls and signals .SH SYNOPSIS .LP .nf -\fBtruss\fR [\fB-fcaeildDE\fR] [\fB-\fR [tTvx] [!] \fIsyscall\fR ,...] - [\fB-\fR [sS] [!] \fIsignal\fR ,...] [\fB-\fR [mM] [!] \fIfault\fR ,...] - [\fB-\fR [rw] [!] \fIfd\fR ,...] - [\fB-\fR [uU] [!] \fIlib\fR ,... : [:] [!] \fIfunc\fR ,...] +\fBtruss\fR [\fB-fcaeildDE\fR] [\fB-\fR [tTvx] [!] \fIsyscall\fR ,...] + [\fB-\fR [sS] [!] \fIsignal\fR ,...] [\fB-\fR [mM] [!] \fIfault\fR ,...] + [\fB-\fR [rw] [!] \fIfd\fR ,...] + [\fB-\fR [uU] [!] \fIlib\fR ,... : [:] [!] \fIfunc\fR ,...] [\fB-o\fR \fIoutfile\fR] \fIcommand\fR | \fB-p\fR \fIpid\fR[\fI/lwps\fR]... .fi @@ -49,7 +49,6 @@ previous ones (those to the left). The following options are supported: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad @@ -60,7 +59,6 @@ Shows the argument strings that are passed in each \fBexec()\fR system call. .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad @@ -75,7 +73,6 @@ processes. .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad @@ -94,7 +91,6 @@ system call. .sp .ne 2 -.mk .na \fB\fB-D\fR\fR .ad @@ -109,7 +105,6 @@ time spent within the system call. .sp .ne 2 -.mk .na \fB\fB-e\fR\fR .ad @@ -120,7 +115,6 @@ Shows the environment strings that are passed in each \fBexec()\fR system call. .sp .ne 2 -.mk .na \fB\fB-E\fR\fR .ad @@ -136,7 +130,6 @@ the system call. .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad @@ -151,7 +144,6 @@ executed the system call or received the signal. .sp .ne 2 -.mk .na \fB\fB-i\fR\fR .ad @@ -167,7 +159,6 @@ option causes such system calls to be reported only once, when they complete. .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad @@ -180,7 +171,6 @@ the LWP-id are included. .sp .ne 2 -.mk .na \fB\fB-m\fR [\fB!\fR]\fIfault\fR,...\fR .ad @@ -195,7 +185,6 @@ are excluded from the trace output. Default is \fB-mall\fR \fB-m\fR .sp .ne 2 -.mk .na \fB\fB-M\fR [\fB!\fR]\fIfault\fR,...\fR .ad @@ -209,7 +198,6 @@ leaves the process stopped and abandoned (see the \fB-T\fR option). Default is .sp .ne 2 -.mk .na \fB\fB-o\fR \fIoutfile\fR\fR .ad @@ -221,7 +209,6 @@ error. .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad @@ -241,7 +228,6 @@ also be specified by their names in the \fB/proc\fR directory, for example, .sp .ne 2 -.mk .na \fB\fB-r\fR [\fB!\fR]\fIfd\fR,...\fR .ad @@ -260,7 +246,6 @@ are shown even in the absence of \fB-r\fR.) Default is .sp .ne 2 -.mk .na \fB\fB-s\fR [\fB!\fR]\fIsignal\fR,...\fR .ad @@ -276,7 +261,6 @@ signals are excluded from the trace output. Default is \fB-sall\fR. .sp .ne 2 -.mk .na \fB\fB-S\fR [\fB!\fR]\fIsignal\fR,...\fR .ad @@ -290,7 +274,6 @@ leaves the process stopped and abandoned (see the \fB-T\fR option). Default is .sp .ne 2 -.mk .na \fB\fB-t\fR [\fB!\fR]\fIsyscall\fR,...\fR .ad @@ -304,7 +287,6 @@ specified system calls are excluded from the trace output. Default is .sp .ne 2 -.mk .na \fB\fB-T\fR [\fB!\fR]\fIsyscall\fR,...\fR .ad @@ -328,7 +310,6 @@ can be used to set the stopped process running again. .sp .ne 2 -.mk .na \fB\fB-u\fR [\fB!\fR]\fIlib\fR,...\fB:\fR[\fB:\fR][\fB!\fR]\fIfunc\fR,\|.\|.\|.\fR @@ -376,7 +357,6 @@ it has not been stripped. .sp .ne 2 -.mk .na \fB\fB-U\fR [\fB!\fR]\fIlib\fR,\|.\|.\|.\|\fB:\fR[\fB:\fR][\fB!\fR]\fIfunc\fR,\|.\|.\|.\fR @@ -391,7 +371,6 @@ option). .sp .ne 2 -.mk .na \fB\fB-v\fR [\fB!\fR]\fIsyscall\fR,...\fR .ad @@ -406,7 +385,6 @@ and output, only the output value is shown. Default is .sp .ne 2 -.mk .na \fB\fB-w\fR [\fB!\fR]\fIfd\fR,...\fR .ad @@ -419,7 +397,6 @@ specified file descriptors (see the \fB-r\fR option). Default is .sp .ne 2 -.mk .na \fB\fB-x\fR [\fB!\fR]\fIsyscall\fR,...\fR .ad @@ -477,7 +454,7 @@ system calls: .sp .in +2 .nf -example$ \fBtruss -t open,close,read,write find . -print >find.out\fR +example$ \fBtruss -t open,close,read,write find . -print >find.out\fR .fi .in -2 .sp @@ -512,7 +489,7 @@ The following example abreviates output: .sp .in +2 .nf -example$ \fBtruss nroff -mm \fIdocument\fR >nroff.out\fR +example$ \fBtruss nroff -mm \fIdocument\fR >nroff.out\fR .fi .in -2 .sp @@ -525,7 +502,7 @@ because 97% of the output reports \fBlseek()\fR, \fBread()\fR, and .sp .in +2 .nf -example$ \fBtruss -t !lseek,read,write nroff -mm \fIdocument\fR >nroff.out\fR +example$ \fBtruss -t !lseek,read,write nroff -mm \fIdocument\fR >nroff.out\fR .fi .in -2 .sp @@ -627,12 +604,10 @@ Interrupting \fBtruss\fR returns \fBinit\fR to normal operation. .SH FILES .sp .ne 2 -.mk .na \fB\fB/proc/*\fR\fR .ad .RS 11n -.rt Process files .RE diff --git a/usr/src/man/man1/tsort.1 b/usr/src/man/man1/tsort.1 index 385543d7bb..f45f720e1e 100644 --- a/usr/src/man/man1/tsort.1 +++ b/usr/src/man/man1/tsort.1 @@ -1,13 +1,13 @@ '\" te .\" Copyright 1989 AT&T Copyright (c) 1992, X/Open Company Limited All Rights Reserved Portions Copyright (c) 1995, Sun Microsystems, Inc. All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 tsort 1 "28 Jun 2007" "SunOS 5.11" "User Commands" +.TH TSORT 1 "Jun 28, 2007" .SH NAME tsort \- topological sort .SH SYNOPSIS @@ -33,12 +33,10 @@ presence, but not ordering. The following operand is supported: .sp .ne 2 -.mk .na \fB\fIfile\fR\fR .ad .RS 8n -.rt A path name of a text file to order. If no \fIfile\fR operand is given, the standard input is used. .RE @@ -92,23 +90,19 @@ that affect the execution of \fBtsort\fR: \fBLANG\fR, \fBLC_ALL\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -120,13 +114,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man1/tty.1 b/usr/src/man/man1/tty.1 index eec95949c7..4a72947eef 100644 --- a/usr/src/man/man1/tty.1 +++ b/usr/src/man/man1/tty.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 tty 1 "11 Aug 2009" "SunOS 5.11" "User Commands" +.TH TTY 1 "Aug 11, 2009" .SH NAME tty \- return user's terminal name .SH SYNOPSIS @@ -45,24 +45,20 @@ The following options are supported: .SS "/usr/bin/tty" .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 6n -.rt Prints the synchronous line number to which the user's terminal is connected, if it is on an active synchronous line. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 6n -.rt Inhibits printing of the terminal path name, allowing one to test just the exit status. .RE @@ -70,7 +66,6 @@ status. .SS "ksh93" .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad @@ -79,7 +74,6 @@ status. \fB\fB--line-number\fR\fR .ad .RS 18n -.rt Write the synchronous line number of the terminal on a separate line following the terminal name line. If the standard input is not a synchronous terminal then "not on an active synchronous line" is written. @@ -87,7 +81,6 @@ then "not on an active synchronous line" is written. .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad @@ -96,7 +89,6 @@ then "not on an active synchronous line" is written. \fB\fB--silent\fR|\fBquiet\fR\fR .ad .RS 18n -.rt Disable the terminal name line. Portable applications should use [[ -t 0 ]] instead. .RE @@ -113,34 +105,28 @@ that affect the execution of \fBtty\fR: \fBLANG\fR, \fBLC_ALL\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Standard input is a terminal. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 6n -.rt Standard input is not a terminal. .RE .sp .ne 2 -.mk .na \fB\fB>1\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -152,17 +138,16 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityCommitted +Interface Stability Committed _ -Standard\fBstandards\fR(5). +Standard \fBstandards\fR(5). .TE .SH SEE ALSO @@ -173,7 +158,6 @@ Standard\fBstandards\fR(5). .SH DIAGNOSTICS .sp .ne 2 -.mk .na \fB\fBnot on an active synchronous line\fR\fR .ad @@ -184,7 +168,6 @@ The standard input is not a synchronous terminal and \fB-l\fR is specified. .sp .ne 2 -.mk .na \fB\fBnot a tty\fR\fR .ad diff --git a/usr/src/man/man1/type.1 b/usr/src/man/man1/type.1 index 6a23b4f36e..f30daca4bd 100644 --- a/usr/src/man/man1/type.1 +++ b/usr/src/man/man1/type.1 @@ -1,13 +1,13 @@ '\" te .\" Copyright (c) 1995, Sun Microsystems, Inc. All Rights Reserved Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 type 1 "1 Feb 1995" "SunOS 5.11" "User Commands" +.TH TYPE 1 "Feb 1, 1995" .SH NAME type \- write a description of command type .SH SYNOPSIS @@ -33,12 +33,10 @@ There is also a shell built-in version of \fBtype\fR that is similar to the The following operand is supported: .sp .ne 2 -.mk .na \fB\fIname\fR \fR .ad .RS 9n -.rt A name to be interpreted. .RE @@ -50,12 +48,10 @@ that affect the execution of \fBtype\fR: \fBLANG\fR, \fBLC_ALL\fR, \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and \fBNLSPATH\fR. .sp .ne 2 -.mk .na \fB\fBPATH\fR \fR .ad .RS 9n -.rt Determine the location of \fIname\fR. .RE @@ -65,23 +61,19 @@ Determine the location of \fIname\fR. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR \fR .ad .RS 7n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR \fR .ad .RS 7n -.rt An error occurred. .RE @@ -93,13 +85,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man1/typeset.1 b/usr/src/man/man1/typeset.1 index bdf977c3fd..9fdacf82c8 100644 --- a/usr/src/man/man1/typeset.1 +++ b/usr/src/man/man1/typeset.1 @@ -2,7 +2,7 @@ .\" Copyright (c) 2009, Sun Microsystems, Inc. All Rights Reserved .\" Copyright 1989 AT&T Copyright .\" Portions Copyright (c) 1982-2007 AT&T Knowledge Ventures -.TH typeset 1 "11 Aug 2009" "SunOS 5.11" "User Commands" +.TH TYPESET 1 "Aug 11, 2009" .SH NAME typeset, whence \- shell built-in functions to set/get attributes and values for shell variables and functions @@ -39,12 +39,10 @@ restored when the function completes. The following list of attributes can be specified: .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 6n -.rt The names refer to function names rather than variable names. No assignments can be made and the only other valid flags are \fB-t\fR, \fB-u\fR and \fB-x\fR. The flag \fB-t\fR turns on execution tracing for this function. The flag @@ -56,23 +54,19 @@ effect across shell procedures invoked by name. .sp .ne 2 -.mk .na \fB\fB-H\fR\fR .ad .RS 6n -.rt This flag provides UNIX to hostname file mapping on non-UNIX machines. .RE .sp .ne 2 -.mk .na \fB\fB-i\fR\fR .ad .RS 6n -.rt Parameter is an integer. This makes arithmetic faster. If \fIn\fR is \fBnon-zero\fR it defines the output arithmetic base; otherwise, the first assignment determines the output base. @@ -80,24 +74,20 @@ assignment determines the output base. .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 6n -.rt All uppercase characters are converted to lowercase. The uppercase flag, \fB-u\fR is turned off. .RE .sp .ne 2 -.mk .na \fB\fB-L\fR\fR .ad .RS 6n -.rt Left justify and remove leading blanks from \fIvalue\fR. If \fIn\fR is \fBnon-zero\fR it defines the width of the field; otherwise, it is determined by the width of the value of first assignment. When the variable is assigned @@ -108,24 +98,20 @@ into the field. Leading zeros are removed if the \fB-Z\fR flag is also set. The .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 6n -.rt The specified \fIname\fRs are marked \fBreadonly\fR and these names cannot be changed by subsequent assignment. .RE .sp .ne 2 -.mk .na \fB\fB-R\fR\fR .ad .RS 6n -.rt Right justify and fill with leading blanks. If \fIn\fR is \fBnon-zero\fR it defines the width of the field, otherwise it is determined by the width of the value of first assignment. The field is left filled with blanks or truncated @@ -134,48 +120,40 @@ from the end if the variable is reassigned. The \fB-L\fR flag is turned off. .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad .RS 6n -.rt Tags the variables. Tags are user definable and have no special meaning to the shell. .RE .sp .ne 2 -.mk .na \fB\fB-u\fR\fR .ad .RS 6n -.rt All lowercase characters are converted to uppercase characters. The lowercase flag, \fB-l\fR is turned off. .RE .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad .RS 6n -.rt The specified \fIname\fRs are marked for automatic export to the \fBenvironment\fR of subsequently-executed commands. .RE .sp .ne 2 -.mk .na \fB\fB-Z\fR\fR .ad .RS 6n -.rt Right justify and fill with leading zeros if the first non-blank character is a digit and the \fB-L\fR flag has not been set. If \fIn\fR is \fBnon-zero\fR it defines the width of the field. Otherwise, it is determined by the width of the @@ -257,45 +235,37 @@ options \fB-L\fR, \fB-R\fR, and \fB-Z\fR. The following preset aliases are set by the shell: .sp .ne 2 -.mk .na \fB\fBfloat\fR\fR .ad .RS 13n -.rt \fBtypeset\fR \fB-E\fR .RE .sp .ne 2 -.mk .na \fB\fBfunctions\fR\fR .ad .RS 13n -.rt \fBtypeset\fR \fB-f\fR .RE .sp .ne 2 -.mk .na \fB\fBinteger\fR\fR .ad .RS 13n -.rt \fBtypeset\fR \fB-i\fR .RE .sp .ne 2 -.mk .na \fB\fBnameref\fR\fR .ad .RS 13n -.rt \fBtypeset\fR \fB-n\fR .RE @@ -324,35 +294,29 @@ The following options are supported by the \fBtypeset\fR built-in command in \fBksh93\fR: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 13n -.rt Indexed array. This is the default. .RE .sp .ne 2 -.mk .na \fB\fB-A\fR\fR .ad .RS 13n -.rt Associative array. Each \fIname\fR is converted to an associative array. If a variable already exists, the current value becomes index \fB0\fR. .RE .sp .ne 2 -.mk .na \fB\fB-b\fR\fR .ad .RS 13n -.rt Each name can contain binary data. Its value is the mime \fBbase64\fR encoding of the data. This option can be used with \fB-Z\fR, to specify fixed sized fields. @@ -360,23 +324,19 @@ fields. .sp .ne 2 -.mk .na \fB\fB-C\fR\fR .ad .RS 13n -.rt Reserved for future use. .RE .sp .ne 2 -.mk .na \fB\fB-E\fR [\fIn\fR]\fR .ad .RS 13n -.rt Floating point number represented in scientific notation. \fIn\fR specifies the number of significant figures when the value is expanded. The default value is \fB10\fR. @@ -384,46 +344,38 @@ number of significant figures when the value is expanded. The default value is .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 13n -.rt Each of the options and names refers to a function. .RE .sp .ne 2 -.mk .na \fB\fB-F\fR [\fIn\fR]\fR .ad .RS 13n -.rt Floating point. \fIn\fR is the number of places after the decimal point when the value is expanded. The default value is \fB10\fR. .RE .sp .ne 2 -.mk .na \fB\fB-h\fR\fR .ad .RS 13n -.rt Reserved for future use. .RE .sp .ne 2 -.mk .na \fB\fB-H\fR\fR .ad .RS 13n -.rt Hostname mapping. Each name holds a native pathname. Assigning a UNIX format pathname causes it to be converted to a pathname suitable for the current host. This has no effect when the native system is UNIX. @@ -431,36 +383,30 @@ This has no effect when the native system is UNIX. .sp .ne 2 -.mk .na \fB\fB-i\fR [\fIbase\fR]\fR .ad .RS 13n -.rt An integer. \fIbase\fR represents the arithmetic base from \fB2\fR to \fB64\fR. The option value can be omitted. The default value is \fB10\fR. .RE .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 13n -.rt Convert uppercase characters to lowercase characters. Unsets the \fB-u\fR option. When used with \fB-i\fR, \fB-E\fR, or \fB-F\fR indicates long variant. .RE .sp .ne 2 -.mk .na \fB\fB-L\fR [\fIn\fR]\fR .ad .RS 13n -.rt Left justify. If \fIn\fR is specified, it represents the field width. If the \fB-Z\fR attribute is also specified, then leading zeros are stripped. The option value can be omitted. @@ -468,48 +414,40 @@ option value can be omitted. .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 13n -.rt Name reference. The value is the name of a variable that \fIname\fR references. \fIname\fR cannot contain a \fB\&.\fR. .RE .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 13n -.rt Causes the output to be in a format that can be used as input to the shell to recreate the attributes for variables. .RE .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 13n -.rt Enables read-only. Once this option is enabled, it cannot be disabled. See \fBreadonly\fR(1). .RE .sp .ne 2 -.mk .na \fB\fB-R\fR [\fIn\fR]\fR .ad .RS 13n -.rt Right justify. If \fIn\fR is specified it represents the field width. If the \fB-Z\fR option is also specified, zeros are used as the fill character. Otherwise, SPACEs are used. @@ -517,35 +455,29 @@ Otherwise, SPACEs are used. .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 13n -.rt Restricts integer size to short when used with \fB-i\fR. .RE .sp .ne 2 -.mk .na \fB\fB-S\fR\fR .ad .RS 13n -.rt When used inside a function defined with the function reserved word, the specified variables will have function static scope. .RE .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad .RS 13n -.rt When used with \fB-f\fR, enables tracing for each of the specified functions. Otherwise, \fB-t\fR is a user defined attribute and has no meaning to the shell. @@ -553,23 +485,19 @@ shell. .sp .ne 2 -.mk .na \fB\fB-T\fR \fItname\fR\fR .ad .RS 13n -.rt \fItname\fR is the name of a type name given to each name. .RE .sp .ne 2 -.mk .na \fB\fB-u\fR\fR .ad .RS 13n -.rt Without \fB-f\fR or \fB-i\fR, converts lowercase characters to uppercase and unsets \fB-l\fR. When used with \fB-f\fR, specifies that \fIname\fR is a function that has not yet been loaded. When used with \fB-i\fR specifies that @@ -578,24 +506,20 @@ the value is displayed as an unsigned integer. .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad .RS 13n -.rt Puts each name on the export list. See \fBexport\fR(1). \fIname\fR cannot contain a \fB\&.\fR. .RE .sp .ne 2 -.mk .na \fB\fB-X\fR [\fIn\fR]\fR .ad .RS 13n -.rt Floating point number represented in hexadecimal notation. \fIn\fR specifies the number of significant figures when the value is expanded. The option value may be omitted. The default value is 10. @@ -603,12 +527,10 @@ may be omitted. The default value is 10. .sp .ne 2 -.mk .na \fB\fB-Z\fR [\fIn\fR]\fR .ad .RS 13n -.rt Zero fill. If \fIn\fR is specified it represents the field width. The option value can be omitted. .RE @@ -618,23 +540,19 @@ value can be omitted. The following exit values are returned by \fBtypeset\fR in \fBksh93\fR: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -655,46 +573,38 @@ The following options are supported by the \fBwhence\fR built-in command in \fBksh93\fR: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 6n -.rt Display all uses for each name rather than the first. .RE .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 6n -.rt Do not check for functions. .RE .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 6n -.rt Do not check to see if name is a reserved word, a built-in, an alias, or a function. .RE .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 6n -.rt For each name specified, the shell displays a line that indicates if that name is one of the following: .RS +4 @@ -752,34 +662,28 @@ Not found The following exit values are returned by \fBwhence\fR in \fBksh93\fR: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. Each name was found by the shell. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 6n -.rt One or more names were not found by the shell. .RE .sp .ne 2 -.mk .na \fB\fB>1\fR\fR .ad .RS 6n -.rt An error occurred. .RE diff --git a/usr/src/man/man1/ul.1 b/usr/src/man/man1/ul.1 index fc2a481914..261a19b20a 100644 --- a/usr/src/man/man1/ul.1 +++ b/usr/src/man/man1/ul.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 ul 1 "17 Mar 1994" "SunOS 5.11" "User Commands" +.TH UL 1 "Mar 17, 1994" .SH NAME ul \- do underlining .SH SYNOPSIS @@ -27,12 +27,10 @@ underline, underlining is ignored. .SH OPTIONS .sp .ne 2 -.mk .na \fB\fB-t\fR\fI terminal\fR\fR .ad .RS 15n -.rt Override the terminal kind specified in the environment. If the terminal cannot underline, underlining is ignored. If the terminal name is not found, no underlining is attempted. @@ -40,12 +38,10 @@ underlining is attempted. .sp .ne 2 -.mk .na \fB\fB-i\fR\fR .ad .RS 15n -.rt Indicate underlining by a separate line containing appropriate dashes `\fB\(mi\fR\&'; this is useful when you want to look at the underlining which is present in an \fBnroff\fR(1) output stream on a \fBCRT-terminal.\fR @@ -58,12 +54,10 @@ is present in an \fBnroff\fR(1) output stream on a \fBCRT-terminal.\fR .SH FILES .sp .ne 2 -.mk .na \fB\fB/usr/share/lib/terminfo/*\fR\fR .ad .RS 29n -.rt .RE diff --git a/usr/src/man/man1/umask.1 b/usr/src/man/man1/umask.1 index 9938d992ce..3f0d814a1a 100644 --- a/usr/src/man/man1/umask.1 +++ b/usr/src/man/man1/umask.1 @@ -3,14 +3,14 @@ .\" Copyright (c) 1992, X/Open Company Limited All Rights Reserved .\" Portions Copyright (c) 1982-2007 AT&T Knowledge Ventures .\" Portions Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 umask 1 "17 Sep 2007" "SunOS 5.11" "User Commands" +.TH UMASK 1 "Sep 17, 2007" .SH NAME umask \- get or set the file mode creation mask .SH SYNOPSIS @@ -54,8 +54,8 @@ execution environment, such as one of the following: .sp .in +2 .nf -(umask 002) -nohup umask ... +(umask 002) +nohup umask ... find . -exec umask ... .fi .in -2 @@ -135,12 +135,10 @@ The following option is supported for \fB/usr/bin/umask\fR and \fBumask\fR in \fBksh\fR: .sp .ne 2 -.mk .na \fB\fB-S\fR\fR .ad .RS 6n -.rt Produces symbolic output. .RE @@ -155,12 +153,10 @@ the previous file mode creation mask. The following option is supported in \fBksh93\fR: .sp .ne 2 -.mk .na \fB\fB-S\fR\fR .ad .RS 6n -.rt Causes the file creation mask to be written or treated as a symbolic value rather than an octal number. .RE @@ -171,12 +167,10 @@ rather than an octal number. The following operand is supported: .sp .ne 2 -.mk .na \fB\fImask\fR\fR .ad .RS 8n -.rt A string specifying the new file mode creation mask. The string is treated in the same way as the \fImode\fR operand described in the \fBchmod\fR(1) manual page. @@ -335,24 +329,20 @@ that affect the execution of \fBumask\fR: \fBLANG\fR, \fBLC_ALL\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt The file mode creation mask was successfully changed, or no \fImask\fR operand was supplied. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -365,13 +355,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SS "ksh93" @@ -379,13 +368,12 @@ Interface StabilityStandard .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityExternal +Interface Stability External .TE .SH SEE ALSO diff --git a/usr/src/man/man1/uname.1 b/usr/src/man/man1/uname.1 index bde827c4d0..b6b57d5742 100644 --- a/usr/src/man/man1/uname.1 +++ b/usr/src/man/man1/uname.1 @@ -2,14 +2,14 @@ .\" Copyright 1989 AT&T .\" Copyright (c) 2003, Sun Microsystems, Inc. All Rights Reserved .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 "17 Sep 2003" "SunOS 5.11" "User Commands" +.TH UNAME 1 "Sep 17, 2003" .SH NAME uname \- print name of current system .SH SYNOPSIS @@ -38,91 +38,75 @@ options print selected information returned by \fBuname\fR(2), The following options are supported: .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 18n -.rt Prints basic information currently available from the system. .RE .sp .ne 2 -.mk .na \fB\fB-i\fR\fR .ad .RS 18n -.rt Prints the name of the platform. .RE .sp .ne 2 -.mk .na \fB\fB-m\fR\fR .ad .RS 18n -.rt Prints the machine hardware name (class). Use of this option is discouraged. Use \fBuname\fR \fB-p\fR instead. See NOTES section below. .RE .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 18n -.rt Prints the nodename (the nodename is the name by which the system is known to a communications network). .RE .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 18n -.rt Prints the current host's \fBISA\fR or processor type. .RE .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 18n -.rt Prints the operating system release level. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 18n -.rt Prints the name of the operating system. This is the default. .RE .sp .ne 2 -.mk .na \fB\fB-S\fR \fIsystem_name\fR\fR .ad .RS 18n -.rt 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 @@ -133,23 +117,19 @@ permanently. .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 18n -.rt Prints the operating system version. .RE .sp .ne 2 -.mk .na \fB\fB-X\fR \fR .ad .RS 18n -.rt Prints expanded system information, one information element per line, as expected by SCO UNIX. The displayed information includes: .RS +4 @@ -200,12 +180,10 @@ that affect the execution of \fBuname\fR: \fBLANG\fR, \fBLC_ALL\fR, \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and \fBNLSPATH\fR. .sp .ne 2 -.mk .na \fB\fBSYSV3\fR \fR .ad .RS 10n -.rt This variable is used to override the default behavior of \fBuname\fR. This is necessary to make it possible for some INTERACTIVE UNIX Systems and SCO UNIX programs and scripts to work properly. Many scripts use \fBuname\fR to @@ -232,67 +210,55 @@ setting \fBSYSV3\fR in the following format: .sp .ne 2 -.mk .na \fB\fIos\fR \fR .ad .RS 12n -.rt Operating system (IUS or SCO). .RE .sp .ne 2 -.mk .na \fB\fIsysname\fR \fR .ad .RS 12n -.rt System name. .RE .sp .ne 2 -.mk .na \fB\fInode\fR \fR .ad .RS 12n -.rt Nodename as displayed by the \fB-n\fR option. .RE .sp .ne 2 -.mk .na \fB\fIrel\fR \fR .ad .RS 12n -.rt Release level as displayed by the \fB-r\fR option. .RE .sp .ne 2 -.mk .na \fB\fIver\fR \fR .ad .RS 12n -.rt Version number as displayed by the \fB-v\fR option. .RE .sp .ne 2 -.mk .na \fB\fImach\fR \fR .ad .RS 12n -.rt Machine name as displayed by \fB-m\fR option. .RE @@ -306,23 +272,19 @@ system value will be used. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR \fR .ad .RS 7n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR \fR .ad .RS 7n -.rt An error occurred. .RE @@ -334,13 +296,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man1/unifdef.1 b/usr/src/man/man1/unifdef.1 index 221929424e..4ccb5906fe 100644 --- a/usr/src/man/man1/unifdef.1 +++ b/usr/src/man/man1/unifdef.1 @@ -3,13 +3,13 @@ .\" 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 unifdef 1 "14 Jan 1992" "SunOS 5.11" "User Commands" +.TH UNIFDEF 1 "Jan 14, 1992" .SH NAME unifdef \- resolve and remove ifdef'ed lines from C program source .SH SYNOPSIS .LP .nf -\fBunifdef\fR [\fB-clt\fR] [\fB-D\fR\fIname\fR] [\fB-U\fR\fIname\fR] [\fB-iD\fR\fIname\fR] [\fB-iU\fR\fIname\fR] ... +\fBunifdef\fR [\fB-clt\fR] [\fB-D\fR\fIname\fR] [\fB-U\fR\fIname\fR] [\fB-iD\fR\fIname\fR] [\fB-iU\fR\fIname\fR] ... [\fIfilename\fR] .fi @@ -45,69 +45,57 @@ from the standard input if no \fIfilename\fR argument is given. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad .RS 11n -.rt Complement the normal operation. Lines that would have been removed or blanked are retained, and vice versa. .RE .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 11n -.rt Replace ``lines removed'' lines with blank lines. .RE .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad .RS 11n -.rt Plain text option. \fBunifdef\fR refrains from attempting to recognize comments and single and double quotes. .RE .sp .ne 2 -.mk .na \fB\fB-D\fR\fIname\fR\fR .ad .RS 11n -.rt Lines associated with the defined symbol \fIname\fR. .RE .sp .ne 2 -.mk .na \fB\fB-U\fR\fIname\fR\fR .ad .RS 11n -.rt Lines associated with the undefined symbol \fIname\fR. .RE .sp .ne 2 -.mk .na \fB\fB-iD\fR\fIname\fR\fR .ad .RS 11n -.rt Ignore, but print out, lines associated with the defined symbol \fIname\fR. If you use \fBifdef\fRs to delimit non-C lines, such as comments or code which is under construction, then you must tell \fBunifdef\fR which symbols are used for @@ -117,12 +105,10 @@ them. .sp .ne 2 -.mk .na \fB\fB-iU\fR\fIname\fR\fR .ad .RS 11n -.rt Ignore, but print out, lines associated with the undefined symbol \fIname\fR. .RE @@ -132,23 +118,19 @@ Ignore, but print out, lines associated with the undefined symbol \fIname\fR. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt Successful operation. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt Operation failed. .RE @@ -159,12 +141,10 @@ Operation failed. .SH DIAGNOSTICS .sp .ne 2 -.mk .na \fB\fBPremature\fR \fBEOF\fR\fR .ad .RS 17n -.rt Inappropriate \fBelse\fR or \fBendif\fR. .RE diff --git a/usr/src/man/man1/uniq.1 b/usr/src/man/man1/uniq.1 index d9c4c1d0c6..fa9cff0319 100644 --- a/usr/src/man/man1/uniq.1 +++ b/usr/src/man/man1/uniq.1 @@ -4,21 +4,21 @@ .\" Copyright (c) 2007 Sun Microsystems, Inc. - All Rights Reserved. .\" Portions Copyright (c) 1982-2007 AT&T Knowledge Ventures .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 uniq 1 "13 Mar 2008" "SunOS 5.11" "User Commands" +.TH UNIQ 1 "Mar 13, 2008" .SH NAME uniq \- report or filter out repeated lines in a file .SH SYNOPSIS .SS "/usr/bin/uniq" .LP .nf -\fB/usr/bin/uniq\fR [\fB-c\fR | \fB-d\fR | \fB-u\fR] [\fB-f\fR \fIfields\fR] [\fB-s\fR \fIchar\fR] +\fB/usr/bin/uniq\fR [\fB-c\fR | \fB-d\fR | \fB-u\fR] [\fB-f\fR \fIfields\fR] [\fB-s\fR \fIchar\fR] [\fIinput_file\fR [\fIoutput_file\fR]] .fi @@ -30,7 +30,7 @@ uniq \- report or filter out repeated lines in a file .SS "ksh93" .LP .nf -\fBuniq\fR [\fB-cdiu\fR] [\fB-D\fR[\fIdelimit\fR]] [\fB-f\fR \fIfields\fR] [\fB-s\fR \fIchars\fR] [\fB-w\fR \fIchars\fR] +\fBuniq\fR [\fB-cdiu\fR] [\fB-D\fR[\fIdelimit\fR]] [\fB-f\fR \fIfields\fR] [\fB-s\fR \fIchars\fR] [\fB-w\fR \fIchars\fR] [\fIinput_file\fR [\fIoutput_file\fR]] .fi @@ -74,35 +74,29 @@ the current offset. The following options are supported by \fB/usr/bin/uniq\fR: .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad .RS 13n -.rt Precedes each output line with a count of the number of times the line occurred in the input. .RE .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad .RS 13n -.rt Suppresses the writing of lines that are not repeated in the input. .RE .sp .ne 2 -.mk .na \fB\fB-f\fR \fIfields\fR\fR .ad .RS 13n -.rt Ignores the first \fIfields\fR fields on each input line when doing comparisons, where \fIfields\fR is a positive decimal integer. A field is the maximal string matched by the basic regular expression: @@ -120,34 +114,28 @@ string is used for comparison. .sp .ne 2 -.mk .na \fB\fB+\fR\fIm\fR\fR .ad .RS 13n -.rt Equivalent to \fB-s\fR \fIchars\fR with \fIchars\fR set to \fIm\fR. .RE .sp .ne 2 -.mk .na \fB\fB\(mi\fR\fIn\fR\fR .ad .RS 13n -.rt Equivalent to \fB-f\fR \fIfields\fR with \fIfields\fR set to \fIn\fR. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR \fIchars\fR\fR .ad .RS 13n -.rt Ignores the first \fIchars\fR characters when doing comparisons, where \fIchars\fR is a positive decimal integer. If specified in conjunction with the \fB-f\fR option, the first \fIchars\fR characters after the first \fIfields\fR @@ -157,12 +145,10 @@ input line, a null string is used for comparison. .sp .ne 2 -.mk .na \fB\fB-u\fR\fR .ad .RS 13n -.rt Suppresses the writing of lines that are repeated in the input. .RE @@ -173,7 +159,6 @@ The following options are supported by the \fBuniq\fR built-in command is \fBksh93\fR: .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad @@ -182,13 +167,11 @@ The following options are supported by the \fBuniq\fR built-in command is \fB\fB--count\fR\fR .ad .RS 28n -.rt Outputs the number of times each line occurred along with the line. .RE .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad @@ -197,13 +180,11 @@ Outputs the number of times each line occurred along with the line. \fB\fB--repeated | duplicates\fR\fR .ad .RS 28n -.rt Outputs only duplicate lines. .RE .sp .ne 2 -.mk .na \fB\fB-D\fR\fR .ad @@ -212,41 +193,34 @@ Outputs only duplicate lines. \fB\fB--all-repeated\fR[\fB=\fR\fIdelimit\fR]\fR .ad .RS 28n -.rt Outputs all duplicate lines as a group with an empty line delimiter specified by \fIdelimit\fR. .sp Specify \fIdelimit\fR as one of the following: .sp .ne 2 -.mk .na \fB\fBnone\fR\fR .ad .RS 12n -.rt Do not delimit duplicate groups. .RE .sp .ne 2 -.mk .na \fB\fBprepend\fR\fR .ad .RS 12n -.rt Prepend an empty line before each group. .RE .sp .ne 2 -.mk .na \fB\fBseparate\fR\fR .ad .RS 12n -.rt Separate each group with an empty line. .RE @@ -255,7 +229,6 @@ The value for \fIdelimit\fR can be omitted. The default value is \fBnone\fR. .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad @@ -264,7 +237,6 @@ The value for \fIdelimit\fR can be omitted. The default value is \fBnone\fR. \fB\fB--skip-fields=\fR\fIfields\fR\fR .ad .RS 28n -.rt Skips over \fIfields\fR number of fields before checking for uniqueness. A field is the minimal string matching the \fBBRE [[:\fR\fIblank\fR\fB:]]*[^[:\fR\fIblank\fR\fB:]]*\fR. @@ -272,7 +244,6 @@ field is the minimal string matching the \fBBRE .sp .ne 2 -.mk .na \fB\fB-i\fR\fR .ad @@ -281,36 +252,30 @@ field is the minimal string matching the \fBBRE \fB\fB--ignore-case\fR\fR .ad .RS 28n -.rt Ignore case in comparisons. .RE .sp .ne 2 -.mk .na \fB\fB+\fR\fIm\fR\fR .ad .RS 28n -.rt Equivalent to the \fB-s\fR \fIchars\fR option, with \fIchars\fR set to \fIm\fR. .RE .sp .ne 2 -.mk .na \fB\fB-\fR\fIn\fR\fR .ad .RS 28n -.rt Equivalent to the \fB-f\fR \fIfields\fR option, with \fIfields\fR set to \fIn\fR. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad @@ -319,7 +284,6 @@ Equivalent to the \fB-f\fR \fIfields\fR option, with \fIfields\fR set to \fB\fB--skip-chars=\fR\fIchars\fR\fR .ad .RS 28n -.rt Skips over \fIchars\fR number of characters before checking for uniqueness. .sp If specified with the \fB-f\fR option, the first \fIchars\fR after the first @@ -329,7 +293,6 @@ the line, an empty string is used for comparison. .sp .ne 2 -.mk .na \fB\fB-u\fR\fR .ad @@ -338,13 +301,11 @@ the line, an empty string is used for comparison. \fB\fB--uniq\fR\fR .ad .RS 28n -.rt Outputs unique lines. .RE .sp .ne 2 -.mk .na \fB\fB-w\fR\fR .ad @@ -353,7 +314,6 @@ Outputs unique lines. \fB\fB--check-chars=\fR\fIchars\fR\fR .ad .RS 28n -.rt Skips over any specified fields and characters, then compares \fIchars\fR number of characters. .RE @@ -364,24 +324,20 @@ number of characters. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIinput_file\fR\fR .ad .RS 15n -.rt A path name of the input file. If \fIinput_file\fR is not specified, or if the \fIinput_file\fR is \fB\(mi\fR, the standard input is used. .RE .sp .ne 2 -.mk .na \fB\fIoutput_file\fR\fR .ad .RS 15n -.rt A path name of the output file. If \fIoutput_file\fR is not specified, the standard output is used. The results are unspecified if the file named by \fIoutput_file\fR is the file named by \fIinput_file\fR. @@ -463,23 +419,19 @@ that affect the execution of \fBuniq\fR: \fBLANG\fR, \fBLC_ALL\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -492,17 +444,16 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityCommitted +Interface Stability Committed _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .SS "ksh93" @@ -510,13 +461,12 @@ StandardSee \fBstandards\fR(5). .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilitySee below. +Interface Stability See below. .TE .sp diff --git a/usr/src/man/man1/units.1 b/usr/src/man/man1/units.1 index 7e5c244ce9..e7acfbe175 100644 --- a/usr/src/man/man1/units.1 +++ b/usr/src/man/man1/units.1 @@ -4,13 +4,13 @@ .\" 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 units 1 "14 Sep 1992" "SunOS 5.11" "User Commands" +.TH UNITS 1 "Sep 14, 1992" .SH NAME units \- converts quantities expressed in standard scales to other scales .SH SYNOPSIS .LP .nf -\fBunits\fR +\fBunits\fR .fi .SH DESCRIPTION @@ -53,89 +53,73 @@ and metric prefixes are recognized, together with a generous leavening of exotica and a few constants of nature including: .sp .ne 2 -.mk .na \fB\fBpi\fR\fR .ad .RS 9n -.rt ratio of circumference to diameter, .RE .sp .ne 2 -.mk .na \fB\fBc\fR\fR .ad .RS 9n -.rt speed of light, .RE .sp .ne 2 -.mk .na \fB\fBe\fR\fR .ad .RS 9n -.rt charge on an electron, .RE .sp .ne 2 -.mk .na \fB\fBg\fR\fR .ad .RS 9n -.rt acceleration of gravity, .RE .sp .ne 2 -.mk .na \fB\fBforce\fR\fR .ad .RS 9n -.rt same as \fBg\fR, .RE .sp .ne 2 -.mk .na \fB\fBmole\fR\fR .ad .RS 9n -.rt Avogadro's number, .RE .sp .ne 2 -.mk .na \fB\fBwater\fR\fR .ad .RS 9n -.rt pressure head per unit height of water, .RE .sp .ne 2 -.mk .na \fB\fBau\fR\fR .ad .RS 9n -.rt astronomical unit. .RE diff --git a/usr/src/man/man1/unix2dos.1 b/usr/src/man/man1/unix2dos.1 index 234aa23b2f..c86781becb 100644 --- a/usr/src/man/man1/unix2dos.1 +++ b/usr/src/man/man1/unix2dos.1 @@ -3,13 +3,13 @@ .\" 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 unix2dos 1 "14 Sep 2000" "SunOS 5.11" "User Commands" +.TH UNIX2DOS 1 "Sep 14, 2000" .SH NAME unix2dos \- convert text file from ISO format to DOS format .SH SYNOPSIS .LP .nf -\fBunix2dos\fR [\fB-ascii\fR] [\fB-iso\fR] [\fB-7\fR] +\fBunix2dos\fR [\fB-ascii\fR] [\fB-iso\fR] [\fB-7\fR] [\fB-437\fR | \fB-850\fR | \fB-860\fR | \fB-863\fR | \fB-865\fR] \fIoriginalfile\fR \fIconvertedfile\fR .fi @@ -33,36 +33,30 @@ rewrite the original file after converting it. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-ascii\fR\fR .ad .RS 10n -.rt Adds carriage returns and converts end of file characters in SunOS format text files to conform to \fBDOS\fR requirements. .RE .sp .ne 2 -.mk .na \fB\fB-iso\fR\fR .ad .RS 10n -.rt This is the default. Converts \fBISO\fR standard characters to the corresponding character in the \fBDOS\fR extended character set. .RE .sp .ne 2 -.mk .na \fB\fB-7\fR\fR .ad .RS 10n -.rt Converts 8 bit SunOS characters to 7 bit \fBDOS\fR characters. .RE @@ -73,56 +67,46 @@ determine which code page to use. Otherwise, the default is US. The user may override the code page with one of the following options: .sp .ne 2 -.mk .na \fB\fB-437\fR\fR .ad .RS 8n -.rt Use US code page .RE .sp .ne 2 -.mk .na \fB\fB-850\fR\fR .ad .RS 8n -.rt Use multilingual code page .RE .sp .ne 2 -.mk .na \fB\fB-860\fR\fR .ad .RS 8n -.rt Use Portuguese code page .RE .sp .ne 2 -.mk .na \fB\fB-863\fR\fR .ad .RS 8n -.rt Use French Canadian code page .RE .sp .ne 2 -.mk .na \fB\fB-865\fR\fR .ad .RS 8n -.rt Use Danish code page .RE @@ -132,24 +116,20 @@ Use Danish code page The following operands are required: .sp .ne 2 -.mk .na \fB\fIoriginalfile\fR \fR .ad .RS 18n -.rt The original file in \fBISO\fR format that is being converted to \fBDOS\fR format. .RE .sp .ne 2 -.mk .na \fB\fIconvertedfile\fR \fR .ad .RS 18n -.rt The new file in \fBDOS\fR format that has been converted from the original \fBISO\fR file format. .RE @@ -161,7 +141,6 @@ The new file in \fBDOS\fR format that has been converted from the original .SH DIAGNOSTICS .sp .ne 2 -.mk .na \fB\fBFile \fIfilename\fR not found, or no read permission\fR\fR .ad @@ -173,7 +152,6 @@ permission. Check with the SunOS command, \fBls\fR \fB-l\fR (see \fBls\fR(1)). .sp .ne 2 -.mk .na \fB\fBBad output filename \fIfilename\fR, or no write permission\fR\fR .ad @@ -186,7 +164,6 @@ drive or diskette is not write-protected. .sp .ne 2 -.mk .na \fB\fBError while writing to temporary file\fR\fR .ad @@ -201,7 +178,6 @@ occurs, the original file remains intact. .sp .ne 2 -.mk .na \fB\fBTranslated tmpfile name = \fIfilename\fR.\fR\fR .ad diff --git a/usr/src/man/man1/uptime.1 b/usr/src/man/man1/uptime.1 index ca59456352..5f33575231 100644 --- a/usr/src/man/man1/uptime.1 +++ b/usr/src/man/man1/uptime.1 @@ -3,13 +3,13 @@ .\" 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 uptime 1 "18 Mar 1994" "SunOS 5.11" "User Commands" +.TH UPTIME 1 "Mar 18, 1994" .SH NAME uptime \- show how long the system has been up .SH SYNOPSIS .LP .nf -\fBuptime\fR +\fBuptime\fR .fi .SH DESCRIPTION diff --git a/usr/src/man/man1/vacation.1 b/usr/src/man/man1/vacation.1 index 9ea06947f8..40c61a55fe 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 "20 Aug 2005" "SunOS 5.11" "User Commands" +.TH VACATION 1 "Aug 20, 2005" .SH NAME vacation \- reply to mail automatically .SH SYNOPSIS @@ -15,7 +15,7 @@ vacation \- reply to mail automatically .LP .nf -\fBvacation\fR [\fB-a\fR \fIalias\fR] [\fB-e\fR \fIfilter_file\fR] [\fB-f\fR \fIdatabase_file\fR] +\fBvacation\fR [\fB-a\fR \fIalias\fR] [\fB-e\fR \fIfilter_file\fR] [\fB-f\fR \fIdatabase_file\fR] [\fB-j\fR] [\fB-m\fR \fImessage_file\fR] [\fB-s\fR \fIsender\fR] [\fB-t\fR\fIN\fR] \fIusername\fR .fi @@ -95,12 +95,10 @@ installation, these being \fB-a\fR, \fB-e\fR, \fB-f\fR, \fB-j\fR, \fB-m\fR, The following options are supported: .sp .ne 2 -.mk .na \fB\fB-I\fR\fR .ad .RS 6n -.rt Initializes the \fB\&.vacation.pag\fR and \fB\&.vacation.dir\fR files and enables \fBvacation\fR. If the \fB-I\fR flag is not specified, and a \fIuser\fR argument is given, \fBvacation\fR reads the first line from the standard input @@ -125,48 +123,40 @@ example, repeats replies to the sender every minute. .sp .ne 2 -.mk .na \fB\fB-a\fR \fIalias\fR\fR .ad .RS 20n -.rt Indicates that \fIalias\fR is one of the valid aliases for the user running \fBvacation\fR, so that mail addressed to that alias generates a reply. .RE .sp .ne 2 -.mk .na \fB\fB-e\fR \fIfilter_file\fR\fR .ad .RS 20n -.rt Uses \fIfilter_file\fR instead of \fB\&.vacation.filter\fR as the source of the domain and email address filters. .RE .sp .ne 2 -.mk .na \fB\fB-f\fR \fIdatabase_file\fR\fR .ad .RS 20n -.rt Uses \fIdatabase_file\fR instead of \fB\&.vacation\fR as the base name for the database file. .RE .sp .ne 2 -.mk .na \fB\fB-j\fR\fR .ad .RS 20n -.rt Does not check whether the recipient appears in the \fBTo:\fR or the \fBCc:\fR line. Warning: use of this option can result in vacation replies being sent to mailing lists and other inappropriate places; its use is therefore strongly @@ -175,12 +165,10 @@ discouraged. .sp .ne 2 -.mk .na \fB\fB-m\fR \fImessage_file\fR\fR .ad .RS 20n -.rt Uses \fB~/\fImessage_file\fR\fR as the message to send for the reply instead of \fB~/.vacation.msg\fR. \fImessage_file\fR is a relative path to the desired vacation message file. To prevent directory/file "not found" errors, @@ -189,24 +177,20 @@ vacation message file. To prevent directory/file "not found" errors, .sp .ne 2 -.mk .na \fB\fB-s\fR \fIsender\fR\fR .ad .RS 20n -.rt Replies to \fIsender\fR instead of the value read from the UNIX \fBFrom\fR line of the incoming message. .RE .sp .ne 2 -.mk .na \fB\fB-t\fR\fIN\fR\fR .ad .RS 20n -.rt Changes the interval between repeat replies to the same sender. The default is 1 week. A trailing \fBs\fR, \fBm\fR, \fBh\fR, \fBd\fR, or \fBw\fR scales \fIN\fR to seconds, minutes, hours, days, or weeks, respectively. @@ -219,12 +203,10 @@ reporting. The \fB-f\fRoption can also be used in conjunction with the \fB-l\fR. .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 6n -.rt Lists the addresses to which a reply has been sent since the last invocation of \fBvacation -I\fR, along with a date and time stamp. .RE diff --git a/usr/src/man/man1/vgrind.1 b/usr/src/man/man1/vgrind.1 index 30fed75678..2428245f37 100644 --- a/usr/src/man/man1/vgrind.1 +++ b/usr/src/man/man1/vgrind.1 @@ -4,13 +4,13 @@ .\" specifies the terms and conditions for redistribution. .\" Copyright (c) 2000, Sun Microsystems, Inc. .\" All Rights Reserved -.TH vgrind 1 "3 Mar 2000" "SunOS 5.11" "User Commands" +.TH VGRIND 1 "Mar 3, 2000" .SH NAME vgrind \- grind nice program listings .SH SYNOPSIS .LP .nf -\fBvgrind\fR [\fB-2fntwx\fR] [\fB-d\fR \fIdefs-file\fR] [\fB-h\fR \fIheader\fR] [\fB-l\fR \fIlanguage\fR] +\fBvgrind\fR [\fB-2fntwx\fR] [\fB-d\fR \fIdefs-file\fR] [\fB-h\fR \fIheader\fR] [\fB-l\fR \fIlanguage\fR] [\fB-s\fR \fIn\fR] [\fB-o\fR \fIpagelist\fR] [\fB-P\fR \fIprinter\fR] [\fB-T\fR \fIoutput-device\fR] \fIfilename\fR... .fi @@ -29,23 +29,19 @@ standard input is passed directly to the standard output except for lines bracketed by the \fBtroff\fR-like macros: .sp .ne 2 -.mk .na \fB\fB\&.vS\fR\fR .ad .RS 9n -.rt starts processing .RE .sp .ne 2 -.mk .na \fB\fB\&.vE\fR\fR .ad .RS 9n -.rt ends processing .RE @@ -105,12 +101,10 @@ without conversion. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-2\fR\fR .ad .RS 16n -.rt Produces two-column output. Specifying this option changes the default point size to 8 (as if the \fB-s8\fR option were supplied). It also arranges for output to appear in landscape mode. @@ -118,46 +112,38 @@ output to appear in landscape mode. .sp .ne 2 -.mk .na \fB\fB-f\fR\fR .ad .RS 16n -.rt Forces filter mode. .RE .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 16n -.rt Does not make keywords boldface. .RE .sp .ne 2 -.mk .na \fB\fB-w\fR\fR .ad .RS 16n -.rt Considers TAB characters to be spaced four columns apart instead of the usual eight. .RE .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad .RS 16n -.rt Outputs the index file in a "pretty" format. The index file itself is produced whenever \fBvgrind\fR is run with a file called \fBindex\fR that is present in the current directory. The index of function definitions can then be run off by @@ -166,36 +152,30 @@ giving \fBvgrind\fR the \fB-x\fR option and the file \fBindex\fR as argument. .sp .ne 2 -.mk .na \fB\fB-d\fR \fIdefs-file\fR\fR .ad .RS 16n -.rt Specifies an alternate language definitions file (default is \fB/usr/lib/vgrindefs\fR). .RE .sp .ne 2 -.mk .na \fB\fB-h\fR \fIheader\fR\fR .ad .RS 16n -.rt Specifies a header to appear in the center of every output page. Use quotes to specify headers with embedded spaces. .RE .sp .ne 2 -.mk .na \fB\fB-l\fR \fIlanguage\fR\fR .ad .RS 16n -.rt Specifies the language to use. Among the \fIlanguage\fRs currently known are: Bourne shell (\fB-lsh\fR), C (\fB-lc\fR, the default), C++ (\fB-lc++\fR), C shell (\fB-lcsh\fR), emacs MLisp (\fB-lml\fR), FORTRAN (\fB-lf\fR), Icon @@ -205,23 +185,19 @@ shell (\fB-lcsh\fR), emacs MLisp (\fB-lml\fR), FORTRAN (\fB-lf\fR), Icon .sp .ne 2 -.mk .na \fB\fB-P\fR \fIprinter\fR\fR .ad .RS 16n -.rt Sends output to the named \fIprinter\fR. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR \fIn\fR\fR .ad .RS 16n -.rt Specifies a point size to use on output (exactly the same as the argument of a \fBtroff\fR \fB\&.ps\fR point size request). .RE @@ -232,24 +208,20 @@ Specifies a point size to use on output (exactly the same as the argument of a \fBTROFF\fR environment variable. See ENVIRONMENT VARIABLES. .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad .RS 20n -.rt Similar to the same option in \fBtroff\fR; that is, formatted text goes to the standard output. .RE .sp .ne 2 -.mk .na \fB\fB-o\fR \fIpagelist\fR\fR .ad .RS 20n -.rt Prints only those pages whose page numbers appear in the comma-separated \fIpagelist\fR of numbers and ranges. A range \fIN\(miM\fR means pages \fIN\fR through \fIM\fR; an initial \fB-N\fR means from the beginning to page \fIN\fR; @@ -258,12 +230,10 @@ and a final \fIN\fR\(mi means from \fIN\fR to the end. .sp .ne 2 -.mk .na \fB\fB-T\fR \fIoutput-device\fR\fR .ad .RS 20n -.rt Formats output for the specified \fIoutput-device\fR. .RE @@ -273,12 +243,10 @@ Formats output for the specified \fIoutput-device\fR. The following operand is supported: .sp .ne 2 -.mk .na \fB\fIfilename\fR\fR .ad .RS 12n -.rt Name of the program source to be processed by \fBvgrind\fR. Use `\fB\(mi\fR\&' to specify the standard input. .RE @@ -293,7 +261,6 @@ mechanism allows for local variations in \fBtroff\fR's name. .SH FILES .sp .ne 2 -.mk .na \fB\fBindex\fR\fR .ad @@ -304,7 +271,6 @@ file where source for index is created .sp .ne 2 -.mk .na \fB\fB/usr/lib/vgrindefs\fR\fR .ad @@ -315,7 +281,6 @@ language descriptions .sp .ne 2 -.mk .na \fB\fB/usr/lib/vfontedpr\fR\fR .ad @@ -326,7 +291,6 @@ preprocessor .sp .ne 2 -.mk .na \fB\fB/usr/share/lib/tmac/tmac.vgrind\fR\fR .ad @@ -346,59 +310,49 @@ macro package \fBvgrind\fR assumes that a certain programming style is followed: .sp .ne 2 -.mk .na \fBC\fR .ad .RS 11n -.rt Function names can be preceded on a line only by SPACE, TAB, or an asterisk (\fB*\fR). The parenthesized arguments must also be on the same line. .RE .sp .ne 2 -.mk .na \fBFORTRAN\fR .ad .RS 11n -.rt Function names need to appear on the same line as the keywords \fBfunction\fR or \fBsubroutine\fR. .RE .sp .ne 2 -.mk .na \fBMLisp\fR .ad .RS 11n -.rt Function names should not appear on the same line as the preceding \fBdefun\fR. .RE .sp .ne 2 -.mk .na \fBModel\fR .ad .RS 11n -.rt Function names need to appear on the same line as the keywords \fBis beginproc\fR. .RE .sp .ne 2 -.mk .na \fBPascal\fR .ad .RS 11n -.rt Function names need to appear on the same line as the keywords \fBfunction\fR or \fBprocedure\fR. .RE diff --git a/usr/src/man/man1/volcheck.1 b/usr/src/man/man1/volcheck.1 index 4f47bcaa38..abcc463278 100644 --- a/usr/src/man/man1/volcheck.1 +++ b/usr/src/man/man1/volcheck.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 volcheck 1 "28 Feb 2007" "SunOS 5.11" "User Commands" +.TH VOLCHECK 1 "Feb 28, 2007" .SH NAME volcheck \- checks for media in a drive and by default checks all floppy media .SH SYNOPSIS @@ -28,24 +28,20 @@ management. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-i\fR \fIsecs\fR\fR .ad .RS 11n -.rt Set the frequency of device checking to \fIsecs\fR seconds. The default is 2 seconds. The minimum frequency is 1 second. .RE .sp .ne 2 -.mk .na \fB\fB-t\fR\fI secs\fR\fR .ad .RS 11n -.rt Check the named device(s) for the next \fIsecs\fR seconds. The maximum number of seconds allowed is 28800, which is 8 hours. The frequency of checking is specified by \fB-i\fR. There is no default total time. @@ -53,12 +49,10 @@ specified by \fB-i\fR. There is no default total time. .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 11n -.rt Verbose. .RE @@ -68,12 +62,10 @@ Verbose. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIpathname\fR\fR .ad .RS 12n -.rt The path name of a media device. .RE @@ -117,12 +109,10 @@ for 600 seconds (10 minutes). .SH FILES .sp .ne 2 -.mk .na \fB\fB/dev/volctl\fR\fR .ad .RS 15n -.rt volume management control port .RE diff --git a/usr/src/man/man1/volrmmount.1 b/usr/src/man/man1/volrmmount.1 index 4c9e953666..006dedfd52 100644 --- a/usr/src/man/man1/volrmmount.1 +++ b/usr/src/man/man1/volrmmount.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 volrmmount 1 "28 Feb 2007" "SunOS 5.11" "User Commands" +.TH VOLRMMOUNT 1 "Feb 28, 2007" .SH NAME volrmmount \- call rmmount to mount or unmount media .SH SYNOPSIS @@ -40,34 +40,28 @@ This command allows you to override volume management's usual handling of media The following options are supported: .sp .ne 2 -.mk .na \fB\fB-i\fR\fR .ad .RS 6n -.rt Simulates an insertion of the specified media by calling \fBrmmount\fR. .RE .sp .ne 2 -.mk .na \fB\fB-e\fR\fR .ad .RS 6n -.rt Simulates an ejection of the specified media by calling \fBrmmount\fR. .RE .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad .RS 6n -.rt Displays the name of the default device for \fBvolrmmount\fR to handle. This device is used if no \fIname\fR or \fInickname\fR is supplied. .RE @@ -78,23 +72,19 @@ device is used if no \fIname\fR or \fInickname\fR is supplied. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIname\fR\fR .ad .RS 12n -.rt The name that volume management recognizes as the device's name. .RE .sp .ne 2 -.mk .na \fB\fInickname\fR\fR .ad .RS 12n -.rt A shortened version of the device's name. Following is the list of recognized nicknames: .RE @@ -103,43 +93,42 @@ nicknames: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -NicknamePath +box; +c | c +l | l . +Nickname Path _ -fd/dev/rdiskette +fd /dev/rdiskette _ -fd0/dev/rdiskette +fd0 /dev/rdiskette _ -fd1/dev/rdiskette1 +fd1 /dev/rdiskette1 _ -diskette/dev/rdiskette +diskette /dev/rdiskette _ -diskette0/dev/rdiskette0 +diskette0 /dev/rdiskette0 _ -diskette1/dev/rdiskette1 +diskette1 /dev/rdiskette1 _ -rdiskette/dev/rdiskette +rdiskette /dev/rdiskette _ -rdiskette0/dev/rdiskette0 +rdiskette0 /dev/rdiskette0 _ -rdiskette1/dev/rdiskette1 +rdiskette1 /dev/rdiskette1 _ -floppy/dev/rdiskette +floppy /dev/rdiskette _ -floppy0/dev/rdiskette0 +floppy0 /dev/rdiskette0 _ -floppy1/dev/rdiskette1 +floppy1 /dev/rdiskette1 _ -cdrom0/dev/rdsk/cXtYdZ/\fIlabel\fR +cdrom0 /dev/rdsk/cXtYdZ/\fIlabel\fR _ -zip0/dev/rdsk/cXtYdZ/\fIlabel\fR +zip0 /dev/rdsk/cXtYdZ/\fIlabel\fR _ -jaz0/dev/rdsk/cXtYdZ/\fIlabel\fR +jaz0 /dev/rdsk/cXtYdZ/\fIlabel\fR _ -rmdisk0/dev/rdsk/cXtYdZ/\fIlabel\fR +rmdisk0 /dev/rdsk/cXtYdZ/\fIlabel\fR .TE .SH EXAMPLES @@ -180,12 +169,10 @@ Notice that if you are using a named floppy, you can use its name in place of .SH FILES .sp .ne 2 -.mk .na \fB\fB/dev/volctl\fR\fR .ad .RS 15n -.rt volume management control port .RE diff --git a/usr/src/man/man1/w.1 b/usr/src/man/man1/w.1 index f87179450c..c05c275406 100644 --- a/usr/src/man/man1/w.1 +++ b/usr/src/man/man1/w.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 w 1 "19 Mar 2004" "SunOS 5.11" "User Commands" +.TH W 1 "Mar 19, 2004" .SH NAME w \- display information about currently logged-in users .SH SYNOPSIS @@ -35,46 +35,38 @@ arguments of the current process. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-h\fR\fR .ad .RS 6n -.rt Suppresses the heading. .RE .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 6n -.rt Produces a long form of output, which is the default. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 6n -.rt Produces a short form of output. In the short form, the tty is abbreviated, the login time and \fBCPU\fR times are left off, as are the arguments to commands. .RE .sp .ne 2 -.mk .na \fB\fB-u\fR\fR .ad .RS 6n -.rt Produces the heading line which shows the current time, the length of time the system has been up, the number of users logged into the system, and the average number of jobs in the run queue over the last 1, 5 and 15 minutes. @@ -82,24 +74,20 @@ number of jobs in the run queue over the last 1, 5 and 15 minutes. .sp .ne 2 -.mk .na \fB\fB-w\fR\fR .ad .RS 6n -.rt Produces a long form of output, which is also the same as the default. .RE .SH OPERANDS .sp .ne 2 -.mk .na \fB\fIuser\fR\fR .ad .RS 8n -.rt Name of a particular user for whom login information is displayed. If specified, output is restricted to that user. .RE @@ -129,12 +117,10 @@ that affect the execution of \fBw\fR: \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and .SH FILES .sp .ne 2 -.mk .na \fB\fB/var/adm/utmpx\fR\fR .ad .RS 18n -.rt user and accounting information .RE diff --git a/usr/src/man/man1/wait.1 b/usr/src/man/man1/wait.1 index a5dc58c632..f7c6b75e6e 100644 --- a/usr/src/man/man1/wait.1 +++ b/usr/src/man/man1/wait.1 @@ -1,22 +1,22 @@ '\" te .\" Copyright (c) 2008, Sun Microsystems, Inc. All Rights Reserved .\" Copyright 1992 X/Open Company Limited -.\" Copyright 1989 AT&T +.\" Copyright 1989 AT&T .\" Portions Copyright (c) 1982-2007 AT&T Knowledge Ventures -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 wait 1 "13 Mar 2008" "SunOS 5.11" "User Commands" +.TH WAIT 1 "Mar 13, 2008" .SH NAME wait \- await process completion .SH SYNOPSIS .LP .nf - + .fi .SS "/bin/sh" @@ -110,62 +110,51 @@ terminated. If one or more job operands are specified, wait waits until all of them have completed. Each job can be specified as one of the following: .sp .ne 2 -.mk .na \fB\fInumber\fR\fR .ad .RS 12n -.rt \fInumber\fR refers to a process ID. .RE .sp .ne 2 -.mk .na \fB\fB-\fR\fInumber\fR\fR .ad .RS 12n -.rt \fInumber\fR refers to a process group ID. .RE .sp .ne 2 -.mk .na \fB\fB%\fR\fInumber\fR\fR .ad .RS 12n -.rt \fInumber\fR refers to a job number .RE .sp .ne 2 -.mk .na \fB\fB%\fR\fIstring\fR\fR .ad .RS 12n -.rt Refers to a job whose name begins with \fIstring\fR .RE .sp .ne 2 -.mk .na \fB\fB%?\fR\fIstring\fR\fR .ad .RS 12n -.rt Refers to a job whose name contains \fIstring\fR .RE .sp .ne 2 -.mk .na \fB\fB%+\fR\fR .ad @@ -174,18 +163,15 @@ Refers to a job whose name contains \fIstring\fR \fB\fB%%\fR\fR .ad .RS 12n -.rt Refers to the current job .RE .sp .ne 2 -.mk .na \fB\fB%-\fR\fR .ad .RS 12n -.rt Refers to the previous job .RE @@ -200,24 +186,20 @@ process that exited with status 127. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIpid\fR\fR .ad .RS 9n -.rt The unsigned decimal integer process \fBID\fR of a command, for which the utility is to wait for the termination. .RE .sp .ne 2 -.mk .na \fB\fIjobid\fR\fR .ad .RS 9n -.rt A job control job \fBID\fR that identifies a background process group to be waited for. The job control job \fBID\fR notation is applicable only for invocations of \fBwait\fR in the current shell execution environment, and only @@ -292,7 +274,7 @@ then either of the following commands returns the exit status of the second .in +2 .nf wait <\fIpid of sleep 31\fR> -wait %% +wait %% .fi .in -2 .sp @@ -311,24 +293,20 @@ The following exit values are returned by the \fBwait\fR built-in in \fBksh93\fR: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 7n -.rt \fBwait\fR was invoked with no operands. All processes known by the invoking process have terminated. .RE .sp .ne 2 -.mk .na \fB\fB127\fR\fR .ad .RS 7n -.rt \fIjob\fR is a process id or process group id that is unknown to the current shell environment. .RE @@ -341,15 +319,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .SH SEE ALSO diff --git a/usr/src/man/man1/wc.1 b/usr/src/man/man1/wc.1 index 0af015bb29..7411cacfa1 100644 --- a/usr/src/man/man1/wc.1 +++ b/usr/src/man/man1/wc.1 @@ -3,14 +3,14 @@ .\" Copyright 1989 AT&T .\" Portions Copyright (c) 1982-2007 AT&T Knowledge Ventures .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 wc 1 "13 Mar 2008" "SunOS 5.11" "User Commands" +.TH WC 1 "Mar 13, 2008" .SH NAME wc \- display a count of lines, words and characters in a file .SH SYNOPSIS @@ -71,7 +71,6 @@ standard input and no filename is written to standard output. The start of the file is defined as the current offset. .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad @@ -86,7 +85,6 @@ List the byte counts. .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad @@ -101,7 +99,6 @@ List the line counts. .sp .ne 2 -.mk .na \fB\fB-L\fR\fR .ad @@ -116,7 +113,6 @@ List the longest line length. .sp .ne 2 -.mk .na \fB\fB-m | C\fR\fR .ad @@ -131,7 +127,6 @@ List the character counts. .sp .ne 2 -.mk .na \fB\fB-q\fR\fR .ad @@ -146,7 +141,6 @@ Suppress invalid multi-byte character warnings. .sp .ne 2 -.mk .na \fB\fB-w\fR\fR .ad @@ -165,56 +159,46 @@ List the word counts. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad .RS 6n -.rt Counts bytes. .RE .sp .ne 2 -.mk .na \fB\fB-C\fR\fR .ad .RS 6n -.rt Same as \fB-m\fR. .RE .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 6n -.rt Counts lines. .RE .sp .ne 2 -.mk .na \fB\fB-m\fR\fR .ad .RS 6n -.rt Counts characters. .RE .sp .ne 2 -.mk .na \fB\fB-w\fR\fR .ad .RS 6n -.rt Counts words delimited by white space characters or new line characters. Delimiting characters are Extended Unix Code (\fBEUC\fR) characters from any code set defined by \fBiswspace()\fR. @@ -230,12 +214,10 @@ bytes.) The following operand is supported: .sp .ne 2 -.mk .na \fB\fIfile\fR\fR .ad .RS 8n -.rt A path name of an input file. If no \fIfile\fR operands are specified, the standard input is used. .RE @@ -254,23 +236,19 @@ that affect the execution of \fBwc\fR: \fBLANG\fR, \fBLC_ALL\fR, .SH EXIT STATUS .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -283,17 +261,16 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityCommitted +Interface Stability Committed _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .SS "ksh93" @@ -301,13 +278,12 @@ StandardSee \fBstandards\fR(5). .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilitySee below. +Interface Stability See below. .TE .sp diff --git a/usr/src/man/man1/whatis.1 b/usr/src/man/man1/whatis.1 index b5733f2b59..73435fb5cb 100644 --- a/usr/src/man/man1/whatis.1 +++ b/usr/src/man/man1/whatis.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 whatis 1 "14 Sep 1992" "SunOS 5.11" "User Commands" +.TH WHATIS 1 "Sep 14, 1992" .SH NAME whatis \- display a one-line summary about a keyword .SH SYNOPSIS @@ -32,12 +32,10 @@ fail. .SH FILES .sp .ne 2 -.mk .na \fB\fB/usr/share/man/windex\fR\fR .ad .RS 25n -.rt Table of contents and keyword database .RE @@ -49,13 +47,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled .TE .SH SEE ALSO diff --git a/usr/src/man/man1/which.1 b/usr/src/man/man1/which.1 index e9a494c6b0..f1d7177dfa 100644 --- a/usr/src/man/man1/which.1 +++ b/usr/src/man/man1/which.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 which 1 "30 Mar 2005" "SunOS 5.11" "User Commands" +.TH WHICH 1 "Mar 30, 2005" .SH NAME which \- locate a command and display its pathname or alias .SH SYNOPSIS @@ -29,12 +29,10 @@ the current shell execution environment. The following operand is supported: .sp .ne 2 -.mk .na \fB\fIname\fR\fR .ad .RS 8n -.rt The name of a command to be located. .RE @@ -44,35 +42,29 @@ The name of a command to be located. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR \fR .ad .RS 7n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR \fR .ad .RS 7n -.rt One or more \fIname\fR operands were not located or an error occurred. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB~/.cshrc\fR\fR .ad .RS 12n -.rt source of aliases and path values .RE diff --git a/usr/src/man/man1/who.1 b/usr/src/man/man1/who.1 index 35ebe42ee7..3e2c121ee7 100644 --- a/usr/src/man/man1/who.1 +++ b/usr/src/man/man1/who.1 @@ -2,14 +2,14 @@ .\" Copyright 1989 AT&T .\" Copyright (c) 2000, Sun Microsystems, Inc. All Rights Reserved .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 "3 Nov 2000" "SunOS 5.11" "User Commands" +.TH WHO 1 "Nov 3, 2000" .SH NAME who \- who is on the system .SH SYNOPSIS @@ -84,89 +84,73 @@ The general format for output is: where: .sp .ne 2 -.mk .na \fB\fIname\fR \fR .ad .RS 12n -.rt User's login name .RE .sp .ne 2 -.mk .na \fB\fIstate\fR \fR .ad .RS 12n -.rt Capability of writing to the terminal .RE .sp .ne 2 -.mk .na \fB\fIline\fR \fR .ad .RS 12n -.rt Name of the line found in \fB/dev\fR .RE .sp .ne 2 -.mk .na \fB\fItime\fR \fR .ad .RS 12n -.rt Time since user's login .RE .sp .ne 2 -.mk .na \fB\fIidle\fR \fR .ad .RS 12n -.rt Time elapsed since the user's last activity .RE .sp .ne 2 -.mk .na \fB\fIpid\fR \fR .ad .RS 12n -.rt User's process id .RE .sp .ne 2 -.mk .na \fB\fIcomment\fR \fR .ad .RS 12n -.rt Comment line in \fBinittab\fR(4) .RE .sp .ne 2 -.mk .na \fB\fIexit\fR \fR .ad .RS 12n -.rt Exit status for dead processes .RE @@ -176,12 +160,10 @@ Exit status for dead processes The following options are supported: .sp .ne 2 -.mk .na \fB\fB-a\fR \fR .ad .RS 9n -.rt Processes \fB/var/adm/utmpx\fR or the named \fIfile\fR with \fB-b\fR, \fB-d\fR, \fB-l\fR, \fB-p\fR, \fB-r\fR, \fB-t\fR, \fB-T\fR, and \fB-u\fR options turned on. @@ -189,23 +171,19 @@ on. .sp .ne 2 -.mk .na \fB\fB-b\fR \fR .ad .RS 9n -.rt Indicates the time and date of the last reboot. .RE .sp .ne 2 -.mk .na \fB\fB-d\fR \fR .ad .RS 9n -.rt 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 @@ -214,23 +192,19 @@ can be useful in determining why a process terminated. .sp .ne 2 -.mk .na \fB\fB-H\fR \fR .ad .RS 9n -.rt Outputs column headings above the regular output. .RE .sp .ne 2 -.mk .na \fB\fB-l\fR \fR .ad .RS 9n -.rt Lists only those lines on which the system is waiting for someone to login. The \fIname\fR field is \fBLOGIN\fR in such cases. Other fields are the same as for user entries except that the \fIstate\fR field does not exist. @@ -238,23 +212,19 @@ user entries except that the \fIstate\fR field does not exist. .sp .ne 2 -.mk .na \fB\fB-m\fR \fR .ad .RS 9n -.rt Outputs only information about the current terminal. .RE .sp .ne 2 -.mk .na \fB\fB-n\fR \fIx\fR \fR .ad .RS 9n -.rt Takes a numeric argument, \fIx\fR, which specifies the number of users to display per line. \fIx\fR must be at least \fB1\fR. The \fB-n\fR option can only be used with \fB-q\fR. @@ -262,12 +232,10 @@ only be used with \fB-q\fR. .sp .ne 2 -.mk .na \fB\fB-p\fR \fR .ad .RS 9n -.rt Lists any other process that is currently active and has been previously spawned by \fBinit\fR. The \fIname\fR field is the name of the program executed by \fBinit\fR as found in \fB/sbin/inittab\fR. The \fIstate\fR, \fIline\fR, and @@ -278,80 +246,66 @@ field of the line from \fB/sbin/inittab\fR that spawned this process. See .sp .ne 2 -.mk .na \fB\fB-q\fR \fR .ad .RS 9n -.rt (Quick \fBwho\fR) Displays only the names and the number of users currently logged on. When this option is used, all other options are ignored. .RE .sp .ne 2 -.mk .na \fB\fB-r\fR \fR .ad .RS 9n -.rt Indicates the current \fIrun-level\fR of the \fBinit\fR process. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR \fR .ad .RS 9n -.rt (Default) Lists only the \fIname\fR, \fIline\fR, and \fItime\fR fields. .RE .SS "/usr/bin/who" .sp .ne 2 -.mk .na \fB\fB-T\fR \fR .ad .RS 7n -.rt Same as the \fB-s\fR option, except that the \fIstate\fR \fIidle\fR, \fIpid\fR, and \fIcomment\fR, fields are also written. \fIstate\fR is one of the following characters: .sp .ne 2 -.mk .na \fB\fB+\fR \fR .ad .RS 9n -.rt The terminal allows write access to other users. .RE .sp .ne 2 -.mk .na \fB\fB\(mi\fR \fR .ad .RS 9n -.rt The terminal denies write access to other users. .RE .sp .ne 2 -.mk .na \fB\fB?\fR \fR .ad .RS 9n -.rt The terminal write-access state cannot be determined. .RE @@ -360,12 +314,10 @@ The terminal write-access state cannot be determined. .SS "/usr/xpg4/bin/who" .sp .ne 2 -.mk .na \fB\fB-T\fR \fR .ad .RS 7n -.rt Same as the \fB-s\fR option, except that the \fIstate\fR field is also written. \fIstate\fR is one of the characters listed under the \fB/usr/bin/who\fR version of this option. If the \fB-u\fR option is used with \fB-T\fR, the idle @@ -374,24 +326,20 @@ time is added to the end of the previous format. .sp .ne 2 -.mk .na \fB\fB-t\fR \fR .ad .RS 7n -.rt Indicates the last change to the system clock (using the \fBdate\fR utility) by \fBroot\fR. See \fBsu\fR(1M) and \fBdate\fR(1). .RE .sp .ne 2 -.mk .na \fB\fB-u\fR \fR .ad .RS 7n -.rt Lists only those users who are currently logged in. The \fIname\fR is the user's login name. The \fIline\fR is the name of the line as found in the directory \fB/dev\fR. The \fItime\fR is the time that the user logged in. The @@ -414,7 +362,6 @@ and so forth. The following operands are supported: .sp .ne 2 -.mk .na \fB\fBam\fR \fBi\fR \fR .ad @@ -423,7 +370,6 @@ The following operands are supported: \fB\fBam\fR \fBI\fR \fR .ad .RS 9n -.rt In the "C" locale, limits the output to describing the invoking user, equivalent to the \fB-m\fR option. The \fBam\fR and \fBi\fR or \fBI\fR must be separate arguments. @@ -431,12 +377,10 @@ separate arguments. .sp .ne 2 -.mk .na \fB\fIfile\fR \fR .ad .RS 9n -.rt Specifies a path name of a file to substitute for the database of logged-on users that \fBwho\fR uses by default. .RE @@ -453,57 +397,47 @@ that affect the execution of \fBwho\fR: \fBLANG\fR, \fBLC_ALL\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR \fR .ad .RS 7n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR \fR .ad .RS 7n -.rt An error occurred. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB/sbin/inittab\fR \fR .ad .RS 19n -.rt Script for \fBinit\fR .RE .sp .ne 2 -.mk .na \fB\fB/var/adm/utmpx\fR \fR .ad .RS 19n -.rt Current user and accounting information .RE .sp .ne 2 -.mk .na \fB\fB/var/adm/wtmpx\fR \fR .ad .RS 19n -.rt Historic user and accounting information .RE @@ -516,13 +450,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man1/whocalls.1 b/usr/src/man/man1/whocalls.1 index becc546b1b..6c8d6b9c1a 100644 --- a/usr/src/man/man1/whocalls.1 +++ b/usr/src/man/man1/whocalls.1 @@ -3,13 +3,13 @@ .\" 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 whocalls 1 "3 Jul 2007" "SunOS 5.11" "User Commands" +.TH WHOCALLS 1 "Jul 3, 2007" .SH NAME whocalls \- report on the calls to a specific procedure .SH SYNOPSIS .LP .nf -\fBwhocalls\fR [\fB-l\fR \fIwholib\fR] [\fB-s\fR] \fIfuncname\fR \fIexecutable\fR +\fBwhocalls\fR [\fB-l\fR \fIwholib\fR] [\fB-s\fR] \fIfuncname\fR \fIexecutable\fR [\fIarguments\fR]... .fi @@ -29,23 +29,19 @@ trace are displayed on standard output. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-l\fR \fIwholib\fR\fR .ad .RS 13n -.rt Specifies an alternate \fBwho.so\fR \fILink-Auditing\fR library to use. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 13n -.rt When available, examines and uses the \fB\&.symtab\fR symbol table for local symbols. This is a little more expensive than using the \fB\&.dynsym\fR symbol table, but can produce more detailed stack trace information. diff --git a/usr/src/man/man1/whois.1 b/usr/src/man/man1/whois.1 index dbe4136f7f..babc6fa22d 100644 --- a/usr/src/man/man1/whois.1 +++ b/usr/src/man/man1/whois.1 @@ -1,4 +1,4 @@ -.TH WHOIS 1 "October 2, 2009" "" +.TH WHOIS 1 "Oct 2, 2009" .SH NAME \fBwhois\fP \- Internet domain name and network number directory service diff --git a/usr/src/man/man1/write.1 b/usr/src/man/man1/write.1 index a0674e85d4..6a699ed901 100644 --- a/usr/src/man/man1/write.1 +++ b/usr/src/man/man1/write.1 @@ -2,14 +2,14 @@ .\" Copyright 1989 AT&T .\" Copyright (c) 2000, Sun Microsystems, Inc. All Rights Reserved .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 write 1 "3 Nov 2000" "SunOS 5.11" "User Commands" +.TH WRITE 1 "Nov 3, 2000" .SH NAME write \- write to another user .SH SYNOPSIS @@ -148,24 +148,20 @@ be terminated. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIuser\fR\fR .ad .RS 12n -.rt User (login) name of the person to whom the message will be written. This operand must be of the form returned by the \fBwho\fR(1) utility. .RE .sp .ne 2 -.mk .na \fB\fIterminal\fR\fR .ad .RS 12n -.rt Terminal identification in the same format provided by the \fBwho\fR utility. .RE @@ -181,46 +177,38 @@ that affect the execution of \fBwrite\fR: \fBLANG\fR, \fBLC_ALL\fR, The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt The addressed user is not logged on or the addressed user denies permission. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB/var/adm/utmpx\fR\fR .ad .RS 18n -.rt User and accounting information for \fBwrite\fR .RE .sp .ne 2 -.mk .na \fB\fB/usr/bin/sh\fR\fR .ad .RS 18n -.rt Bourne shell executable file .RE @@ -232,17 +220,16 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityCommitted +Interface Stability Committed _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .SH SEE ALSO @@ -254,7 +241,6 @@ StandardSee \fBstandards\fR(5). .SH DIAGNOSTICS .sp .ne 2 -.mk .na \fB\fBuser is not logged on\fR\fR .ad @@ -265,7 +251,6 @@ The person you are trying to \fBwrite\fR to is not logged on. .sp .ne 2 -.mk .na \fB\fBPermission denied\fR\fR .ad @@ -277,7 +262,6 @@ The person you are trying to \fBwrite\fR to denies that permission (with .sp .ne 2 -.mk .na \fB\fBWarning: cannot respond, set mesg\fR\fB-y\fR\fR .ad @@ -289,7 +273,6 @@ you. .sp .ne 2 -.mk .na \fB\fBCan no longer write to user\fR\fR .ad diff --git a/usr/src/man/man1/xargs.1 b/usr/src/man/man1/xargs.1 index 12b3f1fd73..7419d44abc 100644 --- a/usr/src/man/man1/xargs.1 +++ b/usr/src/man/man1/xargs.1 @@ -1,20 +1,20 @@ '\" te .\" Copyright 1989 AT&T Copyright (c) 1992, X/Open Company Limited All Rights Reserved Portions Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" 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 xargs 1 "17 Jul 2007" "SunOS 5.11" "User Commands" +.TH XARGS 1 "Jul 17, 2007" .SH NAME xargs \- construct argument lists and invoke utility .SH SYNOPSIS .LP .nf -\fBxargs\fR [\fB-t\fR] [\fB-p\fR] [\fB-e\fR[\fIeofstr\fR]] [\fB-E\fR \fIeofstr\fR] - [\fB-I\fR \fIreplstr\fR] [\fB-i\fR[\fIreplstr\fR]] [\fB-L\fR \fInumber\fR] [\fB-l\fR[\fInumber\fR]] +\fBxargs\fR [\fB-t\fR] [\fB-p\fR] [\fB-e\fR[\fIeofstr\fR]] [\fB-E\fR \fIeofstr\fR] + [\fB-I\fR \fIreplstr\fR] [\fB-i\fR[\fIreplstr\fR]] [\fB-L\fR \fInumber\fR] [\fB-l\fR[\fInumber\fR]] [\fB-n\fR \fInumber\fR [\fB-x\fR]] [\fB-s\fR \fIsize\fR] [\fIutility\fR [\fIargument\fR...]] .fi @@ -54,12 +54,10 @@ specified, the default command line length is at least \fB{LINE_MAX}\fR. The following options are supported: .sp .ne 2 -.mk .na \fB\fB\fR\fB-e\fR\fB[\fR\fIeofstr\fR\fB]\fR\fR .ad .RS 15n -.rt Uses \fIeofstr\fR as the logical end-of-file string. Underscore (\fB_\fR) is assumed for the logical \fBEOF\fR string if neither \fB-e\fR nor \fB-E\fR is used. When the \fIeofstr\fR option-argument is omitted, the logical \fBEOF\fR @@ -70,12 +68,10 @@ logical \fBEOF\fR string is encountered. .sp .ne 2 -.mk .na \fB\fB-E\fR \fIeofstr\fR\fR .ad .RS 15n -.rt Specifies a logical end-of-file string to replace the default underscore. \fBxargs\fR reads standard input until either end-of-file or the logical EOF string is encountered. When \fIeofstr\fR is a null string, the logical @@ -85,12 +81,10 @@ literally. .sp .ne 2 -.mk .na \fB\fB-I\fR \fIreplstr\fR\fR .ad .RS 15n -.rt Insert mode. \fIutility\fR is executed for each line from standard input, taking the entire line as a single argument, inserting it in \fIargument\fR \fIs\fR for each occurrence of \fIreplstr\fR. A maximum of five arguments in @@ -103,24 +97,20 @@ takes effect. .sp .ne 2 -.mk .na \fB\fB\fR\fB-i\fR\fB[\fR\fIreplstr\fR\fB]\fR\fR .ad .RS 15n -.rt This option is equivalent to \fB-I\fR \fIreplstr\fR. The string \fB{\|}\fR is assumed for \fIreplstr\fR if the option-argument is omitted. .RE .sp .ne 2 -.mk .na \fB\fB-L\fR \fInumber\fR\fR .ad .RS 15n -.rt The \fIutility\fR is executed for each non-empty \fInumber\fR lines of arguments from standard input. The last invocation of \fIutility\fR is with fewer lines of arguments if fewer than \fInumber\fR remain. A line is @@ -132,24 +122,20 @@ options are mutually exclusive; the last one specified takes effect. .sp .ne 2 -.mk .na \fB\fB-l[\fR\fInumber\fR\fB]\fR\fR .ad .RS 15n -.rt (The letter ell.) This option is equivalent to \fB-L\fR \fInumber\fR. If \fInumber\fR is omitted, \fB1\fR is assumed. Option \fB-x\fR is forced on. .RE .sp .ne 2 -.mk .na \fB\fB-n\fR \fInumber\fR\fR .ad .RS 15n -.rt Invokes \fIutility\fR using as many standard input arguments as possible, up to \fInumber\fR (a positive decimal integer) arguments maximum. Fewer arguments are used if: @@ -171,12 +157,10 @@ remaining. .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 15n -.rt Prompt mode. The user is asked whether to execute \fIutility\fR at each invocation. Trace mode (\fB-t\fR) is turned on to write the command instance to be executed, followed by a prompt to standard error. An affirmative response @@ -186,12 +170,10 @@ otherwise, that particular invocation of \fIutility\fR is skipped. .sp .ne 2 -.mk .na \fB\fB-s\fR \fIsize\fR\fR .ad .RS 15n -.rt Invokes \fIutility\fR using as many standard input arguments as possible yielding a command line length less than \fIsize\fR (a positive decimal integer) bytes. Fewer arguments are used if: @@ -223,24 +205,20 @@ uses the largest value it supports within the constraints. .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad .RS 6n -.rt Enables trace mode. Each generated command line is written to standard error just prior to invocation. .RE .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad .RS 6n -.rt Terminates if a command line containing \fInumber\fR arguments (see the \fB-n\fR option above) or \fInumber\fR lines (see the \fB-L\fR option above) does not fit in the implied or specified size (see the \fB-s\fR option above). @@ -252,12 +230,10 @@ does not fit in the implied or specified size (see the \fB-s\fR option above). The following operands are supported: .sp .ne 2 -.mk .na \fB\fIutility\fR\fR .ad .RS 12n -.rt The name of the utility to be invoked, found by search path using the \fBPATH\fR environment variable. (ee \fBenviron\fR(5).) If \fIutility\fR is omitted, the default is the \fBecho\fR(1) utility. If the \fIutility\fR operand @@ -267,12 +243,10 @@ results are undefined. .sp .ne 2 -.mk .na \fB\fIargument\fR\fR .ad .RS 12n -.rt An initial option or operand for the invocation of \fIutility\fR. .RE @@ -393,12 +367,10 @@ that affect the execution of \fBxargs\fR: \fBLANG\fR, \fBLC_ALL\fR, \fBLC_COLLATE\fR, \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and \fBNLSPATH\fR. .sp .ne 2 -.mk .na \fB\fBPATH\fR\fR .ad .RS 8n -.rt Determine the location of \fIutility\fR. .RE @@ -418,23 +390,19 @@ expression defined for the \fByesexpr\fR. See \fBlocale\fR(5). The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 12n -.rt All invocations of \fIutility\fR returned exit status \fB0\fR. .RE .sp .ne 2 -.mk .na \fB\fB1\(mi125\fR\fR .ad .RS 12n -.rt A command line meeting the specified requirements could not be assembled, one or more of the invocations of \fIutility\fR returned a non-zero exit status, or some other error occurred. @@ -442,23 +410,19 @@ some other error occurred. .sp .ne 2 -.mk .na \fB\fB126\fR\fR .ad .RS 12n -.rt The utility specified by \fIutility\fR was found but could not be invoked. .RE .sp .ne 2 -.mk .na \fB\fB127\fR\fR .ad .RS 12n -.rt The utility specified by \fIutility\fR could not be found. .RE @@ -477,15 +441,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man1/xgettext.1 b/usr/src/man/man1/xgettext.1 index 6109d081e6..c1286f01b5 100644 --- a/usr/src/man/man1/xgettext.1 +++ b/usr/src/man/man1/xgettext.1 @@ -3,14 +3,14 @@ .\" 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 xgettext 1 "23 Mar 1999" "SunOS 5.11" "User Commands" +.TH XGETTEXT 1 "Mar 23, 1999" .SH NAME xgettext \- extract gettext call strings from C programs .SH SYNOPSIS .LP .nf -\fBxgettext\fR [\fB-ns\fR] [\fB-a\fR [\fB-x\fR \fIexclude-file\fR]] [\fB-c\fR \fIcomment-tag\fR] - [\fB-d\fR \fIdefault-domain\fR] [\fB-j\fR] [\fB-m\fR \fIprefix\fR] [\fB-M\fR \fIsuffix\fR] +\fBxgettext\fR [\fB-ns\fR] [\fB-a\fR [\fB-x\fR \fIexclude-file\fR]] [\fB-c\fR \fIcomment-tag\fR] + [\fB-d\fR \fIdefault-domain\fR] [\fB-j\fR] [\fB-m\fR \fIprefix\fR] [\fB-M\fR \fIsuffix\fR] [\fB-p\fR \fIpathname\fR] \fB-|\fR \fIfilename\fR... .fi @@ -56,19 +56,17 @@ option is used. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 21n -.rt Add comment lines to the output file indicating file name and line number in the source file where each extracted string is encountered. These lines appear before each \fImsgid\fR in the following format: .sp .in +2 .nf -# # File: \fIfilename\fR, line: \fIline-number\fR +# # File: \fIfilename\fR, line: \fIline-number\fR .fi .in -2 .sp @@ -77,36 +75,30 @@ before each \fImsgid\fR in the following format: .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 21n -.rt Generate output sorted by \fImsgid\fRs with all duplicate \fImsgid\fRs removed. .RE .sp .ne 2 -.mk .na \fB\fB-a\fR\fR .ad .RS 21n -.rt Extract all strings, not just those found in \fBgettext\fR(3C), and \fBdgettext()\fR () calls. Only one \fB\&.po\fR file is created. .RE .sp .ne 2 -.mk .na \fB\fB-c\fR \fIcomment-tag\fR\fR .ad .RS 21n -.rt The comment block beginning with \fIcomment-tag\fR as the first token of the comment block is added to the output \fB\&.po\fR file as \fI#\fR delimited comments. For multiple domains, \fBxgettext\fR directs comments and messages to @@ -115,24 +107,20 @@ the prevailing text domain. .sp .ne 2 -.mk .na \fB\fB-d\fR \fIdefault-domain\fR\fR .ad .RS 21n -.rt Rename default output file from \fBmessages.po\fR to \fIdefault-domain\fR \fB\&.po\fR. .RE .sp .ne 2 -.mk .na \fB\fB-j\fR\fR .ad .RS 21n -.rt Join messages with existing message files. If a \fB\&.po\fR file does not exist, it is created. If a \fB\&.po\fR file does exist, new messages are appended. Any duplicate \fBmsgid\fRs are commented out in the resulting @@ -142,12 +130,10 @@ ignored. Results not guaranteed if the existing message file has been edited. .sp .ne 2 -.mk .na \fB\fB-m\fR \fIprefix\fR\fR .ad .RS 21n -.rt Fill in the \fImsgstr\fR with \fIprefix\fR. This is useful for debugging purposes. To make \fImsgstr\fR identical to \fImsgid\fR, use an empty string (\fB""\fR) for \fIprefix\fR. @@ -155,36 +141,30 @@ purposes. To make \fImsgstr\fR identical to \fImsgid\fR, use an empty string .sp .ne 2 -.mk .na \fB\fB-M\fR \fIsuffix\fR\fR .ad .RS 21n -.rt Fill in the \fImsgstr\fR with \fIsuffix\fR. This is useful for debugging purposes. .RE .sp .ne 2 -.mk .na \fB\fB-p\fR \fIpathname\fR\fR .ad .RS 21n -.rt Specify the directory where the output files will be placed. This option overrides the current working directory. .RE .sp .ne 2 -.mk .na \fB\fB-x\fR \fIexclude-file\fR\fR .ad .RS 21n -.rt Specify a \fB\&.po\fR file that contains a list of \fImsgid\fRs that are not to be extracted from the input files. The format of \fIexclude-file\fR is identical to the \fB\&.po\fR file. However, only the \fImsgid\fR directive line @@ -194,12 +174,10 @@ in \fIexclude-file\fR is used. All other lines are simply ignored. The .sp .ne 2 -.mk .na \fB\fB-h\fR\fR .ad .RS 21n -.rt Print a help message on the standard output. .RE diff --git a/usr/src/man/man1/xstr.1 b/usr/src/man/man1/xstr.1 index 8e30ef53b7..c81584bc94 100644 --- a/usr/src/man/man1/xstr.1 +++ b/usr/src/man/man1/xstr.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 xstr 1 "14 Sep 1992" "SunOS 5.11" "User Commands" +.TH XSTR 1 "Sep 14, 1992" .SH NAME xstr \- extract strings from C programs to implement shared strings .SH SYNOPSIS @@ -101,35 +101,29 @@ thus \fBmake\fR(1S) can avoid remaking \fBxs.o\fR unless truly necessary. .SH OPTIONS .sp .ne 2 -.mk .na \fB\fB\(mic \fR\fIfilename\fR\fR .ad .RS 18n -.rt Take C source text from \fIfilename\fR. .RE .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 18n -.rt Verbose: display a progress report indicating where new or duplicate strings were found. .RE .sp .ne 2 -.mk .na \fB\fB\(mil \fR\fIarray\fR\fR .ad .RS 18n -.rt Specify the named \fIarray\fR in program references to abstracted strings. The default array name is \fBxstr\fR. .RE @@ -137,45 +131,37 @@ The default array name is \fBxstr\fR. .SH FILES .sp .ne 2 -.mk .na \fB\fBstrings\fR\fR .ad .RS 12n -.rt data base of strings .RE .sp .ne 2 -.mk .na \fB\fBx.c\fR\fR .ad .RS 12n -.rt massaged C source .RE .sp .ne 2 -.mk .na \fB\fBxs.c\fR\fR .ad .RS 12n -.rt C source for definition of array "xstr*(rq .RE .sp .ne 2 -.mk .na \fB\fB/tmp/xs*\fR\fR .ad .RS 12n -.rt temp file when \fBxstr \fR\fIfilename\fR doesn't touch \fBstrings\fR .RE diff --git a/usr/src/man/man1/yacc.1 b/usr/src/man/man1/yacc.1 index 3d7ce7d18e..9d2d8ca16b 100644 --- a/usr/src/man/man1/yacc.1 +++ b/usr/src/man/man1/yacc.1 @@ -8,13 +8,13 @@ .\" 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 yacc 1 "24 Aug 2009" "SunOS 5.11" "User Commands" +.TH YACC 1 "Aug 24, 2009" .SH NAME yacc \- yet another compiler-compiler .SH SYNOPSIS .LP .nf -\fByacc\fR [\fB-dltVv\fR] [\fB-b\fR \fIfile_prefix\fR] [\fB-Q\fR [y | n]] +\fByacc\fR [\fB-dltVv\fR] [\fB-b\fR \fIfile_prefix\fR] [\fB-Q\fR [y | n]] [\fB-P\fR \fIparser\fR] [\fB-p\fR \fIsym_prefix\fR] \fIfile\fR .fi @@ -37,12 +37,10 @@ command is useful for creating lexical analyzers usable by \fByacc\fR. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-b\fR \fIfile_prefix\fR\fR .ad .RS 18n -.rt Uses \fIfile_prefix\fR instead of \fBy\fR as the prefix for all output files. The code file \fBy.tab.c\fR, the header file \fBy.tab.h\fR (created when \fB-d\fR is specified), and the description file \fBy.output\fR (created when @@ -53,12 +51,10 @@ respectively. .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad .RS 18n -.rt Generates the file \fBy.tab.h\fR with the \fB#define\fR statements that associate the \fByacc\fR user-assigned "token codes" with the user-declared "token names". This association allows source files other than \fBy.tab.c\fR to @@ -67,12 +63,10 @@ access the token codes. .sp .ne 2 -.mk .na \fB\fB-l\fR\fR .ad .RS 18n -.rt Specifies that the code produced in \fBy.tab.c\fR does not contain any \fB#line\fR constructs. This option should only be used after the grammar and the associated actions are fully debugged. @@ -80,12 +74,10 @@ the associated actions are fully debugged. .sp .ne 2 -.mk .na \fB\fB-p\fR \fIsym_prefix\fR\fR .ad .RS 18n -.rt Uses \fIsym_prefix\fR instead of \fByy\fR as the prefix for all external names produced by \fByacc\fR. The names affected include the functions \fByyparse()\fR, \fByylex()\fR and \fByyerror()\fR, and the variables @@ -98,12 +90,10 @@ generated by \fByacc\fR. .sp .ne 2 -.mk .na \fB\fB-P\fR \fIparser\fR\fR .ad .RS 18n -.rt Allows you to specify the parser of your choice instead of \fB/usr/share/lib/ccs/yaccpar\fR. For example, you can specify: .sp @@ -118,12 +108,10 @@ example% \fByacc -P ~/myparser parser.y\fR .sp .ne 2 -.mk .na \fB\fB-Q\fR[\fBy\fR|\fBn\fR]\fR .ad .RS 18n -.rt The \fB-Qy\fR option puts the version stamping information in \fBy.tab.c\fR. This allows you to know what version of \fByacc\fR built the file. The \fB-Qn\fR option (the default) writes no version information. @@ -131,12 +119,10 @@ This allows you to know what version of \fByacc\fR built the file. The .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad .RS 18n -.rt Compiles runtime debugging code by default. Runtime debugging code is always generated in \fBy.tab.c\fR under conditional compilation control. By default, this code is not included when \fBy.tab.c\fR is compiled. Whether or not the @@ -149,24 +135,20 @@ runtime debugging code is smaller and slightly faster. .sp .ne 2 -.mk .na \fB\fB-v\fR\fR .ad .RS 18n -.rt Prepares the file \fBy.output\fR, which contains a description of the parsing tables and a report on conflicts generated by ambiguities in the grammar. .RE .sp .ne 2 -.mk .na \fB\fB-V\fR\fR .ad .RS 18n -.rt Prints on the standard error output the version information for \fByacc\fR. .RE @@ -176,12 +158,10 @@ Prints on the standard error output the version information for \fByacc\fR. The following operand is required: .sp .ne 2 -.mk .na \fB\fIfile\fR\fR .ad .RS 8n -.rt A path name of a file containing instructions for which a parser is to be created. .RE @@ -271,101 +251,83 @@ character (\fBwchar_t\fR) value for these one-token symbols. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fBy.output\fR\fR .ad .RS 14n -.rt state transitions of the generated parser .RE .sp .ne 2 -.mk .na \fB\fBy.tab.c\fR\fR .ad .RS 14n -.rt source code of the generated parser .RE .sp .ne 2 -.mk .na \fB\fBy.tab.h\fR\fR .ad .RS 14n -.rt header file for the generated parser .RE .sp .ne 2 -.mk .na \fB\fByacc.acts\fR\fR .ad .RS 14n -.rt temporary file .RE .sp .ne 2 -.mk .na \fB\fByacc.debug\fR\fR .ad .RS 14n -.rt temporary file .RE .sp .ne 2 -.mk .na \fB\fByacc.tmp\fR\fR .ad .RS 14n -.rt temporary file .RE .sp .ne 2 -.mk .na \fB\fByaccpar\fR\fR .ad .RS 14n -.rt parser prototype for C programs .RE @@ -377,15 +339,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .SH SEE ALSO diff --git a/usr/src/man/man1/yes.1 b/usr/src/man/man1/yes.1 index 15d8a4255a..fb6a77c09a 100644 --- a/usr/src/man/man1/yes.1 +++ b/usr/src/man/man1/yes.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 yes 1 "20 Dec 2006" "SunOS 5.11" "User Commands" +.TH YES 1 "Dec 20, 2006" .SH NAME yes \- generate repetitive affirmative output .SH SYNOPSIS diff --git a/usr/src/man/man1/ypcat.1 b/usr/src/man/man1/ypcat.1 index b0ea3b5e67..b20390ae06 100644 --- a/usr/src/man/man1/ypcat.1 +++ b/usr/src/man/man1/ypcat.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 ypcat 1 "23 Jan 1995" "SunOS 5.11" "User Commands" +.TH YPCAT 1 "Jan 23, 1995" .SH NAME ypcat \- print values in a NIS database .SH SYNOPSIS @@ -24,12 +24,10 @@ Refer to \fBypfiles\fR(4) for an overview of the NIS name service. .SH OPTIONS .sp .ne 2 -.mk .na \fB\fB-k\fR\fR .ad .RS 15n -.rt Display the keys for those maps in which the values are null or the key is not part of the value. None of the maps derived from files that have an ASCII version in \fB/etc\fR fall into this class. @@ -37,23 +35,19 @@ version in \fB/etc\fR fall into this class. .sp .ne 2 -.mk .na \fB\fB-d\fR\fI ypdomain\fR\fR .ad .RS 15n -.rt Specify a domain other than the default domain. .RE .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad .RS 15n -.rt Display map nicknames. .RE diff --git a/usr/src/man/man1/ypmatch.1 b/usr/src/man/man1/ypmatch.1 index 711c19c2c2..0b17cc92c5 100644 --- a/usr/src/man/man1/ypmatch.1 +++ b/usr/src/man/man1/ypmatch.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 ypmatch 1 "22 Aug 1997" "SunOS 5.11" "User Commands" +.TH YPMATCH 1 "Aug 22, 1997" .SH NAME ypmatch \- print the value of one or more keys from a NIS map .SH SYNOPSIS @@ -34,46 +34,38 @@ a key is not matched, a diagnostic message is produced. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-k\fR\fR .ad .RS 13n -.rt Before printing the value of a key, print the key itself, followed by a colon (\fB:\fR). .RE .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad .RS 13n -.rt Inhibit map nickname translation. .RE .sp .ne 2 -.mk .na \fB\fB-d\fR\fI domain\fR\fR .ad .RS 13n -.rt Specify a domain other than the default domain. .RE .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad .RS 13n -.rt Display the map nickname table. This lists the nicknames the command knows of, and indicates the map name associated with each nickname. .RE @@ -84,12 +76,10 @@ and indicates the map name associated with each nickname. The following operand is supported: .sp .ne 2 -.mk .na \fB\fImname\fR\fR .ad .RS 9n -.rt The \fBNIS's\fR name services map .RE @@ -99,23 +89,19 @@ The \fBNIS's\fR name services map The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt Successful operation. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt An error occurred. .RE diff --git a/usr/src/man/man1/yppasswd.1 b/usr/src/man/man1/yppasswd.1 index fca18bb55b..ee1db76297 100644 --- a/usr/src/man/man1/yppasswd.1 +++ b/usr/src/man/man1/yppasswd.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 yppasswd 1 "28 Nov 2001" "SunOS 5.11" "User Commands" +.TH YPPASSWD 1 "Nov 28, 2001" .SH NAME yppasswd \- change your network password in the NIS database .SH SYNOPSIS diff --git a/usr/src/man/man1/ypwhich.1 b/usr/src/man/man1/ypwhich.1 index e449f40298..957f1acd4f 100644 --- a/usr/src/man/man1/ypwhich.1 +++ b/usr/src/man/man1/ypwhich.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 ypwhich 1 "7 Apr 1995" "SunOS 5.11" "User Commands" +.TH YPWHICH 1 "Apr 7, 1995" .SH NAME ypwhich \- return name of NIS server or map master .SH SYNOPSIS @@ -30,34 +30,28 @@ Refer to \fBypfiles\fR(4) for an overview of the NIS name services. .SH OPTIONS .sp .ne 2 -.mk .na \fB\fB-d\fR\fI domain\fR\fR .ad .RS 13n -.rt Use \fIdomain\fR instead of the default domain. .RE .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad .RS 13n -.rt This option inhibits map nickname translation. .RE .sp .ne 2 -.mk .na \fB\fB-m\fR\fI mname\fR\fR .ad .RS 13n -.rt Find the master NIS server for a map. No \fBhostname\fR can be specified with \fB-m\fR. \fImname\fR can be a mapname, or a nickname for a map. When \fImname\fR is omitted, produce a list of available maps. @@ -65,23 +59,19 @@ Find the master NIS server for a map. No \fBhostname\fR can be specified with .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad .RS 13n -.rt Display the map nickname translation table. .RE .sp .ne 2 -.mk .na \fB\fB\(miVn\fR\fR .ad .RS 13n -.rt Version of \fBypbind\fR, V3 is default. .RE diff --git a/usr/src/man/man1/zlogin.1 b/usr/src/man/man1/zlogin.1 index 554522a0f2..c66c972cb6 100644 --- a/usr/src/man/man1/zlogin.1 +++ b/usr/src/man/man1/zlogin.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 zlogin 1 "18 Dec 2006" "SunOS 5.11" "User Commands" +.TH ZLOGIN 1 "Dec 18, 2006" .SH NAME zlogin \- enter a zone .SH SYNOPSIS @@ -14,7 +14,7 @@ zlogin \- enter a zone .LP .nf -\fBzlogin\fR [\fB-ES\fR] [\fB-e\fR \fIc\fR] [\fB-l\fR \fIusername\fR] \fIzonename\fR \fIutility\fR +\fBzlogin\fR [\fB-ES\fR] [\fB-e\fR \fIc\fR] [\fB-l\fR \fIusername\fR] \fIzonename\fR \fIutility\fR [\fIargument\fR]... .fi @@ -29,12 +29,10 @@ utility. \fBzlogin\fR operates in one of three modes: .sp .ne 2 -.mk .na \fBInteractive Mode\fR .ad .RS 24n -.rt If no utility argument is given and the stdin file descriptor for the \fBzlogin\fR process is a tty device, \fBzlogin\fR operates in \fBinteractive mode\fR. In this mode, \fBzlogin\fR creates a new pseudo terminal for use @@ -45,12 +43,10 @@ within the login session. Programs requiring a tty device, for example, .sp .ne 2 -.mk .na \fBNon-Interactive Mode\fR .ad .RS 24n -.rt If a utility is specified, \fBzlogin\fR operates in \fBnon-interactive mode\fR. This mode can be useful for script authors since stdin, stdout, and stderr are preserved and the exit status of \fIutility\fR is returned upon termination. In @@ -63,12 +59,10 @@ in the non-global zone. See \fBrsh\fR(1). .sp .ne 2 -.mk .na \fBConsole Mode\fR .ad .RS 24n -.rt If the \fB-C\fR option is specified, the user is connected to the zone console device and \fBzlogin\fR operates in \fBconsole mode\fR. The zone console is available once the zone is in the installed state. Connections to the console @@ -81,23 +75,19 @@ are persistent across reboot of the zone. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-C\fR\fR .ad .RS 15n -.rt Connects to the zone console. .RE .sp .ne 2 -.mk .na \fB\fB-e\fR \fIc\fR\fR .ad .RS 15n -.rt Specifies a different escape character, \fIc\fR, for the key sequence used to access extended functions and to disconnect from the login. The default escape character is the tilde (\fB~\fR). @@ -105,24 +95,20 @@ character is the tilde (\fB~\fR). .sp .ne 2 -.mk .na \fB\fB-E\fR\fR .ad .RS 15n -.rt Disables the ability to access extended functions or to disconnect from the login by using the escape sequence character. .RE .sp .ne 2 -.mk .na \fB\fB-l\fR \fIusername\fR\fR .ad .RS 15n -.rt Specifies a different \fIusername\fR for the zone login. If you do not use this option, the zone username used is "root". This option is invalid if the \fB-C\fR option is specified. @@ -130,12 +116,10 @@ option, the zone username used is "root". This option is invalid if the .sp .ne 2 -.mk .na \fB\fB-S\fR\fR .ad .RS 15n -.rt "Safe" login mode. \fBzlogin\fR does minimal processing and does not invoke \fBlogin\fR(1) or \fBsu\fR(1M). The \fB-S\fR option can not be used if a username is specified through the \fB-l\fR option, and cannot be used with @@ -150,12 +134,10 @@ Lines that you type that start with the tilde character (\fB~\fR) are "escape sequences". The escape character can be changed using the \fB-e\fR option. .sp .ne 2 -.mk .na \fB\fB~.\fR\fR .ad .RS 6n -.rt Disconnects from the zone. This is not the same as a logout, because the local host breaks the connection with no warning to the zone's end. .RE @@ -171,34 +153,28 @@ process cannot change zone again, nor can any of its children. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIzonename\fR\fR .ad .RS 15n -.rt The name of the zone to be entered. .RE .sp .ne 2 -.mk .na \fB\fIutility\fR\fR .ad .RS 15n -.rt The utility to be run in the specified zone. .RE .sp .ne 2 -.mk .na \fB\fIargument...\fR\fR .ad .RS 15n -.rt Arguments passed to the utility. .RE @@ -221,34 +197,28 @@ to perform the requested operation, \fBzlogin\fR exits with status \fB1\fR. To summarize, the following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 7n -.rt Successful entry. .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 7n -.rt Permission denied, or failure to enter the zone. .RE .sp .ne 2 -.mk .na \fBAny\fR .ad .RS 7n -.rt Return code from utility, or from \fBsu\fR(1M) if operating in non-interactive mode. .RE @@ -261,13 +231,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityEvolving +Interface Stability Evolving .TE .SH SEE ALSO diff --git a/usr/src/man/man1/zonename.1 b/usr/src/man/man1/zonename.1 index 5f347b04da..3d75a3265b 100644 --- a/usr/src/man/man1/zonename.1 +++ b/usr/src/man/man1/zonename.1 @@ -3,13 +3,13 @@ .\" 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 zonename 1 "9 Jan 2004" "SunOS 5.11" "User Commands" +.TH ZONENAME 1 "Jan 9, 2004" .SH NAME zonename \- print name of current zone .SH SYNOPSIS .LP .nf -\fBzonename\fR +\fBzonename\fR .fi .SH DESCRIPTION @@ -22,23 +22,19 @@ The \fBzonename\fR utility prints the name of the current zone. The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR\fR .ad .RS 6n -.rt An error occurred. .RE @@ -50,13 +46,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityEvolving +Interface Stability Evolving .TE .SH SEE ALSO |