usr.sbin/irdaattach/irdaattach.8

   1 .\"     $NetBSD: irdaattach.8,v 1.5 2003/02/25 10:36:10 wiz 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 .\"
  18 .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
  19 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
  20 .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  21 .\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
  22 .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  23 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  24 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  25 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  26 .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  27 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  28 .\" POSSIBILITY OF SUCH DAMAGE.
  29 .\"
  30 .Dd December 4, 2001
  31 .Dt IRDAATTACH 8
  32 .Os
  33 .Sh NAME
  34 .Nm irdaattach
  35 .Nd attach serial lines to IrDA frame driver
  36 .Sh SYNOPSIS
  37 .Nm
  38 .Op Fl d Ar dongle
  39 .Op Fl fHhlmnp
  40 .Ar ttyname
  41 .Sh DESCRIPTION
  42 .Nm
  43 is used to assign a tty line to an IrDA frame level driver.
  44 The following operands are supported by
  45 .Nm :
  46 .Bl -tag -width Ar
  47 .It Fl d Ar dongle
  48 Sets the dongle type.  The following dongles are supported:
  49 .Bl -tag -width actisys+
  50 .It none
  51 No dongle
  52 .It tekram
  53 Tekram IR-210B
  54 .It jeteye
  55 Extended Systems JetEye
  56 .It actisys
  57 ACTiSYS IR-220L
  58 .It actisys+
  59 ACTiSYS IR-220L+
  60 .It litelink
  61 Parallax LiteLink
  62 .It girbil
  63 Greenwich GIrBIL
  64 .El
  65 .Pp
  66 The default is
  67 .Dv none .
  68 .It Fl f
  69 Print the name of the IrDA frame device that should be used to
  70 access the frames.
  71 .It Fl H
  72 Turn on DTR/CTS flow control.  By default, no flow control is done.
  73 .It Fl h
  74 Turn on RTS/CTS flow control.  By default, no flow control is done.
  75 .It Fl l
  76 Turn on the CLOCAL flag, making it possible to run SLIP on a cable
  77 without modem control signals (e.g. DTR, DSR, DCD).
  78 .It Fl m
  79 Maintain modem control signals after closing the line.  Specifically,
  80 this disables HUPCL.
  81 .It Fl n
  82 Do not detach from invoking tty.
  83 .It Fl p
  84 Print process id to file.
  85 .It Ar ttyname
  86 Specifies the name of the tty device.
  87 .Ar Ttyname
  88 should be a string of the form
  89 .Ql ttyXX ,
  90 or
  91 .Ql /dev/ttyXX .
  92 .El
  93 .Pp
  94 Only the super-user may attach a network interface.
  95 .Pp
  96 The frame driver is detached by killing the
  97 .Nm
  98 process.
  99 .Sh EXAMPLES
 100 .Bd -literal -offset indent -compact
 101 irdaattach tty00
 102 ircomm \-Y \-d `irdaattach \-p \-f /dev/tty02`
 103 .Ed
 104 .Sh DIAGNOSTICS
 105 Messages indicating that the specified interface does not exist, the
 106 requested address is unknown, or that the user is not privileged but
 107 tried to alter an interface's configuration.
 108 .Sh SEE ALSO
 109 .Xr daemon 3 ,
 110 .Xr irframe 4 ,
 111 .Xr irframetty 4 ,
 112 .Xr slattach 8
 113 .Sh HISTORY
 114 The
 115 .Nm
 116 command appeared in
 117 .Nx 1.6 .