From owner-man-jp-reviewer@jp.FreeBSD.org Thu Nov 30 21:23:42 2006
Received: (from daemon@localhost)
	by castle.jp.FreeBSD.org (8.11.6p2+3.4W/8.11.3) id kAUCNg443767;
	Thu, 30 Nov 2006 21:23:42 +0900 (JST)
	(envelope-from owner-man-jp-reviewer@jp.FreeBSD.org)
Received: from mail.asahi-net.or.jp (mail2.asahi-net.or.jp [202.224.39.198])
	by castle.jp.FreeBSD.org (8.11.6p2+3.4W/8.11.3) with ESMTP/inet id kAUCNgw43762
	for <man-jp-reviewer@jp.FreeBSD.org>; Thu, 30 Nov 2006 21:23:42 +0900 (JST)
	(envelope-from CQG00620@nifty.ne.jp)
Received: from asahi-net.jp (h204032.ppp.asahi-net.or.jp [61.114.204.32])
	by mail.asahi-net.or.jp (Postfix) with ESMTP id 4E7741EA29
	for <man-jp-reviewer@jp.FreeBSD.org>; Thu, 30 Nov 2006 21:23:41 +0900 (JST)
From: Watanabe Kazuhiro <CQG00620@nifty.ne.jp>
To: jpman reviewer <man-jp-reviewer@jp.FreeBSD.org>
User-Agent: Wanderlust/2.14.0 (Africa) SEMI/1.14.6 (Maruoka) FLIM/1.14.8
 (=?ISO-8859-4?Q?Shij=F2?=) APEL/10.6 Emacs/20.7 (i386--freebsd) MULE/4.0
 (HANANOEN)
MIME-Version: 1.0 (generated by SEMI 1.14.6 - "Maruoka")
Content-Type: text/plain; charset=ISO-2022-JP
Message-Id: <20061130122341.4E7741EA29@mail.asahi-net.or.jp>
Reply-To: man-jp-reviewer@jp.FreeBSD.org
Precedence: list
Date: Thu, 30 Nov 2006 21:22:52 +0900
X-Sequence: man-jp-reviewer 5162
Subject: [man-jp-reviewer 5162] portsnap.8
Sender: owner-man-jp-reviewer@jp.FreeBSD.org
X-Originator: CQG00620@nifty.ne.jp
X-Distribute: distribute version 2.1 (Alpha) patchlevel 24e+060209

$BEOJU0l42$G$9!#(B

portsnap.8 $B$r?75,$KLu$7$?$N$GEj9F$7$^$9!#(B

--- portsnap.8.orig	Thu Nov 30 20:57:51 2006
+++ portsnap.8	Thu Nov 30 20:56:31 2006
@@ -23,15 +23,16 @@
 .\" IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.\" $FreeBSD: src/usr.sbin/portsnap/portsnap/portsnap.8,v 1.3.2.4 2006/05/26 23:13:27 cperciva Exp $
+.\" %FreeBSD: src/usr.sbin/portsnap/portsnap/portsnap.8,v 1.3.2.4 2006/05/26 23:13:27 cperciva Exp %
+.\" $FreeBSD$
 .\"
 .Dd August 13, 2005
 .Dt PORTSNAP 8
 .Os FreeBSD
