summaryrefslogtreecommitdiff
path: root/static/v10/man7/pq.7
blob: fb3e112650b7f6e07b9bc8bdb79a12ced086a3e0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
.TH PQ 7
.SH NAME
pq \- telephonet directory assistance
.SH SYNOPSIS
.B pq
[
.I option ...
]
.I query
.SH DESCRIPTION
.I Pq
queries `Post' directory assistance computers
for information from the AT&T phone book.  A normal
query is a name, in the form
.IB first.middle.middle2.last,suffix,
where only
.I last
is required.
Earlier names may be truncated, even to a null string,
and extra punctuation may be dropped.
Other fields can be specified, in the form
.IB attribute = value,
with fields separated by
.BR / .
The attributes are
.TP
.B pn
.TP
.B name
personal (full) name; for prefix match on last name, append 
.B *
or
.BR ... ;
for phonetic search, append or prepend 
.B ?
.HP
.BR first ,
.BR middle ,
.BR middle2 ,
.BR last ,
.B suffix
.br
parts of name, prefix-matched except for suffix
.HP
.BR pid ,
.B ssn
.br
personnel identification number,
social security number
.TP
.B org
organization code
.TP
.B tl
title: abbreviated or prefix-matched; e.g. 
.BR tl=dh,
.B tl=dep.he
.TP
.B tel
phone number: (908)582-6050, punctuation optional, parts may be omitted from left
.HP
.BR area ,
.BR exch ,
.B ext
.br
parts of phone number
.TP
.B loc
location code; for prefix match, append
.B *
.HP
.BR room ,
.BR street ,
.BR city ,
.BR state ,
.B zip
.br
parts of address, prefix-matched except for state
.TP
.B ema
email address; for prefix match, append *
.TP
.B multi
which of multiple addresses for one employee; e.g. 
.B multi=2
.PD
.PP
The options are
.TP
.B -l
The query is a location code.
.TP
.BI -o " format
Provide output in the specfied
.I format, 
a string like that of
.IR printf (3),
with format codes being attribute names.
.SH EXAMPLES
.PD 0
.TP
.B pq penzias
.TP
.B pq a.a.penzias
.TP
.B pq ema=research!aap
Three ways to find a person.
.TP
.B pq loc=mh/room=2b519
Find members of an office.
.TP
.B pq \-l mt
Find information about a location.
.TP
.B
pq \-o "%24pn %10org %6loc %6room %12tel %ema" a.a.penzias
The default output format.
.PD
.SH FILES
.TP 30
$POST/lib/dispatch
directory configuration file
.SH SEE ALSO
tel (7)