Changeset 8d00c46 for patches/iputils-s20071127-manpages-2.patch

Timestamp:

Feb 18, 2009, 11:27:54 PM (15 years ago)

Author:

Jim Gifford <clfs@…>

Branches:

clfs-1.2, clfs-2.1, clfs-3.0.0-systemd, clfs-3.0.0-sysvinit, master, systemd, sysvinit

Children:

56c7abf

Parents:

ffe68ed

Message:

IPUtils Updates

File:

• patches/iputils-s20071127-manpages-2.patch (moved) (moved from patches/iputils-s20071127-manpages-1.patch) (8 diffs)

patches/iputils-s20071127-manpages-2.patch

@@ -6 +6 @@
 Description: Provides the man pages (adding docbook2man with all its
              dependencies would be a major addition to the book, so I built it
-             -once- on a completed system and saved the data). 
+             -once- on a completed system and saved the data).
 
-diff -Naur doc/arping.8 doc/arping.8
---- doc/arping.8        1969-12-31 16:00:00.000000000 -0800
-+++ doc/arping.8        2009-02-18 20:52:34.000000000 -0800
+diff -Naur iputils-s20071127.orig/doc/arping.8 iputils-s20071127/doc/arping.8
+--- iputils-s20071127.orig/doc/arping.8 1969-12-31 16:00:00.000000000 -0800
++++ iputils-s20071127/doc/arping.8      2009-02-18 23:20:33.249183964 -0800
 @@ -0,0 +1,110 @@
 +.\" This manpage has been automatically generated by docbook2man 
@@ -122 +122 @@
 +and the latest versions are  available in source form at
 +http://www.skbuff.net/iputils/iputils-current.tar.bz2.
-diff -Naur doc/clockdiff.8 doc/clockdiff.8
---- doc/clockdiff.8     1969-12-31 16:00:00.000000000 -0800
-+++ doc/clockdiff.8     2009-02-18 20:52:38.000000000 -0800
+diff -Naur iputils-s20071127.orig/doc/clockdiff.8 iputils-s20071127/doc/clockdiff.8
+--- iputils-s20071127.orig/doc/clockdiff.8      1969-12-31 16:00:00.000000000 -0800
++++ iputils-s20071127/doc/clockdiff.8   2009-02-18 23:20:33.249183964 -0800
 @@ -0,0 +1,81 @@
 +.\" This manpage has been automatically generated by docbook2man 
@@ -207 +207 @@
 +and the latest versions are  available in source form at
 +http://www.skbuff.net/iputils/iputils-current.tar.bz2.
