Difference between revisions of "TFTP"

From ArchWiki
Jump to: navigation, search
(Configuration: Merge info from Network Installation Guide.)
(Configuration: cleanup)
Line 8: Line 8:
  
 
== Configuration ==
 
== Configuration ==
The configuration for tftpd is in {{ic|/etc/conf.d/tftpd}}
 
  
The default configuration is:
+
Create a copy of the {{ic|tftpd.service}} unit, and modify {{ic|ExecStart}} with the appropriate directory to use as the tftp root.
#
+
# Parameters to be passed to TFTPD
+
#
+
TFTPD_ARGS="-l -s /srv/tftp/"
+
  
{{ic|-s /srv/tftp/}} set ftpd root directory to {{ic|/srv/tftp/}}. The directory {{ic|/srv/tftp}} is created automatically when {{Pkg|tftp-hpa}} is installed.
+
{{hc|# vim /etc/systemd/system/tftpd.service|2=
 +
[Unit]
 +
Description=hpa's original TFTP daemon
  
For systemd configuration, {{ic|/usr/lib/systemd/system/tftpd.service}} is used:
+
[Service]
 
+
ExecStart=/usr/sbin/in.tftpd -s /srv/tftp/
[Unit]
+
StandardInput=socket
Description=hpa's original TFTP daemon
+
StandardOutput=inherit
+
StandardError=journal}}
[Service]
+
ExecStart=/usr/sbin/in.tftpd -s /srv/tftp/
+
StandardInput=socket
+
StandardOutput=inherit
+
StandardError=journal
+
 
+
Copy the tftp unit files in {{ic|/usr/lib/systemd/system}} to {{ic|/etc/systemd/system}}; the former gets overwritten when systemd is updated. The [[systemd]] article talks in more detail about customizing unit files.
+
 
+
For a complete list of parameters:
+
$ man in.tftpd
+
  
 
== Run ==
 
== Run ==

Revision as of 22:25, 2 February 2013

The Trivial File Transfer Protocol (TFTP) provides a minimalistic means for transferring files. It is generally used as a part of PXE booting or for updating configuration and firmware on devices which have limited memory such as routers and printers.

This article describes how to set up a tftpd server under Arch Linux using the tftp-hpa package.

Installation

Install the package tftp-hpa which can be found in the official repositories.

Configuration

Create a copy of the tftpd.service unit, and modify ExecStart with the appropriate directory to use as the tftp root.

# vim /etc/systemd/system/tftpd.service
[Unit]
Description=hpa's original TFTP daemon

[Service]
ExecStart=/usr/sbin/in.tftpd -s /srv/tftp/
StandardInput=socket
StandardOutput=inherit
StandardError=journal

Run

Systemd

To start the daemon at boot, run:

# systemctl enable tftpd.socket


To start the daemon manually (You must respect this order):

# systemctl start tftpd.socket
# systemctl start tftpd.service


To stop the daemon manually (You must respect this order):

# systemctl stop tftpd.socket
# systemctl stop tftpd.service

Sysvinit

To start the daemon at boot, add tftpd to the DAEMONS array in /etc/rc.conf.

To start the daemon manually:

# /etc/rc.d/tftpd start

To start the daemon without a configuration file:

# /usr/sbin/in.tftpd -l -s path/to/folder/to/export

Troubleshooting

tftpd startup fails if ipv6 is disabled

If tftpd startup fails without leaving error messages, it might be because ipv6 is disabled and you are not explicitly telling tftpd not to use ipv6. You can make tftpd start by enabling ipv6 or by telling tftpd to only use ipv4, adding the '-4' switch to /etc/conf.d/tftpd

/etc/conf.d/tftpd
TFTPD_ARGS="-l -4 -s /srv/tftp/"