xref: /netbsd/usr.sbin/irdaattach/irdaattach.8 (revision bf9ec67e)
1.\"	$NetBSD: irdaattach.8,v 1.4 2001/12/05 20:12:37 augustss Exp $
2.\"
3.\" Copyright (c) 2001 The NetBSD Foundation, Inc.
4.\" All rights reserved.
5.\"
6.\" This code is derived from software contributed to The NetBSD Foundation
7.\" by Lennart Augustsson.
8.\"
9.\" Redistribution and use in source and binary forms, with or without
10.\" modification, are permitted provided that the following conditions
11.\" are met:
12.\" 1. Redistributions of source code must retain the above copyright
13.\"    notice, this list of conditions and the following disclaimer.
14.\" 2. Redistributions in binary form must reproduce the above copyright
15.\"    notice, this list of conditions and the following disclaimer in the
16.\"    documentation and/or other materials provided with the distribution.
17.\" 3. All advertising materials mentioning features or use of this software
18.\"    must display the following acknowledgement:
19.\"        This product includes software developed by the NetBSD
20.\"        Foundation, Inc. and its contributors.
21.\" 4. Neither the name of The NetBSD Foundation nor the names of its
22.\"    contributors may be used to endorse or promote products derived
23.\"    from this software without specific prior written permission.
24.\"
25.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
26.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
27.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
28.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
29.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
30.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
31.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
32.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
33.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
34.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
35.\" POSSIBILITY OF SUCH DAMAGE.
36.\"
37.Dd December 4, 2001
38.Dt IRDAATTACH 8
39.Os
40.Sh NAME
41.Nm irdaattach
42.Nd attach serial lines to IrDA frame driver
43.Sh SYNOPSIS
44.Nm
45.Op Fl d Ar dongle
46.Op Fl fHhlmnp
47.Ar ttyname
48.Sh DESCRIPTION
49.Nm
50is used to assign a tty line to an IrDA frame level driver.
51The following operands are supported by
52.Nm "" :
53.Bl -tag -width Ar
54.It Fl d Ar dongle
55Sets the dongle type.  The following dongles are supported:
56.Bl -tag -width actisys+
57.It none
58No dongle
59.It tekram
60Tekram IR-210B
61.It jeteye
62Extended Systems JetEye
63.It actisys
64ACTiSYS IR-220L
65.It actisys+
66ACTiSYS IR-220L+
67.It litelink
68Parallax LiteLink
69.It girbil
70Greenwich GIrBIL
71.El
72.Pp
73The default is
74.Dv none .
75.It Fl f
76Print the name of the IrDA frame device that should be used to
77access the frames.
78.It Fl H
79Turn on DTR/CTS flow control.  By default, no flow control is done.
80.It Fl h
81Turn on RTS/CTS flow control.  By default, no flow control is done.
82.It Fl l
83Turn on the CLOCAL flag, making it possible to run SLIP on a cable
84without modem control signals (e.g. DTR, DSR, DCD).
85.It Fl m
86Maintain modem control signals after closing the line.  Specifically,
87this disables HUPCL.
88.It Fl n
89Do not detach from invoking tty.
90.It Fl p
91Print process id to file.
92.It Ar ttyname
93Specifies the name of the tty device.
94.Ar Ttyname
95should be a string of the form
96.Ql ttyXX ,
97or
98.Ql /dev/ttyXX .
99.El
100.Pp
101Only the super-user may attach a network interface.
102.Pp
103The frame driver is detached by killing the
104.Nm
105process.
106.Sh EXAMPLES
107.Bd -literal -offset indent -compact
108irdaattach tty00
109ircomm \-Y \-d `irdaattach \-p \-f /dev/tty02`
110.Ed
111.Sh DIAGNOSTICS
112Messages indicating that the specified interface does not exist, the
113requested address is unknown, or that the user is not privileged but
114tried to alter an interface's configuration.
115.Sh SEE ALSO
116.Xr daemon 3 ,
117.Xr irframe 4 ,
118.Xr irframetty 4 ,
119.Xr slattach 8
120.Sh HISTORY
121The
122.Nm
123command appeared in
124.Nx 1.6 .
125