File: INSTALL

package info (click to toggle)
atftp 0.8.0-8
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 968 kB
  • sloc: ansic: 7,028; sh: 939; makefile: 36
file content (129 lines) | stat: -rw-r--r-- 4,027 bytes parent folder | download | duplicates (2)
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
128
129
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.
  libpcre2       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
    - or -
  git clone https://github.com/madmartin/atftp.git
                                (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 necessary options to atftpd 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 your boot sequence. The
  Debian package automatically does that. I'm not aware if any rpm based
  distribution includes 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
  AC_INIT 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/