-
Notifications
You must be signed in to change notification settings - Fork 0
/
INSTALL
128 lines (91 loc) · 3.91 KB
/
INSTALL
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
The simplest way to install atftp is using either the Debian package
or one provided by your distribution if any. If you need to install
atftp from source, here's the procedure.
1) Needed libraries
----------------
libpthread Needed for the atftpd server.
libwrap Optional if you need host access control.
libpcre Optional if you want to perform file name
substitution. See README.PCRE.
libreadline Optional. Used by the atftp client for better command
line input and history.
2) Needed tools
------------
At least, you need these programs:
make
gcc
You may also need these:
git
automake (tested using version 1.7 and 1.8)
autoconf (tested with version 2.50)
3) How to compile
--------------
3.1) From tarball
./configure [options] (this generates makefiles)
make (actually build the programs)
su -c 'make install' (install files (default location is /usr)
3.2) From git checkout
git clone git://atftp.git.sourceforge.net/gitroot/atftp/atftp
(this creates a clone of the git repository)
cd atftp (change into the newly created subdir)
./autogen.sh (this generates the configure script)
./configure [options] (this generate makefiles)
make (actually build the programs)
su -c 'make install' (install files (default location is /usr)
4) How to start atftpd server
--------------------------
4.1) Using the inetd super server
Add this line to the /etc/inetd.conf file:
tftp dgram udp wait nobody /usr/sbin/tcpd /usr/sbin/in.tftpd /tftpboot
You can add needed option to atftpd as you which at the end of the
line.
4.2) Using xinetd
Add this to the /etc/xinetd.conf file, or create /etc/xinetd.d/tftp-udp file
with the following content:
# tftp-udp
service tftp
{
id = tftp-udp
disable = no
socket_type = dgram
protocol = udp
wait = no
user = nobody
nice = 5
server = /usr/local/sbin/atftpd
server_args = /tftpboot # add other server argument as necessary
}
# eof
4.3) As a stand alone server from init.d scripts
You need to add the proper init script in you boot sequence. The
Debian package automatically does that. I'm not aware if any rpm based
distribution include init scripts. If you absolutely need this on rpm
based distribution or on other systems, start with the Debian
scripts and adapt it to your particular system.
5) Information for future developers of atftp
------------------------------------------
5.1) Cleanup the source directory
After some work and compiling in the package sources, you can delete the
files produced from the compilers by running
make clean
Note: The "Makefile" necessary for this operation is only available
if the "./configure" command has been run at least once.
More cleanup is done with the command
make distclean
This removes all files produced by "./configure" - which includes the
Makefile. If you want to use "make <target>" again, you need to run
"./configure" before.
5.2) Create a release tarball
If a new release should be created, first edit configure.ac and change the
AM_INIT_AUTOMAKE parameter to the new release version number.
Then execute "./autogen.sh" and "./configure". After that,
make distcheck
creates a tar archive with the requested version number, unpacks it immedia-
tely in a temporary subdirectory, compiles the package and executes the
test.sh suite and cleans all that up. If you get the final message
=============================================
atftp-<version> archives ready for distribution:
atftp-<version>.tar.gz
=============================================
then you can upload atftp-<version>.tar.gz to
http://sourceforge.net/projects/atftp/files/