diff options
author | Peter Tribble <peter.tribble@gmail.com> | 2021-06-14 19:29:52 +0100 |
---|---|---|
committer | Peter Tribble <peter.tribble@gmail.com> | 2021-06-15 08:29:27 +0100 |
commit | 9514bcf4c37a9b87200462594803414d12cdd29d (patch) | |
tree | 881afd8f453af988c97efc54bc3bbdacc2920ae9 /usr | |
parent | ee9169cacd8ffeec83d4db687efa35da6f93d039 (diff) | |
download | illumos-joyent-9514bcf4c37a9b87200462594803414d12cdd29d.tar.gz |
13871 Missing spaces in several manual pages
Reviewed by: Richard Lowe <richlowe@richlowe.net>
Reviewed by: Matt Fiddaman <illumos@m.fiddaman.uk>
Reviewed by: Toomas Soome <tsoome@me.com>
Approved by: Gordon Ross <gordon.w.ross@gmail.com>
Diffstat (limited to 'usr')
-rw-r--r-- | usr/src/man/man1/awk.1 | 6 | ||||
-rw-r--r-- | usr/src/man/man1/kmfcfg.1 | 20 | ||||
-rw-r--r-- | usr/src/man/man1/pax.1 | 14 | ||||
-rw-r--r-- | usr/src/man/man1/strings.1 | 21 | ||||
-rw-r--r-- | usr/src/man/man1/touch.1 | 29 | ||||
-rw-r--r-- | usr/src/man/man1/tr.1 | 39 | ||||
-rw-r--r-- | usr/src/man/man1m/ifconfig.1m | 45 | ||||
-rw-r--r-- | usr/src/man/man1m/swap.1m | 26 | ||||
-rw-r--r-- | usr/src/man/man1m/traceroute.1m | 13 | ||||
-rw-r--r-- | usr/src/man/man2/stat.2 | 6 | ||||
-rw-r--r-- | usr/src/man/man3socket/getsourcefilter.3socket | 10 | ||||
-rw-r--r-- | usr/src/man/man3socket/inet6_opt.3socket | 13 |
12 files changed, 42 insertions, 200 deletions
diff --git a/usr/src/man/man1/awk.1 b/usr/src/man/man1/awk.1 index b2983dada4..2b86e7e8b0 100644 --- a/usr/src/man/man1/awk.1 +++ b/usr/src/man/man1/awk.1 @@ -45,7 +45,7 @@ .\" Portions Copyright (c) 2005, 2006 Sun Microsystems, Inc. All Rights Reserved .\" Copyright 2020 Joyent, Inc. .\" -.TH AWK 1 "Apr 20, 2020" +.TH AWK 1 "June 13, 2021" .SH NAME awk \- pattern scanning and processing language .SH SYNOPSIS @@ -192,10 +192,10 @@ the \fB=\fR represent the name of a \fBawk\fR variable. If that name is a \fBawk\fR reserved word, the behavior is undefined. The characters following the equal sign is interpreted as if they appeared in the \fBawk\fR program preceded and followed by a double-quote (\fB"\fR) character, as a \fBSTRING\fR -token , except that if the last character is an unescaped backslash, it is +token, except that if the last character is an unescaped backslash, it is interpreted as a literal backslash rather than as the first character of the sequence \fB\e\fR\&.. The variable is assigned the value of that \fBSTRING\fR -token. If the value is considered a \fInumeric\fRstring\fI,\fR the variable is +token. If the value is considered a \fInumeric\fR string, the variable is assigned its numeric value. Each such variable assignment is performed just before the processing of the following \fIfile\fR, if any. Thus, an assignment before the first \fBfile\fR argument is executed after the \fBBEGIN\fR actions diff --git a/usr/src/man/man1/kmfcfg.1 b/usr/src/man/man1/kmfcfg.1 index c42643c270..6c6d812976 100644 --- a/usr/src/man/man1/kmfcfg.1 +++ b/usr/src/man/man1/kmfcfg.1 @@ -3,18 +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 KMFCFG 1 "Feb 3, 2009" +.TH KMFCFG 1 "June 13, 2021" .SH NAME kmfcfg \- Key Management Policy and Plugin Configuration Utility .SH SYNOPSIS -.LP .nf \fBkmfcfg\fR \fIsubcommand\fR [\fIoption\fR ...] .fi .SH DESCRIPTION -.sp -.LP The \fBkmfcfg\fR command allows users to configure Key Management Framework (KMF) policy databases. The KMF policy database (DB) restricts the use of keys and certificates that are managed through the KMF framework. @@ -28,8 +25,6 @@ export policy definitions either in the system default database file For plugin configuration, \fBkmfcfg\fR allows users to display plugin information, install or uninstall a KMF plugin, and modify the plugin option. .SH SUBCOMMANDS -.sp -.LP The following subcommands are supported: .sp .ne 2 @@ -400,7 +395,7 @@ The \fBdelete\fR subcommand supports the following options: .ad .RS 21n Read policy definitions from the indicated file. If \fIdbfile\fR is not -specified, , the default is the system KMF policy database file: +specified, the default is the system KMF policy database file: \fB/etc/security/kmfpolicy.xml\fR. .RE @@ -699,7 +694,6 @@ The \fBdefault\fR policy in the system KMF policy database cannot be modified. .RE .SS "Plugin Subcommands" -.sp .ne 2 .na \fB\fBinstall keystore=\fR\fIkeystore_name\fR \fBmodulepath=\fR\fIpathname\fR\e @@ -724,7 +718,7 @@ the calling program's instruction set architecture. .RS 4n Display KMF plugin information. .sp -Without the \fBplugin\fRkeyword, \fBkmfcfg list\fR shows the policy information +Without the \fBplugin\fR keyword, \fBkmfcfg list\fR shows the policy information as described in the \fBSUBCOMMANDS\fR section. .RE @@ -755,7 +749,6 @@ Uninstall the plugin with the \fIkeystore_name\fR. .RE .SH EXAMPLES -.LP \fBExample 1 \fRCreating a New Policy .sp .LP @@ -774,8 +767,6 @@ ekuname=ipsecTunnel,ipsecUser .sp .SH EXIT STATUS -.sp -.LP The following exit values are returned: .sp .ne 2 @@ -796,7 +787,6 @@ An error occurred. .RE .SH FILES -.sp .ne 2 .na \fB\fB/etc/security/kmfpolicy.xml\fR\fR @@ -807,8 +797,6 @@ Default system policy database .RE .SH ATTRIBUTES -.sp -.LP See \fBattributes\fR(5) for descriptions of the following attributes: .sp @@ -823,6 +811,4 @@ Interface Stability Uncommitted .TE .SH SEE ALSO -.sp -.LP \fBattributes\fR(5) diff --git a/usr/src/man/man1/pax.1 b/usr/src/man/man1/pax.1 index 46d4aa4a77..f86373c431 100644 --- a/usr/src/man/man1/pax.1 +++ b/usr/src/man/man1/pax.1 @@ -43,7 +43,7 @@ .\" Copyright (c) 1992, X/Open Company Limited All. Rights Reserved. .\" Portions Copyright (c) 2008, Sun Microsystems, Inc. All Rights Reserved .\" -.TH PAX 1 "September 22, 2020" +.TH PAX 1 "June 13, 2021" .SH NAME pax \- portable archive interchange .SH SYNOPSIS @@ -540,7 +540,7 @@ variable. If \fBTMPDIR\fR is not set, \fBpax\fR uses \fB/tmp\fR. This keyword is applicable only to the \fB-x\fR \fBpax\fR format. This keyword allows user control over the action \fBpax\fR takes upon encountering values in an extended header record that, in \fBread\fR or \fBcopy\fR mode, are invalid -in the destination hierarchy or, in \fBlist\fR mode , cannot be written in the +in the destination hierarchy or, in \fBlist\fR mode, cannot be written in the codeset and current locale of the implementation. The following are invalid values that are recognized by \fBpax\fR: .RS +4 @@ -1309,7 +1309,7 @@ where <\fIls\fR \fB-l\fR \fIlisting\fR> is the format specified by the \fBls\fR command with the \fB-l\fR option. When writing path names in this format, it is unspecified what is written for fields for which the underlying archive format does not have the correct information, although the correct number of -blank-character-separated fields is written. +blank-character-separated fields are written. .RE .sp .LP @@ -1361,7 +1361,7 @@ When \fBpax\fR is in \fBread\fR mode or \fBlist\fR mode, using the \fB-x\fR field in an extended header record cannot be translated from the \fBpax\fR UTF-8 codeset format to the codeset and current locale of the implementation, \fBpax\fR writes a diagnostic message to standard error, processes the file as -described for the \fB-o\fR \fBinvalid=\fRoption, and then processes the next +described for the \fB-o\fR \fBinvalid=\fR option, and then processes the next file in the archive. .SS "Output Files" In \fBread\fR mode, the extracted output files are of the archived file type. @@ -1449,7 +1449,7 @@ extended header record when the file is archived. If this extended header record is associated with a file in the archive, those holes are recreated whenever that file is extracted from the archive. See the \fBSEEK_DATA\fR and \fBSEEK_HOLE\fR whence values in \fBlseek\fR(2). In all other cases, any -\fBNUL\fR (\fB\e0\fR) characters found in the archive is written to the file +\fBNUL\fR (\fB\e0\fR) characters found in the archive are written to the file when it is extracted. .sp .LP @@ -2407,7 +2407,7 @@ A Solaris extension to \fBpax\fR extended header keywords. Specifies the data and hole pairs for a sparse file. .sp In write or copy modes and when the \fBxustar\fR or \fBpax\fR format (see \fB-x -format\fR) is specified, \fBpax\fR includes a \fBSUN.holesdate\fR extended +format\fR) is specified, \fBpax\fR includes a \fBSUN.holesdata\fR extended header record if the underlying file system supports the detection of files with holes (see \fBfpathconf\fR(2)) and reports that there is at least one hole in the file being archived. \fIvalue\fR consists of two or more consecutive @@ -2702,7 +2702,7 @@ character set as octets with the most significant bit zero. If an implementation supports the use of characters outside the portable filename character set in names for files, users, and groups, one or more implementation-defined encodings of these characters are provided for -interchange purposes.\fBpax\fR does not create filenames on the local system +interchange purposes. \fBpax\fR does not create filenames on the local system that cannot be accessed by way of the procedures described in volume \fIIEEE Std 1003.1-200x\fR. If a filename is found on the medium that would create an invalid filename, it is implementation-defined whether the data from the file diff --git a/usr/src/man/man1/strings.1 b/usr/src/man/man1/strings.1 index 745be6b5f3..ac310ea457 100644 --- a/usr/src/man/man1/strings.1 +++ b/usr/src/man/man1/strings.1 @@ -44,19 +44,16 @@ .\" Copyright (c) 1992, X/Open Company Limited. All Rights Reserved. .\" Portions Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved .\" -.TH STRINGS 1 "Apr 13, 2007" +.TH STRINGS 1 "June 13, 2021" .SH NAME strings \- find printable strings in an object or binary file .SH SYNOPSIS -.LP .nf \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 .SH DESCRIPTION -.sp -.LP The \fBstrings\fR utility looks for \fBASCII\fR strings in a binary file. A string is any sequence of 4 or more printing characters ending with a NEWLINE or a \fBNULL\fR character. @@ -76,8 +73,6 @@ for a file. All sections can be inspected with the \fB-a\fR option. Individual sections can be inspected with the \fB-N\fR option. .SH OPTIONS -.sp -.LP The following options are supported: .sp .ne 2 @@ -107,7 +102,7 @@ is \fB4\fR. Look only in ELF section name. See \fBelfdump\fR(1). Multiple \fB-N\fR options can be specified to inspect multiple sections. .sp -If the \fB-a\fR or \fB-\fRoption is specified, all \fB-N\fR options are +If the \fB-a\fR or \fB-\fR option is specified, all \fB-N\fR options are ignored . .RE @@ -159,8 +154,6 @@ The offset is written in hexadecimal. .RE .SH OPERANDS -.sp -.LP The following operand is supported: .sp .ne 2 @@ -173,14 +166,10 @@ specified, the \fBstrings\fR utility reads from the standard input. .RE .SH ENVIRONMENT VARIABLES -.sp -.LP See \fBenviron\fR(5) for descriptions of the following environment variables that affect the execution of \fBstrings\fR: \fBLANG\fR, \fBLC_ALL\fR, \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and \fBNLSPATH\fR. .SH EXIT STATUS -.sp -.LP The following exit values are returned: .sp .ne 2 @@ -201,8 +190,6 @@ An error occurred. .RE .SH ATTRIBUTES -.sp -.LP See \fBattributes\fR(5) for descriptions of the following attributes: .sp @@ -224,13 +211,9 @@ The \fBstrings\fR utility, including all options except \fB-N\fR, are specified by standards. See \fBstandards\fR(5). The \fB-N\fR option is not currently specified by any standard. .SH SEE ALSO -.sp -.LP \fBelfdump\fR(1), \fBod\fR(1), \fBattributes\fR(5), \fBenviron\fR(5), \fBstandards\fR(5) .SH NOTES -.sp -.LP The algorithm for identifying strings is extremely primitive. .sp .LP diff --git a/usr/src/man/man1/touch.1 b/usr/src/man/man1/touch.1 index e64678ac7d..81191a19d5 100644 --- a/usr/src/man/man1/touch.1 +++ b/usr/src/man/man1/touch.1 @@ -42,13 +42,12 @@ .\" .\" Copyright 1989 AT&T .\" Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Portions Copyright (c) 2009, Sun Mricrosystems, Inc. All Rights Reserved +.\" Portions Copyright (c) 2009, Sun Microsystems, Inc. All Rights Reserved .\" -.TH TOUCH 1 "Sep 9, 2009" +.TH TOUCH 1 "June 13, 2021" .SH NAME touch, settime \- change file access and modification times .SH SYNOPSIS -.LP .nf \fBtouch\fR [\fB-acm\fR] [\fB-r\fR \fIref_file\fR | \fB-t\fR \fItime\fR | \fB-d\fR \fIdate_time\fR] \fIfile\fR... .fi @@ -64,8 +63,6 @@ touch, settime \- change file access and modification times .fi .SH DESCRIPTION -.sp -.LP The \fBtouch\fR utility sets the access and modification times of each file. The \fIfile\fR operand is created if it does not already exist. .sp @@ -89,13 +86,9 @@ an error. The \fBsettime\fR utility is equivalent to \fBtouch\fR \fB-c\fR [\fItime_spec\fR] \fIfile\fR. .SH OPTIONS -.sp -.LP The following options are supported in the \fBtouch\fR and \fBsettime\fR utilities: .SS "touch" -.sp -.LP The following options are supported for the \fBtouch\fR utility: .sp .ne 2 @@ -323,8 +316,6 @@ it is assumed to be 0. .RE .SS "settime" -.sp -.LP The following option is supported for the \fBsettime\fR utility: .sp .ne 2 @@ -338,8 +329,6 @@ current time. .RE .SH OPERANDS -.sp -.LP The following operands are supported for the \fBtouch\fR and \fBsettime\fR utilities: .sp @@ -436,20 +425,16 @@ YY Corresponding Year 39-68 ERROR .TE -If no \fB-d\fR, \fB-r\fR, or \fB-t\fRoption is specified, at least two operands +If no \fB-d\fR, \fB-r\fR, or \fB-t\fR option is specified, at least two operands are specified, and the first operand is an eight- or ten-digit decimal integer, the first operand is assumed to be a \fItime_spec\fR operand. Otherwise, the first operand is assumed to be a \fIfile\fR operand. .RE .SH USAGE -.sp -.LP See \fBlargefile\fR(5) for the description of the behavior of \fBtouch\fR when encountering files greater than or equal to 2 Gbyte ( 2^31 bytes). .SH ENVIRONMENT VARIABLES -.sp -.LP See \fBenviron\fR(5) for descriptions of the following environment variables 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. @@ -465,8 +450,6 @@ Determine the timezone to be used for interpreting the \fItime\fR or .RE .SH EXIT STATUS -.sp -.LP The following exit values are returned: .sp .ne 2 @@ -491,8 +474,6 @@ which the times could not be successfully modified. .RE .SH ATTRIBUTES -.sp -.LP See \fBattributes\fR(5) for descriptions of the following attributes: .sp @@ -511,13 +492,9 @@ Standard See \fBstandards\fR(5). .TE .SH SEE ALSO -.sp -.LP \fBfutimens\fR(2), \fBstat\fR(2), \fBattributes\fR(5), \fBenviron\fR(5), \fBlargefile\fR(5), \fBstandards\fR(5) .SH NOTES -.sp -.LP Users familiar with the BSD environment find that for the \fBtouch\fR utility, the \fB-f\fR option is accepted but ignored. The \fB-f\fR option is unnecessary because \fBtouch\fR succeeds for all files owned by the user regardless of the diff --git a/usr/src/man/man1/tr.1 b/usr/src/man/man1/tr.1 index a331448112..a64186b42d 100644 --- a/usr/src/man/man1/tr.1 +++ b/usr/src/man/man1/tr.1 @@ -44,11 +44,10 @@ .\" Copyright (c) 1992, X/Open Company Limited. All Rights Reserved. .\" Portions Copyright (c) 2009, Sun Microsystems, Inc. All Rights Reserved. .\" -.TH TR 1 "Mar 3, 2009" +.TH TR 1 "June 13, 2021" .SH NAME tr \- translate characters .SH SYNOPSIS -.LP .nf \fB/usr/bin/tr\fR [\fB-cds\fR] [\fIstring1\fR [\fIstring2\fR]] .fi @@ -89,15 +88,11 @@ tr \- translate characters .fi .SH DESCRIPTION -.sp -.LP The \fBtr\fR utility copies the standard input to the standard output with substitution or deletion of selected characters. The options specified and the \fIstring1\fR and \fIstring2\fR operands control translations that occur while copying characters and single-character collating elements. .SH OPTIONS -.sp -.LP The following options are supported: .sp .ne 2 @@ -244,8 +239,6 @@ appropriate. (See \fBtoupper\fR(3C) and \fBtolower\fR(3C)). An empty string used for \fIstring1\fR or \fIstring2\fR produces undefined results. .SH OPERANDS -.sp -.LP The following operands are supported: .sp .ne 2 @@ -305,7 +298,6 @@ unspecified. .RE .SS "/usr/xpg4/bin/tr" -.sp .ne 2 .na \fB\fIc-c\fR\fR @@ -315,7 +307,6 @@ unspecified. .RE .SS "/usr/bin/tr" -.sp .ne 2 .na \fB[\fIc-c\fR]\fR @@ -364,10 +355,10 @@ names \fBlower\fR or \fBupper\fR are valid in \fIstring2\fR and then only if the corresponding character class \fBupper\fR and \fBlower\fR, respectively, is specified in the same relative position in \fIstring1\fR. Such a specification is interpreted as a request for case conversion. When \fB[:lower:]\fR appears -in \fIstring1\fR and \fB[:upper:]\fR appears in \fIstring2,\fR the arrays +in \fIstring1\fR and \fB[:upper:]\fR appears in \fIstring2\fR, the arrays contain the characters from the \fBtoupper\fR mapping in the \fBLC_CTYPE\fR category of the current locale. When \fB[:upper:]\fR appears in \fIstring1\fR -and \fB[:lower:]\fR appears in \fIstring2,\fR the arrays contain the characters +and \fB[:lower:]\fR appears in \fIstring2\fR, the arrays contain the characters from the \fBtolower\fR mapping in the \fBLC_CTYPE\fR category of the current locale. The first character from each mapping pair is in the array for \fIstring1\fR and the second character from each mapping pair is in the array @@ -407,17 +398,14 @@ as an octal value. Otherwise, it is interpreted as a decimal value. .sp If \fIn\fR is omitted or is \fB0\fR, \fB/usr/bin/tr\fR interprets this as huge; \fB/usr/xpg4/bin/tr\fR and \fB/usr/xpg6/bin/tr\fR interprets this as large -enough to extend the\fIstring2\fR-based sequence to the length of the +enough to extend the \fIstring2\fR-based sequence to the length of the \fIstring1\fR-based sequence. .RE .SH USAGE -.sp -.LP See \fBlargefile\fR(5) for the description of the behavior of \fBtr\fR when encountering files greater than or equal to 2 Gbyte ( 2^31 bytes). .SH EXAMPLES -.LP \fBExample 1 \fRCreating a list of words .sp .LP @@ -471,14 +459,10 @@ and written to \fBfile2\fR. .sp .SH ENVIRONMENT VARIABLES -.sp -.LP See \fBenviron\fR(5) for descriptions of the following environment variables that affect the execution of \fBtr\fR: \fBLANG\fR, \fBLC_ALL\fR, \fBLC_COLLATE\fR, \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and \fBNLSPATH\fR. .SH EXIT STATUS -.sp -.LP The following exit values are returned: .sp .ne 2 @@ -499,13 +483,8 @@ An error occurred. .RE .SH ATTRIBUTES -.sp -.LP See \fBattributes\fR(5) for descriptions of the following attributes: .SS "/usr/bin/tr" -.sp - -.sp .TS box; c | c @@ -516,9 +495,6 @@ CSI Enabled .TE .SS "/usr/xpg4/bin/tr" -.sp - -.sp .TS box; c | c @@ -533,9 +509,6 @@ Standard See \fBstandards\fR(5). .TE .SS "/usr/xpg6/bin/tr" -.sp - -.sp .TS box; c | c @@ -550,14 +523,10 @@ Standard See \fBstandards\fR(5). .TE .SH SEE ALSO -.sp -.LP \fBed\fR(1), \fBsed\fR(1), \fBsh\fR(1), \fBtolower\fR(3C), \fBtoupper\fR(3C), \fBascii\fR(5), \fBattributes\fR(5), \fBenviron\fR(5), \fBlargefile\fR(5), \fBregex\fR(5), \fBstandards\fR(5) .SH NOTES -.sp -.LP Unlike some previous versions, \fB/usr/xpg4/bin/tr\fR correctly processes \fBNUL\fR characters in its input stream. \fBNUL\fR characters can be stripped by using \fBtr\fR \fB-d\fR \fB\&'\e000'\fR. diff --git a/usr/src/man/man1m/ifconfig.1m b/usr/src/man/man1m/ifconfig.1m index 0de64da068..83547719d3 100644 --- a/usr/src/man/man1m/ifconfig.1m +++ b/usr/src/man/man1m/ifconfig.1m @@ -1,13 +1,12 @@ '\" te -.\" Copyright (C) 2012, Darren Reed. All rights reserved +.\" Copyright (C) 2012, Darren Reed. All rights reserved .\" Copyright (C) 2009, Sun Microsystems, Inc. All Rights Reserved .\" 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. -.TH IFCONFIG 1M "July 23, 2012" +.TH IFCONFIG 1M "June 13, 2021" .SH NAME ifconfig \- configure network interface parameters .SH SYNOPSIS -.LP .nf \fBifconfig\fR \fIinterface\fR [\fIaddress_family\fR] [\fIaddress\fR [\fI/prefix_length\fR] [\fIdest_address\fR]] [\fBaddif\fR \fIaddress\fR [\fI/prefix_length\fR]] @@ -37,8 +36,6 @@ ifconfig \- configure network interface parameters .fi .SH DESCRIPTION -.sp -.LP The command \fBifconfig\fR is used to assign an address to a network interface and to configure network interface parameters. The \fBifconfig\fR command must be used at boot time to define the network address of each interface present on @@ -50,8 +47,6 @@ specific to that address family. Only privileged users may modify the configuration of a network interface. Options appearing within braces (\fB{\|}\fR) indicate that one of the options must be specified. .SS Network Interface Observability -.sp -.LP Network interface observability with \fBifconfig\fR is limited to those network interfaces that have been prepared for use with the IP protocol suite. The preferred method for configuring a network @@ -60,8 +55,6 @@ with the use of the \fBplumb\fR option as documented below. Network interfaces that have not been configured for use with the IP protocol suite can only be observed by using the \fBdladm\fR command. .SS DHCP Configuration -.sp -.LP The forms of \fBifconfig\fR that use the \fBauto-dhcp\fR or \fBdhcp\fR arguments are used to control the Dynamic Host Configuration Protocol ("\fBDHCP\fR") configuration of the interface. In this mode, \fBifconfig\fR is @@ -72,8 +65,6 @@ address or characteristics of the interface. If the address of an interface under \fBDHCP\fR is changed, \fBdhcpagent\fR will remove the interface from its control. .SH OPTIONS -.sp -.LP When the \fBifconfig\fR command is executed without any options its behavior is the same as when the \fB\-a\fR option is supplied with no other options or arguments. @@ -1136,7 +1127,7 @@ receive packets. .RS 4n Place the logical interface in zone \fIzonename\fR. The named zone must be active in the kernel in the ready or running state. The interface is unplumbed -when the zone is halted or rebooted. The zone must be configure to be an +when the zone is halted or rebooted. The zone must be configured to be an shared-IP zone. \fBzonecfg\fR(1M) is used to assign network interface names to exclusive-IP zones. .RE @@ -1152,8 +1143,6 @@ Place IP interface in the global zone. This is the default. .RE .SH OPERANDS -.sp -.LP The \fIinterface\fR operand, as well as address parameters that affect it, are described below. .sp @@ -1353,8 +1342,6 @@ configured "up" with \fBifconfig\fR. .RE .SH INTERFACE FLAGS -.sp -.LP The \fBifconfig\fR command supports the following interface flags. The term "address" in this context refers to a logical interface, for example, \fBeri0:0\fR, while "interface" refers to the physical interface, for example, @@ -1574,7 +1561,7 @@ interface. .ad .sp .6 .RS 4n -The interface has no address , just an on-link subnet. +The interface has no address, just an on-link subnet. .RE .sp @@ -1768,8 +1755,6 @@ Indicates that the interface uses an IPv6 external resolver. .RE .SH LOGICAL INTERFACES -.sp -.LP Solaris \fBTCP/IP\fR allows multiple logical interfaces to be associated with a physical network interface. This allows a single machine to be assigned multiple \fBIP\fR addresses, even though it may have only one network @@ -1817,8 +1802,8 @@ allocates the next available logical unit number on the \fBeri0\fR physical interface and assigns an \fIaddress\fR and \fIprefix_length\fR. .sp .LP -A logical interface can be configured with parameters ( -\fIaddress\fR,\fIprefix_length\fR, and so on) different from the physical +A logical interface can be configured with parameters (\fIaddress\fR, +\fIprefix_length\fR, and so on) different from the physical interface with which it is associated. Logical interfaces that are associated with the same physical interface can be given different parameters as well. Each logical interface must be associated with an existing and "up" physical @@ -1840,8 +1825,6 @@ example% \fBifconfig eri0:1 down unplumb\fR .LP will delete the logical interface \fBeri0:1\fR. .SH IP MULTIPATHING GROUPS -.sp -.LP Physical interfaces that share the same link-layer broadcast domain \fBmust\fR be collected into a single IP Multipathing (IPMP) group using the \fBgroup\fR subcommand. Each IPMP group has an associated IPMP IP interface, which can @@ -1919,8 +1902,6 @@ For more background on IPMP, please see the IPMP-related chapters of the \fISystem Administration Guide: Network Interfaces and Network Virtualization\fR. .SH CONFIGURING IPV6 INTERFACES -.sp -.LP When an IPv6 physical interface is plumbed and configured "up" with \fBifconfig\fR, it is automatically assigned an IPv6 link-local address for which the last 64 bits are calculated from the \fBMAC\fR address of the @@ -1993,8 +1974,6 @@ addif 2001:0db8:3c4d:55:a00:20ff:fe8e:f3ad/64 up .in -2 .SS "Configuring IP-over-IP Tunnel Interfaces" -.sp -.LP An IP tunnel is conceptually comprised of two parts: a virtual link between two or more IP nodes, and an IP interface above this link which allows the system to transmit and receive IP packets encapsulated by the underlying link. @@ -2078,8 +2057,6 @@ The \fBtsrc\fR, \fBtdst\fR, \fBencaplim\fR, and \fBhoplimit\fR options to \fBifconfig\fR are obsolete and maintained only for backward compatibility. They are equivalent to their \fBdladm\fR(1M) counterparts. .SS "Display of Tunnel Security Settings" -.sp -.LP The \fBifconfig\fR output for IP tunnel interfaces indicates whether IPsec policy is configured for the underlying IP tunnel link. For example, a line of the following form will be displayed if IPsec policy is present: @@ -2096,7 +2073,6 @@ tunnel security settings --> use 'ipsecconf -ln -i ip.tun1' If you do net set security policy, using either \fBifconfig\fR or \fBipsecconf\fR(1M), there is no tunnel security setting displayed. .SH EXAMPLES -.LP \fBExample 1 \fRUsing the \fBifconfig\fR Command .sp .LP @@ -2475,7 +2451,6 @@ example% \fBifconfig hme0 dhcp release\fR .sp .SH FILES -.sp .ne 2 .na \fB\fB/etc/netmasks\fR\fR @@ -2496,8 +2471,6 @@ Default Internet protocol type. .RE .SH ATTRIBUTES -.sp -.LP See \fBattributes\fR(5) for descriptions of the following attributes: .sp @@ -2516,8 +2489,6 @@ Interface Stability for command output Uncommitted .TE .SH SEE ALSO -.sp -.LP \fBdhcpinfo\fR(1), \fBcfgadm\fR(1M), \fBdhcpagent\fR(1M), \fBdladm\fR(1M), \fBif_mpadm\fR(1M), \fBin.mpathd\fR(1M), \fBin.ndpd\fR(1M), \fBin.routed\fR(1M), \fBipmpstat\fR(1M), \fBipsecconf\fR(1M), \fBndd\fR(1M), @@ -2530,8 +2501,6 @@ Interface Stability for command output Uncommitted .LP \fISystem Administration Guide: IP Services\fR .SH DIAGNOSTICS -.sp -.LP \fBifconfig\fR sends messages that indicate if: .RS +4 .TP @@ -2552,8 +2521,6 @@ the requested address is unknown the user is not privileged and tried to alter an interface's configuration .RE .SH NOTES -.sp -.LP Do not select the names \fBbroadcast\fR, \fBdown\fR, \fBprivate\fR, \fBtrailers\fR, \fBup\fR or other possible option names when you choose host names. If you choose any one of these names as host names, it can cause unusual diff --git a/usr/src/man/man1m/swap.1m b/usr/src/man/man1m/swap.1m index b0fb586f59..e89d02c4d8 100644 --- a/usr/src/man/man1m/swap.1m +++ b/usr/src/man/man1m/swap.1m @@ -4,11 +4,10 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH SWAP 1M "Apr 11, 2008" +.TH SWAP 1M "June 13, 2021" .SH NAME swap \- swap administrative interface .SH SYNOPSIS -.LP .nf \fB/usr/sbin/swap\fR \fB-a\fR \fIswapname\fR [\fIswaplow\fR] [\fIswaplen\fR] .fi @@ -29,13 +28,9 @@ swap \- swap administrative interface .fi .SH DESCRIPTION -.sp -.LP The \fBswap\fR utility provides a method of adding, deleting, and monitoring the system swap areas used by the memory manager. .SH OPTIONS -.sp -.LP The following options are supported: .sp .ne 2 @@ -239,7 +234,7 @@ The list does not include swap space in the form of physical memory because this space is not associated with a particular swap area. .sp If \fBswap\fR \fB-l\fR is run while \fIswapname\fR is in the process of being -deleted (by \fBswap\fR\fB-d\fR), the string \fBINDEL\fR will appear in a sixth +deleted (by \fBswap\fR \fB-d\fR), the string \fBINDEL\fR will appear in a sixth column of the swap stats. .RE @@ -295,33 +290,20 @@ reservation and allocation. .RE These numbers include swap space from all configured swap areas as listed by -the \fB-l\fR option, as well swap space in the form of physical memory. +the \fB-l\fR option, as well as swap space in the form of physical memory. .RE .SH USAGE -.sp -.LP -On the 32-bit operating system, only the first 2 Gbytes -1 are used for swap -devices greater than or equal to 2 Gbytes in size. On the 64-bit operating -system, a block device larger than 2 Gbytes can be fully utilized for swap up -to 2^63 \(mi1 bytes. +A block device up to 2^63 \(mi1 bytes can be fully utilized for swap. .SH ENVIRONMENT VARIABLES -.sp -.LP See \fBenviron\fR(5) for descriptions of the following environment variables that affect the execution of \fBswap\fR: \fBLC_CTYPE\fR and \fBLC_MESSAGE\fR. .SH SEE ALSO -.sp -.LP \fBpagesize\fR(1), \fBmkfile\fR(1M), \fBshareall\fR(1M), \fBgetpagesize\fR(3C), \fBvfstab\fR(4), \fBattributes\fR(5), \fBlargefile\fR(5) .SH NOTES -.sp -.LP For information about setting up a swap area with \fBZFS\fR, see the \fIZFS Administration Guide\fR. .SH WARNINGS -.sp -.LP No check is done to determine if a swap area being added overlaps with an existing file system. diff --git a/usr/src/man/man1m/traceroute.1m b/usr/src/man/man1m/traceroute.1m index dee89c9620..abc2dfbf65 100644 --- a/usr/src/man/man1m/traceroute.1m +++ b/usr/src/man/man1m/traceroute.1m @@ -3,11 +3,10 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH TRACEROUTE 1M "Dec 11, 2015" +.TH TRACEROUTE 1M "June 13, 2021" .SH NAME traceroute \- print the route packets take to network host .SH SYNOPSIS -.LP .nf \fBtraceroute\fR [\fB-adFIlnSvx\fR] [\fB-A\fR \fIaddr_family\fR] [\fB-c\fR \fItraffic_class\fR] [\fB-f\fR \fIfirst_hop\fR] [\fB-g\fR \fIgateway\fR [\fB-g\fR \fIgateway\fR...] | \fB-r\fR] @@ -18,7 +17,6 @@ traceroute \- print the route packets take to network host .fi .SH DESCRIPTION -.LP The Internet is a large and complex aggregation of network hardware, connected by gateways. Tracking the route a packet follows can be difficult. The utility \fBtraceroute\fR traces the route that an \fBIP\fR packet follows to another @@ -300,7 +298,7 @@ bit is always set in this case. .ad .sp .6 .RS 4n -Set the starting \fIttl\fR ( \fIhop limit\fR) value to \fIfirst_hop\fR, to +Set the starting \fIttl\fR (\fIhop limit\fR) value to \fIfirst_hop\fR, to override the default value \fB1\fR. \fBtraceroute\fR skips processing for those intermediate gateways which are less than \fIfirst_hop\fR hops away. .RE @@ -413,7 +411,7 @@ received a reply. Note that \fIpause_sec\fR is a real number. .RS 4n Set the base \fBUDP\fR \fIport\fR number used in probes.The default is 33434. \fBtraceroute\fR hopes that nothing is listening on \fBUDP\fR \fIports\fR -\fB(base+(nhops-1)*nqueries)\fR to \fB(base+(nhops*nqueries)-1)\fRat the +\fB(base+(nhops-1)*nqueries)\fR to \fB(base+(nhops*nqueries)-1)\fR at the destination host, so that an \fBICMP\fR (\fBICMP6\fR) \fBPORT_UNREACHABLE\fR message will be returned to terminate the route tracing. If something is listening on a \fIport\fR in the default range, this option can be used to @@ -538,7 +536,6 @@ checksum is always calculated by the operating system in this case. .RE .SH OPERANDS -.LP The following operands are supported: .sp .ne 2 @@ -551,7 +548,6 @@ The network host. .RE .SH EXAMPLES -.LP \fBExample 1 \fRSample Output From the \fBtraceroute\fR Utility .sp .LP @@ -642,7 +638,6 @@ traceroute to sanfrancisco (172.29.64.39), 30 hops max, 56 byte packets .sp .SH EXIT STATUS -.LP The following exit values are returned: .sp .ne 2 @@ -665,11 +660,9 @@ An error occurred. .RE .SH SEE ALSO -.LP \fBnetstat\fR(1M), \fBsignal\fR(3C), \fBping\fR(1M), \fBattributes\fR(5), \fBprivileges\fR(5), \fBzones\fR(5) .SH WARNINGS -.LP This utility is intended for use in network testing, measurement and management. It should be used primarily for manual fault isolation. Because of the load it could impose on the network, it is unwise to use diff --git a/usr/src/man/man2/stat.2 b/usr/src/man/man2/stat.2 index 831c592df0..5dabfe0d5e 100644 --- a/usr/src/man/man2/stat.2 +++ b/usr/src/man/man2/stat.2 @@ -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 STAT 2 "Mar 15, 2021" +.TH STAT 2 "June 13, 2021" .SH NAME stat, lstat, fstat, fstatat \- get file status .SH SYNOPSIS @@ -247,7 +247,7 @@ disk. This field is not defined for block special or character special files. \fB\fBst_fstype\fR\fR .ad .RS 14n -A null-teminated string that uniquely identifies the type of the filesystem +A null-terminated string that uniquely identifies the type of the filesystem that contains the file. .RE @@ -432,7 +432,7 @@ resolution of the \fIpath\fR argument. \fB\fBENAMETOOLONG\fR\fR .ad .RS 16n -As a result of encountering a symbolic link in resolution of the\fIpath\fR +As a result of encountering a symbolic link in resolution of the \fIpath\fR argument, the length of the substituted pathname strings exceeds {\fBPATH_MAX\fR}. .RE diff --git a/usr/src/man/man3socket/getsourcefilter.3socket b/usr/src/man/man3socket/getsourcefilter.3socket index a5239ef898..7087498ac0 100644 --- a/usr/src/man/man3socket/getsourcefilter.3socket +++ b/usr/src/man/man3socket/getsourcefilter.3socket @@ -3,12 +3,11 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH GETSOURCEFILTER 3SOCKET "Aug 20, 2007" +.TH GETSOURCEFILTER 3SOCKET "June 13, 2021" .SH NAME getsourcefilter, setsourcefilter, getipv4sourcefilter, setipv4sourcefilter \- retrieve and set a socket's multicast filter .SH SYNOPSIS -.LP .nf \fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lsocket\fR [ \fIlibrary\fR... ] #include <netinet/in.h> @@ -40,7 +39,6 @@ retrieve and set a socket's multicast filter .fi .SH DESCRIPTION -.LP These functions allow applications to retrieve and modify the multicast filtering state for a tuple consisting of socket, interface, and multicast group values. @@ -108,11 +106,9 @@ number of addresses in the \fIslist\fR array. The \fIslist\fR argument points to the array of source addresses to be included or excluded, depending on the \fIfmode\fR value. .SH RETURN VALUES -.LP If successful, all four functions return \fB0\fR. Otherwise, they return \fB\(mi1\fR and set \fBerrno\fR to indicate the error. .SH ERRORS -.LP These functions will fail if: .sp .ne 2 @@ -187,7 +183,7 @@ exist; \fIgroup\fR is not being listened to on \fIinterface\fR by \fIsocket\fR. .sp .LP -The functions \fBsetsourcefilter()\fRand \fBsetipv4sourcefilter()\fR can fail +The functions \fBsetsourcefilter()\fR and \fBsetipv4sourcefilter()\fR can fail in the following additional case: .sp .ne 2 @@ -199,7 +195,6 @@ The source filter list is larger than that allowed by the implementation. .RE .SH ATTRIBUTES -.LP See \fBattributes\fR(5) for descriptions of the following attributes: .sp @@ -216,7 +211,6 @@ MT-Level Safe .TE .SH SEE ALSO -.LP \fBif_nametoindex\fR(3SOCKET), \fBsocket\fR(3SOCKET), \fBsockaddr\fR(3SOCKET), \fBattributes\fR(5) .sp diff --git a/usr/src/man/man3socket/inet6_opt.3socket b/usr/src/man/man3socket/inet6_opt.3socket index b081684f7a..75aa96b066 100644 --- a/usr/src/man/man3socket/inet6_opt.3socket +++ b/usr/src/man/man3socket/inet6_opt.3socket @@ -4,13 +4,12 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH INET6_OPT 3SOCKET "Feb 15, 2007" +.TH INET6_OPT 3SOCKET "June 13, 2021" .SH NAME inet6_opt, inet6_opt_init, inet6_opt_append, inet6_opt_finish, inet6_opt_set_val, inet6_opt_next, inet6_opt_find, inet6_opt_get_val \- Option manipulation mechanism .SH SYNOPSIS -.LP .nf \fBcc\fR [ \fIflag\fR ... ] \fIfile\fR ... \fB-lsocket\fR [\fIlibrary...\fR] #include <netinet/in.h> @@ -52,13 +51,11 @@ manipulation mechanism .LP .nf -\fBint\fR\fBinet6_opt_get_val\fR(\fBvoid *\fR\fIdatabuf\fR, \fBint\fR \fIoffset\fR, +\fBint\fR \fBinet6_opt_get_val\fR(\fBvoid *\fR\fIdatabuf\fR, \fBint\fR \fIoffset\fR, \fBvoid *\fR\fIval\fR, \fBsocklen_t *\fR\fIvallen\fR); .fi .SH DESCRIPTION -.sp -.LP The \fBinet6_opt\fR functions enable users to manipulate options without having to know the structure of the option header. .sp @@ -128,8 +125,6 @@ in the option's data portion the value should be extracted. The first byte following the option type and length is accessed by specifying an \fIoffset\fR of zero. .SH RETURN VALUES -.sp -.LP The \fBinet6_opt_init()\fR function returns the number of bytes needed for the empty extension header. If the \fIextlen\fR value is not a positive non-zero multiple of 8, the function fails and returns \fB-1\fR\&. @@ -161,8 +156,6 @@ The \fBinet6_opt_get_val()\fR function returns the \fIoffset\fR for the next field (that is, \fIoffset\fR + \fIvallen\fR) which can be used when extracting option content with multiple fields. .SH ATTRIBUTES -.sp -.LP See \fBattributes\fR(5) for descriptions of the following attributes: .sp @@ -179,7 +172,5 @@ MT-Level Safe .TE .SH SEE ALSO -.sp -.LP RFC 3542 - \fIAdvanced Sockets Application Programming Interface (API) for IPv6\fR, The Internet Society. May 2003 |