# rld 1.0 documentation

About Quickstart Reference Arguments Files Console Parameters Known problems | ## Files By default, rld looks for files and directories in the directory ~/.redlight. The --rootdir commandline argument overrides this default. In addition it is possible to override the defaults on a file-by-file basis. If not overridden by commandline arguments, rld uses the following files: 1. accounts 2. agreement 3. bantable 4. files 5. flatnews 6. rld.conf 7. rld.log 8. trackertable 9. trash ### 1. accounts The file accounts specifies the accounts known to the server and the privileges for those accounts. Each line in the accounts file describes one account: `login:nickname:privileges:password[:home directory]` The login and nickname fields simply describe the account login and the user's default nickname. The privileges field is a 64-bit bitfield represented as a signed integer, such that -1 means "all privileges" and 0 means "no privileges". The password contains the user's encrypted password. To not require a password, put in the string "aaLmYvG0jXYCk" (which is "guest" encrypted). See also the --crypt commandline argument. Finally, there is an optional fifth argument, which if given, specifies the users home directory. If not given, defaults to the value of server.homedir variable. ### 2. agreement This file contains the agreement. The agreement is stored as Macintosh text, i.e. separated by carriage returns (\r). rld reads this file -- if it exists and has been changed -- whenever it needs to show the agreement to a client. If the agreement file does not exist, rld will not show an agreement. ### 3. bantable The file bantable specifies a list of IP addresses that rld should ban. Each line in this file should contain an IP address followed by a space, followed by Unix timestamp (seconds since 1970). The timestamp indicates when this ban expires. If the timestamp is 0, the ban never expires. rld reads this file on startup, then checks to see if it has changed every time somebody connects, in which case it rereads the file. rld writes this file when a ban expires. ### 4. files This directory is the default home directory for rld, i.e. the directory that rld will serve files from (the home directory can be overridden on a per account basis). ### 5. flatnews This file contains the flat news. The flat news is stored as Macintosh text, i.e. separated by carriage returns (\r). rld reads this file at startup and -- if it has been changed -- whenever a client requests the news. rld writes this file when somebody posts news. ### 6. rld.conf This file is read and executed by the console after the server has been initialized. ### 7. rld.log The rld log file. rld shuts down when it cannot write to the logfile. ### 8. trackertable The file trackertable specifies a list of trackers that rld should register with. Each line in this file should contain the hostname of a tracker. Optionally, a password can be given for that tracker, by putting the password on the same line as the hostname separated by a space. rld reads this file on startup, then checks to see if it has changed every minute or so, in which case it rereads the file. ### 9. trash This is the default trash directory for rld, i.e. deleted files end up here. 25 october 2001