DragonFly On-Line Manual Pages

NSSCACHE(1)                      User Commands                     NSSCACHE(1)

NAME
       nsscache - synchronise a local NSS cache with an upstream data source

SYNOPSIS
       nsscache [global options] command [command options]

DESCRIPTION
       nsscache synchronises a local NSS cache against a remote data source.
       This approach allows the administrator to separate the network from the
       NSS lookup codepath, improving speed and reliability of name services.

OPTIONS
       Global options alter general program behaviour:

       -v, --verbose
              enable verbose output

       -d, --debug
              enable debugging output

       -c FILE, --config-file=FILE
              read configuration from FILE

       --version
              show program's version number and exit

       -h, --help
              show this help message and exit

COMMANDS
   update
       Performs an update of the configured caches from the configured
       sources.

       -f, --full
              force a full update from the data source

       --force
              force the update, overriding any safeguards and checks that
              would otherwise prevent the update from occurring. e.g. normally
              empty results from the data source are ignored as bogus -- this
              option will instruct the program to ignore its intuition and use
              the empty map

       -m MAPS, --map=MAPS
              NSS map to operate on, can be supplied multiple times

       -h, --help
              show help for the update command

   verify
       Perform verification of the built caches and validation of the system
       NSS configuration.

       -m MAPS, --map=MAPS
              NSS map to operate on, can be supplied multiple times

       -h, --help
              show help for the verify command

   status
       Show the last update time of each configured cache, and other metrics,
       optionally in a machine-readable format.

       -m MAPS, --map=MAPS
              NSS map to operate on, can be supplied multiple times

       -h, --help
              show help for the status command

   repair
       Verify that the configuration is correct, that the source is reachable,
       then perform a full synchronisation of the cache.

       -m MAPS, --map=MAPS
              NSS map to operate on, can be supplied multiple times

       -h, --help
              show help for the repair command

   help
       Shows online help for each command.

SEE ALSO
       nsscache.conf(5)

       nsswitch.conf(5)

FILES
       /etc/nsscache.conf
              The system-wide configuration file

       /etc/nsswitch.conf
              The system name service switch configuration file

AUTHOR
       Written by Jamie Wilkinson (jaq@google.com) and Vasilios Hoffman
       (vasilios@google.com).

COPYRIGHT
       Copyright (C) 2007 Google, Inc.
       This is free software; see the source for copying conditions.  There is
       NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
       PURPOSE.

nsscache 0.30                      May 2007                        NSSCACHE(1)