From owner-man-jp@jp.FreeBSD.org Mon Oct  6 06:37:29 2003
Received: (from daemon@localhost)
	by castle.jp.FreeBSD.org (8.11.6p2+3.4W/8.11.3) id h95LbTo81203;
	Mon, 6 Oct 2003 06:37:29 +0900 (JST)
	(envelope-from owner-man-jp@jp.FreeBSD.org)
Received: from sccrmhc11.comcast.net (sccrmhc11.comcast.net [204.127.202.55])
	by castle.jp.FreeBSD.org (8.11.6p2+3.4W/8.11.3) with ESMTP/inet id h95LbRJ81177
	for <man-jp@jp.freebsd.org>; Mon, 6 Oct 2003 06:37:28 +0900 (JST)
	(envelope-from horikawa@jp.freebsd.org)
Received: from localhost (12-252-35-167.client.attbi.com[12.252.35.167])
          by comcast.net (sccrmhc11) with SMTP
          id <20031005213720011006pvu2e>; Sun, 5 Oct 2003 21:37:20 +0000
Message-Id: <20031005.153440.74755659.horikawa@attbi.com>
To: man-jp@jp.FreeBSD.org, a_ikeuchi@mic.mitsumi.co.jp
From: Kazuo Horikawa <horikawa@jp.FreeBSD.org>
In-Reply-To: <3F77E041.8070309@mic.mitsumi.co.jp>
References: <3F77DDB5.70803@mic.mitsumi.co.jp>
	<3F77E041.8070309@mic.mitsumi.co.jp>
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, 05 Oct 2003 15:34:40 -0600
X-Sequence: man-jp 4781
Subject: [man-jp 4781] Re: (man9) many new entries
Sender: owner-man-jp@jp.FreeBSD.org
X-Originator: horikawa@jp.FreeBSD.org
X-Distribute: distribute version 2.1 (Alpha) patchlevel 24e+030902

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

$B<!$N$h$&$KJQ99$7$?$$$H;W$$$^$9$,!"$I$&$G$7$g$&$+!)(B

