Changeset 8d00c46


Ignore:
Timestamp:
Feb 18, 2009, 11:27:54 PM (14 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

Files:
3 edited
2 moved

Legend:

Unmodified
Added
Removed
  • BOOK/final-system/common/iputils.xml

    rffe68ed r8d00c46  
    3131    <para os="p3">The following patch contains the man-pages for IPutils:</para>
    3232
    33 <screen os="p4"><userinput>patch -Np1 -i ../&iputils-manpages-patch;</userinput></screen>
     33<screen os="p4"><userinput>patch -Np0 -i ../&iputils-manpages-patch;</userinput></screen>
    3434
    3535    <para os="a">Compile the package:</para>
     
    4242
    4343<screen os="e"><userinput>cp -v ping{,6} /bin
    44 cp -v arping /usr/bin
    45 cp -v tracepath /usr/bin
    46 cp -v trace{path,route}6 /usr/bin
     44install -v -m755 arping /usr/bin
     45install -v -m755 clockdiff /usr/bin
     46install -v -m755 rdisc /usr/bin
     47install -v -m755 tracepath /usr/bin
     48install -v -m755 trace{path,route}6 /usr/bin
    4749install -v -m644 doc/*.8 /usr/share/man/man8</userinput></screen>
    4850
     
    5658
    5759      <seglistitem>
    58         <seg>arping, ping, ping6, tracepath, tracepath6, and traceroute6</seg>
     60        <seg>arping, clockdiff, ping, ping6, rdisc. tracepath, tracepath6, and traceroute6</seg>
    5961      </seglistitem>
    6062    </segmentedlist>
  • BOOK/introduction/common/changelog.xml

    rffe68ed r8d00c46  
    4646        <listitem>
    4747          <para>[Jim] - Added Missing ManPages Patch to IPutils.</para>
     48        </listitem>
     49        <listitem>
     50          <para>[Jim] - IPutils Patches Update - Adds to more useful utilities.</para>
    4851        </listitem>
    4952      </itemizedlist>
  • BOOK/patches.ent

    rffe68ed r8d00c46  
    7979<!ENTITY grep-i18n-patch-size "28 KB">
    8080
    81 <!ENTITY iputils-fixes-patch "iputils-&iputils-version;-fixes-1.patch">
    82 <!ENTITY iputils-fixes-patch-md5 "16d3ac896afe31c0188274930c1dd90e">
    83 <!ENTITY iputils-fixes-patch-size "4 KB">
    84 
    85 <!ENTITY iputils-manpages-patch "iputils-&iputils-version;-manpages-1.patch">
    86 <!ENTITY iputils-manpages-patch-md5 "a16ae02f143f0c0d1f1b714af04bfeb5">
    87 <!ENTITY iputils-manpages-patch-size "40 KB">
     81<!ENTITY iputils-fixes-patch "iputils-&iputils-version;-fixes-2.patch">
     82<!ENTITY iputils-fixes-patch-md5 "b6e85d97bbc08ebe6dc332e25c69bb82">
     83<!ENTITY iputils-fixes-patch-size "8 KB">
     84
     85<!ENTITY iputils-manpages-patch "iputils-&iputils-version;-manpages-2.patch">
     86<!ENTITY iputils-manpages-patch-md5 "d66cd57b5fc2cad961238c64e3eff4ee">
     87<!ENTITY iputils-manpages-patch-size "32 KB">
    8888
    8989<!ENTITY man-i18n-patch "man-&man-version;-i18n-1.patch">
  • patches/iputils-s20071127-fixes-2.patch

    rffe68ed r8d00c46  
    11Submitted By: Jim Gifford (jim at cross-lfs dot org)
    2 Date: 01-15-2009
     2Date: 02-18-2009
    33Initial Package Version: s20071127
    4 Origin: Debian
     4Origin: Debian and Fedora
    55Upstream Status: Unknown
    66Description: Fixes Various Issues
    77
    8 diff -Naur iputils-s20071127.orig/Makefile iputils-s20071127/Makefile
    9 --- iputils-s20071127.orig/Makefile     2007-11-26 16:57:27.000000000 -0800
    10 +++ iputils-s20071127/Makefile  2009-01-15 22:02:32.000000000 -0800
    11 @@ -16,7 +16,7 @@
    12  CCOPT=-D_GNU_SOURCE -O2 -Wstrict-prototypes -Wall -g
    13  CFLAGS=$(CCOPT) $(GLIBCFIX) $(DEFINES)
    14  
    15 -IPV4_TARGETS=tracepath ping clockdiff rdisc arping tftpd rarpd
    16 +IPV4_TARGETS=tracepath ping arping
    17  IPV6_TARGETS=tracepath6 traceroute6 ping6
    18  TARGETS=$(IPV4_TARGETS) $(IPV6_TARGETS)
    19  
    20 @@ -25,7 +25,6 @@
    21  
    22  all: $(TARGETS)
    23  
    24 -
    25  tftpd: tftpd.o tftpsubs.o
    26  ping: ping.o ping_common.o
    27  ping6: ping6.o ping_common.o
    28 @@ -37,7 +36,6 @@
    29  rdisc_srv.o: rdisc.c
    30         $(CC) $(CFLAGS) -DRDISC_SERVER -o rdisc_srv.o rdisc.c
    31  
    32 -
    33  check-kernel:
    34  ifeq ($(KERNEL_INCLUDE),)
    35         @echo "Please, set correct KERNEL_INCLUDE"; false
    368diff -Naur iputils-s20071127.orig/arping.c iputils-s20071127/arping.c
    379--- iputils-s20071127.orig/arping.c     2007-11-26 16:57:27.000000000 -0800
    38 +++ iputils-s20071127/arping.c  2009-01-15 22:02:51.000000000 -0800
     10+++ iputils-s20071127/arping.c  2009-02-18 23:18:09.239954184 -0800
    3911@@ -168,12 +168,17 @@
    4012        if (start.tv_sec==0)
     
    5931        }
    6032        alarm(1);
     33diff -Naur iputils-s20071127.orig/doc/docbook2man-spec.pl iputils-s20071127/doc/docbook2man-spec.pl
     34--- iputils-s20071127.orig/doc/docbook2man-spec.pl      2007-11-26 16:57:27.000000000 -0800
     35+++ iputils-s20071127/doc/docbook2man-spec.pl   2009-02-18 23:18:09.239954184 -0800
     36@@ -428,7 +428,7 @@
     37        output ' ';
     38 
     39        if($_[0]->attribute('CHOICE')->value =~ /opt/i) {
     40-               output '[ ';
     41+               output '[';
     42        }
     43        bold_on();
     44 }
     45@@ -441,7 +441,7 @@
     46                font_off();
     47        }
     48        if($_[0]->attribute('CHOICE')->value =~ /opt/i) {
     49-               output '] ';
     50+               output ']';
     51        }
     52 }
     53 
    6154diff -Naur iputils-s20071127.orig/doc/Makefile iputils-s20071127/doc/Makefile
    6255--- iputils-s20071127.orig/doc/Makefile 2007-11-26 16:57:27.000000000 -0800
    63 +++ iputils-s20071127/doc/Makefile      2009-01-15 22:02:41.000000000 -0800
     56+++ iputils-s20071127/doc/Makefile      2009-02-18 23:18:09.239954184 -0800
    6457@@ -6,7 +6,7 @@
    6558 
     
    8174        @rm -rf $(MANFILES) $(HTMLFILES) iputils.html tmp.db2html tmp.db2man
    8275 
    83 diff -Naur iputils-s20071127.orig/doc/docbook2man-spec.pl iputils-s20071127/doc/docbook2man-spec.pl
    84 --- iputils-s20071127.orig/doc/docbook2man-spec.pl      2007-11-26 16:57:27.000000000 -0800
    85 +++ iputils-s20071127/doc/docbook2man-spec.pl   2009-01-15 22:02:19.000000000 -0800
    86 @@ -428,7 +428,7 @@
    87         output ' ';
    88  
    89         if($_[0]->attribute('CHOICE')->value =~ /opt/i) {
    90 -               output '[ ';
    91 +               output '[';
    92         }
    93         bold_on();
    94  }
    95 @@ -441,7 +441,7 @@
    96                 font_off();
    97         }
    98         if($_[0]->attribute('CHOICE')->value =~ /opt/i) {
    99 -               output '] ';
    100 +               output ']';
    101         }
    102  }
    103  
     76diff -Naur iputils-s20071127.orig/Makefile iputils-s20071127/Makefile
     77--- iputils-s20071127.orig/Makefile     2007-11-26 16:57:27.000000000 -0800
     78+++ iputils-s20071127/Makefile  2009-02-18 23:18:09.239954184 -0800
     79@@ -16,7 +16,7 @@
     80 CCOPT=-D_GNU_SOURCE -O2 -Wstrict-prototypes -Wall -g
     81 CFLAGS=$(CCOPT) $(GLIBCFIX) $(DEFINES)
     82 
     83-IPV4_TARGETS=tracepath ping clockdiff rdisc arping tftpd rarpd
     84+IPV4_TARGETS=tracepath ping arping
     85 IPV6_TARGETS=tracepath6 traceroute6 ping6
     86 TARGETS=$(IPV4_TARGETS) $(IPV6_TARGETS)
     87 
     88@@ -25,7 +25,6 @@
     89 
     90 all: $(TARGETS)
     91 
     92-
     93 tftpd: tftpd.o tftpsubs.o
     94 ping: ping.o ping_common.o
     95 ping6: ping6.o ping_common.o
     96@@ -37,7 +36,6 @@
     97 rdisc_srv.o: rdisc.c
     98        $(CC) $(CFLAGS) -DRDISC_SERVER -o rdisc_srv.o rdisc.c
     99 
     100-
     101 check-kernel:
     102 ifeq ($(KERNEL_INCLUDE),)
     103        @echo "Please, set correct KERNEL_INCLUDE"; false
     104diff -Naur iputils-s20071127.orig/ping6.c iputils-s20071127/ping6.c
     105--- iputils-s20071127.orig/ping6.c      2007-11-26 16:57:27.000000000 -0800
     106+++ iputils-s20071127/ping6.c   2009-02-18 23:18:09.239954184 -0800
     107@@ -414,7 +414,7 @@
     108                        fprintf(stderr, "ping: unknown iface %s\n", device);
     109                        exit(2);
     110                }
     111-               cmsg = (struct cmsghdr*)cmsgbuf;
     112+               cmsg = (struct cmsghdr*)(cmsgbuf+cmsglen);
     113                cmsglen += CMSG_SPACE(sizeof(*ipi));
     114                cmsg->cmsg_len = CMSG_LEN(sizeof(*ipi));
     115                cmsg->cmsg_level = SOL_IPV6;
     116@@ -486,7 +486,6 @@
     117        /*
     118         *      select icmp echo reply as icmp type to receive
     119         */
     120-
     121        ICMP6_FILTER_SETBLOCKALL(&filter);
     122 
     123        if (!working_recverr) {
    104124diff -Naur iputils-s20071127.orig/ping.c iputils-s20071127/ping.c
    105125--- iputils-s20071127.orig/ping.c       2007-11-26 16:57:27.000000000 -0800
    106 +++ iputils-s20071127/ping.c    2009-01-15 22:01:59.000000000 -0800
     126+++ iputils-s20071127/ping.c    2009-02-18 23:18:09.239954184 -0800
    107127@@ -249,7 +249,7 @@
    108128                        if (argc == 1)
     
    151171                        printf("Dest Unreachable, Bad Code: %d\n", code);
    152172                        break;
    153 diff -Naur iputils-s20071127.orig/ping6.c iputils-s20071127/ping6.c
    154 --- iputils-s20071127.orig/ping6.c      2007-11-26 16:57:27.000000000 -0800
    155 +++ iputils-s20071127/ping6.c   2009-01-15 22:02:11.000000000 -0800
    156 @@ -414,7 +414,7 @@
    157                         fprintf(stderr, "ping: unknown iface %s\n", device);
    158                         exit(2);
    159                 }
    160 -               cmsg = (struct cmsghdr*)cmsgbuf;
    161 +               cmsg = (struct cmsghdr*)(cmsgbuf+cmsglen);
    162                 cmsglen += CMSG_SPACE(sizeof(*ipi));
    163                 cmsg->cmsg_len = CMSG_LEN(sizeof(*ipi));
    164                 cmsg->cmsg_level = SOL_IPV6;
    165 @@ -486,7 +486,6 @@
    166         /*
    167          *      select icmp echo reply as icmp type to receive
    168          */
    169 -
    170         ICMP6_FILTER_SETBLOCKALL(&filter);
    171  
    172         if (!working_recverr) {
    173173diff -Naur iputils-s20071127.orig/ping_common.c iputils-s20071127/ping_common.c
    174174--- iputils-s20071127.orig/ping_common.c        2007-11-26 16:57:27.000000000 -0800
    175 +++ iputils-s20071127/ping_common.c     2009-01-15 22:01:42.000000000 -0800
     175+++ iputils-s20071127/ping_common.c     2009-02-18 23:18:09.239954184 -0800
    176176@@ -818,7 +818,8 @@
    177177        }
     
    189189 }
    190190-
     191diff -Naur iputils-s20071127.orig/rdisc.c iputils-s20071127/rdisc.c
     192--- iputils-s20071127.orig/rdisc.c      2007-11-26 16:57:27.000000000 -0800
     193+++ iputils-s20071127/rdisc.c   2009-02-18 23:18:31.745396284 -0800
     194@@ -240,14 +240,25 @@
     195 {
     196        int t;
     197        pid_t pid;
     198+       long open_max;
     199 
     200        if (trace)
     201                return;
     202+       if ((open_max = sysconf(_SC_OPEN_MAX)) == -1) {
     203+               if (errno == 0) {
     204+                       (void) fprintf(stderr, "OPEN_MAX is not supported\n");
     205+               }
     206+               else {
     207+                       (void) fprintf(stderr, "sysconf() error\n");
     208+               }
     209+               exit(1);
     210+       }
     211+
     212 
     213        if ((pid=fork()) != 0)
     214                exit(0);
     215 
     216-       for (t = 0; t < OPEN_MAX; t++)
     217+       for (t = 0; t < open_max; t++)
     218                if (t != s)
     219                        close(t);
     220 
    191221diff -Naur iputils-s20071127.orig/tracepath.c iputils-s20071127/tracepath.c
    192222--- iputils-s20071127.orig/tracepath.c  2007-11-26 16:57:27.000000000 -0800
    193 +++ iputils-s20071127/tracepath.c       2009-01-15 22:01:59.000000000 -0800
     223+++ iputils-s20071127/tracepath.c       2009-02-18 23:18:09.239954184 -0800
    194224@@ -318,9 +318,9 @@
    195225                base_port = atoi(p+1);
     
    204234        }
    205235        memcpy(&target.sin_addr, he->h_addr, 4);
    206 
    207 
  • patches/iputils-s20071127-manpages-2.patch

    rffe68ed r8d00c46  
    66Description: Provides the man pages (adding docbook2man with all its
    77             dependencies would be a major addition to the book, so I built it
    8              -once- on a completed system and saved the data). 
     8             -once- on a completed system and saved the data).
    99
    10 diff -Naur doc/arping.8 doc/arping.8
    11 --- doc/arping.8        1969-12-31 16:00:00.000000000 -0800
    12 +++ doc/arping.8        2009-02-18 20:52:34.000000000 -0800
     10diff -Naur iputils-s20071127.orig/doc/arping.8 iputils-s20071127/doc/arping.8
     11--- iputils-s20071127.orig/doc/arping.8 1969-12-31 16:00:00.000000000 -0800
     12+++ iputils-s20071127/doc/arping.8      2009-02-18 23:20:33.249183964 -0800
    1313@@ -0,0 +1,110 @@
    1414+.\" This manpage has been automatically generated by docbook2man
     
    122122+and the latest versions are  available in source form at
    123123+http://www.skbuff.net/iputils/iputils-current.tar.bz2.
    124 diff -Naur doc/clockdiff.8 doc/clockdiff.8
    125 --- doc/clockdiff.8     1969-12-31 16:00:00.000000000 -0800
    126 +++ doc/clockdiff.8     2009-02-18 20:52:38.000000000 -0800
     124diff -Naur iputils-s20071127.orig/doc/clockdiff.8 iputils-s20071127/doc/clockdiff.8
     125--- iputils-s20071127.orig/doc/clockdiff.8      1969-12-31 16:00:00.000000000 -0800
     126+++ iputils-s20071127/doc/clockdiff.8   2009-02-18 23:20:33.249183964 -0800
    127127@@ -0,0 +1,81 @@
    128128+.\" This manpage has been automatically generated by docbook2man
     
    207207+and the latest versions are  available in source form at
    208208+http://www.skbuff.net/iputils/iputils-current.tar.bz2.
    209 diff -Naur doc/pg3.8 doc/pg3.8
    210 --- doc/pg3.8   1969-12-31 16:00:00.000000000 -0800
    211 +++ doc/pg3.8   2009-02-18 20:52:42.000000000 -0800
    212 @@ -0,0 +1,86 @@
    213 +.\" This manpage has been automatically generated by docbook2man
    214 +.\" from a DocBook document.  This tool can be found at:
    215 +.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/>
    216 +.\" Please send any bug reports, improvements, comments, patches,
    217 +.\" etc. to Steve Cheng <steve@ggi-project.org>.
    218 +.TH "PG3" "8" "18 February 2009" "iputils-071127" "System Manager's Manual: iputils"
    219 +.SH NAME
    220 +pg3, ipg, pgset \- send stream of UDP packets
    221 +.SH SYNOPSIS
    222 +
    223 +\fBsource ipg\fR
    224 +
    225 +
    226 +\fBpg\fR
    227 +
    228 +
    229 +\fBpgset\fR \fB\fICOMMAND\fB\fR
    230 +
    231 +.SH "DESCRIPTION"
    232 +.PP
    233 +\fBipg\fR is not a program, it is script which should be sourced
    234 +to \fBbash\fR. When sourced it loads module \fIpg3\fR and
    235 +exports a few of functions accessible from parent shell. These macros
    236 +are \fBpg\fR to start packet injection and to get the results of run;
    237 +and \fBpgset\fR to setup packet generator.
    238 +.PP
    239 +\fBpgset\fR can send the following commands to module \fIpg3\fR:
    240 +.SH "COMMAND"
    241 +.TP
    242 +\fBodev \fIDEVICE\fB\fR
    243 +Name of Ethernet device to test. See
    244 +warning below.
    245 +.TP
    246 +\fBpkt_size \fIBYTES\fB\fR
    247 +Size of packet to generate. The size includes all the headers: UDP, IP,
    248 +MAC, but does not account for overhead internal to medium, i.e. FCS
    249 +and various paddings.
    250 +.TP
    251 +\fBfrags \fINUMBER\fB\fR
    252 +Each packet will contain \fINUMBER\fR of fragments.
    253 +Maximal amount for linux-2.4 is 6. Far not all the devices support
    254 +fragmented buffers.
    255 +.TP
    256 +\fBcount \fINUMBER\fB\fR
    257 +Send stream of \fINUMBER\fR of packets and stop after this.
    258 +.TP
    259 +\fBipg \fITIME\fB\fR
    260 +Introduce artificial delay between packets of \fITIME\fR
    261 +microseconds.
    262 +.TP
    263 +\fBdst \fIIP_ADDRESS\fB\fR
    264 +Select IP destination where the stream is sent to.
    265 +Beware, never set this address at random. \fBpg3\fR is not a toy,
    266 +it creates really tough stream. Default value is 0.0.0.0.
    267 +.TP
    268 +\fBdst \fIMAC_ADDRESS\fB\fR
    269 +Select MAC destination where the stream is sent to.
    270 +Default value is 00:00:00:00:00:00 in hope that this will not be received
    271 +by any node on LAN.
    272 +.TP
    273 +\fBstop\fR
    274 +Abort packet injection.
    275 +.SH "WARNING"
    276 +.PP
    277 +When output device is set to some random device different
    278 +of hardware Ethernet device, \fBpg3\fR will crash kernel.
    279 +.PP
    280 +Do not use it on VLAN, ethertap, VTUN and other devices,
    281 +which emulate Ethernet not being real Ethernet in fact.
    282 +.SH "AUTHOR"
    283 +.PP
    284 +\fBpg3\fR was written by Robert Olsson <robert.olsson@its.uu.se>.
    285 +.SH "SECURITY"
    286 +.PP
    287 +This can be used only by superuser.
    288 +.PP
    289 +This tool creates floods of packets which is unlikely to be handled
    290 +even by high-end machines. For example, it saturates gigabit link with
    291 +60 byte packets when used with Intel's e1000. In face of such stream
    292 +switches, routers and end hosts may deadlock, crash, explode.
    293 +Use only in test lab environment.
    294 +.SH "AVAILABILITY"
    295 +.PP
    296 +\fBpg3\fR is part of \fIiputils\fR package
    297 +and the latest versions are  available in source form at
    298 +http://www.skbuff.net/iputils/iputils-current.tar.bz2.
    299 diff -Naur doc/ping.8 doc/ping.8
    300 --- doc/ping.8  1969-12-31 16:00:00.000000000 -0800
    301 +++ doc/ping.8  2009-02-18 20:52:44.000000000 -0800
     209diff -Naur iputils-s20071127.orig/doc/ping.8 iputils-s20071127/doc/ping.8
     210--- iputils-s20071127.orig/doc/ping.8   1969-12-31 16:00:00.000000000 -0800
     211+++ iputils-s20071127/doc/ping.8        2009-02-18 23:20:33.249183964 -0800
    302212@@ -0,0 +1,332 @@
    303213+.\" This manpage has been automatically generated by docbook2man
     
    633543+and the latest versions are  available in source form at
    634544+http://www.skbuff.net/iputils/iputils-current.tar.bz2.
    635 diff -Naur doc/rarpd.8 doc/rarpd.8
    636 --- doc/rarpd.8 1969-12-31 16:00:00.000000000 -0800
    637 +++ doc/rarpd.8 2009-02-18 20:52:48.000000000 -0800
    638 @@ -0,0 +1,84 @@
    639 +.\" This manpage has been automatically generated by docbook2man
    640 +.\" from a DocBook document.  This tool can be found at:
    641 +.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/>
    642 +.\" Please send any bug reports, improvements, comments, patches,
    643 +.\" etc. to Steve Cheng <steve@ggi-project.org>.
    644 +.TH "RARPD" "8" "18 February 2009" "iputils-071127" "System Manager's Manual: iputils"
    645 +.SH NAME
    646 +rarpd \- answer RARP REQUESTs
    647 +.SH SYNOPSIS
    648 +
    649 +\fBarping\fR [\fB-aAvde\fR] [\fB-b \fIbootdir\fB\fR] [\fB\fIinterface\fB\fR]
    650 +
    651 +.SH "DESCRIPTION"
    652 +.PP
    653 +Listens
    654 +RARP
    655 +requests from clients. Provided MAC address of client
    656 +is found in \fI/etc/ethers\fR database and
    657 +obtained host name is resolvable to an IP address appropriate
    658 +for attached network, \fBrarpd\fR answers to client with RARPD
    659 +reply carrying an IP address.
    660 +.PP
    661 +To allow multiple boot servers on the network \fBrarpd\fR
    662 +optionally checks for presence Sun-like bootable image in TFTP directory.
    663 +It should have form \fBHexadecimal_IP.ARCH\fR, f.e. to load
    664 +sparc 193.233.7.98 \fIC1E90762.SUN4M\fR is linked to
    665 +an image appropriate for SUM4M in directory \fI/etc/tftpboot\fR.
    666 +.SH "WARNING"
    667 +.PP
    668 +This facility is deeply obsoleted by
    669 +BOOTP
    670 +and later
    671 +DHCP protocols.
    672 +However, some clients really still need this to boot.
    673 +.SH "OPTIONS"
    674 +.TP
    675 +\fB-a\fR
    676 +Listen on all the interfaces. Currently it is an internal
    677 +option, its function is overridden with \fIinterface\fR
    678 +argument. It should not be used.
    679 +.TP
    680 +\fB-A\fR
    681 +Listen not only RARP but also ARP messages, some rare clients
    682 +use ARP by some unknown reason.
    683 +.TP
    684 +\fB-v\fR
    685 +Be verbose.
    686 +.TP
    687 +\fB-d\fR
    688 +Debug mode. Do not go to background.
    689 +.TP
    690 +\fB-e\fR
    691 +Do not check for presence of a boot image, reply if MAC address
    692 +resolves to a valid IP address using \fI/etc/ethers\fR
    693 +database and DNS.
    694 +.TP
    695 +\fB-b \fIbootdir\fB\fR
    696 +TFTP boot directory. Default is \fI/etc/tftpboot\fR
    697 +.SH "SEE ALSO"
    698 +.PP
    699 +\fBarping\fR(8),
    700 +\fBtftpd\fR(8).
    701 +.SH "AUTHOR"
    702 +.PP
    703 +\fBrarpd\fR was written by
    704 +Alexey Kuznetsov
    705 +<kuznet@ms2.inr.ac.ru>.
    706 +It is now maintained by
    707 +YOSHIFUJI Hideaki
    708 +<yoshfuji@skbuff.net>.
    709 +.SH "SECURITY"
    710 +.PP
    711 +\fBrarpd\fR requires CAP_NET_RAWIO capability
    712 +to listen and send RARP and ARP packets. It also needs CAP_NET_ADMIN
    713 +to give to kernel hint for ARP resolution; this is not strictly required,
    714 +but some (most of, to be more exact) clients are so badly broken that
    715 +are not able to answer ARP before they are finally booted. This is
    716 +not wonderful taking into account that clients using RARPD in 2002
    717 +are all unsupported relic creatures of 90's and even earlier.
    718 +.SH "AVAILABILITY"
    719 +.PP
    720 +\fBrarpd\fR is part of \fIiputils\fR package
    721 +and the latest versions are  available in source form at
    722 +http://www.skbuff.net/iputils/iputils-current.tar.bz2.
    723 diff -Naur doc/rdisc.8 doc/rdisc.8
    724 --- doc/rdisc.8 1969-12-31 16:00:00.000000000 -0800
    725 +++ doc/rdisc.8 2009-02-18 20:52:53.000000000 -0800
     545diff -Naur iputils-s20071127.orig/doc/rdisc.8 iputils-s20071127/doc/rdisc.8
     546--- iputils-s20071127.orig/doc/rdisc.8  1969-12-31 16:00:00.000000000 -0800
     547+++ iputils-s20071127/doc/rdisc.8       2009-02-18 23:20:33.249183964 -0800
    726548@@ -0,0 +1,110 @@
    727549+.\" This manpage has been automatically generated by docbook2man
     
    835657+and the latest versions are  available in source form at
    836658+http://www.skbuff.net/iputils/iputils-current.tar.bz2.
    837 diff -Naur doc/tftpd.8 doc/tftpd.8
    838 --- doc/tftpd.8 1969-12-31 16:00:00.000000000 -0800
    839 +++ doc/tftpd.8 2009-02-18 20:52:57.000000000 -0800
    840 @@ -0,0 +1,85 @@
    841 +.\" This manpage has been automatically generated by docbook2man
    842 +.\" from a DocBook document.  This tool can be found at:
    843 +.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/>
    844 +.\" Please send any bug reports, improvements, comments, patches,
    845 +.\" etc. to Steve Cheng <steve@ggi-project.org>.
    846 +.TH "TFTPD" "8" "18 February 2009" "iputils-071127" "System Manager's Manual: iputils"
    847 +.SH NAME
    848 +tftpd \- Trivial File Transfer Protocol server
    849 +.SH SYNOPSIS
    850 +
    851 +\fBtftpd\fR \fB\fIdirectory\fB\fR
    852 +
    853 +.SH "DESCRIPTION"
    854 +.PP
    855 +\fBtftpd\fR is a server which supports the DARPA
    856 +Trivial File Transfer Protocol
    857 +(RFC1350).
    858 +The TFTP server is started
    859 +by \fBinetd\fR(8).
    860 +.PP
    861 +\fIdirectory\fR is required argument; if it is not given
    862 +\fBtftpd\fR aborts. This path is prepended to any file name requested
    863 +via TFTP protocol, effectively chrooting \fBtftpd\fR to this directory.
    864 +File names are validated not to escape out of this directory, however
    865 +administrator may configure such escape using symbolic links.
    866 +.PP
    867 +It is in difference of variants of \fBtftpd\fR usually distributed
    868 +with unix-like systems, which take a list of directories and match
    869 +file names to start from one of given prefixes or to some random
    870 +default, when no arguments were given. There are two reasons not to
    871 +behave in this way: first, it is inconvenient, clients are not expected
    872 +to know something about layout of filesystem on server host.
    873 +And second, TFTP protocol is not a tool for browsing of server's filesystem,
    874 +it is just an agent allowing to boot dumb clients.
    875 +.PP
    876 +In the case when \fBtftpd\fR is used together with
    877 +\fBrarpd\fR(8),
    878 +tftp directories in these services should coincide and it is expected
    879 +that each client booted via TFTP has boot image corresponding
    880 +its IP address with an architecture suffix following Sun Microsystems
    881 +conventions. See
    882 +\fBrarpd\fR(8)
    883 +for more details.
    884 +.SH "SECURITY"
    885 +.PP
    886 +TFTP protocol does not provide any authentication.
    887 +Due to this capital flaw \fBtftpd\fR is not able to restrict
    888 +access to files and will allow only publically readable
    889 +files to be accessed. Files may be written only if they already
    890 +exist and are publically writable.
    891 +.PP
    892 +Impact is evident, directory exported via TFTP \fBmust not\fR
    893 +contain sensitive information of any kind, everyone is allowed
    894 +to read it as soon as a client is allowed. Boot images do not contain
    895 +such information as rule, however you should think twice before
    896 +publishing f.e. Cisco IOS config files via TFTP, they contain
    897 +\fBunencrypted\fR passwords and may contain some information
    898 +about the network, which you were not going to make public.
    899 +.PP
    900 +The \fBtftpd\fR server should be executed by \fBinetd\fR
    901 +with dropped root privileges, namely with a user ID giving minimal
    902 +access to files published in tftp directory. If it is executed
    903 +as superuser occasionally, \fBtftpd\fR drops its UID and GID
    904 +to 65534, which is most likely not the thing which you expect.
    905 +However, this is not very essential; remember, only files accessible
    906 +for everyone can be read or written via TFTP.
    907 +.SH "SEE ALSO"
    908 +.PP
    909 +\fBrarpd\fR(8),
    910 +\fBtftp\fR(1),
    911 +\fBinetd\fR(8).
    912 +.SH "HISTORY"
    913 +.PP
    914 +The \fBtftpd\fR command appeared in 4.2BSD. The source in iputils
    915 +is cleaned up both syntactically (ANSIized) and semantically (UDP socket IO).
    916 +.PP
    917 +It is distributed with iputils mostly as good demo of an interesting feature
    918 +(MSG_CONFIRM) allowing to boot long images by dumb clients
    919 +not answering ARP requests until they are finally booted.
    920 +However, this is full functional and can be used in production.
    921 +.SH "AVAILABILITY"
    922 +.PP
    923 +\fBtftpd\fR is part of \fIiputils\fR package
    924 +and the latest versions are  available in source form at
    925 +http://www.skbuff.net/iputils/iputils-current.tar.bz2.
    926 diff -Naur doc/tracepath.8 doc/tracepath.8
    927 --- doc/tracepath.8     1969-12-31 16:00:00.000000000 -0800
    928 +++ doc/tracepath.8     2009-02-18 20:53:04.000000000 -0800
     659diff -Naur iputils-s20071127.orig/doc/tracepath.8 iputils-s20071127/doc/tracepath.8
     660--- iputils-s20071127.orig/doc/tracepath.8      1969-12-31 16:00:00.000000000 -0800
     661+++ iputils-s20071127/doc/tracepath.8   2009-02-18 23:21:37.765316105 -0800
    929662@@ -0,0 +1,94 @@
    930663+.\" This manpage has been automatically generated by docbook2man
     
    993726+with TTL of 2 was rejected at the first hop due to Path MTU Discovery.
    994727+.PP
    995 +Te last line summarizes information about all the path to the destination,
     728+The last line summarizes information about all the path to the destination,
    996729+it shows detected Path MTU, amount of hops to the destination and our
    997730+guess about amount of hops from the destination to us, which can be
     
    1022755+and the latest versions are  available in source form at
    1023756+http://www.skbuff.net/iputils/iputils-current.tar.bz2.
    1024 diff -Naur doc/traceroute6.8 doc/traceroute6.8
    1025 --- doc/traceroute6.8   1969-12-31 16:00:00.000000000 -0800
    1026 +++ doc/traceroute6.8   2009-02-18 20:53:04.000000000 -0800
     757diff -Naur iputils-s20071127.orig/doc/traceroute6.8 iputils-s20071127/doc/traceroute6.8
     758--- iputils-s20071127.orig/doc/traceroute6.8    1969-12-31 16:00:00.000000000 -0800
     759+++ iputils-s20071127/doc/traceroute6.8 2009-02-18 23:20:33.249183964 -0800
    1027760@@ -0,0 +1,42 @@
    1028761+.\" This manpage has been automatically generated by docbook2man
     
    1068801+and the latest versions are  available in source form at
    1069802+http://www.skbuff.net/iputils/iputils-current.tar.bz2.
     803
Note: See TracChangeset for help on using the changeset viewer.