-diff -Naur doc/pg3.8 doc/pg3.8
---- doc/pg3.8   1969-12-31 16:00:00.000000000 -0800
-+++ doc/pg3.8   2009-02-18 20:52:42.000000000 -0800
-@@ -0,0 +1,86 @@
-+.\" This manpage has been automatically generated by docbook2man 
-+.\" from a DocBook document.  This tool can be found at:
-+.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
-+.\" Please send any bug reports, improvements, comments, patches, 
-+.\" etc. to Steve Cheng <steve@ggi-project.org>.
-+.TH "PG3" "8" "18 February 2009" "iputils-071127" "System Manager's Manual: iputils"
-+.SH NAME
-+pg3, ipg, pgset \- send stream of UDP packets
-+.SH SYNOPSIS
-+
-+\fBsource ipg\fR
-+
-+
-+\fBpg\fR
-+
-+
-+\fBpgset\fR \fB\fICOMMAND\fB\fR
-+
-+.SH "DESCRIPTION"
-+.PP
-+\fBipg\fR is not a program, it is script which should be sourced
-+to \fBbash\fR. When sourced it loads module \fIpg3\fR and
-+exports a few of functions accessible from parent shell. These macros
-+are \fBpg\fR to start packet injection and to get the results of run;
-+and \fBpgset\fR to setup packet generator.
-+.PP
-+\fBpgset\fR can send the following commands to module \fIpg3\fR:
-+.SH "COMMAND"
-+.TP
-+\fBodev \fIDEVICE\fB\fR
-+Name of Ethernet device to test. See
-+warning below.
-+.TP
-+\fBpkt_size \fIBYTES\fB\fR
-+Size of packet to generate. The size includes all the headers: UDP, IP,
-+MAC, but does not account for overhead internal to medium, i.e. FCS
-+and various paddings.
-+.TP
-+\fBfrags \fINUMBER\fB\fR
-+Each packet will contain \fINUMBER\fR of fragments.
-+Maximal amount for linux-2.4 is 6. Far not all the devices support
-+fragmented buffers.
-+.TP
-+\fBcount \fINUMBER\fB\fR
-+Send stream of \fINUMBER\fR of packets and stop after this.
-+.TP
-+\fBipg \fITIME\fB\fR
-+Introduce artificial delay between packets of \fITIME\fR
-+microseconds.
-+.TP
-+\fBdst \fIIP_ADDRESS\fB\fR
-+Select IP destination where the stream is sent to.
-+Beware, never set this address at random. \fBpg3\fR is not a toy,
-+it creates really tough stream. Default value is 0.0.0.0.
-+.TP
-+\fBdst \fIMAC_ADDRESS\fB\fR
-+Select MAC destination where the stream is sent to.
-+Default value is 00:00:00:00:00:00 in hope that this will not be received
-+by any node on LAN.
-+.TP
-+\fBstop\fR
-+Abort packet injection.
-+.SH "WARNING"
-+.PP
-+When output device is set to some random device different
-+of hardware Ethernet device, \fBpg3\fR will crash kernel.
-+.PP
-+Do not use it on VLAN, ethertap, VTUN and other devices,
-+which emulate Ethernet not being real Ethernet in fact.
-+.SH "AUTHOR"
-+.PP
-+\fBpg3\fR was written by Robert Olsson <robert.olsson@its.uu.se>.
-+.SH "SECURITY"
-+.PP
-+This can be used only by superuser.
-+.PP
-+This tool creates floods of packets which is unlikely to be handled
-+even by high-end machines. For example, it saturates gigabit link with
-+60 byte packets when used with Intel's e1000. In face of such stream
-+switches, routers and end hosts may deadlock, crash, explode.
-+Use only in test lab environment.
-+.SH "AVAILABILITY"
-+.PP
-+\fBpg3\fR is part of \fIiputils\fR package
-+and the latest versions are  available in source form at
-+http://www.skbuff.net/iputils/iputils-current.tar.bz2.
-diff -Naur doc/ping.8 doc/ping.8
---- doc/ping.8  1969-12-31 16:00:00.000000000 -0800
-+++ doc/ping.8  2009-02-18 20:52:44.000000000 -0800
+diff -Naur iputils-s20071127.orig/doc/ping.8 iputils-s20071127/doc/ping.8
+--- iputils-s20071127.orig/doc/ping.8   1969-12-31 16:00:00.000000000 -0800
++++ iputils-s20071127/doc/ping.8        2009-02-18 23:20:33.249183964 -0800
 @@ -0,0 +1,332 @@
 +.\" This manpage has been automatically generated by docbook2man 
@@ -633 +543 @@
 +and the latest versions are  available in source form at
 +http://www.skbuff.net/iputils/iputils-current.tar.bz2.
