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 follows:
<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.