From owner-svn-src-all@FreeBSD.ORG Thu Mar 29 16:02:40 2012 Return-Path: Delivered-To: svn-src-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id D6965106566C; Thu, 29 Mar 2012 16:02:40 +0000 (UTC) (envelope-from joel@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:4f8:fff6::2c]) by mx1.freebsd.org (Postfix) with ESMTP id BE5538FC12; Thu, 29 Mar 2012 16:02:40 +0000 (UTC) Received: from svn.freebsd.org (localhost [127.0.0.1]) by svn.freebsd.org (8.14.4/8.14.4) with ESMTP id q2TG2en2000313; Thu, 29 Mar 2012 16:02:40 GMT (envelope-from joel@svn.freebsd.org) Received: (from joel@localhost) by svn.freebsd.org (8.14.4/8.14.4/Submit) id q2TG2eKi000303; Thu, 29 Mar 2012 16:02:40 GMT (envelope-from joel@svn.freebsd.org) Message-Id: <201203291602.q2TG2eKi000303@svn.freebsd.org> From: Joel Dahl Date: Thu, 29 Mar 2012 16:02:40 +0000 (UTC) To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org X-SVN-Group: head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Cc: Subject: svn commit: r233665 - in head: bin/ps lib/libc/posix1e lib/libc/sys lib/libutil usr.bin/rctl X-BeenThere: svn-src-all@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "SVN commit messages for the entire src tree \(except for " user" and " projects" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 29 Mar 2012 16:02:40 -0000 Author: joel (doc committer) Date: Thu Mar 29 16:02:40 2012 New Revision: 233665 URL: http://svn.freebsd.org/changeset/base/233665 Log: mandoc complains loudly when s are misused in columnated lists. Fix this syntax violation and while I'm here also convert to Ta and adjust quotation marks in order to prevent this problem in the future. Modified: head/bin/ps/ps.1 head/lib/libc/posix1e/acl_add_flag_np.3 head/lib/libc/posix1e/acl_add_perm.3 head/lib/libc/posix1e/acl_set_entry_type_np.3 head/lib/libc/posix1e/acl_set_tag_type.3 head/lib/libc/posix1e/acl_to_text.3 head/lib/libc/sys/ktrace.2 head/lib/libutil/login.conf.5 head/usr.bin/rctl/rctl.8 Modified: head/bin/ps/ps.1 ============================================================================== --- head/bin/ps/ps.1 Thu Mar 29 15:47:29 2012 (r233664) +++ head/bin/ps/ps.1 Thu Mar 29 16:02:40 2012 (r233665) @@ -292,37 +292,37 @@ The flags associated with the process as the include file .In sys/proc.h : .Bl -column P_SINGLE_BOUNDARY 0x40000000 -.It Dv "P_ADVLOCK" Ta No "0x00001 Process may hold a POSIX advisory lock" -.It Dv "P_CONTROLT" Ta No "0x00002 Has a controlling terminal" -.It Dv "P_KTHREAD" Ta No "0x00004 Kernel thread" -.It Dv "P_FOLLOWFORK" Ta No "0x00008 Attach debugger to new children" -.It Dv "P_PPWAIT" Ta No "0x00010 Parent is waiting for child to exec/exit" -.It Dv "P_PROFIL" Ta No "0x00020 Has started profiling" -.It Dv "P_STOPPROF" Ta No "0x00040 Has thread in requesting to stop prof" -.It Dv "P_HADTHREADS" Ta No "0x00080 Has had threads (no cleanup shortcuts)" -.It Dv "P_SUGID" Ta No "0x00100 Had set id privileges since last exec" -.It Dv "P_SYSTEM" Ta No "0x00200 System proc: no sigs, stats or swapping" -.It Dv "P_SINGLE_EXIT" Ta No "0x00400 Threads suspending should exit, not wait" -.It Dv "P_TRACED" Ta No "0x00800 Debugged process being traced" -.It Dv "P_WAITED" Ta No "0x01000 Someone is waiting for us" -.It Dv "P_WEXIT" Ta No "0x02000 Working on exiting" -.It Dv "P_EXEC" Ta No "0x04000 Process called exec" -.It Dv "P_WKILLED" Ta No "0x08000 Killed, shall go to kernel/user boundary ASAP" -.It Dv "P_CONTINUED" Ta No "0x10000 Proc has continued from a stopped state" -.It Dv "P_STOPPED_SIG" Ta No "0x20000 Stopped due to SIGSTOP/SIGTSTP" -.It Dv "P_STOPPED_TRACE" Ta No "0x40000 Stopped because of tracing" -.It Dv "P_STOPPED_SINGLE" Ta No "0x80000 Only one thread can continue" -.It Dv "P_PROTECTED" Ta No "0x100000 Do not kill on memory overcommit" -.It Dv "P_SIGEVENT" Ta No "0x200000 Process pending signals changed" -.It Dv "P_SINGLE_BOUNDARY" Ta No "0x400000 Threads should suspend at user boundary" -.It Dv "P_HWPMC" Ta No "0x800000 Process is using HWPMCs" -.It Dv "P_JAILED" Ta No "0x1000000 Process is in jail" -.It Dv "P_ORPHAN" Ta No "0x2000000 Orphaned by original parent, reparented to debugger" -.It Dv "P_INEXEC" Ta No "0x4000000 Process is in execve()" -.It Dv "P_STATCHILD" Ta No "0x8000000 Child process stopped or exited" -.It Dv "P_INMEM" Ta No "0x10000000 Loaded into memory" -.It Dv "P_SWAPPINGOUT" Ta No "0x20000000 Process is being swapped out" -.It Dv "P_SWAPPINGIN" Ta No "0x40000000 Process is being swapped in" +.It Dv "P_ADVLOCK" Ta No "0x00001" Ta "Process may hold a POSIX advisory lock" +.It Dv "P_CONTROLT" Ta No "0x00002" Ta "Has a controlling terminal" +.It Dv "P_KTHREAD" Ta No "0x00004" Ta "Kernel thread" +.It Dv "P_FOLLOWFORK" Ta No "0x00008" Ta "Attach debugger to new children" +.It Dv "P_PPWAIT" Ta No "0x00010" Ta "Parent is waiting for child to exec/exit" +.It Dv "P_PROFIL" Ta No "0x00020" Ta "Has started profiling" +.It Dv "P_STOPPROF" Ta No "0x00040" Ta "Has thread in requesting to stop prof" +.It Dv "P_HADTHREADS" Ta No "0x00080" Ta "Has had threads (no cleanup shortcuts)" +.It Dv "P_SUGID" Ta No "0x00100" Ta "Had set id privileges since last exec" +.It Dv "P_SYSTEM" Ta No "0x00200" Ta "System proc: no sigs, stats or swapping" +.It Dv "P_SINGLE_EXIT" Ta No "0x00400" Ta "Threads suspending should exit, not wait" +.It Dv "P_TRACED" Ta No "0x00800" Ta "Debugged process being traced" +.It Dv "P_WAITED" Ta No "0x01000" Ta "Someone is waiting for us" +.It Dv "P_WEXIT" Ta No "0x02000" Ta "Working on exiting" +.It Dv "P_EXEC" Ta No "0x04000" Ta "Process called exec" +.It Dv "P_WKILLED" Ta No "0x08000" Ta "Killed, shall go to kernel/user boundary ASAP" +.It Dv "P_CONTINUED" Ta No "0x10000" Ta "Proc has continued from a stopped state" +.It Dv "P_STOPPED_SIG" Ta No "0x20000" Ta "Stopped due to SIGSTOP/SIGTSTP" +.It Dv "P_STOPPED_TRACE" Ta No "0x40000" Ta "Stopped because of tracing" +.It Dv "P_STOPPED_SINGLE" Ta No "0x80000" Ta "Only one thread can continue" +.It Dv "P_PROTECTED" Ta No "0x100000" Ta "Do not kill on memory overcommit" +.It Dv "P_SIGEVENT" Ta No "0x200000" Ta "Process pending signals changed" +.It Dv "P_SINGLE_BOUNDARY" Ta No "0x400000" Ta "Threads should suspend at user boundary" +.It Dv "P_HWPMC" Ta No "0x800000" Ta "Process is using HWPMCs" +.It Dv "P_JAILED" Ta No "0x1000000" Ta "Process is in jail" +.It Dv "P_ORPHAN" Ta No "0x2000000" Ta "Orphaned by original parent, reparented to debugger" +.It Dv "P_INEXEC" Ta No "0x4000000" Ta "Process is in execve()" +.It Dv "P_STATCHILD" Ta No "0x8000000" Ta "Child process stopped or exited" +.It Dv "P_INMEM" Ta No "0x10000000" Ta "Loaded into memory" +.It Dv "P_SWAPPINGOUT" Ta No "0x20000000" Ta "Process is being swapped out" +.It Dv "P_SWAPPINGIN" Ta No "0x40000000" Ta "Process is being swapped in" .El .It Cm label The MAC label of the process. Modified: head/lib/libc/posix1e/acl_add_flag_np.3 ============================================================================== --- head/lib/libc/posix1e/acl_add_flag_np.3 Thu Mar 29 15:47:29 2012 (r233664) +++ head/lib/libc/posix1e/acl_add_flag_np.3 Thu Mar 29 16:02:40 2012 (r233665) @@ -52,10 +52,10 @@ that already exist in the flagset. .Pp Valid values are: .Bl -column -offset 3n "ACL_ENTRY_NO_PROPAGATE_INHERIT" -.It ACL_ENTRY_FILE_INHERIT Will be inherited by files. -.It ACL_ENTRY_DIRECTORY_INHERIT Will be inherited by directories. -.It ACL_ENTRY_NO_PROPAGATE_INHERIT Will not propagate. -.It ACL_ENTRY_INHERIT_ONLY Inherit-only. +.It ACL_ENTRY_FILE_INHERIT Ta "Will be inherited by files." +.It ACL_ENTRY_DIRECTORY_INHERIT Ta "Will be inherited by directories." +.It ACL_ENTRY_NO_PROPAGATE_INHERIT Ta "Will not propagate." +.It ACL_ENTRY_INHERIT_ONLY Ta "Inherit-only." .El .Sh RETURN VALUES .Rv -std acl_add_flag_np Modified: head/lib/libc/posix1e/acl_add_perm.3 ============================================================================== --- head/lib/libc/posix1e/acl_add_perm.3 Thu Mar 29 15:47:29 2012 (r233664) +++ head/lib/libc/posix1e/acl_add_perm.3 Thu Mar 29 16:02:40 2012 (r233665) @@ -59,22 +59,22 @@ For POSIX.1e ACLs, valid values are: .Pp For NFSv4 ACLs, valid values are: .Bl -column -offset 3n "ACL_WRITE_NAMED_ATTRS" -.It ACL_READ_DATA Read permission -.It ACL_LIST_DIRECTORY Same as ACL_READ_DATA -.It ACL_WRITE_DATA Write permission, or permission to create files -.It ACL_ADD_FILE Same as ACL_READ_DATA -.It ACL_APPEND_DATA Permission to create directories. Ignored for files -.It ACL_ADD_SUBDIRECTORY Same as ACL_APPEND_DATA -.It ACL_READ_NAMED_ATTRS Ignored -.It ACL_WRITE_NAMED_ATTRS Ignored -.It ACL_EXECUTE Execute permission -.It ACL_DELETE_CHILD Permission to delete files and subdirectories -.It ACL_READ_ATTRIBUTES Permission to read basic attributes -.It ACL_WRITE_ATTRIBUTES Permission to change basic attributes -.It ACL_DELETE Permission to delete the object this ACL is placed on -.It ACL_READ_ACL Permission to read ACL -.It ACL_WRITE_ACL Permission to change the ACL and file mode -.It ACL_SYNCHRONIZE Ignored +.It ACL_READ_DATA Ta "Read permission" +.It ACL_LIST_DIRECTORY Ta "Same as ACL_READ_DATA" +.It ACL_WRITE_DATA Ta "Write permission, or permission to create files" +.It ACL_ADD_FILE Ta "Same as ACL_READ_DATA" +.It ACL_APPEND_DATA Ta "Permission to create directories. Ignored for files" +.It ACL_ADD_SUBDIRECTORY Ta "Same as ACL_APPEND_DATA" +.It ACL_READ_NAMED_ATTRS Ta "Ignored" +.It ACL_WRITE_NAMED_ATTRS Ta "Ignored" +.It ACL_EXECUTE Ta "Execute permission" +.It ACL_DELETE_CHILD Ta "Permission to delete files and subdirectories" +.It ACL_READ_ATTRIBUTES Ta "Permission to read basic attributes" +.It ACL_WRITE_ATTRIBUTES Ta "Permission to change basic attributes" +.It ACL_DELETE Ta "Permission to delete the object this ACL is placed on" +.It ACL_READ_ACL Ta "Permission to read ACL" +.It ACL_WRITE_ACL Ta "Permission to change the ACL and file mode" +.It ACL_SYNCHRONIZE Ta "Ignored" .El .Pp Calling Modified: head/lib/libc/posix1e/acl_set_entry_type_np.3 ============================================================================== --- head/lib/libc/posix1e/acl_set_entry_type_np.3 Thu Mar 29 15:47:29 2012 (r233664) +++ head/lib/libc/posix1e/acl_set_entry_type_np.3 Thu Mar 29 16:02:40 2012 (r233665) @@ -49,8 +49,8 @@ to the value referred to by .Pp Valid values are: .Bl -column -offset 3n "ACL_ENTRY_TYPE_ALLOW" -.It ACL_ENTRY_TYPE_ALLOW "allow" type entry -.It ACL_ENTRY_TYPE_DENY "deny" type entry +.It ACL_ENTRY_TYPE_ALLOW Ta "allow" type entry +.It ACL_ENTRY_TYPE_DENY Ta "deny" type entry .El .Pp This call brands the ACL as NFSv4. Modified: head/lib/libc/posix1e/acl_set_tag_type.3 ============================================================================== --- head/lib/libc/posix1e/acl_set_tag_type.3 Thu Mar 29 15:47:29 2012 (r233664) +++ head/lib/libc/posix1e/acl_set_tag_type.3 Thu Mar 29 16:02:40 2012 (r233665) @@ -49,14 +49,14 @@ to the value of .Pp Valid values are: .Bl -column -offset 3n "ACL_OTHER_OBJ" -.It ACL_USER_OBJ Permissions apply to file owner -.It ACL_USER Permissions apply to additional user specified by qualifier -.It ACL_GROUP_OBJ Permissions apply to file group -.It ACL_GROUP Permissions apply to additional group specified by qualifier -.It ACL_MASK Permissions specify mask -.It ACL_OTHER Permissions apply to "other" -.It ACL_OTHER_OBJ Same as ACL_OTHER -.It ACL_EVERYONE Permissions apply to "everyone@" +.It ACL_USER_OBJ Ta "Permissions apply to file owner" +.It ACL_USER Ta "Permissions apply to additional user specified by qualifier" +.It ACL_GROUP_OBJ Ta "Permissions apply to file group" +.It ACL_GROUP Ta "Permissions apply to additional group specified by qualifier" +.It ACL_MASK Ta "Permissions specify mask" +.It ACL_OTHER Ta Permissions apply to "other" +.It ACL_OTHER_OBJ Ta "Same as ACL_OTHER" +.It ACL_EVERYONE Ta Permissions apply to "everyone@" .El .Pp Calling Modified: head/lib/libc/posix1e/acl_to_text.3 ============================================================================== --- head/lib/libc/posix1e/acl_to_text.3 Thu Mar 29 15:47:29 2012 (r233664) +++ head/lib/libc/posix1e/acl_to_text.3 Thu Mar 29 16:02:40 2012 (r233665) @@ -67,9 +67,9 @@ The flags specified are formed by .Em or Ns 'ing the following values .Bl -column -offset 3n "ACL_TEXT_NUMERIC_IDS" -.It ACL_TEXT_VERBOSE Format ACL using verbose form -.It ACL_TEXT_NUMERIC_IDS Do not resolve IDs into user or group names -.It ACL_TEXT_APPEND_ID In addition to user and group names, append numeric IDs +.It ACL_TEXT_VERBOSE Ta "Format ACL using verbose form" +.It ACL_TEXT_NUMERIC_IDS Ta "Do not resolve IDs into user or group names" +.It ACL_TEXT_APPEND_ID Ta "In addition to user and group names, append numeric IDs" .El .Pp This function allocates any memory necessary to contain the string and Modified: head/lib/libc/sys/ktrace.2 ============================================================================== --- head/lib/libc/sys/ktrace.2 Thu Mar 29 15:47:29 2012 (r233664) +++ head/lib/libc/sys/ktrace.2 Thu Mar 29 16:02:40 2012 (r233665) @@ -67,12 +67,12 @@ The argument specifies the requested ktrace operation. The defined operations are: .Bl -column KTRFLAG_DESCENDXXX -offset indent -.It "KTROP_SET Enable trace points specified in" +.It KTROP_SET Ta "Enable trace points specified in" .Fa trpoints . -.It "KTROP_CLEAR Disable trace points specified in" +.It KTROP_CLEAR Ta "Disable trace points specified in" .Fa trpoints . -.It "KTROP_CLEARFILE Stop all tracing." -.It "KTRFLAG_DESCEND The tracing change should apply to the" +.It KTROP_CLEARFILE Ta "Stop all tracing." +.It KTRFLAG_DESCEND Ta "The tracing change should apply to the" specified process and all its current children. .El .Pp @@ -81,20 +81,20 @@ The argument specifies the trace points of interest. The defined trace points are: .Bl -column KTRFAC_PROCCTORXXX -offset indent -.It "KTRFAC_SYSCALL Trace system calls." -.It "KTRFAC_SYSRET Trace return values from system calls." -.It "KTRFAC_NAMEI Trace name lookup operations." -.It "KTRFAC_GENIO Trace all I/O (note that this option can" +.It KTRFAC_SYSCALL Ta "Trace system calls." +.It KTRFAC_SYSRET Ta "Trace return values from system calls." +.It KTRFAC_NAMEI Ta "Trace name lookup operations." +.It KTRFAC_GENIO Ta "Trace all I/O (note that this option can" generate much output). -.It "KTRFAC_PSIG Trace posted signals." -.It "KTRFAC_CSW Trace context switch points." -.It "KTRFAC_USER Trace application-specific events." -.It "KTRFAC_STRUCT Trace certain data structures." -.It "KTRFAC_SYSCTL Trace sysctls." -.It "KTRFAC_PROCCTOR Trace process construction." -.It "KTRFAC_PROCDTOR Trace process destruction." -.It "KTRFAC_CAPFAIL Trace capability failures." -.It "KTRFAC_INHERIT Inherit tracing to future children." +.It KTRFAC_PSIG Ta "Trace posted signals." +.It KTRFAC_CSW Ta "Trace context switch points." +.It KTRFAC_USER Ta "Trace application-specific events." +.It KTRFAC_STRUCT Ta "Trace certain data structures." +.It KTRFAC_SYSCTL Ta "Trace sysctls." +.It KTRFAC_PROCCTOR Ta "Trace process construction." +.It KTRFAC_PROCDTOR Ta "Trace process destruction." +.It KTRFAC_CAPFAIL Ta "Trace capability failures." +.It KTRFAC_INHERIT Ta "Inherit tracing to future children." .El .Pp Each tracing event outputs a record composed of a generic header Modified: head/lib/libutil/login.conf.5 ============================================================================== --- head/lib/libutil/login.conf.5 Thu Mar 29 15:47:29 2012 (r233664) +++ head/lib/libutil/login.conf.5 Thu Mar 29 16:02:40 2012 (r233665) @@ -224,7 +224,7 @@ directory of the user. See .Xr ftpd 8 for details. -.It "label string Default MAC policy; see" +.It "label string Default MAC policy; see" .Xr maclabel 7 . .It "lang string Set $LANG environment variable to the specified value. .It "manpath path Default search path for manpages. Modified: head/usr.bin/rctl/rctl.8 ============================================================================== --- head/usr.bin/rctl/rctl.8 Thu Mar 29 15:47:29 2012 (r233664) +++ head/usr.bin/rctl/rctl.8 Thu Mar 29 16:02:40 2012 (r233665) @@ -121,33 +121,33 @@ A filter that matches all defined rules "::maxproc". .Sh RESOURCES .Bl -column -offset 3n "pseudoterminals" -.It "cputime CPU time, in seconds" -.It "datasize data size, in bytes" -.It "stacksize stack size, in bytes" -.It "coredumpsize core dump size, in bytes" -.It "memoryuse resident set size, in bytes" -.It "memorylocked locked memory, in bytes" -.It "maxproc number of processes" -.It "openfiles file descriptor table size" -.It "vmemoryuse address space limit, in bytes" -.It "pseudoterminals number of PTYs" -.It "swapuse swap usage, in bytes" -.It "nthr number of threads" -.It "msgqqueued number of queued SysV messages" -.It "msgqsize SysV message queue size, in bytes" -.It "nmsgq number of SysV message queues" -.It "nsem number of SysV semaphores" -.It "nsemop number of SysV semaphores modified in a single semop(2) call" -.It "nshm number of SysV shared memory segments" -.It "shmsize SysV shared memory size, in bytes" -.It "wallclock wallclock time, in seconds" +.It cputime Ta "CPU time, in seconds" +.It datasize Ta "data size, in bytes" +.It stacksize Ta "stack size, in bytes" +.It coredumpsize Ta "core dump size, in bytes" +.It memoryuse Ta "resident set size, in bytes" +.It memorylocked Ta "locked memory, in bytes" +.It maxproc Ta "number of processes" +.It openfiles Ta "file descriptor table size" +.It vmemoryuse Ta "address space limit, in bytes" +.It pseudoterminals Ta "number of PTYs" +.It swapuse Ta "swap usage, in bytes" +.It nthr Ta "number of threads" +.It msgqqueued Ta "number of queued SysV messages" +.It msgqsize Ta "SysV message queue size, in bytes" +.It nmsgq Ta "number of SysV message queues" +.It nsem Ta "number of SysV semaphores" +.It nsemop Ta "number of SysV semaphores modified in a single semop(2) call" +.It nshm Ta "number of SysV shared memory segments" +.It shmsize Ta "SysV shared memory size, in bytes" +.It wallclock Ta "wallclock time, in seconds" .El .Pp .Sh ACTIONS .Bl -column -offset 3n "pseudoterminals" -.It "deny deny the allocation; not supported for cpu and wallclock" -.It "log log a warning to the console" -.It "devctl send notification to" +.It deny Ta "deny the allocation; not supported for cpu and wallclock" +.It log Ta "log a warning to the console" +.It devctl Ta "send notification to" .Xr devd 8 .It "sig* e.g. sigterm; send a signal to the offending process" .El