Git init
[framework/connectivity/bluez.git] / tools / sdptool.1
1 .\" $Header$
2 .\"
3 .\"     transcript compatibility for postscript use.
4 .\"
5 .\"     synopsis:  .P! <file.ps>
6 .\"
7 .de P!
8 .fl
9 \!!1 setgray
10 .fl
11 \\&.\"
12 .fl
13 \!!0 setgray
14 .fl                     \" force out current output buffer
15 \!!save /psv exch def currentpoint translate 0 0 moveto
16 \!!/showpage{}def
17 .fl                     \" prolog
18 .sy sed -e 's/^/!/' \\$1\" bring in postscript file
19 \!!psv restore
20 .
21 .de pF
22 .ie     \a\\*(f1\a\a .ds f1 \\n(.f
23 .el .ie \a\\*(f2\a\a .ds f2 \\n(.f
24 .el .ie \a\\*(f3\a\a .ds f3 \\n(.f
25 .el .ie \a\\*(f4\a\a .ds f4 \\n(.f
26 .el .tm ? font overflow
27 .ft \\$1
28 ..
29 .de fP
30 .ie     !\a\\*(f4\a\a \{\
31 .       ft \\*(f4
32 .       ds f4\"
33 '       br \}
34 .el .ie !\a\\*(f3\a\a \{\
35 .       ft \\*(f3
36 .       ds f3\"
37 '       br \}
38 .el .ie !\a\\*(f2\a\a \{\
39 .       ft \\*(f2
40 .       ds f2\"
41 '       br \}
42 .el .ie !\a\\*(f1\a\a \{\
43 .       ft \\*(f1
44 .       ds f1\"
45 '       br \}
46 .el .tm ? font underflow
47 ..
48 .ds f1\"
49 .ds f2\"
50 .ds f3\"
51 .ds f4\"
52 '\" t
53 .ta 8n 16n 24n 32n 40n 48n 56n 64n 72n
54 .TH "sdptool" "1"
55 .SH "NAME"
56 sdptool \(em control and interrogate SDP servers
57 .SH "SYNOPSIS"
58 .PP
59 \fBsdptool\fR [\fIoptions\fR]  {\fIcommand\fR}  [\fIcommand parameters\fR \&...]
60 .SH "DESCRIPTION"
61 .PP
62 \fBsdptool\fR provides the interface for
63 performing SDP queries on Bluetooth devices, and administering a
64 local \fBsdpd\fR.
65 .SH "COMMANDS"
66 .PP
67 The following commands are available.  In all cases \fBbdaddr\fR
68 specifies the device to search or browse.  If \fIlocal\fP is used
69 for \fBbdaddr\fP, then the local \fBsdpd\fR is searched.
70 .PP
71 Services are identified and manipulated with a 4-byte \fBrecord_handle\fP
72 (NOT the service name).  To find a service's \fBrecord_handle\fP, look for the
73 "Service RecHandle" line in the \fBsearch\fP or \fBbrowse\fP results
74 .IP "\fBsearch [--bdaddr bdaddr] [--tree] [--raw] [--xml] service_name\fP" 10
75 Search for services..
76 .IP "" 10
77 Known service names are DID, SP, DUN, LAN, FAX, OPUSH,
78 FTP, HS, HF, HFAG, SAP, NAP, GN, PANU, HCRP, HID, CIP,
79 A2SRC, A2SNK, AVRCT, AVRTG, UDIUE, UDITE and SYNCML.
80 .IP "\fBbrowse [--tree] [--raw] [--xml] [bdaddr]\fP" 10
81 Browse all available services on the device
82 specified by a Bluetooth address as a parameter.
83 .IP "\fBrecords [--tree] [--raw] [--xml] bdaddr\fP" 10
84 Retrieve all possible service records.
85 .IP "\fBadd [ --handle=N --channel=N ]\fP" 10
86 Add a service to the local
87 \fBsdpd\fR.
88 .IP "" 10
89 You can specify a handle for this record using
90 the \fB--handle\fP option.
91 .IP "" 10
92 You can specify a channel to add the service on
93 using the \fB--channel\fP option.
94 .IP "\fBdel record_handle\fP" 10
95 Remove a service from the local
96 \fBsdpd\fR.
97 .IP "\fBget [--tree] [--raw] [--xml] [--bdaddr bdaddr] record_handle\fP" 10
98 Retrieve a service from the local
99 \fBsdpd\fR.
100 .IP "\fBsetattr record_handle attrib_id attrib_value\fP" 10
101 Set or add an attribute to an SDP record.
102
103 .IP "\fBsetseq record_handle attrib_id attrib_values\fP" 10
104 Set or add an attribute sequence to an
105 SDP record.
106 .SH "OPTIONS"
107 .IP "\fB--help\fP" 10
108 Displays help on using sdptool.
109
110 .SH "EXAMPLES"
111 .PP
112 sdptool browse 00:80:98:24:15:6D
113 .PP
114 sdptool browse local
115 .PP
116 sdptool add DUN
117 .PP
118 sdptool del 0x10000
119 .SH "BUGS"
120 .PP
121 Documentation needs improving.
122 .SH "AUTHOR"
123 .PP
124 Maxim Krasnyansky <maxk@qualcomm.com>. Man page written
125 by Edd Dumbill <ejad@debian.org>.
126
127 .SH "SEE ALSO"
128 .PP
129 sdpd(8)
130 .\" created by instant / docbook-to-man, Thu 15 Jan 2004, 21:01