SITE COMMANDS REFERENCE revision 2.4

Site commands are sets of extended commands that can be issued by a ftp client, and they are not defined in RFC. However, they are supported by various ftp servers, and different servers ususally have different supprted site commands. The RaidenFTPD also supports many site commands to extend the functionalities of a standard Ftp server. Here are a list of commands and user guides for the commands that RaidenFTPD supports .

where to enter the site command ?

if you use command line ftp.exe : type quote site xxx

if you use flashfxp : menu -> commands -> raw command

if you use smartftp : menu -> view -> show panes -> command line

if you use CuteFTP Pro : menu -> tools -> enter FTP command

the server will add the user [username] to the server with a password of [password] and group [groupname]. The user will default to a ratio of 1:4, with a max login = 2, and the level of guest. Root users can add users to other groups. Super can add users to his own group.

[note] site adduser [username] [password] will also work. The groupname will default to the issuer's group.

ex: site adduser john hdsa89 homies

the server will remove this user from the user accounts.

ex: site deluser john

the server will set account expiration date for user or remove the expiration date from user account

ex: site expire john 2002/10/25 <- set user account john's expiration date to 2002/10/25

ex: site expire john 0 <- remove expiration date from user account john

the server will add the [ipaddress] to the allowing list for user [username]

ex: site addip john 163.95.1.54

the server will remove the [username@ipaddress] from the IP allowing list

[note]site delip [ipaddress] , also works , to remove IP for all users

ex: site delip john 163.95.1.54 , site delip 163.95.1.54

the server will Change User's Group name , the group name should not contain any space character

ex: site chgrp root rootgroup

the server will change and update the password for specified user , please note that the root level users can change anyone's password and the super or the normal level users can only change their own password .

ex: site chpass john mypassaa

the server will Change User's ratio , note that the Ratio factor can be between 0-9 , 0 means unlimited.and 1-9 means 1:1-1:9 (UL/DL)

ex: site chratio john 3

will make john's ratio 1:3 (UL/DL)

by sending this command by Ftp client to RaidenFTPD , the server will Change User's level , note that the level factor can be between 0-3 , where 0 is root , 1 is super , 2 is normal and 3 is guest level.

ex: site chlvl john 1

will make john's level super

by sending this command by Ftp client to RaidenFTPD , the server will Change User's max logins per account , note that the Logins factor can be between 0-9

ex: site chlogin john 5

will make john's to have 5 max logins

the server will change your tagline (comment) to your user account , a comment is a short description to this user

ex: site tagline I LIKE RAIDENFTPD

the server will Disable an user's account (the account is still there) . Super users can disable users in their group only

ex: site disable john

the server will enable an user's account . Super users can enable users in their group only

ex: site enable john

the server will return the current user information and currently logged in user list under this account , or if you specify an username the server will return the user info you specified , only root users can list all users , and super users can only list same group users

ex: site unfo

the server will list all allowed IPs on this server or all users/group on this server .

ex: site list ip , site list user

the server will kick an user , Super users can only kick same group users

ex: site kick peter

the server turn the current ftp session into stealth mode (run it again to turn off stealth mode again) , when your session is in stealth mode , no event triggers will occur , and your activity will be "hidden mode" when other user types a site who , however , root users can still see the activities without any limitation

ex: site stealth

by sending this command by Ftp client to RaidenFTPD , the server will add [MB credit] mb of download credits to the user [username]

ex: site give peter 333

by sending this command by Ftp client to RaidenFTPD , the server will take [MB credit] mb of download credits away from the user [username]

ex: site take peter 435

by sending this command by Ftp client to RaidenFTPD , the server will displays userfile changes by all root/super level users , or send a site uchanges clear to clear the file

ex: site uchanges

ex: site uchanges clear

the server will change the dir/file [mode] for [filename] , the [mode] can varies from 000-777 and the [filename] can contain wildcard character * or spaces

The first number applies to the owner of the directory. The second number applies to users in the same group as the owner. The third number sets permissions for users outside of the owner's group.

A value of 0 indicates NO permissions. 1 allows execute. 2 allows write. 4 allows read. The values add together. So 6 is 4+2 (read + write access)...

ex: site chmod 775 * this will change all files/dirs under current directory to mode 775

ex: site chmod 760 john.mp3 this will change john.mp3 to mode 760

the server will change the dir/file operating system [attributes] for [filename] , the [attributes] can be one or combination of the following characters, [filename] must be an exact filename and it can not contain a wildcard character. the user has to be the owner of this file in order to change its attribute, or using the root level.

arhsn

a: archive r: readonly h: hidden s: system n:normal

ex: site attrib +ar xxx.zip this will change xxx.zip with readonly attribute and archive attribute

ex: site attrib +n xxx.zip this will reset xxx.zip to normal file attribute

the server will change the owner/group for [filename] , the [filename] can contain wildcard * or spaces

ex: site chown john:root *

ex: site chown john:root readme.txt

'site pre [target_dir]' command, to move [target_dir] (possibly under current directory) to previously defined pre location
previously defined pre destination location: must be set in raidenftpd.ini DEF_SITE_PRE_DESTINATION
the user who issues this command must be in the group name called 'preusers' (add this group to the username who wishes to perform this command)

ex: site pre xxx, site pre /xxx, DEF_SITE_PRE_DESTINATION=C:\TEMP

the server will display the following information : directory info of the current virtual directory , the directory info contains files , total file size , uploaders/groups information of the current virtual directory

ex: site race

the server will remove [dirname] directory at once , very danger command , user with care , you need to be root level or a member of fsmaster group in order to use this command