-diff -Naur doc/rarpd.8 doc/rarpd.8
---- doc/rarpd.8 1969-12-31 16:00:00.000000000 -0800
-+++ doc/rarpd.8 2009-02-18 20:52:48.000000000 -0800
-@@ -0,0 +1,84 @@
-+.\" This manpage has been automatically generated by docbook2man 
-+.\" from a DocBook document.  This tool can be found at:
-+.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
-+.\" Please send any bug reports, improvements, comments, patches, 
-+.\" etc. to Steve Cheng <steve@ggi-project.org>.
-+.TH "RARPD" "8" "18 February 2009" "iputils-071127" "System Manager's Manual: iputils"
-+.SH NAME
-+rarpd \- answer RARP REQUESTs
-+.SH SYNOPSIS
-+
-+\fBarping\fR [\fB-aAvde\fR] [\fB-b \fIbootdir\fB\fR] [\fB\fIinterface\fB\fR]
-+
-+.SH "DESCRIPTION"
-+.PP
-+Listens
-+RARP
-+requests from clients. Provided MAC address of client
-+is found in \fI/etc/ethers\fR database and
-+obtained host name is resolvable to an IP address appropriate
-+for attached network, \fBrarpd\fR answers to client with RARPD
-+reply carrying an IP address.
-+.PP
-+To allow multiple boot servers on the network \fBrarpd\fR
-+optionally checks for presence Sun-like bootable image in TFTP directory.
-+It should have form \fBHexadecimal_IP.ARCH\fR, f.e. to load
-+sparc 193.233.7.98 \fIC1E90762.SUN4M\fR is linked to
-+an image appropriate for SUM4M in directory \fI/etc/tftpboot\fR.
-+.SH "WARNING"
-+.PP
-+This facility is deeply obsoleted by
-+BOOTP
-+and later
-+DHCP protocols.
-+However, some clients really still need this to boot.
-+.SH "OPTIONS"
-+.TP
-+\fB-a\fR
-+Listen on all the interfaces. Currently it is an internal
-+option, its function is overridden with \fIinterface\fR
-+argument. It should not be used.
-+.TP
-+\fB-A\fR
-+Listen not only RARP but also ARP messages, some rare clients
-+use ARP by some unknown reason.
-+.TP
-+\fB-v\fR
-+Be verbose.
-+.TP
-+\fB-d\fR
-+Debug mode. Do not go to background.
-+.TP
-+\fB-e\fR
-+Do not check for presence of a boot image, reply if MAC address
-+resolves to a valid IP address using \fI/etc/ethers\fR
-+database and DNS. 
-+.TP
-+\fB-b \fIbootdir\fB\fR
-+TFTP boot directory. Default is \fI/etc/tftpboot\fR
-+.SH "SEE ALSO"
-+.PP
-+\fBarping\fR(8),
-+\fBtftpd\fR(8).
-+.SH "AUTHOR"
-+.PP
-+\fBrarpd\fR was written by
-+Alexey Kuznetsov
-+<kuznet@ms2.inr.ac.ru>.
-+It is now maintained by
-+YOSHIFUJI Hideaki
-+<yoshfuji@skbuff.net>.
-+.SH "SECURITY"
-+.PP
-+\fBrarpd\fR requires CAP_NET_RAWIO capability
-+to listen and send RARP and ARP packets. It also needs CAP_NET_ADMIN
-+to give to kernel hint for ARP resolution; this is not strictly required,
-+but some (most of, to be more exact) clients are so badly broken that
-+are not able to answer ARP before they are finally booted. This is
-+not wonderful taking into account that clients using RARPD in 2002
-+are all unsupported relic creatures of 90's and even earlier.
-+.SH "AVAILABILITY"
-+.PP
-+\fBrarpd\fR is part of \fIiputils\fR package
-+and the latest versions are  available in source form at
-+http://www.skbuff.net/iputils/iputils-current.tar.bz2.
-diff -Naur doc/rdisc.8 doc/rdisc.8
---- doc/rdisc.8 1969-12-31 16:00:00.000000000 -0800
-+++ doc/rdisc.8 2009-02-18 20:52:53.000000000 -0800
+diff -Naur iputils-s20071127.orig/doc/rdisc.8 iputils-s20071127/doc/rdisc.8
+--- iputils-s20071127.orig/doc/rdisc.8  1969-12-31 16:00:00.000000000 -0800
++++ iputils-s20071127/doc/rdisc.8       2009-02-18 23:20:33.249183964 -0800
 @@ -0,0 +1,110 @@
 +.\" This manpage has been automatically generated by docbook2man 
@@ -835 +657 @@
 +and the latest versions are  available in source form at
 +http://www.skbuff.net/iputils/iputils-current.tar.bz2.
