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 PARTICU-
       LAR PURPOSE.

nsscache 0.7							     May 2007							       NSSCACHE(1)