From owner-p4-projects@FreeBSD.ORG Sat May 24 12:58:12 2003 Return-Path: Delivered-To: p4-projects@freebsd.org Received: by hub.freebsd.org (Postfix, from userid 32767) id 5EB8E37B404; Sat, 24 May 2003 12:58:12 -0700 (PDT) Delivered-To: perforce@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 23BAF37B401 for ; Sat, 24 May 2003 12:58:12 -0700 (PDT) Received: from repoman.freebsd.org (repoman.freebsd.org [216.136.204.115]) by mx1.FreeBSD.org (Postfix) with ESMTP id 7846343F75 for ; Sat, 24 May 2003 12:58:11 -0700 (PDT) (envelope-from peter@freebsd.org) Received: from repoman.freebsd.org (localhost [127.0.0.1]) by repoman.freebsd.org (8.12.6/8.12.6) with ESMTP id h4OJwB0U000737 for ; Sat, 24 May 2003 12:58:11 -0700 (PDT) (envelope-from peter@freebsd.org) Received: (from perforce@localhost) by repoman.freebsd.org (8.12.6/8.12.6/Submit) id h4OJwAOh000733 for perforce@freebsd.org; Sat, 24 May 2003 12:58:10 -0700 (PDT) Date: Sat, 24 May 2003 12:58:10 -0700 (PDT) Message-Id: <200305241958.h4OJwAOh000733@repoman.freebsd.org> X-Authentication-Warning: repoman.freebsd.org: perforce set sender to peter@freebsd.org using -f From: Peter Wemm To: Perforce Change Reviews Subject: PERFORCE change 31812 for review X-BeenThere: p4-projects@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: p4 projects tree changes List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 24 May 2003 19:58:13 -0000 http://perforce.freebsd.org/chv.cgi?CH=31812 Change 31812 by peter@peter_overcee on 2003/05/24 12:57:51 IFC @31811 (damn, seems like I'm getting RSI from typing 'p4 integ') Affected files ... .. //depot/projects/hammer/gnu/lib/libstdc++/Makefile#9 integrate .. //depot/projects/hammer/lib/libc/posix1e/mac.conf.5#3 integrate .. //depot/projects/hammer/lib/libc_r/man/pthread_getconcurrency.3#2 integrate .. //depot/projects/hammer/lib/libpam/modules/pam_chroot/pam_chroot.8#3 integrate .. //depot/projects/hammer/lib/libpthread/man/pthread_attr_get_np.3#2 integrate .. //depot/projects/hammer/sbin/bsdlabel/bsdlabel.8#3 integrate .. //depot/projects/hammer/sbin/mksnap_ffs/mksnap_ffs.8#2 integrate Differences ... ==== //depot/projects/hammer/gnu/lib/libstdc++/Makefile#9 (text+ko) ==== @@ -1,4 +1,4 @@ -# $FreeBSD: src/gnu/lib/libstdc++/Makefile,v 1.42 2003/02/10 06:09:55 kan Exp $ +# $FreeBSD: src/gnu/lib/libstdc++/Makefile,v 1.43 2003/05/24 19:38:18 peter Exp $ GCCDIR= ${.CURDIR}/../../../contrib/gcc SRCDIR= ${.CURDIR}/../../../contrib/libstdc++ ==== //depot/projects/hammer/lib/libc/posix1e/mac.conf.5#3 (text+ko) ==== @@ -27,23 +27,22 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" $FreeBSD: src/lib/libc/posix1e/mac.conf.5,v 1.3 2003/04/26 03:32:18 rwatson Exp $ +.\" $FreeBSD: src/lib/libc/posix1e/mac.conf.5,v 1.4 2003/05/24 19:50:43 ru Exp $ .\" .Dd April 19, 2003 .Dt MAC.CONF 5 .Os .Sh NAME .Nm mac.conf -.Nd Format of the MAC library configuration file +.Nd format of the MAC library configuration file .Sh DESCRIPTION The .Nm file configures the default label elements to be used by policy-agnostic applications that operate on MAC labels. -.Nm -contains a series of default label sets specified by object class, +A file contains a series of default label sets specified by object class, in addition to blank lines and comments preceded by a -.Dv # +.Ql # symbol. .Pp Each declaration consists of a single line with two fields separated @@ -53,7 +52,7 @@ library calls prior to an application invocation of a function from .Xr mac_get 3 . Label element names may optionally begin with a -.Dv ? +.Ql \&? symbol to indicate that a failure to retrieve the label element for an object should be silently ignored, and improves usability if the set of MAC policies may change over time. @@ -86,9 +85,9 @@ MAC library configuration file. .El .Sh SEE ALSO +.Xr mac 3 , .Xr mac_get 3 , .Xr mac_prepare 3 , -.Xr mac 3 , .Xr mac 4 , .Xr mac 9 .Sh HISTORY ==== //depot/projects/hammer/lib/libc_r/man/pthread_getconcurrency.3#2 (text+ko) ==== @@ -22,12 +22,12 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" $FreeBSD: src/lib/libc_r/man/pthread_getconcurrency.3,v 1.1 2003/04/20 01:53:12 jdp Exp $ +.\" $FreeBSD: src/lib/libc_r/man/pthread_getconcurrency.3,v 1.2 2003/05/24 19:50:43 ru Exp $ .Dd April 11, 2003 .Dt PTHREAD_GETCONCURRENCY 3 .Os .Sh NAME -.Nm pthread_getconcurrency, +.Nm pthread_getconcurrency , .Nm pthread_setconcurrency .Nd get or set level of concurrency .Sh LIBRARY @@ -35,7 +35,7 @@ .Sh SYNOPSIS .In pthread.h .Ft int -.Fn pthread_getconcurrency "void" +.Fn pthread_getconcurrency void .Ft int .Fn pthread_setconcurrency "int new_level" .Sh DESCRIPTION @@ -43,29 +43,37 @@ .Fn pthread_getconcurrency function allows an application to inform the threads implementation of its desired concurrency level, -.Va new_level . +.Fa new_level . The actual level of concurrency provided by the implementation -as a result of this function call is unspecified. If new_level is -zero, it causes the implementation to maintain the concurrency +as a result of this function call is unspecified. +If +.Fa new_level +is zero, it causes the implementation to maintain the concurrency level at its discretion as if .Fn pthread_setconcurrency -was never called. The +was never called. +The .Fn pthread_getconcurrency function returns the value set by a previous call to the .Fn pthread_setconcurrency -function. If the +function. +If the .Fn pthread_setconcurrency function was not previously called, this function returns zero to indicate that the implementation is maintaining the concurrency -level. When an application calls -.Fn pthread_setconcurrency +level. +When an application calls +.Fn pthread_setconcurrency , it is informing the implementation of its desired concurrency -level. The implementation uses this as a hint, not a requirement. +level. +The implementation uses this as a hint, not a requirement. .Sh RETURN VALUES If successful, the .Fn pthread_setconcurrency -function returns zero. Otherwise, an error number is returned -to indicate the error. The +function returns zero. +Otherwise, an error number is returned +to indicate the error. +The .Fn pthread_getconcurrency function always returns the concurrency level set by a previous call to @@ -82,21 +90,21 @@ .Bl -tag -width Er .It Bq Er EINVAL The value specified by -.Va new_level +.Fa new_level is negative. .It Bq Er EAGAIN -The value specific by -.Va new_level +The value specified by +.Fa new_level would cause a system resource to be exceeded. .El .Sh APPLICATION USAGE Use of these functions changes the state of the underlying -concurrency upon which the application depends. Library -developers are advised to not use the +concurrency upon which the application depends. +Library developers are advised to not use the .Fn pthread_getconcurrency and .Fn pthread_setconcurrency -functions since their use may conflict with an applications +functions since their use may conflict with an application's use of these functions. .Sh STANDARDS The @@ -104,4 +112,4 @@ and .Fn pthread_setconcurrency functions conform to -.St -susv2 +.St -susv2 . ==== //depot/projects/hammer/lib/libpam/modules/pam_chroot/pam_chroot.8#3 (text+ko) ==== @@ -3,7 +3,7 @@ .\" .\" Portions of this software were developed for the FreeBSD Project by .\" ThinkSec AS and NAI Labs, the Security Research Division of Network -.\" Associates, Inc. under DARPA/SPAWAR contract N66001-01-C-8035 +.\" Associates, Inc. under DARPA/SPAWAR contract N66001-01-C-8035 .\" ("CBOSS"), as part of the DARPA CHATS research program. .\" .\" Redistribution and use in source and binary forms, with or without @@ -30,7 +30,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" $FreeBSD: src/lib/libpam/modules/pam_chroot/pam_chroot.8,v 1.2 2003/04/08 16:52:18 des Exp $ +.\" $FreeBSD: src/lib/libpam/modules/pam_chroot/pam_chroot.8,v 1.3 2003/05/24 19:50:43 ru Exp $ .\" .Dd February 10, 2003 .Dt PAM_CHROOT 8 @@ -48,11 +48,11 @@ The chroot service module for PAM chroots users into either a predetermined directory or one derived from their home directory. If a user's home directory as specified in the -.Dv passwd +.Vt passwd structure returned by .Xr getpwnam 3 contains the string -.Dq /./ , +.Dq Li /./ , the portion of the directory name to the left of that string is used as the chroot directory, and the portion to the right will be the current working directory inside the chroot tree. @@ -63,7 +63,7 @@ options (see below) are used. .Bl -tag -width ".Cm also_root" .It Cm also_root -Do not hold user id 0 exempt from the chroot requirement. +Do not hold user ID 0 exempt from the chroot requirement. .It Cm always Report a failure if a chroot directory could not be derived from the user's home directory, and the ==== //depot/projects/hammer/lib/libpthread/man/pthread_attr_get_np.3#2 (text+ko) ==== @@ -22,7 +22,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" $FreeBSD: src/lib/libpthread/man/pthread_attr_get_np.3,v 1.1 2003/03/03 22:40:20 phantom Exp $ +.\" $FreeBSD: src/lib/libpthread/man/pthread_attr_get_np.3,v 1.2 2003/05/24 19:50:43 ru Exp $ .\" .Dd January 31, 2003 .Dt PTHREAD_ATTR_GET_NP 3 @@ -87,8 +87,9 @@ function returns 0. Otherwise, an error number is returned to indicate the error. .Sh ERRORS +The .Fn pthread_attr_get_np -will fail if: +function will fail if: .Bl -tag -width Er .It Bq Er EINVAL Invalid value for one of given parameters. ==== //depot/projects/hammer/sbin/bsdlabel/bsdlabel.8#3 (text+ko) ==== @@ -33,7 +33,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)disklabel.8 8.2 (Berkeley) 4/19/94 -.\" $FreeBSD: src/sbin/bsdlabel/bsdlabel.8,v 1.53 2003/05/03 09:58:20 phk Exp $ +.\" $FreeBSD: src/sbin/bsdlabel/bsdlabel.8,v 1.54 2003/05/24 19:53:08 ru Exp $ .\" .Dd March 15, 2003 .Dt BSDLABEL 8 @@ -47,29 +47,30 @@ .Ar disk .Nm .Fl w -.Op Fl nA +.Op Fl \&An .Op Fl B Op Fl b Ar boot .Op Fl m Ar machine -.Ar disk +.Ar disk .Op Ar type .Nm .Fl e -.Op Fl nA +.Op Fl \&An .Op Fl B Op Fl b Ar boot .Op Fl m Ar machine .Ar disk .Nm .Fl R -.Op Fl nA +.Op Fl \&An .Op Fl B Op Fl b Ar boot .Op Fl m Ar machine .Ar disk protofile -.Pp .Sh DESCRIPTION The .Nm utility -installs, examines or modifies the BSD label on a disk partition. +installs, examines or modifies the +.Bx +label on a disk partition. In addition, .Nm can install bootstrap code. @@ -81,10 +82,12 @@ the .Nm utility will automatically prepend it. -.Ss General options -The +.Ss General Options +The .Fl A -option enables processing of the historical parts of the BSD label. +option enables processing of the historical parts of the +.Bx +label. If the option is not given, suitable values are set for these fields. .Pp The @@ -120,31 +123,31 @@ .Pp .Nm .Fl w -.Op Fl nA +.Op Fl \&An .Op Fl m Ar machine .Ar disk .Op Ar type .Pp -If the drive type if specified the entry of that name in the +If the drive type is specified, the entry of that name in the .Xr disktab 5 -file is used, otherwise a default layout is used. +file is used; otherwise a default layout is used. .Ss Editing an Existing Disk Label To edit an existing disk label, use the form .Pp .Nm .Fl e -.Op Fl nA +.Op Fl \&An .Op Fl m Ar machine .Ar disk .Pp -This command opens the disklabel in the default editor and when the editor -exits the label is validated and if OK written to disk. +This command opens the disk label in the default editor, and when the editor +exits, the label is validated and if OK written to disk. .Ss Restoring a Disk Label From a File To restore a disk label from a file, use the form .Pp .Nm .Fl R -.Op Fl nA +.Op Fl \&An .Op Fl m Ar machine .Ar disk protofile .Pp @@ -360,7 +363,7 @@ .Dl "bsdlabel -w /dev/da0s1" .Pp Create a label for -.Pa da0s1 +.Pa da0s1 . .Pp .Dl "bsdlabel -e da0s1" .Pp @@ -460,10 +463,10 @@ g: * * 4.2BSD .Ed .Sh SEE ALSO +.Xr ccd 4 , .Xr geom 4 , -.Xr ccd 4 , .Xr md 4 , -.Xr disklabel 5 , +.\" Xr bsdlabel 5 , .Xr disktab 5 , .Xr boot0cfg 8 , .Xr fdisk 8 ==== //depot/projects/hammer/sbin/mksnap_ffs/mksnap_ffs.8#2 (text+ko) ==== @@ -32,14 +32,14 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" $FreeBSD: src/sbin/mksnap_ffs/mksnap_ffs.8,v 1.1 2003/03/02 01:50:33 mckusick Exp $ +.\" $FreeBSD: src/sbin/mksnap_ffs/mksnap_ffs.8,v 1.2 2003/05/24 19:53:08 ru Exp $ .\" .Dd January 19, 2003 .Dt MKSNAP_FFS 8 .Os .Sh NAME .Nm mksnap_ffs -.Nd take a filesystem snapshot +.Nd take a file system snapshot .Sh SYNOPSIS .Nm .Ar mountpoint @@ -47,29 +47,29 @@ .Sh DESCRIPTION The .Nm -command creates a snapshot named +utility creates a snapshot named .Ar snapshot_name -on the filesystem mounted at +on the file system mounted at .Ar mountpoint . The .Ar snapshot_name -argument must be contained within the filesystem mounted at +argument must be contained within the file system mounted at .Ar mountpoint . .Pp The group ownership of the file is set to -.Dq operator ; +.Dq Li operator ; the owner of the file remains -.Dq root . +.Dq Li root . The mode of the snapshot is set to be readable by the owner or members of the -.Dq operator +.Dq Li operator group. .Sh SEE ALSO .Xr chmod 2 , .Xr chown 8 , .Xr mount_ffs 8 .Sh HISTORY -A +The .Nm -command first appeared in +utility first appeared in .Fx 5.0 .