README
1
2 LINUX NET DISTRIBUTION
3
4 Version 0.03
5
6 Fred N. van Kempen <waltje@uwalt.nl.mugnet.org>
7
8 Ross Biro <bir7@leland.stanford.edu>
9
10 Rick Sladkey <jrs@world.std.com>
11
12
13The NET distribution for LINUX is a complete set of executables,
14setup files, documentation and all the sources needed to rebuild
15the package. It is intended as the `official' NET package for
16the LINUX operating system, mostly to get rid of the current
17situation of total chaos in NETland...
18
19The first distribution has been done by Ross Biro, who wrote the
20TCP/IP stuff in the LINUX kernel to start with. As usual, the
21Berkeley BSD UNIX software was taken as a base for this distri-
22bution. Several `foreign' programs are included as well.
23
24To make porting easy, a library has been built which contains the
25modules from BSD UNIX that were missing in the LINUX library. They
26are declared in the header files that go with it. These files
27must be copied to the /usr/net/include/bsd directory and a symbolic
28link must be created from /usr/include/bsd.
29
30This is a compliation of some net sources, mostly from bsd-net2. I
31have made an effort to get the programs to compile with few or no
32changes except for a new Makefile. This resulted in a bsd include
33directory and a bsd library. Take a look at them to see what types of
34things are required to get BSD sources to compile correctly without
35changes. Some of the tricks are pretty ugly. Please don't laugh...
36
37Everything should compile straight with the libc-4.2 libraries. Just
38type "make" in this directory. You may have to do some surgery on
39libbsd/libbsd.a to get things to compile with libc-4.1.
40
41Notes
42=====
43
44bsd: The directory "bsd" contains include files that, for the most
45part, just overload include files of the same name from /usr/include.
46It provides some BSD things like "union wait" and others.
47
48libbsd: The libbsd.a archive is a small library of some functions that
49are not in our libc as well as some emulation support functions
50referenced in the bsd header files. Notably, it includes a
51half-decent transparent sgtty emulation package.
52
53inetd: Works. Only pathname changes.
54
55ftp: Works. No changes.
56
57ftpd: I find that ls with ftpd doesn't work very often. It reports
58"Transport endpoint already connected" 9 times out of 10. I think
59this is a bug in the kernel which will be fixed in a subsequent
60release. There was a memory allocation bug in the original source,
61look for "#ifdef linux". Also, the shadow password stuff is not
62compiled in as I haven't had a chance to mess with that.
63
64telnet: Works but see the man page for info about the .telnetrc file
65and other new options. This is a really nice telnet with rlogin
66emulation and lots of other stuff not present in older telnets. The
67original Linux port of telnet/telnetd was done by Pete Chown.
68
69telnetd: Several people have reported that the 0.1 telnetd sometimes
70disconnected before getting to the login prompt. The 0.2 version
71omits the vhangup stuff which might have been causing the problem.
72Also fixed is the problem with /etc/wtmp not being updated correctly
73on logout. It was trying to use /var/adm/wtmp.
74
75finger: Works. One minor change for POSIX timezone handling.
76
77fingerd: Works, no changes.
78
79ping: Works, no changes. Must be suid to root.
80
81named: Works. A few changes for pathnames and net device
82configuration stuff.
83
84nslookup: Works, but it's fussier than older nslookups about named
85being setup correctly. Note the -I option is needed for flex -- that
86was a tough one to find. No changes.
87
88named-xfer: Not tested.
89
90rcp: Works. Must be suid to root.
91
92rsh: Works. Must be suid to root.
93
94rshd: Works.
95
96rlogin: Works OK but needs more testing. This one depends pretty heavily
97on the sgtty emulation in libbsd which is not complete yet. There is
98an odd timing bug with select and termio settings. Look for "sleep(1)"
99to see what I mean. Must be suid to root.
100
101rlogind: Works with the URGENT stuff commented out. There was a nasty
102bug with shared libraries because environ was redefined.
103
104talk: Works. This is the new byte-order independent talk, not the old
105talk that, e.g., native SunOS uses. The old one wouldn't work with
106them anyway. Not the fault of Linux. Includes a one line patch for a
107bug in our curses and another for a bug in the original source dealing
108with select.
109
110ntalkd: Works. No changes.
111
112tftp: Works. No changes.
113
114tftpd: Works. No changes.
115
116Sample Entries for inetd.conf
117=============================
118telnet stream tcp nowait root /usr/etc/inet/telnetd telnetd
119ntalk dgram udp wait root /usr/etc/inet/ntalkd ntalkd
120ftp stream tcp nowait root /usr/etc/inet/ftpd ftpd -l
121finger stream tcp nowait root /usr/etc/inet/fingerd finger
122shell stream tcp nowait root /usr/etc/inet/rshd rshd
123login stream tcp nowait root /usr/etc/inet/rlogind rlogind
124tftp dgram udp wait root /usr/etc/inet/tftpd tftpd
125
126Rick Sladkey
127jrs@world.std.com
128
README.HLU
1HJ,
2
3This is the source of the current "libbsd.a" as I have it
4next to the libc 4.3.2. You can safely ignore the blahblah
5in the other README- throw it away after you added this stuff
6to the rest of libc...
7
8I think the best way to add this to the standard set of C
9libraries is to keep it in the form of a single non-sharable
10library (/usr/lib/libbsd.a) that only gets linked if the user
11asks for it by typing "-lbsd". I don't know if this is pos-
12sible, but I don't think it should be added to the "shared"
13image, because it might cause other problems in that case...
14
15Fred.
16