From owner-man-jp@jp.FreeBSD.org Mon Aug 18 07:39:13 2003
Received: (from daemon@localhost)
	by castle.jp.FreeBSD.org (8.11.6p2+3.4W/8.11.3) id h7HMdDb75500;
	Mon, 18 Aug 2003 07:39:13 +0900 (JST)
	(envelope-from owner-man-jp@jp.FreeBSD.org)
Received: from rwcrmhc12.comcast.net (rwcrmhc12.comcast.net [216.148.227.85])
	by castle.jp.FreeBSD.org (8.11.6p2+3.4W/8.11.3) with ESMTP/inet id h7HMdC075419
	for <man-jp@jp.freebsd.org>; Mon, 18 Aug 2003 07:39:12 +0900 (JST)
	(envelope-from horikawa@jp.freebsd.org)
Received: from localhost (12-252-35-167.client.attbi.com[12.252.35.167](untrusted sender))
          by comcast.net (rwcrmhc12) with SMTP
          id <2003081722390501400618t1e>; Sun, 17 Aug 2003 22:39:05 +0000
Message-Id: <20030817.163741.95062063.horikawa@attbi.com>
To: man-jp@jp.FreeBSD.org
From: Kazuo Horikawa <horikawa@jp.FreeBSD.org>
X-Mailer: Mew version 3.2 on Emacs 21.3 / Mule 5.0 (SAKAKI)
Mime-Version: 1.0
Content-Type: Text/Plain; charset=iso-2022-jp
Content-Transfer-Encoding: 7bit
Reply-To: man-jp@jp.FreeBSD.org
Precedence: list
Date: Sun, 17 Aug 2003 16:37:41 -0600
X-Sequence: man-jp 4696
Subject: [man-jp 4696] manpage updates to 5.1-CURRENT-20030817-JPSNAP
Sender: owner-man-jp@jp.FreeBSD.org
X-Originator: horikawa@jp.FreeBSD.org
X-Distribute: distribute version 2.1 (Alpha) patchlevel 24e+030814

$BKY@n$G$9!#(B

