aname2num(1)							 aname2num(1)



NAME
  aname2num - convert name to a	phone number from .phonelist file

SYNOPSIS
  aname2num [options] [name [name...]]

DESCRIPTION
  The aname2num	program	is used	to lookup names	in the user .phonelist file
  and return a phone number. The .phonelist file should	be specified as	fol-
  lows:


  <phone-list>	 ::=   [<entry>...]
  <entry>	 ::=   <first> [<more>...]
  <first>	 ::=   <name> [<num>] [<adr>] CR
  <more>	 ::=   TAB [<white>...]	<more2>	CR
  <more2>	 ::=   [<name>]	[<num>]	[<adr>]
  <name>	 ::=   <name1> [<name2>...]
  <name1>	 ::=   {any printing but ":" or	";"}
  <name2>	 ::=   <name1> | <white>
  <num>		 ::=   ":" [<num1>...]
  <num1>	 ::=   <white> | <num2>
  <num2>	 ::=   {any printing but ";"}
  <adr>		 ::=   ";" [<adr1>...]
  <adr1>	 ::=   <white> | <adr2>
  <adr2>	 ::=   {any printing}
  <white>	 ::=   SPACE | TAB

  The name may be specified as separate	arguments (which will be concatenated
  with delimiting spaces).  If no name is specified, the name will be read
  from standard	input.	The search is then performed on	all lines that do not
  begin	with white space (e.g.,	space, tab) and	is an un-anchored search upto
  any ":" on the line.

  If the supplied name begins with a digit, then the string is assumed to be
  a phone number and a search will not be performed. The number	will still be
  rewritten and	returned on standard output.

  After	the number is in hand, aname2num uses rewrite rules to generate	the
  actual dialled sequence.  Seven digit	numbers	are prepended with "9,"	and
  10 digit numbers are prepended with "10,".

OPTIONS
  aname2num accepts the	following command line options described below.

  -c	  Name comparisons will	be case	sensitive. The default is for case to
	  be ignored.

  -f fileName
	  The specified	fileName will be used for the phonelist	instead	of
	  the default $HOME/.phonelist file.

  -n	  Supress the rewrite rules, so	that the given number is used
	  exactly.

RETURN VALUE

  If a match is	found, the phone-number	will be	returned after being cleaned
  up (anything before a	":" and	after a	";" will be deleted) and re-written
  (rules are location dependent. See the source	code rewrite() routine for an
  example).

  Exit status is 0 on success, 1 if no match found, -1 if an error occurred.

SEE ALSO
  AF(1)	adial(1)

BUGS

COPYRIGHT
  Copyright 1993-1994, Digital Equipment Corporation.
  See AF(1) for	a full statement of rights and permissions.

AUTHORS
  Dave Wecker, Cambridge Research Lab, Digital Equipment Corporation.
  Larry	Stewart,  Cambridge Research Lab, Digital Equipment Corporation.