-.Sh NAME
+.Sh $BL>>N(B
 .Nm portsnap
-.Nd fetch and extract compressed snapshots of the ports tree
-.Sh SYNOPSIS
+.Nd ports $B%D%j!<$N05=L$5$l$?%9%J%C%W%7%g%C%H$r<hF@!"E83+$9$k(B
+.Sh $B=q<0(B
 .Nm
 .Op Fl I
 .Op Fl d Ar workdir
@@ -42,195 +43,184 @@
 .Op Fl s Ar server
 .Cm command ...
 .Op Ar path
-.Sh DESCRIPTION
-The
+.Sh $B2r@b(B
 .Nm
-tool is used to fetch and update compressed snapshots
-of the
+$B%D!<%k$O(B
 .Fx
-ports tree, and extract and update an
-uncompressed ports tree.
-.Sh OPTIONS
-The following options are supported:
+$B$N(B ports $B%D%j!<$N05=L$5$l$?%9%J%C%W%7%g%C%H$N<hF@$H99?7!"(B
+$B$*$h$SI|85$7$?(B ports $B%D%j!<$NE83+$H99?7$K;HMQ$5$l$^$9!#(B
+.Sh $B%*%W%7%g%s(B
+$B0J2<$N%*%W%7%g%s$,%5%]!<%H$5$l$F$$$^$9(B:
 .Bl -tag -width "-f conffile"
 .It Fl d Ar workdir
-Store working files (e.g. downloaded updates) in
-.Ar workdir .
-(default:
+$B:n6H%U%!%$%k(B ($BNc(B: $B%@%&%s%m!<%I$7$?99?7(B) $B$r(B
+.Ar workdir
+$B$KJ]B8$7$^$9!#(B
+($B%G%U%)%k%H(B:
 .Pa /var/db/portsnap ,
-or as given in the configuration file.)
+$B$^$?$O@_Dj%U%!%$%k$GM?$($i$l$?>l=j!#(B)
 .It Fl f Ar conffile
-Read the configuration from from
-.Ar conffile .
-(default:
+$B@_Dj$r(B
+.Ar conffile
+$B$+$iFI$_9~$_$^$9!#(B
+($B%G%U%)%k%H(B:
 .Pa /etc/portsnap.conf )
 .It Fl I
-For the
 .Cm update
-command, update INDEX files, but not the rest of the ports tree.
+$B%3%^%s%I$K$*$$$F!"(BINDEX $B%U%!%$%k$r99?7$7$^$9$,!";D$j$N(B ports $B%D%j!<$K$O(B
+$B2?$b$7$^$;$s!#(B
 .It Fl k Ar KEY
-Expect a public key with given SHA256 hash.
-(default: read value from configuration file.)
+$BM?$($i$l$?(B SHA256 $B%O%C%7%eCM$N8x3+80$r4|BT$7$^$9!#(B
+($B%G%U%)%k%H(B: $B@_Dj%U%!%$%k$+$iCM$rFI$_9~$_$^$9!#(B)
 .It Fl l Ar descfile
-Merge the specified local describes file into the INDEX files being 
-built.
-The
+$B;XDj$7$?%m!<%+%k$J5-=R%U%!%$%k$r!"9=C[$5$l$?(B INDEX $B%U%!%$%k$KE}9g$7$^$9!#(B
 .Ar descfile
-should be generated by running
+$B$O!"%m!<%+%k$J$=$l$>$l$N(B port $B%G%#%l%/%H%j$G(B
 .Cm make describe
-in each of the local port directories.
+$B$N<B9T$K$h$C$F@8@.$5$l$k$Y$-$G$9!#(B
 .It Fl p Ar portsdir
-When extracting or updating an uncompressed snapshot,
-operate on the directory
-.Ar portsdir .
-(default:
+$BI|85$7$?%9%J%C%W%7%g%C%H$r!"%G%#%l%/%H%j(B
+.Ar portsdir
+$B$GE83+$^$?$O99?7$7$^$9!#(B
+($B%G%U%)%k%H(B:
 .Pa /usr/ports/ ,
-or as given in the configuration file.)
+$B$^$?$O@_Dj%U%!%$%k$GM?$($i$l$?>l=j!#(B)
 .It Fl s Ar server
-Fetch files from the specified server or server pool.
-(default: portsnap.FreeBSD.org , or as given in the
-configuration file.)
+$B%U%!%$%k$r;XDj$5$l$?%5!<%P$^$?$O%5!<%P%W!<%k$+$i<hF@$7$^$9!#(B
+($B%G%U%)%k%H(B: portsnap.FreeBSD.org ,
+$B$^$?$O@_Dj%U%!%$%k$GM?$($i$l$?%5!<%P!#(B)
 .It path
-For
 .Cm extract
-command only, operate only on parts of the ports tree starting with
-.Ar path .
-(e.g.
+$B%3%^%s%I$K$*$$$F$N$_!"(B
+.Ar path
+$B$G;O$^$k(B ports $B%D%j!<$N0lIt$N$_$rA`:n$7$^$9!#(B
+($BNc(B:
 .Nm
 .cm extract
 .Ar sysutils/port
-would extract sysutils/portsman, sysutils/portsnap,
-sysutils/portupgrade, etc.)
+$B$O(B sysutils/portsman, sysutils/portsnap, sysutils/portupgrade, $BEy$r(B
+$BE83+$7$^$9!#(B)
 .El
-.Sh COMMANDS
-The
+.Sh $B%3%^%s%I(B
 .Cm command
-can be any one of the following:
+$B$O0J2<$N$&$A$N$I$l$+$G$9(B:
 .Pp
 .Bl -tag -width "-f conffile"
 .It fetch
-Fetch a compressed snapshot of the ports tree, or update
-the existing snapshot.
-This command should only be used interactively; for
-non-interactive use, you should use the
+ports $B%D%j!<$N05=L$5$l$?%9%J%C%W%7%g%C%H$r<hF@!"(B
+$B$^$?$O4{B8$N%9%J%C%W%7%g%C%H$r99?7$7$^$9!#(B
+$B$3$N%3%^%s%I$OBPOC7A<0$G$N$_;HMQ$5$l$k$Y$-$G$"$j!"(B
+$BHsBPOC7A<0$N>l9g$O(B
 .Cm cron
-command.
+$B%3%^%s%I$r;HMQ$9$Y$-$G$9!#(B
 .It cron
-Sleep a random amount of time between 1 and 3600 seconds,
-then operate as if the
+1 $BIC$+$i(B 3600 $BIC$N4V$N!"%i%s%@%`$J;~4VBT$C$F$+$i!"(B
 .Cm fetch
-command was specified.
-As the name suggests, this command is designed for running
-from
-.Xr cron 8 ;
-the random delay serves to minimize the probability that
-a large number of machines will simultaneously attempt to
-fetch updates.
+$B%3%^%s%I$,;XDj$5$l$?$N$HF1$8A`:n$r$7$^$9!#(B
+$BL>A0$+$iM=B,$5$l$k$h$&$K!"$3$N%3%^%s%I$O(B
+.Xr cron 8
+$B$+$i<B9T$5$l$k$h$&$K@_7W$5$l$F$$$^$9!#(B
+$B%i%s%@%`$JCY1d$K$h$j!"B??t$N%^%7%s$,F1;~$K99?7$r<hF@$7$h$&$H$9$k(B
+$B2DG=@-$r:G>.$K$7$^$9!#(B
 .It extract
-Extract a ports tree, replacing existing files and directories.
-NOTE: This will remove anything occupying the location where
-files or directories are being extracted; in particular, any
-changes made locally to the ports tree (for example, adding new
-patches) will be silently obliterated.
+ports $B%D%j!<$rE83+$7!"4{B8$N%U%!%$%k$*$h$S%G%#%l%/%H%j$rCV$-49$($^$9!#(B
+$BCm(B: $B$3$l$K$h$C$F!"%U%!%$%k$^$?$O%G%#%l%/%H%j$,E83+$5$l$k>l=j$K$"$k!"(B
+$B$"$i$f$k$b$N$,:o=|$5$l$^$9!#(B
+$BFC$K!"(Bports $B%D%j!<$KBP$7$F%m!<%+%k$K9T$o$l$?$"$i$f$kJQ99(B
+($BNc$($P!"DI2C$N%Q%C%A(B) $B$OL[$C$F>C5n$5$l$^$9!#(B
 .Pp
-Only run this command to initialize your portsnap-maintained
-ports tree for the first time, if you wish to start over with
-a clean, completely unmodified tree, or if you wish to extract
-a specific part of the tree (using the
-.Ar path
-option).
+$B$3$l$O%/%j!<%s$J!"2?$bJQ99$7$F$$$J$$%D%j!<$+$i$d$jD>$7$?$$>l9g!"(B
+$B$^$?$O(B
+.Ar path  
+$B%*%W%7%g%s$r;HMQ$7$F%D%j!<$NFCDj$N0lIt$rE83+$7$?$$>l9g$J$I!"(B
+portsnap $B$G4IM}$7$F$$$k(B ports $B%D%j!<$r:G=i$K=i4|2=$9$k>l9g$N$_!"(B
+$B$3$N%3%^%s%I$r<B9T$7$^$9!#(B
 .It update
-Update a ports tree extracted using the
 .Cm extract
-command.
-You must run this command to apply changes to your ports tree
-after downloading updates via the
+$B%3%^%s%I$r;HMQ$7$FE83+$7$?(B ports $B%D%j!<$r99?7$7$^$9!#(B
+$B$3$N%3%^%s%I$O%m!<%+%k$J(B ports $B%D%j!<$KJQ99$rE,MQ$9$k$?$a$K!"(B
+$B99?7$r(B
 .Cm fetch
-or
+$B$^$?$O(B
 .Cm cron
-commands.
-Again, note that in the parts of the ports tree which are being
-updated, any local changes or additions will be removed.
+$B%3%^%s%I$G%@%&%s%m!<%I$7$?8e$K<B9T$9$Y$-$G$9!#(B
+$B:FEY=R$Y$^$9$,!"(Bports $B%D%j!<$N0lIt$,99?7$5$l$k:]!"%m!<%+%k$J$"$i$f$kJQ99(B
+$B$*$h$SDI2CJ*$O:o=|$5$l$k$3$H$KCm0U$7$F$/$@$5$$!#(B
 .El
 .Sh TIPS
 .Bl -bullet
 .It
-If your clock is set to local time, adding the line
+$B;~7W$,%m!<%+%k%?%$%`$K@_Dj$5$l$F$$$k>l9g!"(B
+.Pa /usr/ports
+$B$K$9$0$KE83+$9$k$3$H$,$G$-$k!"(B ports $B%D%j!<$N:G?7$N%9%J%C%W%7%g%C%H$,(B
+$B>o$KMxMQ2DG=$J>uBV$K$7$F$*$/$K$O!"(B/etc/crontab $B$K<!$N9T$rDI2C$9$k$N$,(B
+$B$h$$J}K!$G$9!#(B
 .Pp
 .Dl 0 3 * * * root /usr/sbin/portsnap cron
 .Pp
-to /etc/crontab is a good way to make sure you always have
-an up-to-date snapshot of the ports tree available which
-can quickly be extracted into
-.Pa /usr/ports .
-If your clock is set to UTC, please pick a random time other
-than 3AM, to avoid overly imposing an uneven load on the
-server(s) hosting the snapshots.
+$B;~7W$,(B UTC $B$K@_Dj$5$l$F$$$k>l9g$O!"%9%J%C%W%7%g%C%H$rDs6!$7$F$$$k%5!<%P(B ($B72(B) $B$K(B
+$B=8CfE*$J2aEY$NIi2Y$rIi$o$;$k$3$H$N$J$$$h$&$K!"8aA0(B 3 $B;~0J30$N%i%s%@%`$J;~9o$r(B
+$BA*Br$9$k$h$&$K$7$F$/$@$5$$!#(B
 .It
-Running
+.Xr cron 8
+$B$+$i(B
 .Nm
 .Cm update
-from
-.Xr cron 8
-is a bad idea -- if you are ever installing or updating a
-port at the time the cron job runs, you will probably end up
-in a mess when
-.Nm
-updates or removes files which are being used by the port
-build.
-However, running
+$B$r<B9T$9$k$N$O0-$$9M$($G$9!#(B
+port $B$r%$%s%9%H!<%k$^$?$O99?7$7$F$$$k;~$K(B cron $B%8%g%V$,<B9T$5$l!"(B
+$B$=$N(B port $B$N9=C[$K;HMQ$7$F$$$k%U%!%$%k$r(B
+.Nm
+$B$,99?7$^$?$O:o=|$7$F$7$^$&$H!":G=*E*$K$O$a$A$c$/$A$c$J>uBV$H$J$k$G$7$g$&!#(B
+$B$7$+$7(B
 .Nm
 .Fl I
 .Cm update
-is probably safe, and can be used together with
+$B$O62$i$/0BA4$G$"$j!"(B
 .Xr portversion 1
-to identify installed software which is out of date.
+$B$HAH$_9g$o$;$k$3$H$G!"8E$/$J$C$?%$%s%9%H!<%k:Q$_$N%=%U%H%&%'%"$r<1JL$9$k$N$K(B
+$B;HMQ$9$k$3$H$,$G$-$^$9!#(B
 .It
-If you wish to use
+$BB??t$N%^%7%s$r:G?7$N>uBV$KJ]$D$?$a$K(B
 .Nm
-to keep a large number of machines up to date, you may wish
-to set up a caching HTTP proxy.
-Since
+$B$r;HMQ$7$?$$>l9g!"(BHTTP $B%-%c%C%7%e%W%m%-%7$r@_Dj$7$?$/$J$k$+$bCN$l$^$;$s!#(B
 .Nm
-uses
+$B$O99?7$r%@%&%s%m!<%I$9$k$N$K(B
 .Xr fetch 1
-to download updates, setting the
+$B$r;HMQ$7$F$$$k$?$a!"(B
 .Ev HTTP_PROXY
-environment variable will direct it to fetch updates from
-the given proxy.
-This is much more efficient than
-.Em mirroring
-the files on the portsnap server, since the vast majority
-of files are not needed by any particular client.
+$B4D6-JQ?t$r@_Dj$9$k$3$H$G!"M?$($i$l$?%W%m%-%7$+$i99?7$N<hF@$r9T$&$h$&$K$J$j$^$9!#(B
+$B$3$l$O(B portsnap $B%5!<%P$N%U%!%$%k$r(B
+.Em $B%_%i!<%j%s%0(B
+$B$9$k$h$j$b$O$k$+$K8zN(E*$G$9!#(B
+$B$I$N$h$&$J%/%i%$%"%s%H$G$"$C$F$b!"Hs>o$KB?$/$N%U%!%$%k$OITMW$J$b$N$@$+$i$G$9!#(B
 .El
-.Sh PRIVACY NOTICE
-As an unavoidable part of its operation, a machine running
+.Sh $B%W%i%$%P%7!<$K4X$9$kCm0U(B
+$B$=$NA`:n>eHr$1$i$l$J$$MWAG$H$7$F!"(B
 .Nm
-will make its public IP address and the list of files it fetches 
-available to the server from which it fetches updates.
-Using these it may be possible to recognize a machine over an extended 
-period of time, determine when it is updated, and identify which 
-portions of the FreeBSD ports tree, if any, are being ignored using 
-"REFUSE" directives in
-.Pa portsnap.conf .
-In addition, the FreeBSD release level is transmitted to the server.
+$B$r<B9T$7$F$$$k%^%7%s$O!"<+?H$N%Q%V%j%C%/(B IP $B%"%I%l%9$H(B
+$B<hF@$9$k%U%!%$%k$N%j%9%H$r!"99?7$r<hF@$7$F$$$k%5!<%P$G;2>H2DG=$K$7$^$9!#(B
+$B$3$l$i$N;HMQ$K$h$j!"D9$$4|4V$KEO$C$F!"99?7$,$$$D9T$o$l$k$+$rFCDj$7!"(B
+$B$^$?$b$7(B
+.Pa portsnap.conf
+$B$G(B "REFUSE" $BL?Na$,;HMQ$5$l$F$$$l$P!"(BFreeBSD ports $B%D%j!<$N$I$NItJ,$,(B
+$BL5;k$5$l$k$+$r3NG'$9$k$3$H$r%^%7%s$KG'$a$k2DG=@-$,$"$j$^$9!#(B
+$B2C$($F!"(BFreeBSD $B$N%j%j!<%9%l%Y%k$,%5!<%P$KE>Aw$5$l$^$9!#(B
 .Pp
-Statistical data generated from information collected in this manner 
-may be published, but only in aggregate and after anonymizing the
-individual systems.
-.Sh FILES
+$B$3$NJ}K!$G=8$a$i$l$?>pJs$+$i@8@.$7$?E}7W>pJs$O8x3+$5$l$k$+$bCN$l$^$;$s$,!"(B
+$BAm7W$N$_$G$"$j!"$^$?8D!9$N%7%9%F%`$OF?L>2=$7$?8e$H$J$j$^$9!#(B
+.Sh $B4XO"%U%!%$%k(B
 .Bl -tag -width "/etc/portsnap.conf"
 .It /etc/portsnap.conf
-Default location of the portsnap configuration file.
+portsnap $B@_Dj%U%!%$%k$N%G%U%)%k%H$N>l=j!#(B
 .It /var/db/portsnap
-Default location where compressed snapshots are stored.
+$B05=L$5$l$?%9%J%C%W%7%g%C%H$,J]B8$5$l$k%G%U%)%k%H$N>l=j!#(B
 .It /usr/ports
-Default location where the ports tree is extracted.
+ports $B%D%j!<$,E83+$5$l$k%G%U%)%k%H$N>l=j!#(B
 .El
-.Sh SEE ALSO
+.Sh $B4XO"9`L\(B
 .Xr fetch 1
 .Xr fetch 3
 .Xr portsnap.conf 5
 .Xr sha256 1
-.Sh AUTHORS
+.Sh $B:n<T(B
 .An Colin Percival Aq cperciva@FreeBSD.org

---
Watanabe Kazuhiro (CQG00620@nifty.ne.jp)
