Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
util:addfiles [2010/02/26 14:23] – Links to util:scfg changed to util:scfg:index digitalman | util:addfiles [2019/03/09 21:52] – [Troubleshoot] electrosys | ||
---|---|---|---|
Line 1: | Line 1: | ||
====== ADDFILES ====== | ====== ADDFILES ====== | ||
- | FIXME | + | The Synchronet ADDFILES utility is an external native command-line program (written in C) that may be used to add files to the Synchronet file transfer database, usually in an automated or bulk fashion. |
- | ===== See Also ===== | + | ===== Usage ===== |
- | * [[.: | + | |
+ | There are 3 ways to use the ADDFILES utility. In all cases, the first argument must be either a configured directory' | ||
+ | |||
+ | ==== Importing File Lists ==== | ||
+ | |||
+ | To add or update filenames and descriptions from a list file (e.g. '' | ||
+ | addfiles code [-options] +listfile [desc_off] [size_off] | ||
+ | |||
+ | '' | ||
+ | |||
+ | If a filelist is specified on the command line, a description offset can be | ||
+ | specified as the next argument. If used, this parameter will specify at what | ||
+ | column to start importing the descriptions. For PCBoard DIR file format, you | ||
+ | should specify a description offset of 33. Example: | ||
+ | |||
+ | addfiles GAMES +DIR10 33 | ||
+ | |||
+ | This offset is also used for the importing of any extended description lines. | ||
+ | |||
+ | '' | ||
+ | |||
+ | If a filelist is specified on the command line with a description offset, | ||
+ | a file size offset can be specified too. If a file size offset is specified, | ||
+ | the disk does not need to be searched for the size of the file to determine | ||
+ | the credit value. This is useful for adding lists of files from a CD-ROM | ||
+ | drive as it speeds up process since the CD does not need to be scanned for | ||
+ | the file size. This parameter is also useful for importing off-line file | ||
+ | lists, where the file doesn' | ||
+ | file format, this offset should be set to 13. Example: | ||
+ | |||
+ | addfiles GAMES +DIR10 33 13 | ||
+ | |||
+ | ==== Adding a Single File ==== | ||
+ | |||
+ | To add or update a single file to a database with a description: | ||
+ | addfiles code [-options] filename " | ||
+ | |||
+ | ==== Searching for Files on Disk ==== | ||
+ | |||
+ | To add any files found in the storage directory for one or more directories, | ||
+ | |||
+ | All together: | ||
+ | addfiles code -szn | ||
+ | |||
+ | ==== Options ==== | ||
+ | < | ||
+ | -a | ||
+ | -b | ||
+ | -c do not remove extra spaces from file description | ||
+ | -d | ||
+ | -e do not import extended descriptions | ||
+ | -f | ||
+ | -t | ||
+ | -i | ||
+ | -n do not update information for existing files | ||
+ | -o | ||
+ | -u do not update upload date for existing files | ||
+ | -z check for and import FILE_ID.DIZ and DESC.SDI | ||
+ | -k keep original short description (not DIZ) | ||
+ | -s | ||
+ | -l < | ||
+ | -x < | ||
+ | </ | ||
+ | ==== Auto-ADD ==== | ||
+ | |||
+ | * use '' | ||
+ | * use '' | ||
+ | * use '' | ||
+ | | ||
+ | ==== Examples ==== | ||
+ | |||
+ | Importing FILES.BBS format: | ||
+ | addfiles games +c: | ||
+ | |||
+ | Importing DIRxx format: | ||
+ | addfiles games +c: | ||
+ | |||
+ | Importing any offline files from all // | ||
+ | addfiles - -sn | ||
+ | |||
+ | ===== Troubleshoot ===== | ||
+ | |||
+ | * ADDFILES depends on the Extractable File Types to extract the description file from the archive, if these are not setup properly or if the access level is incorrect, ADDFILES will not be able to run this command. Ensure Extractable files Types are setup and also that the Access Level is set correctly within the Extractable File Types. As with all the SBBS Utilities ADDFILES is not run under a user context, so you need to ensure that there are no Access requirements on the Extractable File Types so that ADDFILES is able to access the file DB. | ||
+ | |||
+ | ===== See Also ===== | ||
+ | * [[util: |