diff options
author | Peter Tribble <peter.tribble@gmail.com> | 2020-09-21 19:23:46 +0100 |
---|---|---|
committer | Peter Tribble <peter.tribble@gmail.com> | 2020-09-22 13:05:37 +0100 |
commit | c64c5389d6d65f1a8915fd0ff67288100f518172 (patch) | |
tree | 11c5a786d6c33e55ab800f1bc7a615f5d50a7caa /usr/src | |
parent | a7f55c951e21deb266649b41baa71501d3382f4d (diff) | |
download | illumos-joyent-c64c5389d6d65f1a8915fd0ff67288100f518172.tar.gz |
13141 Man page formatting runs words together
Reviewed by: Gergő Mihály Doma <domag02@gmail.com>
Reviewed by: Andy Fiddaman <andy@omniosce.org>
Reviewed by: Volker A. Brandt <vab@bb-c.de>
Approved by: Dan McDonald <danmcd@joyent.com>
Diffstat (limited to 'usr/src')
-rw-r--r-- | usr/src/man/man1/limit.1 | 42 | ||||
-rw-r--r-- | usr/src/man/man1m/cfgadm.1m | 32 | ||||
-rw-r--r-- | usr/src/man/man1m/in.ndpd.1m | 13 | ||||
-rw-r--r-- | usr/src/man/man1m/mpathadm.1m | 30 | ||||
-rw-r--r-- | usr/src/man/man2/_lwp_cond_wait.2 | 16 | ||||
-rw-r--r-- | usr/src/man/man3c_db/td_thr_setsigpending.3c_db | 16 | ||||
-rw-r--r-- | usr/src/man/man3proc/ps_lgetregs.3proc | 11 | ||||
-rw-r--r-- | usr/src/man/man3scf/scf_value_create.3scf | 15 | ||||
-rw-r--r-- | usr/src/man/man7d/audio810.7d | 15 | ||||
-rw-r--r-- | usr/src/man/man9f/inb.9f | 18 | ||||
-rw-r--r-- | usr/src/man/man9s/ddi_dma_attr.9s | 15 |
11 files changed, 34 insertions, 189 deletions
diff --git a/usr/src/man/man1/limit.1 b/usr/src/man/man1/limit.1 index 7843fafb2f..34952062af 100644 --- a/usr/src/man/man1/limit.1 +++ b/usr/src/man/man1/limit.1 @@ -44,18 +44,16 @@ .\" Portions Copyright (c) 1982-2007 AT&T Knowledge Ventures .\" Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved .\" -.TH LIMIT 1 "Nov 2, 2007" +.TH LIMIT 1 "September 12, 2020" .SH NAME limit, ulimit, unlimit \- set or get limitations on the system resources available to the current shell and its descendents .SH SYNOPSIS -.LP .nf \fB/usr/bin/ulimit\fR [\fB-f\fR] [\fIblocks\fR] .fi .SS "sh" -.LP .nf \fBulimit\fR [\fB-\fR [HS] [a | cdfnstv]] .fi @@ -66,7 +64,6 @@ available to the current shell and its descendents .fi .SS "csh" -.LP .nf \fBlimit\fR [\fB-h\fR] [\fIresource\fR [\fIlimit\fR]] .fi @@ -77,27 +74,21 @@ available to the current shell and its descendents .fi .SS "ksh" -.LP .nf \fBulimit\fR [\fB-HSacdfnstv\fR] [\fIlimit\fR] .fi .SS "ksh93" -.LP .nf \fBulimit\fR [\fB-HSacdfmnpstv\fR] [\fIlimit\fR] .fi .SH DESCRIPTION .SS "/usr/bin/ulimit" -.sp -.LP The \fBulimit\fR utility sets or reports the file-size writing limit imposed on files written by the shell and its child processes (files of any size can be read). Only a process with appropriate privileges can increase the limit. .SS "sh" -.sp -.LP The Bourne shell built-in function, \fBulimit\fR, prints or sets hard or soft resource limits. These limits are described in \fBgetrlimit\fR(2). .sp @@ -107,7 +98,7 @@ number of limits can be printed at one time. The \fB-a\fR option prints all limits. .sp .LP -If \fIlimit\fR is present, \fBulimit\fR sets the specified limit to\fIlimit\fR. +If \fIlimit\fR is present, \fBulimit\fR sets the specified limit to \fIlimit\fR. The string \fBunlimited\fR requests that the current limit, if any, be removed. Any user can set a soft limit to any value less than or equal to the hard limit. Any user can lower a hard limit. Only a user with appropriate privileges @@ -185,8 +176,6 @@ Maximum size of virtual memory (in Kbytes) .RE .SS "csh" -.sp -.LP The C-shell built-in function, \fBlimit\fR, limits the consumption by the current process or any process it spawns, each not to exceed \fIlimit\fR on the specified \fIresource\fR. The string \fBunlimited\fR requests that the current @@ -328,8 +317,6 @@ Remove corresponding hard limits. Only the privileged user can do this. .RE .SS "ksh" -.sp -.LP The Korn shell built-in function, \fBulimit\fR, sets or displays a resource limit. The available resources limits are listed below. Many systems do not contain one or more of these limits. The limit for a specified resource is set @@ -421,15 +408,11 @@ The number of K-bytes for virtual memory. .LP If no option is specified, \fB-f\fR is assumed. .SS "Per-Shell Memory Parameters" -.sp -.LP The \fBheapsize\fR, \fBdatasize\fR, and \fBstacksize\fR parameters are not system tunables. The only controls for these are hard limits, set in a shell startup file, or system-wide soft limits, which, for the current version of the Solaris OS, is 2^64bytes. .SS "ksh93" -.sp -.LP \fBulimit\fR sets or displays resource limits. These limits apply to the current process and to each child process created after the resource limit has been set. If \fIlimit\fR is specified, the resource limit is set, otherwise, @@ -681,8 +664,6 @@ Specifies the process size in Kbytes. .RE .SH OPTIONS -.sp -.LP The following option is supported by \fB/usr/bin/ulimit\fR: .sp .ne 2 @@ -695,8 +676,6 @@ in blocks. The \fB-f\fR option is also the default case. .RE .SH OPERANDS -.sp -.LP The following operand is supported by \fB/usr/bin/ulimit\fR: .sp .ne 2 @@ -709,7 +688,6 @@ The number of 512-byte blocks to use as the new file size limit. .SH EXAMPLES .SS "/usr/bin/ulimit" -.LP \fBExample 1 \fRLimiting the Stack Size .sp .LP @@ -732,7 +710,6 @@ memory(kbytes) unlimited .sp .SS "sh/ksh" -.LP \fBExample 2 \fRLimiting the Number of File Descriptors .sp .LP @@ -755,7 +732,6 @@ vmemory(kbytes) unlimited .sp .SS "csh" -.LP \fBExample 3 \fRLimiting the Core Dump File Size .sp .LP @@ -800,14 +776,10 @@ memorysize unlimited .sp .SH ENVIRONMENT VARIABLES -.sp -.LP See \fBenviron\fR(5) for descriptions of the following environment variables that affect the execution of \fBulimit\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 by \fBulimit\fR: .sp .ne 2 @@ -828,13 +800,8 @@ A request for a higher limit was rejected or an error occurred. .RE .SH ATTRIBUTES -.sp -.LP See \fBattributes\fR(5) for descriptions of the following attributes: .SS "/usr/bin/ulimit, csh, ksh, sh" -.sp - -.sp .TS box; c | c @@ -847,9 +814,6 @@ Standard See \fBstandards\fR(5). .TE .SS "ksh93" -.sp - -.sp .TS box; c | c @@ -860,8 +824,6 @@ Interface Stability Uncommitted .TE .SH SEE ALSO -.sp -.LP \fBbc\fR(1), \fBcsh\fR(1), \fBksh\fR(1), \fBksh93\fR(1), \fBsh\fR(1), \fBdf\fR(1M), \fBsu\fR(1M), \fBswap\fR(1M), \fBsysdef\fR(1M), \fBgetrlimit\fR(2), \fBattributes\fR(5), \fBenviron\fR(5), \fBstandards\fR(5) diff --git a/usr/src/man/man1m/cfgadm.1m b/usr/src/man/man1m/cfgadm.1m index 2228332dcb..6083cd7c5d 100644 --- a/usr/src/man/man1m/cfgadm.1m +++ b/usr/src/man/man1m/cfgadm.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 CFGADM 1M "Oct 25, 2004" +.TH CFGADM 1M "September 12, 2020" .SH NAME cfgadm \- configuration administration .SH SYNOPSIS -.LP .nf \fB/usr/sbin/cfgadm\fR [\fB-f\fR] [\fB-y\fR | \fB-n\fR] [\fB-v\fR] [\fB-o\fR \fIhardware_options\fR] \fB-c\fR \fIfunction\fR \fIap_id\fR... @@ -37,8 +36,6 @@ cfgadm \- configuration administration .fi .SH DESCRIPTION -.sp -.LP The \fBcfgadm\fR command provides configuration administration operations on dynamically reconfigurable hardware resources. These operations include displaying status, (\fB-l\fR), initiating testing, (\fB-t\fR), invoking @@ -100,7 +97,7 @@ are limited to configuration administration operations. The hardware resources of an occupant in the \fBconfigured\fR state are represented by normal Solaris data structures and thus some or all of those hardware resources can be in use by Solaris. All occupants provide both the \fBconfigured\fR and -\fBunconfigured\fR states, +\fBunconfigured\fR states. .sp .LP An attachment point can be in one of five conditions: \fBunknown\fR, \fBok\fR, @@ -169,12 +166,12 @@ and generated by the corresponding hardware specific library. .LP For example, consider a base attachment point, which represents a \fBSCSI HBA\fR, with the physical \fBap_id\fR -\fB/devices/sbus@1f,0/SUNW,fas@e,8800000:scsi\fR and logical \fBap_id c0\fR . A +\fB/devices/sbus@1f,0/SUNW,fas@e,8800000:scsi\fR and logical \fBap_id c0\fR. A disk attached to this \fBSCSI HBA\fR could be represented by a dynamic attachment point with logical \fBap_id\fR \fBc0::dsk/c0t0d0\fR where \fBc0\fR is the base component and \fBdsk/c0t0d0\fR is the hardware specific dynamic component. Similarly the physical \fBap_id\fR for this dynamic attachment point -would be: \fB/devices/sbus@1f,0/SUNW,fas@e,8800000:scsi::dsk/c0t0d0\fR +would be: \fB/devices/sbus@1f,0/SUNW,fas@e,8800000:scsi::dsk/c0t0d0\fR. .sp .LP An \fIap_type\fR is a partial form of a logical \fBap_id\fR that can be @@ -210,8 +207,6 @@ system log daemon \fBsyslogd\fR(1M). The arguments for this command conform to the \fBgetopt\fR(3C) and \fBgetsubopt\fR(3C) syntax convention. .SH OPTIONS -.sp -.LP The following options are supported: .sp .ne 2 @@ -550,13 +545,10 @@ Suppresses any interactive confirmation and assume that the answer is .RE .SH USAGE -.sp -.LP The required privileges to use this command are hardware dependent. Typically, a default system configuration restricts all but the list option to the superuser. .SH EXAMPLES -.LP \fBExample 1 \fRListing Attachment Points in the Device Tree .sp .LP @@ -726,8 +718,6 @@ example# cfgadm -c configure c0::dsk/c0t0d0 .sp .SH ENVIRONMENT VARIABLES -.sp -.LP See \fBenviron\fR(5) for descriptions of the following environment variables that affect the execution of \fBcfgadm\fR: \fBLC_TIME\fR, \fBLC_MESSAGES\fR, \fBNLSPATH\fR and \fBTZ\fR. @@ -763,8 +753,6 @@ applies to both the human readable (\fBstatus_time\fR) and parsable .RE .SH EXIT STATUS -.sp -.LP The following exit values are returned: .sp .ne 2 @@ -803,8 +791,6 @@ Usage error. .RE .SH SEE ALSO -.sp -.LP \fBcfgadm_fp\fR(1M), \fBcfgadm_ib\fR(1M), \fBcfgadm_pci\fR(1M), \fBcfgadm_sbd\fR(1M), \fBcfgadm_scsi\fR(1M), \fBcfgadm_usb\fR(1M), \fBifconfig\fR(1M), \fBmount\fR(1M), \fBprtdiag\fR(1M), @@ -812,14 +798,12 @@ Usage error. \fBgetopt\fR(3C), \fBgetsubopt\fR(3C), \fBisatty\fR(3C), \fBattributes\fR(5), \fBenviron\fR(5) .SH DIAGNOSTICS -.sp -.LP Diagnostic messages appear on the standard error output. Other than options and usage errors, the following are diagnostic messages produced by this utility: .sp .in +2 .nf -cfgadm: Configuration administration not supported on\fIap_id\fR +cfgadm: Configuration administration not supported on \fIap_id\fR .fi .in -2 .sp @@ -835,7 +819,7 @@ cfgadm: No library found for \fIap_id\fR .sp .in +2 .nf -cfgadm: \fIap_id\fRis ambiguous +cfgadm: \fIap_id\fR is ambiguous .fi .in -2 .sp @@ -901,8 +885,6 @@ cfgadm: \fIoperation\fR: Hardware specific failure: \fIerror_text\fR See \fBconfig_admin\fR(3CFGADM) for additional details regarding error messages. .SH NOTES -.sp -.LP Hardware resources enter the unconfigured pool in a hardware specific manner. This can occur at various times such as: system initialization or as a result of an unconfigure operation. An occupant that is in the \fBunconfigured\fR @@ -916,7 +898,7 @@ input for another command, for example within a shell script. For parsable output, the \fB-s\fR option must be used to select the fields required. The \fB-s\fR option can also be used to suppress the column headings. The following fields always produce parsable output: \fBap_id\fR, \fBphysid\fR, -\fBr_state\fR, \fBo_state\fR, \fBcondition\fR, \fBbusy\fR \fBstatus_time_p\fR, +\fBr_state\fR, \fBo_state\fR, \fBcondition\fR, \fBbusy\fR, \fBstatus_time_p\fR, \fBclass\fR, and \fBtype\fR. Parsable output never has white-space characters embedded in the field value. .sp diff --git a/usr/src/man/man1m/in.ndpd.1m b/usr/src/man/man1m/in.ndpd.1m index 19d071df9b..f967d1f652 100644 --- a/usr/src/man/man1m/in.ndpd.1m +++ b/usr/src/man/man1m/in.ndpd.1m @@ -3,17 +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 IN.NDPD 1M "Sep 02, 2015" +.TH IN.NDPD 1M "September 12, 2020" .SH NAME in.ndpd \- daemon for IPv6 autoconfiguration .SH SYNOPSIS -.LP .nf \fB/usr/lib/inet/in.ndpd\fR [\fB-adt\fR] [\fB-f\fR \fIconfig_file\fR] .fi .SH DESCRIPTION -.LP \fBin.ndpd\fR provides both the host and router autoconfiguration components of Neighbor Discovery for IPv6 and Stateless and Stateful Address Autoconfiguration for IPv6. In particular, \fBin.ndpd\fR implements: @@ -148,9 +146,9 @@ of routers, a host can generate only link-local addresses. Link-local addresses can only be used for communication with nodes on the same link. .sp .LP -For information on how to enable IPv6 address autoconfiguration, see \fI\fR +For information on how to enable IPv6 address autoconfiguration, see +\fISystem Administration Guide: IP Services\fR. .SH OPTIONS -.LP Supported options and equivalent SMF service properties are listed below. SMF service properties are set using a command of the form: .sp @@ -215,7 +213,7 @@ Use \fIconfig_file\fR for configuration information instead of the default .ad .sp .6 .RS 4n -Turn on tracing (printing) of all sent and received packets to\fBstdout\fR. +Turn on tracing (printing) of all sent and received packets to \fBstdout\fR. When set, the program runs in the foreground and stays attached to the controlling terminal. As such, this option cannot be run under the SMF. .RE @@ -232,7 +230,6 @@ the hosts. .RE .SH SEE ALSO -.LP \fBdhcpagent\fR(1M), \fBifconfig\fR(1M), \fBndp\fR(1M), \fBrouteadm\fR(1M), \fBsvcadm\fR(1M), \fBndpd.conf\fR(4), \fBattributes\fR(5), \fBsmf\fR(5), \fBicmp6\fR(7P), \fBip6\fR(7P), \fBndp\fR(7P) @@ -249,11 +246,9 @@ Autoconfiguration\fR. The Internet Society. December 1998. Narten, T., and Draves, R. \fIRFC 3041, Privacy Extensions for Stateless Address Autoconfiguration in IPv6\fR. The Internet Society. January 2001. .SH DIAGNOSTICS -.LP Receipt of a \fBSIGHUP\fR signal will make \fBin.ndpd\fR restart and reread \fB/etc/inet/ndpd.conf\fR. .SH NOTES -.LP The \fBin.ndpd\fR daemon service is managed by the service management facility, \fBsmf\fR(5), under the service identifier: .sp diff --git a/usr/src/man/man1m/mpathadm.1m b/usr/src/man/man1m/mpathadm.1m index aa1b0a88c5..8ab8b6511c 100644 --- a/usr/src/man/man1m/mpathadm.1m +++ b/usr/src/man/man1m/mpathadm.1m @@ -3,25 +3,22 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH MPATHADM 1M "May 4, 2009" +.TH MPATHADM 1M "September 12, 2020" .SH NAME mpathadm \- multipath discovery and administration .SH SYNOPSIS -.LP .nf \fBmpathadm\fR \fIsubcommand\fR \fIdirect-object\fR [\fIoptions\fR] [\fIoperand\fR] .fi .SH DESCRIPTION -.sp -.LP The \fBmpathadm\fR command enables multipathing discovery and management. The \fBmpathadm\fR command is implemented as a set of subcommands, many with their own options, that are described in the section for that subcommand. Options not associated with a particular subcommand are described under OPTIONS. The \fBmpathadm\fR subcommands operate on a \fIdirect-object\fR. These are described in this section for each subcommand. The \fIdirect-objects\fR, -\fIinitiator-port\fR, \fItarget-port\fR, and\fIlogical-unit\fR in the +\fIinitiator-port\fR, \fItarget-port\fR, and \fIlogical-unit\fR in the subcommands are consistent with SCSI standard definitions. .sp .LP @@ -95,8 +92,6 @@ Set a path to be used over other paths on a logical-unit. The \fBmpathadm\fR subcommands operate on a \fIdirect-object\fR. These are described in this section for each subcommand. .SS "list Subcommand" -.sp -.LP The syntax for the \fBlist\fR subcommand is: .sp .in +2 @@ -171,8 +166,6 @@ Return the list of logical units names that are associated with the given .RE .SS "\fBshow\fR Subcommand" -.sp -.LP The syntax for the \fBshow\fR subcommand is: .sp .in +2 @@ -225,8 +218,6 @@ associated identifier type defined by the SCSI standards. .RE .SS "\fBmodify\fR Subcommand" -.sp -.LP The syntax for the \fBmodify\fR subcommand is: .sp .in +2 @@ -329,8 +320,6 @@ configuration is supported at the logical unit level. .RE .SS "\fBenable\fR Subcommand" -.sp -.LP The syntax for the \fBenable\fR subcommand is: .sp .in +2 @@ -360,8 +349,6 @@ logical unit will be enabled. .RE .SS "\fBdisable\fR Subcommand" -.sp -.LP The syntax for the \fBdisable\fR subcommand is: .sp .in +2 @@ -391,8 +378,6 @@ logical unit will be disabled. .RE .SS "\fBfailover\fR Subcommand" -.sp -.LP The syntax for the \fBfailover\fR subcommand is: .sp .in +2 @@ -419,8 +404,6 @@ active. .RE .SS "\fBoverride\fR Subcommand" -.sp -.LP The syntax for the \fBoverride\fR subcommand is: .sp .in +2 @@ -500,8 +483,6 @@ also be included. .RE .SH OPTIONS -.sp -.LP The following options are supported: .sp .ne 2 @@ -535,7 +516,6 @@ combination of subcommand and direct-object. .RE .SH EXAMPLES -.LP \fBExample 1 \fRObtaining a List of Multipathing Support .sp .LP @@ -652,7 +632,7 @@ Logical Unit: /dev/rdsk/c4t60003BA27D2120004204AC2B000DAB00d0s2 Asymmetric: yes Current Load Balance: round-robin Logical Unit Group ID: NA - Aauto Failback: on + Auto Failback: on Auto Probing: NA Paths: @@ -713,8 +693,6 @@ with the specified initiator port, target port, and logical unit. .sp .SH ATTRIBUTES -.sp -.LP See \fBattributes\fR(5) for descriptions of the following attributes: .sp @@ -729,7 +707,5 @@ Interface Stability Evolving .TE .SH SEE ALSO -.sp -.LP \fBstmsboot\fR(1M), \fBlibMPAPI\fR(3LIB), \fBexec_attr\fR(4), \fBattributes\fR(5) diff --git a/usr/src/man/man2/_lwp_cond_wait.2 b/usr/src/man/man2/_lwp_cond_wait.2 index 171b713ff5..c095bbc954 100644 --- a/usr/src/man/man2/_lwp_cond_wait.2 +++ b/usr/src/man/man2/_lwp_cond_wait.2 @@ -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 _LWP_COND_WAIT 2 "Apr 13, 2001" +.TH _LWP_COND_WAIT 2 "September 12, 2020" .SH NAME _lwp_cond_wait, _lwp_cond_timedwait, _lwp_cond_reltimedwait \- wait on a condition variable .SH SYNOPSIS -.LP .nf #include <sys/lwp.h> @@ -28,8 +27,6 @@ condition variable .fi .SH DESCRIPTION -.sp -.LP These functions are used to wait for the occurrence of a condition represented by an LWP condition variable. LWP condition variables must be initialized to 0 before use. @@ -61,13 +58,9 @@ The \fB_lwp_cond_wait()\fR, \fB_lwp_cond_timedwait()\fR, and \fB_lwp_cond_reltimedwait()\fR functions always return with the mutex locked and owned by the calling lightweight process. .SH RETURN VALUES -.sp -.LP Upon successful completion, \fB0\fR is returned. A non-zero value indicates an error. .SH ERRORS -.sp -.LP If any of the following conditions are detected, \fB_lwp_cond_wait()\fR, \fB_lwp_cond_timedwait()\fR, and \fB_lwp_cond_reltimedwait()\fR fail and return the corresponding value: @@ -115,11 +108,10 @@ If any of the following conditions occur, \fB_lwp_cond_timedwait()\fR and \fB\fBETIME\fR\fR .ad .RS 9n -The time specified in\fIabstime\fR or \fIreltime\fR has passed. +The time specified in \fIabstime\fR or \fIreltime\fR has passed. .RE .SH EXAMPLES -.LP \fBExample 1 \fRUse the \fB_lwp_cond_wait()\fR function in a loop testing some condition. .sp @@ -164,7 +156,7 @@ while (cond == FALSE) { if (err == ETIME) { /* timeout, do something */ break; - SENDwhom} + } } (void) _lwp_mutex_unlock(&m); .fi @@ -206,7 +198,5 @@ while (cond == FALSE) { .in -2 .SH SEE ALSO -.sp -.LP \fB_lwp_cond_broadcast\fR(2), \fB_lwp_cond_signal\fR(2), \fB_lwp_kill\fR(2), \fB_lwp_mutex_lock\fR(2), \fBfork\fR(2), \fBkill\fR(2) diff --git a/usr/src/man/man3c_db/td_thr_setsigpending.3c_db b/usr/src/man/man3c_db/td_thr_setsigpending.3c_db index 9026e83642..f2dce9f57f 100644 --- a/usr/src/man/man3c_db/td_thr_setsigpending.3c_db +++ b/usr/src/man/man3c_db/td_thr_setsigpending.3c_db @@ -3,18 +3,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 TD_THR_SETSIGPENDING 3C_DB "Oct 20, 1998" +.TH TD_THR_SETSIGPENDING 3C_DB "September 12, 2020" .SH NAME td_thr_setsigpending, td_thr_sigsetmask \- manage thread signals for libc_db .SH SYNOPSIS -.LP .nf cc [ \fIflag\fR... ] \fIfile\fR... -lc_db [ \fIlibrary\fR... ] #include <proc_service.h> #include <thread_db.h> -\fBtd_err_e\fR \fBtd_thr_setsigpending\fR(\fBconst td_thrhandle_t *\fR \fIth_p\fR, \fBconst uchar_ t\fR \fIti_sigpending_flag\fR, - \fBconst sigset_t\fR \fIti_sigmask\fR;); +\fBtd_err_e\fR \fBtd_thr_setsigpending\fR(\fBconst td_thrhandle_t *\fR \fIth_p\fR, \fBconst uchar_t\fR \fIti_sigpending_flag\fR, + \fBconst sigset_t\fR \fIti_sigmask\fR); .fi .LP @@ -23,8 +22,6 @@ cc [ \fIflag\fR... ] \fIfile\fR... -lc_db [ \fIlibrary\fR... ] .fi .SH DESCRIPTION -.sp -.LP The \fBtd_thr_setsigpending()\fR and \fBtd_thr_setsigmask()\fR functions affect the signal state of the thread identified by \fIth_p\fR. .sp @@ -66,10 +63,9 @@ desired, and .RS +4 .TP 4. -set the new signal mask with\fBtd_thr_sigsetmask()\fR. +set the new signal mask with \fBtd_thr_sigsetmask()\fR. .RE .SH RETURN VALUES -.sp .ne 2 .na \fB\fBTD_OK\fR\fR @@ -106,8 +102,6 @@ A \fBlibc_db\fR internal error occurred. .RE .SH ATTRIBUTES -.sp -.LP See \fBattributes\fR(5) for description of the following attributes: .sp @@ -122,7 +116,5 @@ MT-Level Safe .TE .SH SEE ALSO -.sp -.LP \fBlibc_db\fR(3LIB), \fBtd_thr_dbsuspend\fR(3C_DB), \fBtd_thr_get_info\fR(3C_DB), \fBattributes\fR(5) diff --git a/usr/src/man/man3proc/ps_lgetregs.3proc b/usr/src/man/man3proc/ps_lgetregs.3proc index 2ae19d7ff4..65a519831e 100644 --- a/usr/src/man/man3proc/ps_lgetregs.3proc +++ b/usr/src/man/man3proc/ps_lgetregs.3proc @@ -3,17 +3,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 PS_LGETREGS 3PROC "Jan 30, 1998" +.TH PS_LGETREGS 3PROC "September 12, 2020" .SH NAME ps_lgetregs, ps_lsetregs, ps_lgetfpregs, ps_lsetfpregs, ps_lgetxregsize, ps_lgetxregs, ps_lsetxregs \- routines that access the target process register in libthread_db .SH SYNOPSIS -.LP .nf #include <proc_service.h> -\fB ps_err_e\fR \fBps_lgetregs\fR(\fBstruct ps_prochandle *\fR\fIph\fR, \fBlwpid_t\fR \fIlid\fR, +\fBps_err_e\fR \fBps_lgetregs\fR(\fBstruct ps_prochandle *\fR\fIph\fR, \fBlwpid_t\fR \fIlid\fR, \fBprgregset_t\fR \fIgregset\fR); .fi @@ -54,7 +53,6 @@ in libthread_db .fi .SH DESCRIPTION -.LP \fBps_lgetregs()\fR, \fBps_lsetregs()\fR, \fBps_lgetfpregs()\fR, \fBps_lsetfpregs()\fR, \fBps_lgetxregsize()\fR, \fBps_lgetxregs()\fR, \fBps_lsetxregs()\fR read and write register sets from lightweight processes @@ -63,8 +61,7 @@ in libthread_db \fIlid\fR, and \fBps_lsetregs()\fR sets them. \fBps_lgetfpregs()\fR gets the \fBLWP\fR's floating point register set, while \fBps_lsetfpregs()\fR sets it. .SS "SPARC Only" -.LP -\fBps_lgetxregsize()\fR,\fBps_lgetxregs()\fR, and\fBps_lsetxregs()\fR are +\fBps_lgetxregsize()\fR, \fBps_lgetxregs()\fR, and \fBps_lsetxregs()\fR are SPARC-specific. They do not need to be defined by a controlling process on non-SPARC architecture. \fBps_lgetxregsize()\fR returns in \fB*\fR\fIxregsize\fR the size of the architecture-dependent extra state @@ -108,7 +105,6 @@ The function did not return successfully. .RE .SH ATTRIBUTES -.LP See \fBattributes\fR(5) for description of the following attributes: .sp @@ -123,6 +119,5 @@ MT Level Safe .TE .SH SEE ALSO -.LP \fBlibc_db\fR(3LIB), \fBproc_service\fR(3PROC), \fBattributes\fR(5), \fBthreads\fR(5) diff --git a/usr/src/man/man3scf/scf_value_create.3scf b/usr/src/man/man3scf/scf_value_create.3scf index d1662df58a..10cec46cd0 100644 --- a/usr/src/man/man3scf/scf_value_create.3scf +++ b/usr/src/man/man3scf/scf_value_create.3scf @@ -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 SCF_VALUE_CREATE 3SCF "May 28, 2009" +.TH SCF_VALUE_CREATE 3SCF "September 12, 2020" .SH NAME scf_value_create, scf_value_handle, scf_value_reset, scf_value_destroy, scf_value_type, scf_value_base_type, scf_value_is_type, scf_type_base_type, @@ -15,7 +15,6 @@ scf_value_set_time, scf_value_set_from_string, scf_value_set_astring, scf_value_set_ustring, scf_value_set_opaque \- manipulate values in the Service Configuration Facility .SH SYNOPSIS -.LP .nf cc [ \fIflag\fR\&.\|.\|. ] \fIfile\fR\&.\|.\|. \fB-lscf\fR [ \fIlibrary\fR\&.\|.\|. ] #include <libscf.h> @@ -152,8 +151,6 @@ cc [ \fIflag\fR\&.\|.\|. ] \fIfile\fR\&.\|.\|. \fB-lscf\fR [ \fIlibrary\fR\&.\|. .fi .SH DESCRIPTION -.sp -.LP The \fBscf_value_create()\fR function creates a new, reset \fBscf_value_t\fR that holds a single typed value. The value can be used only with the handle specified by \fIh\fR and objects associated with \fIh\fR. @@ -229,8 +226,6 @@ The \fBscf_value_set_from_string()\fR function is the inverse of The \fBscf_value_set_*()\fR functions will succeed on \fBscf_value_t\fR objects that have already been set. .SH RETURN VALUES -.sp -.LP Upon successful completion, \fBscf_value_create()\fR returns a new, reset \fBscf_value_t\fR. Otherwise, it returns \fINULL\fR. .sp @@ -264,8 +259,6 @@ not including the terminating null byte. Otherwise, they return -1. Upon successful completion, \fBscf_value_get_opaque()\fR returns the number of bytes written. Otherwise, it returns -1. .SH ERRORS -.sp -.LP The \fBscf_value_create()\fR function will fail if: .sp .ne 2 @@ -364,7 +357,7 @@ The \fBscf_value_type()\fR, \fBscf_value_base_type()\fR, \fBscf_value_get_boolean()\fR, \fBscf_value_get_count()\fR, \fBscf_value_get_integer()\fR, \fBscf_value_get_time()\fR, \fBscf_value_get_astring()\fR, \fBscf_value_get_ustring()\fR, -\fBscf_value_get_as_string()\fR, and\fBscf_value_get_as_string_typed()\fR +\fBscf_value_get_as_string()\fR, and \fBscf_value_get_as_string_typed()\fR functions will fail if: .sp .ne 2 @@ -395,8 +388,6 @@ base-type chain. .LP The \fBscf_error\fR(3SCF) function can be used to retrieve the error value. .SH ATTRIBUTES -.sp -.LP See \fBattributes\fR(5) for descriptions of the following attributes: .sp @@ -413,7 +404,5 @@ MT-Level Safe .TE .SH SEE ALSO -.sp -.LP \fBlibscf\fR(3LIB), \fBscf_entry_add_value\fR(3SCF), \fBscf_error\fR(3SCF), \fBattributes\fR(5) diff --git a/usr/src/man/man7d/audio810.7d b/usr/src/man/man7d/audio810.7d index aa2543f73b..53abf390d5 100644 --- a/usr/src/man/man7d/audio810.7d +++ b/usr/src/man/man7d/audio810.7d @@ -3,17 +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 AUDIO810 7D "May 13, 2009" +.TH AUDIO810 7D "September 12, 2020" .SH NAME audio810 \- Intel ICH series, nVidia nForce series and AMD 8111 audio core support .SH DESCRIPTION -.sp -.LP The \fBaudio810\fR driver provides support for AC 97 audio controllers embedded in Intel ICH, nVidia nForce, and AMD 8111 chips. .SH FILES -.sp .ne 2 .na \fB\fB/kernel/drv/audio810\fR\fR @@ -41,8 +38,6 @@ in Intel ICH, nVidia nForce, and AMD 8111 chips. .RE .SH ATTRIBUTES -.sp -.LP See \fBattributes\fR(5) for a descriptions of the following attributes: .sp @@ -59,8 +54,6 @@ Interface Stability Uncommitted .TE .SH SEE ALSO -.sp -.LP \fBioctl\fR(2), \fBattributes\fR(5), \fBaudio\fR(7I), \fBmixer\fR(7I), \fBstreamio\fR(7I) .sp @@ -71,16 +64,12 @@ Inc. .LP \fIALC655 Specification\fR \(em Realtek Inc. .SH NOTES -.sp -.LP Some laptops (including Sony VAIO, among others), have their on-board amplifier powered down by default, meaning that audio is suppressed even if hardware and the \fBaudio810\fR driver are working normally. To correct this, set the \fBac97-invert-amp=1\fR property in the \fB/kernel/drv/audio810.conf\fR to power-up the amplifier. .SH DIAGNOSTICS -.sp -.LP In addition to being logged, the following messages may appear on the system console: .sp @@ -108,7 +97,7 @@ interrupt rate. \fB\fBrecord-interrupts too high\fR\fR .ad .RS 30n -The interrupt rate set in\fBaudio810.conf\fR is set too high. It has been +The interrupt rate set in \fBaudio810.conf\fR is set too high. It has been reset to the rate specified in the message. Update \fBaudio810.conf\fR to a lower interrupt rate. .RE diff --git a/usr/src/man/man9f/inb.9f b/usr/src/man/man9f/inb.9f index 61fc3c1444..686508d008 100644 --- a/usr/src/man/man9f/inb.9f +++ b/usr/src/man/man9f/inb.9f @@ -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 INB 9F "Oct 24, 2012" +.TH INB 9F "September 12, 2020" .SH NAME inb, inw, inl, repinsb, repinsw, repinsd \- read from an I/O port .SH SYNOPSIS -.LP .nf #include <sys/ddi.h> #include <sys/sunddi.h> @@ -45,15 +44,12 @@ inb, inw, inl, repinsb, repinsw, repinsd \- read from an I/O port .fi .SH INTERFACE LEVEL -.sp -.LP The functions described here are obsolete. For the \fBinb()\fR, \fBinw()\fR, and \fBinl()\fR functions, use, respectively, \fBddi_get8\fR(9F), \fBddi_get16\fR(9F), and \fBddi_get32\fR(9F) instead. For \fBrepinsb()\fR, -\fBrepinsw()\fR, and\fBrepinsl()\fR, use, respectively, \fBddi_rep_get8\fR(9F), +\fBrepinsw()\fR, and \fBrepinsl()\fR, use, respectively, \fBddi_rep_get8\fR(9F), \fBddi_rep_get16\fR(9F), and \fBddi_rep_get32\fR(9F) instead. .SH PARAMETERS -.sp .ne 2 .na \fB\fIport\fR\fR @@ -81,8 +77,6 @@ The number of values to be read from the I/O port. .RE .SH DESCRIPTION -.sp -.LP These routines read data of various sizes from the I/O port with the address specified by \fIport\fR. .sp @@ -97,17 +91,11 @@ the number of values to be read. A pointer to a buffer will receive the input data; the buffer must be long enough to hold count values of the requested size. .SH RETURN VALUES -.sp -.LP The \fBinb()\fR, \fBinw()\fR, and \fBinl()\fR functions return the value that was read from the I/O port. .SH CONTEXT -.sp -.LP These functions may be called from user, interrupt, or kernel context. .SH ATTRIBUTES -.sp -.LP See \fBattributes\fR(5) for descriptions of the following attributes: .sp @@ -124,8 +112,6 @@ Stability Level Obsolete .TE .SH SEE ALSO -.sp -.LP \fBisa\fR(4), \fBattributes\fR(5), \fBddi_get8\fR(9F), \fBddi_get16\fR(9F), \fBddi_get32\fR(9F), \fBddi_rep_get8\fR(9F), \fBddi_rep_get16\fR(9F), \fBddi_rep_get32\fR(9F), \fBoutb\fR(9F) diff --git a/usr/src/man/man9s/ddi_dma_attr.9s b/usr/src/man/man9s/ddi_dma_attr.9s index c4c100bf94..73865d9f2b 100644 --- a/usr/src/man/man9s/ddi_dma_attr.9s +++ b/usr/src/man/man9s/ddi_dma_attr.9s @@ -3,28 +3,22 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH DDI_DMA_ATTR 9S "Feb 12, 2009" +.TH DDI_DMA_ATTR 9S "September 12, 2020" .SH NAME ddi_dma_attr \- DMA attributes structure .SH SYNOPSIS -.LP .nf #include <sys/ddidmareq.h> .fi .SH INTERFACE LEVEL -.sp -.LP Solaris DDI specific (Solaris DDI) .SH DESCRIPTION -.sp -.LP A \fBddi_dma_attr_t\fR structure describes device- and \fBDMA\fR engine-specific attributes necessary to allocate \fBDMA\fR resources for a device. The driver might have to extend the attributes with bus-specific information, depending on the bus to which the device is connected. .SH STRUCTURE MEMBERS -.sp .in +2 .nf uint_t dma_attr_version; /* version number */ @@ -116,7 +110,7 @@ scatter/gather list of a device. Possible values are as follows: .ad .RS 7n Device \fBDMA\fR engine is not constrained by the size, for example, -with\fBDMA\fR chaining. +with \fBDMA\fR chaining. .RE .sp @@ -226,7 +220,6 @@ capability instead. .RE .SH EXAMPLES -.LP \fBExample 1 \fRInitializing the \fBddi_dma_attr_t\fR Structure .sp .LP @@ -310,8 +303,6 @@ static ddi_dma_attr_t dma_attrs = { .in -2 .SH ATTRIBUTES -.sp -.LP See \fBattributes\fR(5) for descriptions of the following attributes: .sp @@ -326,8 +317,6 @@ Interface Stability Committed .TE .SH SEE ALSO -.sp -.LP \fBattributes\fR(5), \fBddi_dma_addr_bind_handle\fR(9F), \fBddi_dma_alloc_handle\fR(9F), \fBddi_dma_buf_bind_handle\fR(9F), \fBddi_dma_burstsizes\fR(9F), \fBddi_dma_mem_alloc\fR(9F), |