DirList2 Server - Command-Line Functions


Creating Indexes

Syntax: dirlist2.cgi {-c | --create | -create} [-v | -vv] [options] IndexFile
Options:
    --encrypt    Enable encryption on the index file initially (default is no)
    --pw-cache   Enable caching of /etc/passwd (default is no cache)
    --no-admin   Don't prompt for an Administrator password (default is to ask)
    --no-guest   Force guest's search level to "none" (default is to ask level)
    --no-domain  Use the compile-time domain as the e-mail domain (default is to ask)
    --no-url     Don't set a default URL (default is to ask)
    -v           Verbose mode -- display progress and other information
    -vv          Very-verbose -- display very detailed progress information

Most of the time, you'll want to use the defaults. In that case, simply typing dirlist2.cgi -c dirlist_indexes/users.idx2 will set up your "users" index file after asking a few questions. All of these options are also configurable after the index has been created. To modify these options after creating an index file, use an administrative tool such as the DirList2ODBC driver.


Updating Indexes

Syntax: dirlist2.cgi {-u | --update | -update} [-v | -vv] IndexFile [HomeBaseDirectory]

This command updates an index file with a home directory, updating names and web sites where necessary while adding any new users that were not already in the index file. As an option, the HomeBaseDirectory parameter may be used to force a home directory to scan if you do not want to use the one defined in the index file or if the index file does not have a base directory defined yet.

Right after creating an index file, it is customary to run dirlist2.cgi -u dirlist_indexes/users.idx2 /home to immediately populate the index file with the users on the system who have directories in /home. After this, use an administrative tool such as the DirList2ODBC driver to set the base directory (BaseDir in tblIndexInfo in the ODBC driver) to /home or wherever you store user accounts. Once the base directory has been defined, you no longer need to specify the HomeBaseDirectory parameter during updates.

 

Copyright (c) 2000, 2002, 2004, 2007 Steven Lawrance
Copyright (c) 1999-2000 Bryant College
Written by Steven Lawrance
DirList2 Server Version: 2.9
Last Revision:
08-04-2007