ex: site wipe xxxxxx_dir

the server will output the content of [filename] to the client , it is usually used for text files only . the [filename] can contain space characters . note that the [filename] can not contain path , and RaidenFTPD only searchs for the file in the ftp current directory .

ex: site cat readme.txt

the server will set the [filename] freely downloadable even if the user has no download credit at all , note that this file still needs to have 'R' flag so users can read it .

note : filename can be a single file or can also contain wildcard

ex: site free allmylist.zip

the server will return a list of directories and files which match the keyword .

note : the site srch command only search from your online or offline dupe database , it does not search from disk

note : the keyword can be in uppercase or lowercase , it can contain multiple keywords also

ex: site srch raiden ftp

the server will encrypt the [filename] according to the current user's special signature value , in the other word the encrypted file can only be decrypted by the same user .

note : works in current directory only , [filename] can not contain path

ex: site encrypt myfile.zip

the server will decrypt the [filename] according to the current user's special signature value , in the other word the user can only decrypt the files which are encrypted by himself .

note : works in current directory only , [filename] can not contain path

ex: site decrypted myfile.zip.encrypted

the server will move all files and directories (virtual current directory) to the [pathname] , note that the [pathname] is still a virtual path , it does not need to exist , however its parent directory must exist

note : requires the user account to have X flag on current directory and W flag on target directory .

ex: site move /uploads/newdir

the /uploads should be existed prior to this command

by sending this command by Ftp client to RaidenFTPD , the server will get the file in the [url] to the ftp current directory , note that this operation is performed in the background , hence you can send multiple site urlget commands and the RaidenFTPD will manage to get them for you .

the [url] can be in the following format

http://[address]/[path]/[filename]

ex : http://www.somewhere.com/download/somefile.zip

ftp://[address]/[path]/[filename]

ex : ftp://ftp.somewhere.com/download/somefile.zip

ftp://[username]:[password]/[address]:[port]/[path]/[filename]

ex : ftp://john:pass/ftp.somewhere.com:21/download/somefile.zip

the server will return a list of latest 10 directories made by ftp users under this server .

ex: site new

the server will return mp3 information for all .mp3 files found under the current virtual directory

ex: site mp3

the server will rename [dirname] to [nuked][dirname] , and keep this record in /message/site-nukes.msg , users can type site nukes to see current nukes.

note : only users with group=nukers can execute this command

note : multiplier is not implemented yet , but reserved

ex: site nuke dos editor|3|we dont use dos

note: this command is for use with site administrators to clean up unwanted directories without giving out X flag on virtual paths

note: use site unnuke [dirname] , to return to the original status

When using mem-db user database , you can issue this site sync m2d command to force the server to write the user database from memory to disk , or issue site sync d2m to force the server to load user database from disk user file to mem-db

ex: site sync m2d

When a root level user issues this command, the server will reply the current server IP , UPnP server IP , Lan IP , Data port range , and other server IP information which will be helpful to track PASV/PORT problems.

ex: site ipconfig

the server will return a list of top 10 uploaders under this server .

ex: site utop

the server will return a list of top 10 uploaders under this server .

ex: site utop

the server will return a list of top 10 downloaders under this server .

ex: site dtop

the server will return a list of top 10 uploaders during this week

note : you can display this list in /message/*.msg file by inserting the following line into *.msg file

%#site-wkup.msg

ex: site wkup

the server will return a list of top 10 downloaders during this week

note : you can display this list in /message/*.msg file by inserting the following line into *.msg file

%#site-wkdn.msg

ex: site wkdn

the server will return a list of top 10 uploading groups during this week

note : you can display this list in /message/*.msg file by inserting the following line into *.msg file

%#site-gpwu.msg

ex: site gpwu

the server will return a list of top 10 downloading groups during this week

note : you can display this list in /message/*.msg file by inserting the following line into *.msg file

%#site-gpwd.msg

ex: site gpwd

the server will return a list of top 10 uploaders during this month

note : you can display this list in /message/*.msg file by inserting the following line into *.msg file

%#site-mnup.msg

ex: site mnup

the server will return a list of top 10 downloaders during this month

note : you can display this list in /message/*.msg file by inserting the following line into *.msg file

%#site-mndn.msg

ex: site mndn

the server will return a list of top 10 uploading groups during this month

note : you can display this list in /message/*.msg file by inserting the following line into *.msg file

%#site-gpmu.msg

ex: site gpmu

the server will return a list of top 10 downloading groups during this month

note : you can display this list in /message/*.msg file by inserting the following line into *.msg file

%#site-gpmd.msg

ex: site gpmd

the server will reload the *.ftpd file without a restarting of RaidenFTPD .

note : all connected users will stay connected

ex: site reload

the server be refuse to accept more connections immediatelly

note : the server will refuse to accept new connections, but existing connections will remain connected.

ex: site close

the server will be reopened , if it was previously closed

ex: site open

restore the GUI if it was previously made hidden

ex: site show

the server will return the local time and date to the ftp client .
ex: site time

the server will return a list of currently online users . This information will contain the username , groupname , user's ip address and the last actions of users .

ex: site who

generate integrity check reports of the current directory based on the .sfv file which is found in the current directory

ex: site rescan

ex: site rescan *.mp3

the server will return the online users count , uploaders and downloaders count , and the bandwidth info.

ex: site bw

the server will Insert your short text into the message board , and if you wish to display the message board in any message file just add a line in /message/*.msg

%#site-onel.msg

note that it must be placed in the beginning of a line

ex: site onel I LOVE RaidenFTPD