-diff -Naur doc/tftpd.8 doc/tftpd.8
---- doc/tftpd.8 1969-12-31 16:00:00.000000000 -0800
-+++ doc/tftpd.8 2009-02-18 20:52:57.000000000 -0800
-@@ -0,0 +1,85 @@
-+.\" This manpage has been automatically generated by docbook2man 
-+.\" from a DocBook document.  This tool can be found at:
-+.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
-+.\" Please send any bug reports, improvements, comments, patches, 
-+.\" etc. to Steve Cheng <steve@ggi-project.org>.
-+.TH "TFTPD" "8" "18 February 2009" "iputils-071127" "System Manager's Manual: iputils"
-+.SH NAME
-+tftpd \- Trivial File Transfer Protocol server
-+.SH SYNOPSIS
-+
-+\fBtftpd\fR \fB\fIdirectory\fB\fR
-+
-+.SH "DESCRIPTION"
-+.PP
-+\fBtftpd\fR is a server which supports the DARPA
-+Trivial File Transfer Protocol
-+(RFC1350).
-+The TFTP server is started
-+by \fBinetd\fR(8).
-+.PP
-+\fIdirectory\fR is required argument; if it is not given
-+\fBtftpd\fR aborts. This path is prepended to any file name requested
-+via TFTP protocol, effectively chrooting \fBtftpd\fR to this directory.
-+File names are validated not to escape out of this directory, however
-+administrator may configure such escape using symbolic links.
-+.PP
-+It is in difference of variants of \fBtftpd\fR usually distributed
-+with unix-like systems, which take a list of directories and match
-+file names to start from one of given prefixes or to some random
-+default, when no arguments were given. There are two reasons not to
-+behave in this way: first, it is inconvenient, clients are not expected
-+to know something about layout of filesystem on server host.
-+And second, TFTP protocol is not a tool for browsing of server's filesystem,
-+it is just an agent allowing to boot dumb clients. 
-+.PP
-+In the case when \fBtftpd\fR is used together with
-+\fBrarpd\fR(8),
-+tftp directories in these services should coincide and it is expected
-+that each client booted via TFTP has boot image corresponding
-+its IP address with an architecture suffix following Sun Microsystems
-+conventions. See 
-+\fBrarpd\fR(8)
-+for more details.
-+.SH "SECURITY"
-+.PP
-+TFTP protocol does not provide any authentication.
-+Due to this capital flaw \fBtftpd\fR is not able to restrict
-+access to files and will allow only publically readable
-+files to be accessed. Files may be written only if they already
-+exist and are publically writable.
-+.PP
-+Impact is evident, directory exported via TFTP \fBmust not\fR
-+contain sensitive information of any kind, everyone is allowed
-+to read it as soon as a client is allowed. Boot images do not contain
-+such information as rule, however you should think twice before
-+publishing f.e. Cisco IOS config files via TFTP, they contain
-+\fBunencrypted\fR passwords and may contain some information
-+about the network, which you were not going to make public.
-+.PP
-+The \fBtftpd\fR server should be executed by \fBinetd\fR
-+with dropped root privileges, namely with a user ID giving minimal
-+access to files published in tftp directory. If it is executed
-+as superuser occasionally, \fBtftpd\fR drops its UID and GID
-+to 65534, which is most likely not the thing which you expect.
-+However, this is not very essential; remember, only files accessible
-+for everyone can be read or written via TFTP.
-+.SH "SEE ALSO"
-+.PP
-+\fBrarpd\fR(8),
-+\fBtftp\fR(1),
-+\fBinetd\fR(8).
-+.SH "HISTORY"
-+.PP
-+The \fBtftpd\fR command appeared in 4.2BSD. The source in iputils
-+is cleaned up both syntactically (ANSIized) and semantically (UDP socket IO).
-+.PP
-+It is distributed with iputils mostly as good demo of an interesting feature
-+(MSG_CONFIRM) allowing to boot long images by dumb clients
-+not answering ARP requests until they are finally booted.
-+However, this is full functional and can be used in production.
-+.SH "AVAILABILITY"
-+.PP
-+\fBtftpd\fR is part of \fIiputils\fR package
-+and the latest versions are  available in source form at
-+http://www.skbuff.net/iputils/iputils-current.tar.bz2.
-diff -Naur doc/tracepath.8 doc/tracepath.8
---- doc/tracepath.8     1969-12-31 16:00:00.000000000 -0800
-+++ doc/tracepath.8     2009-02-18 20:53:04.000000000 -0800
+diff -Naur iputils-s20071127.orig/doc/tracepath.8 iputils-s20071127/doc/tracepath.8
+--- iputils-s20071127.orig/doc/tracepath.8      1969-12-31 16:00:00.000000000 -0800
++++ iputils-s20071127/doc/tracepath.8   2009-02-18 23:21:37.765316105 -0800
 @@ -0,0 +1,94 @@
 +.\" This manpage has been automatically generated by docbook2man 
@@ -993 +726 @@
 +with TTL of 2 was rejected at the first hop due to Path MTU Discovery.
 +.PP
-+Te last line summarizes information about all the path to the destination,
++The last line summarizes information about all the path to the destination,
 +it shows detected Path MTU, amount of hops to the destination and our
 +guess about amount of hops from the destination to us, which can be
@@ -1022 +755 @@
 +and the latest versions are  available in source form at
 +http://www.skbuff.net/iputils/iputils-current.tar.bz2.
-diff -Naur doc/traceroute6.8 doc/traceroute6.8
---- doc/traceroute6.8   1969-12-31 16:00:00.000000000 -0800
-+++ doc/traceroute6.8   2009-02-18 20:53:04.000000000 -0800
+diff -Naur iputils-s20071127.orig/doc/traceroute6.8 iputils-s20071127/doc/traceroute6.8
+--- iputils-s20071127.orig/doc/traceroute6.8    1969-12-31 16:00:00.000000000 -0800
++++ iputils-s20071127/doc/traceroute6.8 2009-02-18 23:20:33.249183964 -0800
 @@ -0,0 +1,42 @@
 +.\" This manpage has been automatically generated by docbook2man 
@@ -1068 +801 @@
 +and the latest versions are  available in source form at
 +http://www.skbuff.net/iputils/iputils-current.tar.bz2.
+