From 638a31a3e24744379ca4274722cebfb783cb3acd Mon Sep 17 00:00:00 2001 From: ru Date: Tue, 20 May 2003 21:01:21 +0000 Subject: Reapply mdoc(7) fixes that got accidentally lost in the last Bluetooth update, and fix a few more issues. Submitted by: Maksim Yevmenkin , ru Approved by: re (blanket) --- usr.bin/bluetooth/btsockstat/btsockstat.1 | 40 ++++++++------- usr.bin/bluetooth/rfcomm_sppd/rfcomm_sppd.1 | 77 +++++++++++++++-------------- 2 files changed, 62 insertions(+), 55 deletions(-) (limited to 'usr.bin/bluetooth') diff --git a/usr.bin/bluetooth/btsockstat/btsockstat.1 b/usr.bin/bluetooth/btsockstat/btsockstat.1 index 608958d..d76799b 100644 --- a/usr.bin/bluetooth/btsockstat/btsockstat.1 +++ b/usr.bin/bluetooth/btsockstat/btsockstat.1 @@ -1,5 +1,3 @@ -.\" btsockstat.1 -.\" .\" Copyright (c) 2001-2002 Maksim Yevmenkin .\" All rights reserved. .\" @@ -26,6 +24,7 @@ .\" .\" $Id: btsockstat.1,v 1.4 2003/04/27 19:25:15 max Exp $ .\" $FreeBSD$ +.\" .Dd August 31, 2002 .Dt BTSOCKSTAT 1 .Os @@ -34,43 +33,46 @@ .Nd show Bluetooth sockets information .Sh SYNOPSIS .Nm -.Op Fl p Ar protocol -.Op Fl r +.Op Fl rh .Op Fl M Ar core -.Op Fl h +.Op Fl p Ar protocol .Sh DESCRIPTION The -.Nm -command symbolically displays the contents of various Bluetooth sockets -related data structures. There are few output formats, depending on the +.Nm +utility symbolically displays the contents of various Bluetooth sockets +related data structures. +There are few output formats, depending on the options for the information presented. +The .Nm -will print results to the standard output and error messages to the +utility +will print results to the standard output and error messages to the standard error. .Pp The options are as follows: .Bl -tag -width indent +.It Fl h +Display usage message and exit. +.It Fl M Ar core +Extract values associated with the name list from the specified core +instead of the default +.Pa /dev/kmem . .It Fl p Ar protocol -Display a list of active sockets (protocol control blocks) for each -specified protocol. Supported protocols are: +Display a list of active sockets (protocol control blocks) for each +specified protocol. +Supported protocols are: .Cm hci_raw , l2cap_raw , l2cap, rfcomm and .Cm rfcomm_s . .It Fl r Display a list of active routing entries (if any) for specified protocol. -.It Fl M Ar core -Extract values associated with the name list from the specified core -instead of the default -.Pa /dev/kmem . -.It Fl h -Display usage message and exit. .El .Sh BUGS -Most likely. Please report if found. +Most likely. +Please report if found. .Sh DIAGNOSTICS .Ex -std .Sh SEE ALSO .Xr ng_btsocket 4 .Sh AUTHORS .An Maksim Yevmenkin Aq m_evmenkin@yahoo.com - diff --git a/usr.bin/bluetooth/rfcomm_sppd/rfcomm_sppd.1 b/usr.bin/bluetooth/rfcomm_sppd/rfcomm_sppd.1 index 8c244d6..a2804b0 100644 --- a/usr.bin/bluetooth/rfcomm_sppd/rfcomm_sppd.1 +++ b/usr.bin/bluetooth/rfcomm_sppd/rfcomm_sppd.1 @@ -1,8 +1,6 @@ -.\" rfcomm_pppd.1 -.\" .\" Copyright (c) 2001-2003 Maksim Yevmenkin .\" All rights reserved. -.\" +.\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: @@ -11,7 +9,7 @@ .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. -.\" +.\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE @@ -23,9 +21,10 @@ .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. -.\" +.\" .\" $Id: rfcomm_sppd.1,v 1.1 2003/04/26 23:55:34 max Exp $ .\" $FreeBSD$ +.\" .Dd April 26, 2003 .Dt RFCOMM_SPPD 1 .Os @@ -34,61 +33,66 @@ .Nd RFCOMM Serial Port Profile daemon .Sh SYNOPSIS .Nm -.Op Fl a Ar BD_ADDR -.Op Fl b -.Op Fl c Ar channel -.Op Fl t Ar tty -.Op Fl h +.Op Fl bh +.Fl a Ar BD_ADDR +.Fl c Ar channel +.Fl t Ar tty .Sh DESCRIPTION The .Nm -is a Serial Port Profile daemon. It opens RFCOMM connection to the -specified server's BD_ADDR and channel. Once connection is established +utility is a Serial Port Profile daemon. +It opens RFCOMM connection to the specified server's +.Ar BD_ADDR +and +.Ar channel . +Once connection is established, the .Nm -provides access to the server's remote serial port via +utility provides access to the server's remote serial port via .Xr pty 4 interface. .Pp +The .Nm -opens both master and slave pseudo terminals. This is done to ensure that -RFCOMM connection stays open until +utility opens both master and slave pseudo terminals. +This is done to ensure that RFCOMM connection stays open until .Nm -is terminated. The data received from the master pseudo terminal are sent over -the RFCOMM connection. The data received from the RFCOMM connection are written -into master pseudo terminal. The application in its turn opens slave pseudo +is terminated. +The data received from the master pseudo terminal are sent over +the RFCOMM connection. +The data received from the RFCOMM connection are written +into master pseudo terminal. +The application in its turn opens the slave pseudo terminal and operates on it just like it would operate over the standard serial port. .Pp The options are as follows: .Bl -tag -width indent .It Fl a Ar BD_ADDR -This requied option specifies the remote BD_ADDR of the RFCOMM server. +This required option specifies the remote BD_ADDR of the RFCOMM server. .It Fl b -Detach from the controlling terminal, i.e. run in background. +Detach from the controlling terminal, i.e., run in background. .It Fl c Ar channel -This required option specifies RFCOMM channel to connect to. This channel -must provide Serial Port service. -.It Fl t Ar tty -Slave pseudo tty name. +This required option specifies RFCOMM channel to connect to. +This channel must provide Serial Port service. .It Fl h Display usage message and exit. +.It Fl t Ar tty +Slave pseudo tty name. .El .Sh EXAMPLES -.Bl -tag -width indent -.It rfcomm_sppd -a 00:01:02:03:04:05 -c 1 -t /dev/ttyp1 +.Dl "rfcomm_sppd -a 00:01:02:03:04:05 -c 1 -t /dev/ttyp1" .Pp -Will start +Will start the .Nm -and open RFCOMM connection to the server at -.Em 00:01:02:03:04:05 -and channel -.Em 1 . -Once connection has been established +utility and open RFCOMM connection to the server at +.Li 00:01:02:03:04:05 +and channel +.Li 1 . +Once the connection has been established, .Pa /dev/ttyp1 can be used to talk to the remote serial port on the server. -.El .Sh FILES -.Bl -tag -width /dev/tty[p-sP-S][0-9a-v]x -compact +.Bl -tag -width ".Pa /dev/tty[p-sP-S][0-9a-v]" -compact .It Pa /dev/pty[p-sP-S][0-9a-v] master pseudo terminals .It Pa /dev/tty[p-sP-S][0-9a-v] @@ -97,11 +101,12 @@ slave pseudo terminals .Sh DIAGNOSTICS .Ex -std .Sh BUGS +The .Nm -currently is not integrated with SDP (Service Discovery Protocol). +utility is not currently integrated with SDP (Service Discovery Protocol). .Sh SEE ALSO -.Xr pty 4 , .Xr ng_btsocket 4 , +.Xr pty 4 , .Xr rfcomm_pppd 8 .Sh AUTHORS .An Maksim Yevmenkin Aq m_evmenkin@yahoo.com -- cgit v1.1