doc/ja_JP.eucJP/man $B$N99?7$r(B 5.1-CURRENT-20030817-JPSNAP $B$KBP$7$F(B
$B<B;\$7!"(Bman2, man9 $B0J30$O40N;$7$^$7$?!#(B

man2, man9 $B$K$D$$$F$O!":FEY!"CSFb$5$s$K$*4j$$$7$?$$$G$9!#(B
   
$B:9J,$NBg$-$5$O<!$NDL$j$G$9!#(B

                    diff -u $B$N9T?t(B
 o diff2             246 $B9T(B
 o diff9              57 $B9T(B

5.1-CURRENT-20030711-JPSNAP $B$H(B 5.1-CURRENT-20030817-JPSNAP $B$N:9J,$O(B
http://home.jp.freebsd.org/~horikawa/5.1-CURRENT-20030817-JPSNAP/diff[29] 
$B$KCV$-$^$7$?(B ($BC;$+$$$N$G2<5-$K$b0zMQ$7$F$*$-$^$9(B)$B!#Cm0UE@$O<!$NDL$j$G$9!#(B
 (1) $B99?7ITMW$N$b$N(B ($B%O!<%I%j%s%/$K$h$jJ#?t%(%s%H%j$K$J$C$F$$$k$b$N(B)
     $B$O:o=|$7$^$7$?!#(B($B$7$F$"$k$D$b$j$G$9(B)
 (2) $BL$Lu$N$b$N$O99?7$7$J$/$F9=$$$^$;$s!#(B
     ($BK]Lu$7$F$$$?$@$$$F$b9=$$$^$;$s(B)
 (3) $FreeBSD: ... Exp$ $B$O!"(B%FreeBSD: ... Exp% $B$KJQ99$7$F$"$j$^$9!#(B
     $BLuJ899?7$N:]$K$3$N:9J,$r$=$N$^$^E=$jIU$1$F$/$@$5$$!#(B
 (4) "Only in" $B$G3+;O$9$k9T$K$D$$$F$O!"2DG=$G$"$l$P(B Makefile $B$X$N(B
     $B:9J,$r:n@.$7$F$/$@$5$$!#(B

$BF|K\8l%^%K%e%"%k$O!"(B
http://www.freebsd.org/cgi/cvsweb.cgi/doc/ja_JP.eucJP/man/
$B$d!"(Bcvsup $B$J$I$9$k$3$H$GF@$i$l$^$9!#(B
--
$BKY@nOBM:(B

diff -ur ../5.1-CURRENT-20030711-JPSNAP/man2/connect.2 man2/connect.2
--- ../5.1-CURRENT-20030711-JPSNAP/man2/connect.2	Fri Jul 11 08:28:59 2003
+++ man2/connect.2	Sun Aug 17 08:45:06 2003
@@ -30,7 +30,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\"     @(#)connect.2	8.1 (Berkeley) 6/4/93
-.\" %FreeBSD: src/lib/libc/sys/connect.2,v 1.23 2003/04/01 20:25:46 ceri Exp %
+.\" %FreeBSD: src/lib/libc/sys/connect.2,v 1.25 2003/08/06 14:21:06 yar Exp %
 .\"
 .Dd June 4, 1993
 .Dt CONNECT 2
@@ -117,10 +117,19 @@
 It is possible to
 .Xr select 2
 for completion by selecting the socket for writing.
+.It Bq Er EINTR
+The connection attempt was interrupted by the delivery of a signal.
+The connection will be established in the background,
+as in the case of
+.Er EINPROGRESS .
 .It Bq Er EALREADY
-The socket is non-blocking
-and a previous connection attempt
-has not yet been completed.
+A previous connection attempt has not yet been completed.
+.It Bq Er EACCES
+An attempt is made to connect to a broadcast address (obtained through the
+.Dv INADDR_BROADCAST 
+constant or the
+.Dv INADDR_NONE
+return value) through a socket that does not provide broadcast functionality.
 .El
 .Pp
 The following errors are specific to connecting names in the UNIX domain.
diff -ur ../5.1-CURRENT-20030711-JPSNAP/man2/i386_get_ldt.2 man2/i386_get_ldt.2
--- ../5.1-CURRENT-20030711-JPSNAP/man2/i386_get_ldt.2	Fri Jul 11 08:28:57 2003
+++ man2/i386_get_ldt.2	Sun Aug 17 08:45:05 2003
@@ -30,7 +30,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\"     from: @(#)fork.2	6.5 (Berkeley) 3/10/91
-.\" %FreeBSD: src/lib/libc/i386/sys/i386_get_ldt.2,v 1.17 2003/06/09 11:46:22 jhb Exp %
+.\" %FreeBSD: src/lib/libc/i386/sys/i386_get_ldt.2,v 1.19 2003/08/04 19:11:56 julian Exp %
 .\"
 .Dd September 20, 1993
 .Dt I386_GET_LDT 2
@@ -73,6 +73,39 @@
 .Aq Pa i386/segments.h .
 These structures are defined by the architecture
 as disjoint bit-fields, so care must be taken in constructing them.
+.Pp
+If 
+.Fa start_sel
+is 
+.Em LDT_AUTO_ALLOC ,
+.Fa num_sels
+is 1 and the descriptor pointed to by 
+.Fa descs
+is legal, then
+.Fn i386_set_ldt
+will allocate a descriptor and return its 
+selector number.
+.Pp
+If 
+.Fa num_descs
+is 1,
+.Fa start_sels
+is valid, and 
+.Fa descs
+is NULL, then 
+.Fn i386_set_ldt
+will free that descriptor
+(making it available to be reallocated again later).
+.Pp
+If 
+.Fa num_descs    
+is 0, 
+.Fa start_sels
+is 0 and
+.Fa descs
+is NULL then, as a special case,
+.Fn i386_set_ldt
+will free all descriptors.
 .Sh RETURN VALUES
 Upon successful completion,
 .Fn i386_get_ldt
@@ -81,6 +114,8 @@
 .Fn i386_set_ldt
 system call
 returns the first selector set.
+In the case when a descriptor is allocated by the kernel, its number will
+be returned.
 Otherwise, a value of -1 is returned and the global
 variable
 .Va errno
diff -ur ../5.1-CURRENT-20030711-JPSNAP/man2/ioctl.2 man2/ioctl.2
--- ../5.1-CURRENT-20030711-JPSNAP/man2/ioctl.2	Fri Jul 11 08:29:01 2003
+++ man2/ioctl.2	Sun Aug 17 08:45:06 2003
@@ -31,7 +31,7 @@
 .\"
 .\"     @(#)ioctl.2	8.2 (Berkeley) 12/11/93
 .\"
-.\" %FreeBSD: src/lib/libc/sys/ioctl.2,v 1.21 2002/12/19 09:40:25 ru Exp %
+.\" %FreeBSD: src/lib/libc/sys/ioctl.2,v 1.23 2003/07/15 12:23:12 ceri Exp %
 .\"
 .Dd December 11, 1993
 .Dt IOCTL 2
diff -ur ../5.1-CURRENT-20030711-JPSNAP/man2/kqueue.2 man2/kqueue.2
--- ../5.1-CURRENT-20030711-JPSNAP/man2/kqueue.2	Fri Jul 11 08:29:01 2003
+++ man2/kqueue.2	Sun Aug 17 08:45:07 2003
@@ -22,7 +22,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\" %FreeBSD: src/lib/libc/sys/kqueue.2,v 1.32 2002/12/19 09:40:25 ru Exp %
+.\" %FreeBSD: src/lib/libc/sys/kqueue.2,v 1.33 2003/08/05 07:12:49 jmg Exp %
 .\"
 .Dd April 14, 2000
 .Dt KQUEUE 2
@@ -265,6 +265,13 @@
 This may be cleared by passing in EV_CLEAR, at which point the
 filter will resume waiting for data to become available before
 returning.
+.It "BPF devices"
+Returns when the BPF buffer is full, the BPF timeout has expired, or
+when the BPF has
+.Dq immediate mode
+enabled and there is any data to read;
+.Va data
+contains the number of bytes available.
 .El
 .It EVFILT_WRITE
 Takes a descriptor as the identifier, and returns whenever
@@ -274,7 +281,7 @@
 will contain the amount of space remaining in the write buffer.
 The filter will set EV_EOF when the reader disconnects, and for
 the fifo case, this may be cleared by use of EV_CLEAR.
-Note that this filter is not supported for vnodes.
+Note that this filter is not supported for vnodes or BPF devices.
 .Pp
 For sockets, the low water mark and socket error handling is
 identical to the EVFILT_READ case.
diff -ur ../5.1-CURRENT-20030711-JPSNAP/man2/madvise.2 man2/madvise.2
--- ../5.1-CURRENT-20030711-JPSNAP/man2/madvise.2	Fri Jul 11 08:29:02 2003
+++ man2/madvise.2	Sun Aug 17 08:45:07 2003
@@ -30,13 +30,13 @@
 .\" SUCH DAMAGE.
 .\"
 .\"	@(#)madvise.2	8.1 (Berkeley) 6/9/93
-.\" %FreeBSD: src/lib/libc/sys/madvise.2,v 1.29 2003/03/31 21:09:56 wes Exp %
+.\" %FreeBSD: src/lib/libc/sys/madvise.2,v 1.30 2003/08/09 03:23:24 bms Exp %
 .\"
 .Dd July 19, 1996
 .Dt MADVISE 2
 .Os
 .Sh NAME
-.Nm madvise
+.Nm madvise , posix_madvise
 .Nd give advice about use of memory
 .Sh LIBRARY
 .Lb libc
@@ -44,12 +44,17 @@
 .In sys/mman.h
 .Ft int
 .Fn madvise "void *addr" "size_t len" "int behav"
+.Ft int
+.Fn posix_madvise "void *addr" "size_t len" "int behav"
 .Sh DESCRIPTION
 The
 .Fn madvise
 system call
 allows a process that has knowledge of its memory behavior
 to describe it to the system.
+The
+.Fn posix_madvise
+interface is identical and is provided for standards conformance.
 .Pp
 The known behaviors are:
 .Bl -tag -width MADV_SEQUENTIAL
@@ -124,6 +129,15 @@
 This should be used judiciously in processes that must remain running
 for the system to properly function.
 .El
+.Pp
+Portable programs that call the
+.Fn posix_madvise
+interface should use the aliases
+.Dv POSIX_MADV_NORMAL , POSIX_MADV_SEQUENTIAL ,
+.Dv POSIX_MADV_RANDOM , POSIX_MADV_WILLNEED ,
+and
+.Dv POSIX_MADV_DONTNEED
+rather than the flags described above.
 .Sh RETURN VALUES
 .Rv -std madvise
 .Sh ERRORS
@@ -132,6 +146,10 @@
 system call will fail if:
 .Bl -tag -width Er
 .It Bq Er EINVAL
+The
+.Fa behav
+argument is not valid.
+.It Bq Er ENOMEM
 The virtual address range specified by the
 .Fa addr
 and
@@ -146,6 +164,11 @@
 .Xr mprotect 2 ,
 .Xr msync 2 ,
 .Xr munmap 2
+.Sh STANDARDS
+The
+.Fn posix_madvise
+interface conforms to
+.St -p1003.1-2001 .
 .Sh HISTORY
 The
 .Fn madvise
Only in man2: mlockall.2
Only in man2: munlockall.2
Only in man2: posix_madvise.2
diff -ur ../5.1-CURRENT-20030711-JPSNAP/man2/ptrace.2 man2/ptrace.2
--- ../5.1-CURRENT-20030711-JPSNAP/man2/ptrace.2	Fri Jul 11 08:29:03 2003
+++ man2/ptrace.2	Sun Aug 17 08:45:07 2003
@@ -1,8 +1,8 @@
-.\" %FreeBSD: src/lib/libc/sys/ptrace.2,v 1.31 2002/12/19 09:40:25 ru Exp %
+.\" %FreeBSD: src/lib/libc/sys/ptrace.2,v 1.32 2003/08/11 13:13:46 iedowse Exp %
 .\"	$NetBSD: ptrace.2,v 1.2 1995/02/27 12:35:37 cgd Exp $
 .\"
 .\" This file is in the public domain.
-.Dd January 20, 1996
+.Dd August 11, 2003
 .Dt PTRACE 2
 .Os
 .Sh NAME
@@ -162,7 +162,8 @@
 The
 .Fa data
 argument
-is not used.
+provides a signal number to be delivered to the traced process as it
+resumes execution, or 0 if no signal is to be sent.
 .It Dv PT_KILL
 The traced process terminates, as if
 .Dv PT_CONTINUE
Only in man9: uma_zone_set_max.9
diff -ur ../5.1-CURRENT-20030711-JPSNAP/man9/zone.9 man9/zone.9
--- ../5.1-CURRENT-20030711-JPSNAP/man9/zone.9	Fri Jul 11 08:38:57 2003
+++ man9/zone.9	Sun Aug 17 08:50:41 2003
@@ -23,16 +23,17 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\" %FreeBSD: src/share/man/man9/zone.9,v 1.24 2003/05/31 14:20:30 hmp Exp %
+.\" %FreeBSD: src/share/man/man9/zone.9,v 1.25 2003/07/21 14:20:58 harti Exp %
 .\"
-.Dd May 18, 2002
+.Dd July 21, 2003
 .Dt ZONE 9
 .Os
 .Sh NAME
 .Nm uma_zcreate ,
 .Nm uma_zalloc ,
 .Nm uma_zfree ,
-.Nm uma_zdestroy
+.Nm uma_zdestroy ,
+.Nm uma_zone_set_max
 .Nd zone allocator
 .Sh SYNOPSIS
 .In sys/param.h
@@ -50,6 +51,8 @@
 .Fn uma_zfree "uma_zone_t zone" "void *item"
 .Ft void
 .Fn uma_zdestroy "uma_zone_t zone"
+.Ft void
+.Fn uma_zone_set_max "uma_zone_t zone" "int nitems"
 .Sh DESCRIPTION
 The zone allocator provides an efficient interface for managing
 dynamically-sized collections of items of similar size.
@@ -167,6 +170,22 @@
 must have been freed with
 .Fn uma_zfree
 before.
+.Pp
+The purpose of
+.Fn uma_zone_set_max
+is to limit the maximum amount of memory that the system can dedicated
+toward the zone specified by the
+.Fa zone
+argument.
+The
+.Fa nitems
+argument gives the upper limit of items in the zone.
+This limits the total number of items in the zone which includes:
+allocated items, free items and free items in the per-cpu caches.
+On systems with more than one CPU it may not be possible to allocate
+the specified number of items even when there is no shortage of memory,
+because all of the remaining free items may be in the caches of the
+other CPUs when the limit is hit.
 .Sh RETURN VALUES
 The
 .Fn uma_zalloc