[bus_child_present.9]
> -.Sh DESCRIPTION
> -The
> +.Sh $B2r@b(B
>  .Fn bus_child_present
> -function requests that the parent device driver of
> +$B4X?t$O!"?F%G%P%$%9$N%I%i%$%P$N(B
>  .Fa dev
> -check to see if the
> -hardware represented by
> +$B$,!"(B
>  .Fa dev
> -is still physically accessible at this time.
> +$B$G5-=R$5$l$k%O!<%I%&%'%"$,$=$N;~E@$G$$$^$@$KJ*M}E*$K%"%/%;%92DG=$G$"$k$+(B
> +$B$I$&$+$r%A%'%C%/$9$k$3$H$rMW5a$7$^$9!#(B

bus_child_present() $B4X?t$O!"(Bdev $B$N?F%G%P%$%9%I%i%$%P$KBP$7!"(B
dev $B$G5-=R$5$l$k%O!<%I%&%'%"$,8=;~E@$G$$$^$@$KJ*M}E*$K%"%/%;%92DG=$G(B
$B$"$k$+$I$&$+$r%A%'%C%/$9$k$3$H$rMW5a$7$^$9!#(B

> -While the notion of accessible varies from bus to bus, generally
> -hardware that is not acceessible cannot be accessed via the
> +$BMxMQ2DG=$N9M$($,%P%9$+$i%P%9$XJQ2=$9$k4V!"MxMQ$G$-$J$$%O!<%I%&%'%"$O!"(B
> +$B$=$&$G$J$$>l9g$K%G%P%$%9$X%"%/%;%9$9$k$?$a$K;HMQ$5$l$k(B
>  .Fn bus_space*
> -methods that would otherwise be used to access the device.
> +$B%a%=%C%I$r2p$7$FIaDL$O%"%/%;%9$9$k$3$H$,$G$-$^$;$s!#(B

$BMxMQ2DG=$N35G0$O%P%9Kh$K0[$J$j$^$9$,!"(B
$B0lHLE*$K$OMxMQ$G$-$J$$%O!<%I%&%'%"$H$O!"(B
$BMxMQ$G$-$k$H$-$K$O(B bus_space*() $B%a%=%C%I$r2p$7$F%"%/%;%9$G$-$k$b$N$,!"(B
bus_space*() $B%a%=%C%I$r2p$7$F%"%/%;%9$G$-$J$$$b$N$r;X$7$^$9!#(B


[bus_set_resource.9]
> @@ -45,51 +45,50 @@
>  .Fo bus_set_resource
>  .Fa "device_t dev" "int type" "int rid" "u_long start" "u_long count"
>  .Fc
> -.Sh DESCRIPTION
> -The
> +.Sh $B2r@b(B
>  .Fn bus_set_resource
> -function
> -sets the start address of the resource
> +$B4X?t$O%j%=!<%9$N3+;O%"%I%l%9!"(B
>  .Fa type , rid
> -pair to be
> +$B$N%Z%"$H$J$k$Y$-(B
>  .Fa count
> -long.
> +$BD9$5$r@_Dj$7$^$9!#(B

bus_set_resource() $B4X?t$O!"(B
type, rid $B%Z%"$G;XDj$5$l$k%j%=!<%9$N$&$A!"(B
$B;XDj$5$l$?3+;O%"%I%l%9$N$b$N$rD9$5(B count $B$K@_Dj$7$^$9!#(B


[condvar.9]
> +$B$O$=$N>uBVJQ?t$r@bL@$9$k(B null $B$G=*C<$5$l$?J8;zNs$X$N%]%$%s%?$G$9!#(B
                           $B%L%k(B

> +$B%9%l%C%I$,$"$k>uBV$G%&%'%$%H$9$k$H$-$K!"(B
>  .Fa mp
> +$B$O$=$N%9%l%C%I$,%V%m%C%/$5$l$kA0$KIT2DJ,$K3+J|$5$l!"$=$l$+$i(B
> +$B$=$N4X?t8F$S=P$7$,La$kA0$KIT2DJ,$K3MF@$5$l$^$9!#(B
                                    /\$B:F(B
($B86J8$G$O(B reacquire $B$J$N$G(B)

>  .Fn cv_timedwait
> -and
> +$B$*$h$S(B
>  .Fn cv_timedwait_sig
> -wait for at most
> +$B$O%V%m%C%/$,2r=|$5$l(B
> +.Er EWOULDBLOCK
> +$B$rJV$9A0$K$[$\(B
             $B:GD9(B
>  .Fa timo
>  /
>  .Dv HZ
> -seconds before being unblocked and returning
> +$BIC4V%&%'%$%H$7$^$9!#(B


>  .Fn cv_wait_sig
> -and
> +$B$*$h$S(B
>  .Fn cv_timedwait_sig
> -return prematurely with a value of
> +$B$O!"%7%0%J%k$,$H$i$($i$l$?>l9g$K$OB(:B$K(B
                                     $BL$40$N$^$^(B
>  .Er EINTR
> -or
> +$B$^$?$O(B
>  .Er ERESTART
> -if a signal is caught, or 0 if signaled via
> +$B$NCM$GLa$j$^$9!#(B
> +$B$^$?$O!"(B
>  .Fn cv_signal
> -or
> -.Fn cv_broadcast .
> +$B$^$?$O(B
> +.Fn cv_broadcast
> +$B$r2p$7$F%7%0%J%k$r$H$i$($?>l9g$K$O(B 0 $B$NCM$GLa$j$^$9!#(B
   $B$GDLCN$r<u$1$?>l9g$K$O(B 0 $B$NCM$GLa$j$^$9!#(B

signaled via cv_signal() or cv_broadcast() $B$G$O!"(BSIGXXX $B$N%7%0%J%k(B
(signal(3) $B$N%7%0%J%k(B) $B$r;H$&$o$1$G$O$J$$$N$G!"!VDLCN!W$H$$$C$?(B
$B$3$H$P$r;H$C$?J}$,$h$$$G$7$g$&!#(B


[groupmember.9]
>  .It Fa cred
> -The credentials to search for the group in.
> +$B%0%k!<%WFb$N8!:w$5$l$k$Y$->ZL@$G$9!#(B
   $B$3$l$i$N>ZL@$r8!:w$7$F!"%0%k!<%W$r$_$D$1$h$&$H$7$^$9!#(B


[pseudofs.9]
> +$B$3$l$O(B VFS $B%7%9%F%`$H$N%$%s%?%U%'!<%9!"%"%/%;%9@)8f$N6/@)!"%U%!%$%k?t$N(B
> +$BDI@W$N0];}!"$*$h$S%W%m%;%9FCM-$N%U%!%$%k$H%G%#%l%/%H%j$NJ#@=!"(B
> +$B$N$h$&$JA4$F$NJ#;($J%S%C%H$KG[N8$7$^$9!#(B
                       $B;vJA$NLLE]$r$_$^$9!#(B


[sema.9]
> +.Nd $B%+!<%M%k%+%&%s%H%;%^%U%)(B
               $B$N7W?t%;%^%U%)(B

> -.Sh DESCRIPTION
> -Counting semaphores provide a mechanism for synchronizing access to a pool of
> -resources.
> -Unlike mutexes, semaphores do not have the concept of an owner, so they can also
> -be useful in situations where one thread needs to acquire a resource, and
> -another thread needs to release it.
> -Each semaphore has an integer value associated with it.
> -Posting (incrementing) always succeeds, but waiting (decrementing) can only
> -successfully complete if the resulting value of the semaphore is greater than or
> -equal to zero.
> +.Sh $B2r@b(B
> +$B%;%^%U%)$r%+%&%s%H$9$k$3$H$O%j%=!<%9$N%W!<%k$X$N%"%/%;%9$NF14|$N$?$a$N(B
> +$B;EAH$_$rDs6!$7$^$9!#(B
$B7W?t%;%^%U%)$O!"!D(B

> +$B%;%^%U%)$O(B mutex $B$H>uBVJQ?t$h$jJ#;($JF14|$N;EAH$_$G!"(B
                                                    $B$G$9$N$G!"(B
> +$B$=$N$?$a8zN(E*$G$O$"$j$^$;$s!#(B


> +$B$3$3$G(B
>  .Fa sema
> +$B$O(B
> +.Vt "struct sema"
> +$B$N$?$a$N6u4V$X$N%]%$%s%?$G!"(B
           $BNN0h(B
(sx.9 $B$d(B condvar.9 $B$G$NI=8=$HF1$8$K$7$^$7$g$&(B)

> +$B$O$=$N%;%^%U%)$r@bL@$9$k(B null $B$G=*C<$5$l$?J8;zNs$X$N%]%$%s%?$G$9!#(B
                            $B%L%k(B


[sx.9]
> +$B$O$=$N6&M-(B/$BGSB>%m%C%/$r@bL@$9$k(B null $B$G=*C<$5$l$kJ8;zNs$X$N%]%$%s%?$G$9!#(B
                                   $B%L%k(B           $B$?(B


[taskqueue.9]
> -After calling
>  .Fn taskqueue_create ,
                       ^^$B%H%k(B
> -the
> +$B$N8F$S=P$7$N8e$G!"(B($B3d$j9~$_%O%s%I%i$NEPO?$J$I$N(B) $B$=$NB>$N=i4|2=$,(B
> +$B<B9T$5$l$k$3$H$r2DG=$K$9$k$?$a$K!"$3$N%^%/%m$X$N(B
>  .Va init
> -argument to the macro is executed as a C statement,
> -allowing any further initialisation to be performed
> -(such as registering an interrupt handler etc.)
> +$B0z?t$,(B C $B$N%9%F!<%H%a%s%H$H$7$F<B9T$5$l$^$9!#(B

malloc.9 $B$G$O!V(BGiant$B!W$O!V(BGiant$B!W$K$J$C$F$$$k$N$G!"!V(BGiant$B!W$K(B
$B$7$^$;$s$+!)(B
> -The swi taskqueues are run via a software interrupt mechanism.
> -The taskqueue_swi queue runs without the protection of the Giant kernel lock,
> -and the taskqueue_swi_giant queue runs with the protection of the Giant
> -kernel lock.
> -The thread taskqueue runs in a kernel thread context, and tasks run from
> -this thread do not run under the Giant kernel lock.
> -If the caller wants to run under Giant, he should explicitly acquire and
> -release Giant in his taskqueue handler routine.
> +swi $B%?%9%/%-%e!<$O%=%U%H%&%'%"3d$j9~$_$N;EAH$_$r2p$7$F<B9T$5$l$^$9!#(B
> +taskqueue_swi $B%-%e!<$O%8%c%$%"%s%H%+!<%M%k%m%C%/$NJ]8nL5$7$G<B9T$7!"(B
> +taskqueue_swi_giant $B%-%e!<$O%8%c%$%"%s%H%+!<%M%k%m%C%/$NJ]8nM-$j$G(B
> +$B<B9T$7$^$9!#(B
> +$B%9%l%C%I%?%9%/%-%e!<$O%+!<%M%k%9%l%C%I%3%s%F%-%9%H$G<B9T$5$l!"$3$N%9%l%C%I(B
> +$B$+$i<B9T$5$l$k%?%9%/$O!"%8%c%$%"%s%H%+!<%M%k%m%C%/2=$G<B9T$5$l$^$;$s!#(B
                                                     $B2<(B

> +$B8F$S=P$7B&$,%8%c%$%"%s%H%m%C%/2=$G<B9T$7$?$$>l9g$K$O!"8F$S=P$7B&$N(B
                                 $B2<(B

> +$B%?%9%/%-%e!<%O%s%I%i%k!<%A%s$NCf$G!"8F$S=P$7B&$,L@3N$K%8%c%$%"%s%H%m%C%/$N(B
> +$B3MF@$*$h$S2rJ|$r9T$J$&$Y$-$G$9!#(B


> +$B$3$l$O!"3d$j9~$_$,L58z2=$5$l$FHq$d$5$l$k;~4V$N:G>.NL$r!"=L>.$7$^$9!#(B
                                               $B$r!":G>.CM$K$^$G=L>.$7$^$9!#(B

> +$B%9%l%C%I%-%e!<$O!"Nc$($P!"%9%l%C%I%3%s%F%-%9%H$+$i$N$_<B9T$9$k$3$H$,2DG=$J(B
> +$B2?$+$r9T$J$&%+!<%M%k4X?t$N8F$S=P$9$?$a$KI,MW$J3d$j9~$_%l%Y%k$N%k!<%A%s$K(B
> +$B$h$C$F!";HMQ$5$l$k$3$H$,2DG=$G$9!#(B
$B%9%l%C%I%-%e!<$O!"Nc$($P!"%9%l%C%I%3%s%F%-%9%H$+$i$N$_<B9T$9$k$3$H$,2DG=$J(B
$B2?$+$r9T$J$&%+!<%M%k4X?t$N8F$S=P$9$3$H$,I,MW$J!"3d$j9~$_%l%Y%k$N%k!<%A%s$K(B
$B$h$C$F;HMQ$5$l$k$3$H$,2DG=$G$9!#(B
--
$BKY@nOBM:(B
