AEFTPD(1p)

📦 version 0.20, in ubuntu stonking

🎀 AEFTPD(1p) — the FTP daemon page, bestie edition 🎀

okay so first things first: this is the manual page for aeftpd, and it lives in section 1p of the manual (that's the "user contributed perl docs" corner of the world). it's giving server admin realness, it's giving ✨daemon energy✨, and honestly? we're obsessed. let's get into it.

✨ NAME ✨

aeftpd — FTP Server 💅

🌸 VERSION 🌸

version 0.20

🦋 SYNOPSIS 🦋

so here's the whole vibe, verbatim, no cap:

% aeftpd [ --port port ]
         [ --hostname hostname ]
         [ --inet ]
         [ --stderr path ]
         [ --context context ]
         [ --chroot ]
           --pam service |
           --cred user:pass |
           --cred random |
           --auth class [ --auth key=val ]
         [ --verbose ]
% aeftpd --version
% aeftpd --help

like… yes, you have to pick an auth thing. it's the main character of the command line. 🫶

💖 DESCRIPTION 💖

this program starts an FTP daemon using the perl library AnyEvent::FTP::Server. that's it, that's the whole plot. iconic.

⭐ OPTIONS ⭐

every single one, coming right up. nothing skipped, we don't do that here.

  • --port port — the TCP port to listen to 🎧
  • --hostname hostname — the hostname or IP address to listen on 🏠
  • --inet — run in inet mode. by default aeftpd runs as a single process in standalone mode. if you use this option, you can run aeftp from inetd, xinetd or a similar daemon. here's a line for /etc/inetd.conf which was tested on Debian Wheezy, and may work for you if your operating system supports PAM and you have Authen::Simple::PAM installed:
ftp stream tcp nowait root /usr/sbin/tcpd aeftpd --inet --stderr /tmp/aeftp.log --pam login
  • --stderr path — redirect stderr from the daemon to the file specified by the given path 📝
  • --chroot — use chroot to restrict the user to only his home directory once he has logged in. this option requires the chroot function, which is supported by Perl on most UNIX and UNIX like operating systems 🔒
  • --cred [ user:pass | random ] — allow authentication with the given username and password. if you specify random then a randomly generated username and password will be used 🎲
  • --auth class — specify a Authen::Simple class to use for authentication. you should NOT include the Authen::Simple prefix when specifying the class (that is, use PAM instead of Authen::Simple::PAM) 🚨
  • --auth key=val — specify an argument to pass into the chosen Authen::Simple object 🔧
  • --pam service — use PAM for authentication. this option is simply a shortcut. this:
% aeftpd --pam login

is the same as

% aeftpd --auth PAM --auth service=login
  • --verbose — print all FTP commands and their responses to stderr 🗣️
  • --context context — set the default context. the default is FSRW
  • --version — print out the AnyEvent::FTP version to stdout and exit 👋
  • --help — display the usage for this command 🙋

👑 AUTHOR 👑

Author: Graham Ollis <plicease@cpan.org>

Contributors:

  • Ryo Okamoto
  • Shlomi Fish
  • José Joaquín Atria

the squad. the collaborators. the legends. 🌈

This software is copyright (c) 2017-2022 by Graham Ollis.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. periodt. 💅

and that's the whole page bestie!! this one shipped with perl v5.40.1, dated 2026-02-16, and yeah it's still filed under AEFTPD(1p) like the queen it is. go run a daemon, hydrate, and stay slay 🦋💖✨

📦 where this page comes from