The following command line arguments (introduced in ARLO 1.2) either specify the way ARLO should behave or to print certain information and quit (aka – “Non-Interactive Mode”).
Be aware that when in non-interactive mode, ARLO must still parse the entire log file. If your logs are large in size and take several seconds to read in then you will need to wait that time for the information to be printed. Thus, if you are going to be looking at information on several users or you do not need the output saved to a file then it is best to use the normal interactive menu based mode as the logs will only need to be read once.
-quiet or -q
Do not clear the screen or print “Reading Logs…” messages.
Use this if you are redirecting output to a file.
-user or -u
Use to specify a username. eg, ‘ -user joe ‘ will select ‘joe’ as the user.
This (or -allusers , see below) is required when requesting user specific stats.
If you are not going to print specific stats in non-interactive mode, this will still set the default selected user.
-allusers
Use to select all users.
This is only relavent in non-interactive mode.
-fullreport
Print all reports. This includes general server stats, “top 10” lists, leech ratios, and all information about all users.
WARNING – This can produce a VERY large file and may take a minute or so to write. Be patient and only use this option if you really want this.
This option overrides all others.
-stats
Print stats for the specified user(s).
-serverstats
Print server-wide stats and “top 10” lists.
-leechbyratio
Print leech ratios sorted by ratio.
-leechbyuser
Print leech ratios sorted by username.
-nicks
Print nicknames used by the specified user(s).
-downloads
Print downloads made by the specified user(s).
-uploads
Print uploads made by the specified user(s).
-bestleech
Print the top 10 Best leech ratios.
-worstleech
Print the worst 10 Best leech ratios.
-topdownloaders
Print the top 10 downloaders.
-topuploaders
Print the top 10 uploaders.
-topdownloads
Print the top 10 most popular downloads.
-macbr
Use traditional MacOS line breaks instead of *nix line breaks. Use this option if you are redirecting output to a file that will be read by a program that does not auto-detect line breaks. Of course, now that MacOS X is around, and it is a *nix at the core, the world should be starting to accept *nix line breaks as a standard. I recommend BBEdit as a good text editor which can auto-detect line breaks.
-topx
Use to change top 10 lists to top X lists. eg, ‘ -topx 25 ‘ will change all top 10 lists to top 25 lists.
-headerfile
Use to specify a document to print before the normal output.
eg, ‘ -headerfile header.html ‘ will print the contents of the file header.html before the requested stats.
-footerfile
Use to specify a document to print after the normal output.
eg, ‘ -footerfile footer.html ‘ will print the contents of the file footer.html before the requested stats.
-noheaders
Don’t print the headers for each stat. eg, using ‘ -noheaders ‘ will prevent the “Top 10 Downloads” header from being printed above the top 10 downloads list.
-uploadlog or -uploadslog
Use to specify an alternate upload log.
eg, ‘ -uploadlog /Applications/Carracho\ Server/Logs/Uploads ‘ would use that file as the Uploads Log.
If this option is not specified, “Uploads” in the current working directory will be assumed. This means that ARLO will work fine if you put it in and run it from the same directory as your log files.
-downloadlog or -downloadslog
Use to specify an alternate download log.
eg, ‘ -downloadlog /Applications/Carracho\ Server/Logs/Downloads ‘ would use that file as the Uploads Log.
If this option is not specified, “Downloads” in the current working directory will be assumed. This means that ARLO will work fine if you put it in and run it from the same directory as your log files.