Synchronet v3.19b-Win32 (install) has been released (Jan-2022).

You can donate to the Synchronet project using PayPal.

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
module:filelist [2021/04/12 00:01] – [Format Output] Add size/credit format option examples digital manmodule:filelist [2021/04/18 18:37] (current) – [File List] link to FILELIST digital man
Line 1: Line 1:
 ====== File List ====== ====== File List ======
  
-New for Synchronet v3.19, this JavaScript utility script (''filelist.js'') replaces the functionality of the old FILELIST program.+New for Synchronet v3.19, this JavaScript utility script (''filelist.js'') replaces the functionality of the old [[util:FILELIST]] program.
  
 Normally executed via [[util:JSexec]], this script will generate a list of files from one or more Synchronet system's file databases (filebases) and send the list to ''stdout'' which can be redirected to a file using normal system shell methods, for example: Normally executed via [[util:JSexec]], this script will generate a list of files from one or more Synchronet system's file databases (filebases) and send the list to ''stdout'' which can be redirected to a file using normal system shell methods, for example:
Line 27: Line 27:
   -json[=spaces]  use JSON formatted output   -json[=spaces]  use JSON formatted output
   -new=<days>     include new files uploaded in past <days>   -new=<days>     include new files uploaded in past <days>
-  -p=[list]       specify comma-separated list of property names to print+  -p=<list>       specify comma-separated list of property names to print 
 +  -cdt            include credit value instead of file size
   -ext            include extended file descriptions   -ext            include extended file descriptions
   -ext=<prefix>   specify extended file description prefix   -ext=<prefix>   specify extended file description prefix
Line 33: Line 34:
   -date=<fmt>     specify date/time display format (strftime syntax)   -date=<fmt>     specify date/time display format (strftime syntax)
   -size=<fmt>     specify size/byte display format (0-12)   -size=<fmt>     specify size/byte display format (0-12)
-  -name=<len>     specify filename length+  -name=<len>     specify filename length (default: 12)
   -pad            pad filename with spaces   -pad            pad filename with spaces
 +  -adate          use latest archived file date/time instead of file time
   -v              increase verbosity (detail) of output   -v              increase verbosity (detail) of output
 </file> </file>
Line 101: Line 103:
 To increase the maximum length of the file name displayed, use the ''-name=<length>'' option. To increase the maximum length of the file name displayed, use the ''-name=<length>'' option.
  
 +By default, filenames shorter than the maximum are not padded (between the base file name and suffix/extension).
 To pad (with spaces) short names and file extensions, use the ''-pad'' option. To pad (with spaces) short names and file extensions, use the ''-pad'' option.
  
-To control the extended description line prefixes, use the ''-ext=<prefix>'' option.+By default, extended descriptions are indented with a prefix that matches the ''FILES.BBS'' standard (indented with spaces separated from the description with a pipe character). To customize the extended description line prefixes, use the ''-ext=<prefix>'' option.
  
-To choose your own file properties to include in the list, specify the comman-separated list of property names with the ''-p=<list>'' option.+To choose your own file object properties to include in the list, specify the comma-separated list of property names with the ''-p=<list>'' option.
  
-To choose your own date/time display format, specify a [[custom:strftime]] format string with the ''-date=<fmt>'' option.+To choose your own ''printf''-style format string, use the ''-fmt=<fmt>'' command-line option. 
 + 
 +The default date/time format will be either "MM/DD/YY" or "DD/MM/YY" depending on the [[util:SCFG]]->System->Toggle options->European Date Format setting. To choose your own date/time display format, specify a [[custom:strftime]] format string with the ''-date=<fmt>'' option.
  
 The default file credit/size format is a rounded floating point format with a single digit of precision and a suffix of G, M, K or B. To choose an alternate file credit/size format, specify the format number (0-12) with the ''-size=<fmt>'' option: The default file credit/size format is a rounded floating point format with a single digit of precision and a suffix of G, M, K or B. To choose an alternate file credit/size format, specify the format number (0-12) with the ''-size=<fmt>'' option:
Line 113: Line 118:
 == Size Formats == == Size Formats ==
 The formatting options for file sizes (bytes) or credit values: The formatting options for file sizes (bytes) or credit values:
-^        0  ^    1  ^     2  ^      3  ^    4  ^     5  ^      6  ^  7  ^   8  ^    9  ^    10  ^     11  ^    12  ^+^        0((FILES.BBS compatible))  ^    1  ^     2((the default))  ^      3  ^    4  ^     5  ^      6  ^  7  ^   8  ^    9  ^    10  ^     11  ^    12  ^
 |      9805 |   10K |   9.6K |   9.58K |   10K |   9.6K |   9.58K |  0M | 0.0M | 0.01M | 0.009M |  9,805B |    10K | |      9805 |   10K |   9.6K |   9.58K |   10K |   9.6K |   9.58K |  0M | 0.0M | 0.01M | 0.009M |  9,805B |    10K |
 |      3177 |    3K |   3.1K |   3.10K |    3K |   3.1K |   3.10K |  0M | 0.0M | 0.00M | 0.003M |  3,177B |     3K | |      3177 |    3K |   3.1K |   3.10K |    3K |   3.1K |   3.10K |  0M | 0.0M | 0.00M | 0.003M |  3,177B |     3K |

Trace: