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

FreeBSD Manual Pages

  
 
  

home | help
BSEARCH(1)		  BSD General Commands Manual		    BSEARCH(1)

NAME
     bsearch --	manages	one-time passwords

SYNOPSIS
     bsearch [-KVvh] [-b block-size] [-m max-cache-size] file [key ...]

DESCRIPTION
     The bsearch program performs binary searches of file which	must be	a
     sorted flat text file.

     Each line is a record.  Each record starts	with a key that	is optionally
     followed by whitespace and	a value.  Whitespace may be quoted with	a
     backslash,	but newline and	carriage-return	characters must	be quoted in
     some other	manner (e.g., as backslash-n and backslash-r).	Escapes	are
     not interpreted nor removed.

     If	no key arguments are given on the comman-line, then keys will be read
     from standard input.

     By	default	only values are	printed	to standard output.  Use the -K	option
     to	also print keys.  The exit status will be non-zero if any key lookups
     fail.

     Options are:

     -K	     Print keys.

     -V	     Don't print values.

     -h	     Print usage and exit.

     -v	     Print statistic and debug information to standard error.  file A
	     sorted flat text file.  NOTE: use the "C" locale for sorting this
	     file, as in "LC_ALL=C sort	-u -o file file".

     -h	     For getting a help	message.

     -m	     Set max-cache-size	as the maximum cache size.  If the file	is
	     smaller than this size then the whole file	will be	read into mem-
	     ory, else the program will	read blocks.  Defaults to 1MB.

     -b	     Set block-size as the block size for block-wise I/O.  This	must
	     be	a power	of 2, must be no smaller than 512 and no larger	than
	     1MB.  Defaults to the file's filesystem's preferred blocksize.

EXAMPLES
	   $ env LC_ALL=C sort -o /tmp/words /usr/share/dict/words
	   $ bsearch -Kv /tmp/words day
	   Using whole-file method
	   Key day found at offset 327695 in 12	loops and 0 reads
	   day
	   $

NOTES
     Records must not be longer	than one block's size.

     Flat text files must be sorted in the "C" locale.	In some	systems	the
     default locale may	result in case-insensitive sorting by the sort com-
     mand.

SEE ALSO
     sort(1)

KTH-KRB			       November	30, 2011		       KTH-KRB

NAME | SYNOPSIS | DESCRIPTION | EXAMPLES | NOTES | SEE ALSO

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

home | help