Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
NSSTEST(8)	      nsstest $PACKAGE_VERSION@	man page	    NSSTEST(8)

NAME
       nsstest - test nsswitch (and nss_ndb) functionality

SYNOPSIS
       nsstest [options]action[arguments]

DESCRIPTION
       This manual page	documents briefly the nsstest command.

       nsstest	is a tool that can be used to test and measure latency in nss-
       witch lookups (currently	only for passwd	& group	databases). The	normal
       (non  ndb_xx)  actions tests the	whole chain so can be used to test the
       speed of	other nsswitch backends.

OPTIONS
       -h     Show summary of options.

       -v     Increase verbosity.

       -x     Expect failure (give error if not	failed)

       -c     Validate returned	data

       -s     Keep database(s) open (setpwent, setgrent)

       -C text
	      Compare returned data

       -B bytes
	      Buffer size [default: 1048576 bytes]

       -T seconds
	      Timeout limit [default: 2	s]

       -N times
	      Repeat test [default: 0 times]

       -P threads
	      Run in parallel [default:	0 (single-threaded)]

ACTIONS
       Test the	various	library	calls (or ndb directly	for  the  ndb_xxx  ac-
       tions).	 The  argument	is  typically  the user/group name or uid/gids
       needed.

       getpwnam	user-name

       getpwnam_r user-name

       getpwuid	uid

       getpwuid_r uid

       getpwent

       getpwent_r

       getgrnam	group-name

       getgrnam_r group-name

       getgrgid	gid

       getgrgid_r gid

       getgrent

       getgrent_r

       getgrouplist user-name

       ndb_getpwnam_r user-name

       ndb_getpwuid_r uid

       ndb_getgrnam_r group-name

       ndb_getgrgid_r gid

EXAMPLES
       Single-Threaded username	lookups	in passwd database
	      $	nsstest	getpwnam peter
	      Call results:
		Calls:	   38561
		Time:	   2.00	s
		Time/call: 51.87 A<micro>s
	      Test results:
		Min:	   47.68 A<micro>s/c
		Avg:	   51.87 A<micro>s/c
		Max:	   870.70 A<micro>s/c

       Multi-threaded (4 threads) parallel group lookups in group database
	      $	nsstest	-P 4 getgrnam_r	employees
	      Call results:
		Calls:	   79659
		Time:	   2.00	s
		Time/call: 25.16 A<micro>s
	      Test results:
		Min:	   78.92 A<micro>s/c
		Avg:	   100.44 A<micro>s/c
		Max:	   2.03	ms/c

	      $	nsstest	 -P10 -s -x ndb_getpwnam_r no-such-user
	      Call results:
		Calls:	   237570
		Time:	   2.01	s
		Time/call: 8.45	A<micro>s
	      Test results:
		Min:	   34.57 A<micro>s/c
		Avg:	   84.20 A<micro>s/c
		Max:	   1.01	ms/c

SEE ALSO
       nss_ndb(8),  makendb(8),	 nss_ndb.conf(5),   nsswitch.conf(5),	nsdis-
       patch(3), https://github.com/ptrrkssn/nss_ndb

AUTHOR
       nss_ndb and tools was written by	Peter Eriksson <pen@lysator.liu.se>.

1.0.23				  13 Jun 2020			    NSSTEST(8)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | ACTIONS | EXAMPLES | SEE ALSO | AUTHOR

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=nsstest&sektion=8&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help