nsscache(1) [debian man page]

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)

NSS(5)							     Linux Programmer's Manual							    NSS(5)

NAME

       nss - Name Service Switch configuration file

DESCRIPTION

       Each  call  to  a  function  which retrieves data from a system database like the password or group database is handled by the Name Service
       Switch implementation in the GNU C library.  The various services provided are implemented by independent modules, each of which  naturally
       varies widely from the other.

       The  default  implementations  coming  with  the  GNU C library are by default conservative and do not use unsafe data.	This might be very
       costly in some situations, especially when the databases are large.  Some modules allow the system administrator to request  taking  short-
       cuts if these are known to be safe.  It is then the system administrator's responsibility to ensure the assumption is correct.

       There are other modules where the implementation changed over time.  If an implementation used to sacrifice speed for memory consumption it
       might create problems if the preference is switched.

       The /etc/default/nss file contains a number of variable assignments.  Each variable controls the behavior  of  one  or  more  NSS  modules.
       White spaces are ignored.  Lines beginning with '#' are treated as comments.

       The variables currently recognized are:

       NETID_AUTHORITATIVE = TRUE|FALSE
	      If set to TRUE, the NIS backend for the initgroups(3) function will accept the information from the netid.byname NIS map as authori-
	      tative.  This can speed up the function significantly if the group.byname map is large.  The content of the netid.byname map is used
	      as is.  The system administrator has to make sure it is correctly generated.

       SERVICES_AUTHORITATIVE = TRUE|FALSE
	      If  set  to TRUE, the NIS backend for the getservbyname(3) and getservbyname_r(3) functions will assume that the services.byservice-
	      name NIS map exists and is authoritative, particularly that it contains both keys with /proto and without /proto	for  both  primary
	      service names and service aliases.  The system administrator has to make sure it is correctly generated.

       SETENT_BATCH_READ = TRUE|FALSE
	      If  set  to  TRUE, the NIS backend for the setpwent(3) and setgrent(3) functions will read the entire database at once and then hand
	      out the requests one by one from memory with every corresponding getpwent(3) or getgrent(3) call respectively.  Otherwise each getp-
	      went(3) or getgrent(3) call might result in a network communication with the server to get the next entry.

FILES

       /etc/default/nss

EXAMPLE

       The default configuration corresponds to the following configuration file:

       NETID_AUTHORITATIVE=FALSE
       SERVICES_AUTHORITATIVE=FALSE
       SETENT_BATCH_READ=FALSE

SEE ALSO

       nsswitch.conf

COLOPHON

       This  page is part of release 3.53 of the Linux man-pages project.  A description of the project, and information about reporting bugs, can
       be found at http://www.kernel.org/doc/man-pages/.

Linux								    2013-02-13								    NSS(5)