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

FreeBSD Manual Pages

  
 
  

home | help
BSEARCH(1)		    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  option-
       ally 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  op-
       tion  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
	       memory, 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		    BSEARCH(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=bsearch&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>

home | help