PHONE.SH(1)							   PHONE.SH(1)



NAME
       phone.sh  -  partial  key  search a tab delimited flat file database of
       phone numbers

SYNOPSIS
       phone.sh [-d database]

DESCRIPTION
       Partial key search a tab delimited flat file database of phone numbers,
       and if a unique match is found, dial the number using the spcid(1) pro-
       gram.

       The default database of phone numbers is "${HOME}/.phone.numbers".

       The database records consist of exactly three fields:

	   1) The name, (first name followed by last name, separated by
	      spaces.

	   2) The phone, (cellular, pager, home, work, etc.)

	   3) The phone number.

       The fields are separated by a single tab character, (hex 09).

       The partial key search begins with each field,  and  all  records  that
       match  all  partial  keys are printed on stderr, unless only one record
       matches, in which case the number is dialed.

OPTIONS
       -d database
	      Databae file name.

       -q     Don't dial the number, just print it.

WARNINGS
       The termios(3) and fopen(2) settings tested only on Linux 2.4,  and  on
       US  Robotics 56K, V.92, and, 33.6 Sportster. No others were tested. The
       semaphore locking mechanism uses fcntl(2), and may  not	be  compatible
       with other serial programs.

SEE ALSO
       spcid(1),   spgettermios(1)  spsettermios(1),  spttyS0(1),  spttyS1(1),
       sprawS0(1), sprawS1(1), phone.sh(1)

DIAGNOSTICS
       Error messages for  incompatible  arguments,  inaccessible  files,  and
       opening and closing files.

AUTHORS
       ----------------------------------------------------------------------

       A license is hereby granted to reproduce this software source code and
       to create executable versions from this source code for personal,
       non-commercial use.  The copyright notice included with the software
       must be maintained in all copies produced.

       THIS PROGRAM IS PROVIDED "AS IS". THE AUTHOR PROVIDES NO WARRANTIES
       WHATSOEVER, EXPRESSED OR IMPLIED, INCLUDING WARRANTIES OF
       MERCHANTABILITY, TITLE, OR FITNESS FOR ANY PARTICULAR PURPOSE.  THE
       AUTHOR DOES NOT WARRANT THAT USE OF THIS PROGRAM DOES NOT INFRINGE THE
       INTELLECTUAL PROPERTY RIGHTS OF ANY THIRD PARTY IN ANY COUNTRY.

       Copyright (c) 1994-2006, John Conover, All Rights Reserved.

       Comments and/or bug reports should be addressed to:

	   john@email.johncon.com (John Conover)

       ----------------------------------------------------------------------



				 June 18, 2006			   PHONE.SH(1)