From 280cca9f112cbc2f86a9b7653a2ad003769e4fcb Mon Sep 17 00:00:00 2001 From: Marcel Holtmann Date: Wed, 31 Mar 2004 20:14:52 +0000 Subject: Add sdptool utility --- tools/sdptool.1 | 116 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 116 insertions(+) create mode 100644 tools/sdptool.1 (limited to 'tools/sdptool.1') diff --git a/tools/sdptool.1 b/tools/sdptool.1 new file mode 100644 index 00000000..8f938f92 --- /dev/null +++ b/tools/sdptool.1 @@ -0,0 +1,116 @@ +.\" $Header$ +.\" +.\" transcript compatibility for postscript use. +.\" +.\" synopsis: .P! +.\" +.de P! +.fl +\!!1 setgray +.fl +\\&.\" +.fl +\!!0 setgray +.fl \" force out current output buffer +\!!save /psv exch def currentpoint translate 0 0 moveto +\!!/showpage{}def +.fl \" prolog +.sy sed -e 's/^/!/' \\$1\" bring in postscript file +\!!psv restore +. +.de pF +.ie \\*(f1 .ds f1 \\n(.f +.el .ie \\*(f2 .ds f2 \\n(.f +.el .ie \\*(f3 .ds f3 \\n(.f +.el .ie \\*(f4 .ds f4 \\n(.f +.el .tm ? font overflow +.ft \\$1 +.. +.de fP +.ie !\\*(f4 \{\ +. ft \\*(f4 +. ds f4\" +' br \} +.el .ie !\\*(f3 \{\ +. ft \\*(f3 +. ds f3\" +' br \} +.el .ie !\\*(f2 \{\ +. ft \\*(f2 +. ds f2\" +' br \} +.el .ie !\\*(f1 \{\ +. ft \\*(f1 +. ds f1\" +' br \} +.el .tm ? font underflow +.. +.ds f1\" +.ds f2\" +.ds f3\" +.ds f4\" +'\" t +.ta 8n 16n 24n 32n 40n 48n 56n 64n 72n +.TH "sdptool" "1" +.SH "NAME" +sdptool \(em control and interrogate SDP servers +.SH "SYNOPSIS" +.PP +\fBsdptool\fR [\fIoptions\fR] {\fIcommand\fR} [\fIcommand parameters\fR \&...] +.SH "DESCRIPTION" +.PP +\fBsdptool\fR provides the interface for +performing SDP queries on Bluetooth devices, and administering a +local \fBsdpd\fR. +.SH "COMMANDS" +.PP +The following commands are available. +.IP "\fBsearch [--bdaddr bdaddr] [--tree] service\fP" 10 +Search for services.. +.IP "" 10 +Known service names are SP< DUN, LAN, FAX, OPUSH, +FTRN, NAP, GN, HID, CIP. +.IP "\fBbrowse [--tree] [bdaddr]\fP" 10 +Browse all available services on the device +specified by a Bluetooth address as a parameter. +.IP "\fBadd [ --channel=N ]\fP" 10 +Add a service to the local +\fBsdpd\fR. +.IP "" 10 +You can specify a channel to add the service on +using the \fB--channel\fP option. +.IP "\fBdel record_handle\fP" 10 +Remove a service from the local +\fBsdpd\fR. +.IP "\fBget [--tree] [--bdaddr bdaddr] record_handle\fP" 10 +Retrieve a service from the local +\fBsdpd\fR. +.IP "\fBsetattr record_handle attrib_id attrib_value\fP" 10 +Set or add an attribute to an SDP record. + +.IP "\fBsetseq record_handle attrib_id attrib_values\fP" 10 +Set or add an attribute sequence to an +SDP record. +.SH "OPTIONS" +.IP "\fB--help\fP" 10 +Displays help on using sdptool. + +.SH "EXAMPLES" +.PP +sdptool browse 00:80:98:24:15:6D +.PP +sdptool add DUN +.PP +sdptool del LAN +.SH "BUGS" +.PP +Documentation needs improving. +.SH "AUTHOR" +.PP +Maxim Krasnyansky . Man page written +by Edd Dumbill . + +.SH "SEE ALSO" +.PP +sdpd(8) +.\" created by instant / docbook-to-man, Thu 15 Jan 2004, 21:01 -- cgit From d9689662976b6e83f4c6ac9baacae98cb32700a1 Mon Sep 17 00:00:00 2001 From: Marcel Holtmann Date: Sun, 6 Mar 2005 11:18:59 +0000 Subject: Add example for browsing the local services --- tools/sdptool.1 | 2 ++ 1 file changed, 2 insertions(+) (limited to 'tools/sdptool.1') diff --git a/tools/sdptool.1 b/tools/sdptool.1 index 8f938f92..91a28a84 100644 --- a/tools/sdptool.1 +++ b/tools/sdptool.1 @@ -99,6 +99,8 @@ Displays help on using sdptool. .PP sdptool browse 00:80:98:24:15:6D .PP +sdptool browse local +.PP sdptool add DUN .PP sdptool del LAN -- cgit From 18cb95673231d41455528a782b168ee05f32fe2b Mon Sep 17 00:00:00 2001 From: Marcel Holtmann Date: Fri, 6 May 2005 14:13:41 +0000 Subject: Add command for retrieving possible service records --- tools/sdptool.1 | 2 ++ 1 file changed, 2 insertions(+) (limited to 'tools/sdptool.1') diff --git a/tools/sdptool.1 b/tools/sdptool.1 index 91a28a84..c4f248eb 100644 --- a/tools/sdptool.1 +++ b/tools/sdptool.1 @@ -73,6 +73,8 @@ FTRN, NAP, GN, HID, CIP. .IP "\fBbrowse [--tree] [bdaddr]\fP" 10 Browse all available services on the device specified by a Bluetooth address as a parameter. +.IP "\fBrecords [--tree] bdaddr\fP" 10 +Retrieve all possible service records. .IP "\fBadd [ --channel=N ]\fP" 10 Add a service to the local \fBsdpd\fR. -- cgit From e7b5f3c69c6a7303b951e7a1398c87a568a16761 Mon Sep 17 00:00:00 2001 From: Marcel Holtmann Date: Fri, 6 May 2005 16:10:26 +0000 Subject: Include a raw mode for showing the original record tree --- tools/sdptool.1 | 21 +++++++++++---------- 1 file changed, 11 insertions(+), 10 deletions(-) (limited to 'tools/sdptool.1') diff --git a/tools/sdptool.1 b/tools/sdptool.1 index c4f248eb..5ed9e33e 100644 --- a/tools/sdptool.1 +++ b/tools/sdptool.1 @@ -65,15 +65,16 @@ local \fBsdpd\fR. .SH "COMMANDS" .PP The following commands are available. -.IP "\fBsearch [--bdaddr bdaddr] [--tree] service\fP" 10 +.IP "\fBsearch [--bdaddr bdaddr] [--tree] [--raw] service\fP" 10 Search for services.. .IP "" 10 -Known service names are SP< DUN, LAN, FAX, OPUSH, -FTRN, NAP, GN, HID, CIP. -.IP "\fBbrowse [--tree] [bdaddr]\fP" 10 +Known service names are DID, SP, DUN, LAN, FAX, OPUSH, +FTP, HS, HF, SAP, NAP, GN, PANU, HID, CIP, CTP, A2SRC, A2SNK +and SYNCML. +.IP "\fBbrowse [--tree] [--raw] [bdaddr]\fP" 10 Browse all available services on the device specified by a Bluetooth address as a parameter. -.IP "\fBrecords [--tree] bdaddr\fP" 10 +.IP "\fBrecords [--tree] [--raw] bdaddr\fP" 10 Retrieve all possible service records. .IP "\fBadd [ --channel=N ]\fP" 10 Add a service to the local @@ -84,7 +85,7 @@ using the \fB--channel\fP option. .IP "\fBdel record_handle\fP" 10 Remove a service from the local \fBsdpd\fR. -.IP "\fBget [--tree] [--bdaddr bdaddr] record_handle\fP" 10 +.IP "\fBget [--tree] [--raw] [--bdaddr bdaddr] record_handle\fP" 10 Retrieve a service from the local \fBsdpd\fR. .IP "\fBsetattr record_handle attrib_id attrib_value\fP" 10 @@ -99,13 +100,13 @@ Displays help on using sdptool. .SH "EXAMPLES" .PP -sdptool browse 00:80:98:24:15:6D +sdptool browse 00:80:98:24:15:6D .PP -sdptool browse local +sdptool browse local .PP -sdptool add DUN +sdptool add DUN .PP -sdptool del LAN +sdptool del 0x10000 .SH "BUGS" .PP Documentation needs improving. -- cgit From 0bf15aa0833fccedbb038830bee423f29e6b1d5e Mon Sep 17 00:00:00 2001 From: Marcel Holtmann Date: Mon, 11 Jul 2005 17:19:40 +0000 Subject: Update some wording in the manual page --- tools/sdptool.1 | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) (limited to 'tools/sdptool.1') diff --git a/tools/sdptool.1 b/tools/sdptool.1 index 5ed9e33e..781a91e5 100644 --- a/tools/sdptool.1 +++ b/tools/sdptool.1 @@ -64,8 +64,14 @@ performing SDP queries on Bluetooth devices, and administering a local \fBsdpd\fR. .SH "COMMANDS" .PP -The following commands are available. -.IP "\fBsearch [--bdaddr bdaddr] [--tree] [--raw] service\fP" 10 +The following commands are available. In all cases \fBbdaddr\fR +specifies the device to search or browse. If \fIlocal\fP is used +for \fBbdaddr\fP, then the local \fBsdpd\fR is searched. +.PP +Services are identified and manipulated with a 4-byte \fBrecord_handle\fP +(NOT the service name). To find a service's \fBrecord_handle\fP, look for the +"Service RecHandle" line in the \fBsearch\fP or \fBbrowse\fP results +.IP "\fBsearch [--bdaddr bdaddr] [--tree] [--raw] service_name\fP" 10 Search for services.. .IP "" 10 Known service names are DID, SP, DUN, LAN, FAX, OPUSH, -- cgit From 6c53a6b4e4282459ec072a64d09a4c13a7feded5 Mon Sep 17 00:00:00 2001 From: Marcel Holtmann Date: Sat, 21 Jan 2006 11:39:07 +0000 Subject: Add service record for the ISDN profile --- tools/sdptool.1 | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) (limited to 'tools/sdptool.1') diff --git a/tools/sdptool.1 b/tools/sdptool.1 index 781a91e5..6f8d634d 100644 --- a/tools/sdptool.1 +++ b/tools/sdptool.1 @@ -74,17 +74,20 @@ Services are identified and manipulated with a 4-byte \fBrecord_handle\fP .IP "\fBsearch [--bdaddr bdaddr] [--tree] [--raw] service_name\fP" 10 Search for services.. .IP "" 10 -Known service names are DID, SP, DUN, LAN, FAX, OPUSH, -FTP, HS, HF, SAP, NAP, GN, PANU, HID, CIP, CTP, A2SRC, A2SNK -and SYNCML. +Known service names are DID, SP, DUN, LAN, FAX, OPUSH, +FTP, HS, HF, HFAG, SAP, NAP, GN, PANU, HID, CIP, +A2SRC, A2SNK, AVRCT, AVRTG, UDIUE, UDITE and SYNCML. .IP "\fBbrowse [--tree] [--raw] [bdaddr]\fP" 10 Browse all available services on the device specified by a Bluetooth address as a parameter. .IP "\fBrecords [--tree] [--raw] bdaddr\fP" 10 Retrieve all possible service records. -.IP "\fBadd [ --channel=N ]\fP" 10 +.IP "\fBadd [ --handle=N --channel=N ]\fP" 10 Add a service to the local \fBsdpd\fR. +.IP "" 10 +You can specify a handle for this record using +the \fB--handle\fP option. .IP "" 10 You can specify a channel to add the service on using the \fB--channel\fP option. -- cgit From e45e2d95822026cd2fd1de52644ba5096a1d4858 Mon Sep 17 00:00:00 2001 From: Marcel Holtmann Date: Sat, 21 Jan 2006 13:36:10 +0000 Subject: Add HCRP service identifier --- tools/sdptool.1 | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'tools/sdptool.1') diff --git a/tools/sdptool.1 b/tools/sdptool.1 index 6f8d634d..5392a97c 100644 --- a/tools/sdptool.1 +++ b/tools/sdptool.1 @@ -75,7 +75,7 @@ Services are identified and manipulated with a 4-byte \fBrecord_handle\fP Search for services.. .IP "" 10 Known service names are DID, SP, DUN, LAN, FAX, OPUSH, -FTP, HS, HF, HFAG, SAP, NAP, GN, PANU, HID, CIP, +FTP, HS, HF, HFAG, SAP, NAP, GN, PANU, HCRP, HID, CIP, A2SRC, A2SNK, AVRCT, AVRTG, UDIUE, UDITE and SYNCML. .IP "\fBbrowse [--tree] [--raw] [bdaddr]\fP" 10 Browse all available services on the device -- cgit From 07ad6734b5859f00f4cb4fbb0bda806953339a69 Mon Sep 17 00:00:00 2001 From: Marcel Holtmann Date: Thu, 23 Nov 2006 05:01:13 +0000 Subject: Don't forget to mention the --xml option in the manual page --- tools/sdptool.1 | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) (limited to 'tools/sdptool.1') diff --git a/tools/sdptool.1 b/tools/sdptool.1 index 5392a97c..686ec95a 100644 --- a/tools/sdptool.1 +++ b/tools/sdptool.1 @@ -71,16 +71,16 @@ for \fBbdaddr\fP, then the local \fBsdpd\fR is searched. Services are identified and manipulated with a 4-byte \fBrecord_handle\fP (NOT the service name). To find a service's \fBrecord_handle\fP, look for the "Service RecHandle" line in the \fBsearch\fP or \fBbrowse\fP results -.IP "\fBsearch [--bdaddr bdaddr] [--tree] [--raw] service_name\fP" 10 +.IP "\fBsearch [--bdaddr bdaddr] [--tree] [--raw] [--xml] service_name\fP" 10 Search for services.. .IP "" 10 Known service names are DID, SP, DUN, LAN, FAX, OPUSH, FTP, HS, HF, HFAG, SAP, NAP, GN, PANU, HCRP, HID, CIP, A2SRC, A2SNK, AVRCT, AVRTG, UDIUE, UDITE and SYNCML. -.IP "\fBbrowse [--tree] [--raw] [bdaddr]\fP" 10 +.IP "\fBbrowse [--tree] [--raw] [--xml] [bdaddr]\fP" 10 Browse all available services on the device specified by a Bluetooth address as a parameter. -.IP "\fBrecords [--tree] [--raw] bdaddr\fP" 10 +.IP "\fBrecords [--tree] [--raw] [--xml] bdaddr\fP" 10 Retrieve all possible service records. .IP "\fBadd [ --handle=N --channel=N ]\fP" 10 Add a service to the local @@ -94,7 +94,7 @@ using the \fB--channel\fP option. .IP "\fBdel record_handle\fP" 10 Remove a service from the local \fBsdpd\fR. -.IP "\fBget [--tree] [--raw] [--bdaddr bdaddr] record_handle\fP" 10 +.IP "\fBget [--tree] [--raw] [--xml] [--bdaddr bdaddr] record_handle\fP" 10 Retrieve a service from the local \fBsdpd\fR. .IP "\fBsetattr record_handle attrib_id attrib_value\fP" 10 -- cgit