HOWTO_GLFTPD

This article is still a Stub. You can help Gentoo-Wiki by expanding it.

1 Emerge glFTPd
2 Starting the server
3 Configure
4 Adding ZipScript Support

Emerge glFTPd

First, just emerge it:

emerge glftpd

Note: The ebuilds to date do not properly support installing in a jailed environment. If you want to do this you will need to either, create your own ebuild (in a portage overlay is recommended) or install and maintain glftpd yourself manually.

Starting the server

Read the documentation in /opt/glftpd/docs/
After you setup your conf file, edit the xinetd entry in /etc/xinetd.d/glftpd to enable, then start xinetd. ( Verify - only_from = localhost has been removed from your /etc/xinetd.conf, this is turned on as a security measure by default on the emergence of xinetd.)

/etc/init.d/xinetd start

To add glftpd to your services file and to create a cronjob for auto generating statistics, just run this command after you install:

ebuild /var/db/pkg/net-ftp/glftpd-2.00/glftpd-2.00.ebuild config

You also want to add which port glftpd should listen to. Add the following to /etc/services

glftpd     21/tcp

If your box is sitting behind a NAT/firewall/whatever you will probably want to take a look at the pasv_addr and pasv_ports configuration.

N.B if doesn't work , you'll have to change disable = yes to disable = no :) in your /etc/xinetd.d/glftpd

Configure

A SAMPLE configuration file for /etc/glftpd.conf might look like this:

File: /etc/glftpd.conf

## Site name
sitename_long G[:space:]E[:space:]N
sitename_short  GENTOO
email           root@localhost
master root

## Root Path
rootpath        /glftpd
datapath        /ftp-data

## Time Zone
timezone -6

login_prompt DEFAULT[:space:]HTTP[:space:]SERVER[:space:]READY
welcome_msg     /ftp-data/misc/welcome.msg      *
goodbye_msg     /ftp-data/misc/goodbye.msg      *
banner          /ftp-data/misc/banner

## TLS enforcements
userrejectsecure                !*
userrejectinsecure              !*
denydiruncrypted                !*
denydatauncrypted               !*
color_mode 0
stat_section    DEFAULT                 *               yes

## Sections Configuration and Permissions
# command <section> <flags>
upload          *                               *
resume          *                               *
makedir         /site/MOVIES/*                      *
makedir         /site/MUSIC/*                   *
makedir         /site/HOMEVIDEOS/*                      *
makedir         /site/SPEED/*                   *
makedir         /site/REQUEST/*/*/*             *
makedir         /site/REQUEST/*/                1 S
makedir         /site/PRIVATE/*                 1 S
makedir         /site/_STAFF/*                  1 S
download        *                               *
dirlog          *                               *
renameown       *                               *
rename          *                               1 S
filemove        *                               1 S
renameown       /site/*                         !8 *
nuke            *                               *
delete          /site/*                        1 S
deleteown       /site/*                         !8 *
nodupecheck     /site/SPEED/*
nodupecheck     /site/PRIVATE/*
nodupecheck     /site/_STAFF/*
nostats         /site/SPEED/*
creditcheck /site/SPEED 0 *

## Secure Settings
#secure_pass    a2..            *
#secure_ip      1               1               1               *

## Path Filters
path-filter     *       /ftp-data/misc/pathmsg          ^[-A-Za-z0-9_.()[:space:]]*$  ^\.  ^-
use_dir_size k /site/incoming
show_totals     *
show_diz        .message
msgpath /site/REQUEST/ /ftp-data/misc/msg.request *
free_space 20
max_users 30 5
total_users 300

# dupecheck     how many days?  ignore file case like Windows?
dupe_check      7               no
dl_incomplete 1
noretrieve      passwd  passwd- group   group-

## Minimum Home Dir
min_homedir     /site

#tagline                No[:space:]Tagline[:space:]Set

## Ignore Types (Usually accepted by ZIPSCRIPT)
ignore_type  *.[tT][xX][tT] *.[nN][fF][oO] [rR][eE][aA][dD][mM][eE] .message
ignore_type  *.[sS][fF][vV] *.[cC][rR][cC] *.[dD][iI][zZ]

## Message Configuration
oneliners       /ftp-data/misc/oneliners        7
requests        /ftp-data/misc/requests         10
lastonline      /ftp-data/misc/lastonline       10

## Nuke Configuration
nukedir_style   _NUKED-%N       2       50000
empty_nuke      25000
multiplier_max  20

## Private Groups Configuration
privgroup       SiTEOP           My[:space:]SiTEOP[:space:]Group
privgroup       STAFFPRE       Staff[:space:]Viewable[:space:]Pres
privpath /site/PRIVATE          =SiTEOP 1 S N
privpath /site/_STAFF           =SiTEOP 1 S N

############################################################################

## Additional Commands (Usually 3rd Party Scripts)
site_cmd RULES       TEXT    /ftp-data/misc/site.rules
site_cmd LOCATE      EXEC    /bin/locate.sh
site_cmd undupe      EXEC    /bin/undupe.sh
site_cmd AUTODELETE    EXEC  /bin/autodelete 1
custom-autodelete      *
custom-undupe          *

## Site Commands Configuration
# <command> <flags>
-addip           1 2 7 S
-adduser         1 2 7 C S
-change          1 7 S
-changeflags     1 S
-changeratio     1 2 7
-changesratio    1 7
-changehomedir   1 S
-chmod           1 S
-chgrp           1 7 S
-chgrp-priv      1 S
-chpass          1 S
-delip           1 2 7 S
-deluser         1 2 7 S
-dirs           !8 * S
-errlog          1 S
-flags          !8 * S
-gadduser        1 7 C S
-ginfo           2 H S
-give            G
-group          !3 * S
-groups          1 S
-grpadd          1 C S
-grpdel          1 S
-grplog          1 S
-grpnfo          1 2 S
-grpren          1 S
-grpstats        * S
-help           !8 * S
-info           !8 * S
-kick            D S
-kill            E
-logins          1
-misc           !8 * S
-msg            !8 * S
-msg*            1 S
-msg=            1 S
-msg{           !8 * S
-nuke            A N S
-onel           !8 * S
-oneladd        !8 * S
-predupe         1 7 S
-passwd         !8 * S
-purge           1
-readd           1 2 7 S
-renuser         1 7 S
-reqlog          1 A B 7 S
-request        !8 * S
-requestadd     !8 * S
-show            1 S
-stat           !8 * S
-stats          !8 * S
-swho            =STAFF 1 E S
-take            F
-syslog          1 =STAFF
-undupe          C N S
-unnuke          B N S
-update          1 S
-user           !8 * S
-users           H S
-usercomment     1 7 S
-userextra       1 2 7 S
-who            !8 * S
-wipe            1
-seen            1 S
-laston          1 S
-userothers      1 S
-traffic         1 7 S

Adding ZipScript Support

A zipscript adds support for verifying the contents of an upload by parsing a .sfv file, and checking against the files CRC-32 hash. This pretty much just makes sure the file is correct for that upload.