TFTP on Mac OS X

I needed to upgrade the firmware in a NetGear Switch. That’s done by pointing the Netgear at a tftp server that has the new firmware image. Simple enough. But where to find a tftp server ? as usually Apple included it in Leopard…

I found how to activate it here : http://aplawrence.com/MacOSX/tftp.html

Here is a copy, just in case :

I thought they might reserve that for the Server version of Mac OS X, but no, there it was, man page and all. The man page warns:
This server should not be started manually; instead, it should be run using launchd(8) using the plist /System/Library/LaunchDaemons/tftp.plist. It may be started using the launchctl(1) load command.

Well, I don’t normally want tftpd running, so launchctl is the obvious choice. Fire that up with “sudo launchctl” and then type:

load -F /System/Library/LaunchDaemons/tftp.plist

Why “-F”? Because by default, the tftp.plist contains:

<key>Disabled</key>
<true/>

If you leave out -F, launchctl will say “nothing found to load”, which isn’t very helpful – what it really should say is “I can’t load this because it’s presently disabled”. The -F forces it to ignore that little impediment..if you don’t use sudo, it will say:

bind(): Permission denied

Assuming you had neither problem, some fraction of a second later, tftpd is ready to run (well, LaunchD is ready to listen for tftpd requests and start it up, but you get the idea). Where’s your tftpd directory? Not in /tftpboot where you might expect to find it on a Unix system.. the tfpt.plist actually specifies the program arguments, and by default it looks like this:

<key>ProgramArguments</key>
<array>
<string>/usr/libexec/tftpd</string>
<string>-i</string>
<string>/private/tftpboot</string>
</array>

So “/private/tftpboot” is where you want to put the files to be accessed. When you are ready to shut tftp off, just tell launchctl:

unload /System/Library/LaunchDaemons/tftp.plist

If you did want tftpd to run all the time, you would use

load -w /System/Library/LaunchDaemons/tftp.plist

That changes the “Disabled” key so that the file now has this:

<key>InitGroups</key>
<true/>
“tftpd” would now be enabled at each boot. Should you later change your mind, “unload -w /System/Library/LaunchDaemons/tftp.plist” will put things back as they were.

Leave a Reply

Your email address will not be published. Required fields are marked *