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
|
.\"Created by graziano obertelli <graziano@cs.ucsb.edu>
.\"
.TH nws_search 1 "September 27, 2002" "nws_search"
.SH NAME
nws_search \- search a Network Weather Service nameserver
.SH SYNOPSIS
.B nws_search
[-a][-o][-V][-f yes/no][-N host][-v level] filter [attribute ...]
.SH DESCRIPTION
This manual page explains the
.B nws_search
program.
.B nws_search
is used to query a
.B nws_nameserver(1)
in order to obtain various infomation about
.B nws_sensor(1)
, running activities, available measurements etc...
The filter is an LDAP-like filter (see
.B EXAMPLES
for few examples on how to use it).
.B
.SH OPTIONS
.BI -a
.RS
only the attributes should be displayed
.RE
.BI
.RS
only the values of should be displayed
.RE
.BI -N\ nws_nameserver
.RS
specifies the nws_nameserver to be queried
.RE
.BI -f\ yes/no
.RS
Indicates whether to format the program output, listing one attribute per
line and padding the names. The default is yes.
.RE
.BI -t\ timeout
.RS
Use
.I timeout
seconds as timeout during communications with the nameserver. 0 has a
special meaning of disabling the timeout altogether.
.RE
.BI -v\ level
.RS
Set the verbosity in case of error. Value of
.I level
can be 0 to 5 where 5 is the more verbose. It is currently disabled.
.RE
.BI -V
.RS
Print the version informations.
.RE
.SH EXAMPLES
To retrieve registrations of all cliques register with
.I nameserver
.RS
nws_search -N
.I nameserver
"(&(objectclass=nwsActivity)(control=clique))"
.RE
To retrieve registrations for all sensors
.RS
nws_search -N
.I nameserver
"(hostType=sensor)"
.RE
To retrieve registrations that have a name starting with abc
.RS
nws_search -N
.I nameserver
"(name=abc*)"
.RE
.SH BUGS
.P
Bugs list is at
.UR http://nws.cs.ucsb.edu
http://nws.cs.ucsb.edu.
.UE
.SH AUTHOR
NWS is an original idea of Rich Wolski Rich Wolski (rich@cs.ucsb.edu) who
came up with the original
.B nws_memory.
.P
Neil Spring, Jim Hayes (jhayes@cs.ucsd.edu) and Martin Swany maintained
and enhanced it.
.P
Graziano Obertelli (graziano@cs.ucsb.edu) currently maintains NWS and
wrote this man page.
.SH SEE ALSO
.BR nws_sensor(1),
.BR nws_search(1),
.BR nws_nameserver(1),
.BR nws_extract(1)
.BR halt_activity(1)
.BR start_activity(1)
|
