Add IP to user.
site addip toto 127.*This will allow user "toto" to connect from all ip beggining by "127."
To check ident when user is connecting, just add 'ident@' before the ip.
site addip toto foobar@127.*
If you are a gadmin, you can only change users from your group.
Add a user, with and no allowed ip. If group is specified, user will be added to the group (Note: only siteops can add users to a different group than their own group), otherwise the main group of the current user will be used.
User's homedir is determined using the value 'default_home' of the group. A default ratio is also set (1:3).
You MUST add an ip after.
ex: site adduser toto mypassword anonymous
If you are a gadmin, you can only add users from your group.
Operations on backend. 'command' can be one of :
close: unload 'backend'. If you have no backend, or if backend is in use, the server will be in an unstable state !
commit: commits change to backend in a synchronous way. After the command, you can shutdown or reload the server in a safe way
init: loads a new backend. NO verifications are made - be sure of what you are doing !
reload: close and init a backend, without commiting it. This command allows you to modify backend and reload modifications. Modifications should be made carefully, especially if users are loggued !
site backend commit plaintextThis is a DANGEROUS command
Change access rights on a file or directory for a specific user/group
Always prefer the site chmod command when you can
Change a field for a user.
Field | Description |
name | This will change the user's login name. The modification is immediate, even if user is currently loggued ! |
pass | This will change the user's password. This is similar to the site chpass command |
homedir | This will change the user's homedir. |
tagline | User's tagline. This is similar to the site tagline command |
group | Add / remove user from group. site chgrp command is better, as it can handle several group changes in one command |
max_idle | Set the maximum idle time for this user. See the site idle command |
perms | Set user's default perms (All: 0xffffffff, retrieve only: 0x03). This command will change |
flags | Set user's flags. This is similar to the site flags command For flags info see Flags Table. You can use '+flag' or '-flag' to add or remove flags, otherwise it will replace all existing flags. |
max_ul | Upstream bandwidth control in bytes/sec (0 = Unlimited). |
max_dl | Same but for downloads. |
ratio | User ratio |
num_logins | Maximum number of simultaneous logins. |
If you are a gadmin, you can only change users from your group (except homedir, flags, and groups).
For each group in list, add user to group or removes it if he/she already belongs to group.
site changegrp toto guest admin
This will add user "toto" to group "admin" and remove "toto" from group "guest", if user had group "guest" before.
Check permission for a specific user.
site checkperm toto my_file RIGHT_RETR
Table 3-1. Permissions
Permission | Description |
RIGHT_LIST | User can list files (directory) |
RIGHT_RETR | User can retrieve file |
RIGHT_STOR | User can upload file (directory) or can overwrite (file) |
RIGHT_CWD | User can go into this directory |
RIGHT_RNFR | User can rename file |
RIGHT_MKDIR | User can create dir at current location |
RIGHT_RMDIR | User can delete dir at current location |
Change file group
site chgrp admin dir1This will give dir1 to group "admin", but not its content !
Change permissions for "user" on files. Permissions are unix-like.
site chmod toto rwx dir1is equivalent to
site chmod toto 755 dir1
Change file owner
site chown toto dir1This will give dir1 to user "toto", but not its content !
Change user password.
ex: site chpass toto newpassword
This will change the password to 'newpassword' for the user 'toto'.
% denotes any password
If you are a gadmin, you can only change users from your group.
Change user ratio
ex: site chratio toto 3
This will change the ratio to 1:3 for the user 'toto'.
A ratio of 0 means no ratio (leech access).
If you are a gadmin, you can only change users from your group. To give a ratio of 0 you need to have a free leech slot. If a gadmin sets back a ratio from 0 to a non-zero value, he gets back his leech slot.
Close server for everyone except siteops.
This is mainly designed to temporarily close server for maintenance.
See the site reopen command
Toggle use of color in server replies.
WARNING : This can kill many clients (especially graphical ones) !
Delete ip from user. You can also use the ip number (given by "site who").
site delip toto 127.0.0.1This will remove the ip "127.0.0.1" from user "toto".
site delip toto 1This will remove ip #1 in ip list from user "toto"
"ip" can contain wildcards, but they are not interpreted.
site delip toto 127.*This will remove the exact ip "127.*", and not all ip beginning by "127."
If an user has no authorized ip, he cannot login
If you are a gadmin, you can only change users from your group.
Delete a user, may be readded with site READD
site deluser toto
This will set the flag DELETED (D) for the user 'toto'. In order to fully delete this user you will need to do a 'site purge'
If you are a gadmin, you can only change users from your group.
Display a user's flags.
site flags
This will show your own flags
site flags toto
This will show flags of user toto
Table 3-2. Flags
Flagname | Flag | Description |
SITEOP | O | User is siteop |
GADMIN | G | User is groupadmin of his/her first public group* |
DELETED | D | User is deleted |
IDLER | I | User is allowed to idle forever |
SEE_IP | s | User is allowed to see other's ip |
SEE_HOME | t | User is allowed to see other's home |
HIDDEN | H | User will not appear in site who |
TLS | k | User will be forced to use TLS/SSL connections |
TLS_DATA | K | User will be forced to use TLS/SSL data connections |
ANONYMOUS | A | User cannot make any modifications |
COLOR | 5 | Enable the use of color (toggle with site color) |
If a second argument is provided, it will be used to change flags for user. You can use '+flag' or '-flag' to add or remove flags, otherwise it will replace all existing flags.
*NOTE* If you have flag O then you do NOT want flag G
If you are a gadmin, you can only change users from your group.
Show free space in the current dir.
Show detailed info on a group.
site gsinfo idlers
This will show detailed info (members, uploaded/downloaded files) on group 'idlers'
Gives credits to user (Taken from you)
site give toto 100000
This will give around 100mb of credits to user 'toto'
List groups and shows detailed informations
Add a group. (Note: only siteops can add groups).
Group's defaultpath is determined using the value 'default_home' of your group, or your homedir if you have no group.
You MUST check all values after.
ex: site grpadd newgroup
Add IP to a group.
site grpaddip idlers 127.*This will allow users from group "idlers" to connect from all ip beggining by "127."
To check ident when user is connecting, just add 'ident@' before the ip.
site grpaddip idlers foobar@127.*
Change a field for a group.
Field | Description |
name | This will change the group name. The modification is immediate, even if a user is currently loggued ! |
tagline | Group's tagline. |
homedir | This will change the group's default homedir. |
max_idle | Set the maximum idle time for this group. |
perms | Set group's default perms (All: 0xffffffff, retrieve only: 0x03). This command will change |
max_ul | Upstream bandwidth control in bytes/sec (0 = Unlimited). |
max_dl | Same but for downloads. |
ratio | Group default ratio |
num_logins | Maximum number of simultaneous logins. |
Delete a group
site grpdel idlers
Unlike site deluser, the deletion is definitive (you can't readd deleted groups, so be carefull).
Delete ip from group. You can also use the ip number (given by site gsinfo).
site grpdelip idlers 127.0.0.1This will remove the ip "127.0.0.1" from group "idlers".
site grpdelip idlers 1This will remove ip #1 in ip list from group "idlers"
"ip" can contain wildcards, but they are not interpreted.
site grpdelip idlers 127.*This will remove the exact ip "127.*", and not all ip beginning by "127."
Kill all users from a group
ex: site grpkill idlers
This will kick all members of the group 'idlers'.
User running the command will not be kicked even if member of the group.
Change group ratio
ex: site grpratio idlers 3
This will change the ratio to 1:3 for the group 'idlers'.
A ratio of 0 means no ratio (leech access).
Group ratio is used only when adding users in this group
Renames a group
ex: site grpren ftp new_ftp
This will change the group name 'ftp' to 'new_ftp'.
All users in group 'ftp' will now automatically belong to 'new_ftp'.
Show system info on a group.
site gsinfo idlers
This will show system info (default home, ratio) on group 'idlers'
Display helpscreen.
This sets your idle-time (the amount of time you can be online without doing something) for this session only (unless commited to backend). Max idle-time is 7200 sec.
site idle
This will show your current idle-time settings
site idle 3600
This will set your idle-timeout to 3600 sec.
"site idle 0" for users that have the idle flag (I) will allow them to idle forever.
Tells the sitebot to invite irc_nick on sitebot's channel.
Kick a user off the site.
site kick toto
This will kill all connections for the user 'toto'
Kill a PID
site kill 345
This will kill pid #345 (if it belongs to a wzdftpd user)
Create or removes symbolic links.
Both paths are given relative to the current user homedir.
NOTE: if the underlying filesystem supports symbolic links, they will be used, otherwise an abstraction layer is provided to have similar behaviour. Most unix filesystem supports symbolic links.
Manage directory message file
site msg show
Manage command permissions
site perm show site
This will show permissions for all site commands
Remove deleted users, site READD will not work for purged users.
If run without arguments, purge ALL deleted users
site purge toto
This will erase definitively user 'toto' (only if it has been deleted).
If you are a gadmin, you can only purge users from your group (that is, if you are giving access to this command in your config file).
Re-add a user.
site readd toto
This will remove the DELETED flag for user 'toto'
If you are a gadmin, you can only change users from your group.
Reload config file.
site reload
This will reload config file (wzd.cfg by default)
This is a DANGEROUS command
Re-open server for everyone.
Usefull after server has been closed with the site close command
Display local site rules.
Shutdown the server. Users that are currently loggued are not kicked, and your connection is not closed. You will need to start the server on the machine.
Changes you current user ID, resulting in a user change. This is similar to the 'su' command on unix systems. This allow becoming a user without knowing his password and logging in as this user.
site su foobar
This will change your ID to become user foobar.
If you are a gadmin, you can only become a user from your group.
Unlike other ftpds, this is NOT emulation, you are really becoming the other user, and there is no way to turn back identity. This is why, by security, this command is restricted to siteops, and will be logged every time you use it.
Shows detailed information about users online.
Shows/Sets your tagline
site tagline
This will show your current tagline
site tagline my new tagline
This will set your tagline to 'my new tagline'
If you are a gadmin, you can only change users from your group.
Removes credits from user (this is not the opposite from site give, you are NOT granted from the same account)
site take toto 100000
This will remove 100mb of credits from user 'toto'
Show detailed informations for a user.
List users and shows their group and detailed informations
Display server uptime.
Display server version.
Show users online.
Delete file (or directory). The difference with the standard removal functions is that the uploader does not loose credits and upload stats for the removed file.
To remove a directory and all subdirectories recursively, you can specify the -r option.
Be carefull, this command is quite dangerous !
Gives CRC32 Checksum of the file
xcrc "1mB"
This will return the crc32 of the file
xcrc "1mB" 100 1500
This will return the crc32 of the file, only on the portion starting at 100, and on 1500 bytes.
xcrc "1mB" 100 1500 FE7F5BCE
This will do the same thing but with a starting crc of 0xFE7F5BCE
Gives MD5 Checksum of the file
xmd5 "1mB"
This will return the MD5 of the file
xmd5 "1mB" 100 1500
This will return the MD5 of the file, only on the portion starting at 100, and on 1500 bytes.