Upload Tizen:Base source
[framework/base/util-linux-ng.git] / sys-utils / ldattach.8
1 .\" Copyright 2008 Tilman Schmidt (tilman@imap.cc)
2 .\" May be distributed under the GNU General Public License version 2 or later
3 .TH LDATTACH 8 "14 January 2008" "Linux 2.6" "Linux Programmer's Manual"
4 .SH NAME
5 ldattach \- attach a line discipline to a serial line
6 .SH SYNOPSIS
7 .B ldattach
8 .RB [ \-dhV78neo12 ]
9 .RB [ \-s
10 .IR speed ]
11 .I ldisc device
12 .SH DESCRIPTION
13 The
14 .B ldattach
15 daemon opens the specified
16 .I device
17 file
18 (which should refer to a serial device)
19 and attaches the line discipline
20 .I ldisc
21 to it for processing of the sent and/or received data.
22 It then goes into the background keeping the device open so that the
23 line discipline stays loaded.
24
25 The line discipline
26 .I ldisc
27 may be specified either by name
28 or by number.
29
30 In order to detach the line discipline,
31 .BR kill (1)
32 the
33 .B ldattach
34 process.
35
36 With no arguments,
37 .B ldattach
38 prints usage information.
39 .SH LINE DISCIPLINES
40 Depending on the kernel release, the following line disciplines are supported:
41 .TP
42 .BR TTY ( 0 )
43 The default line discipline,
44 providing transparent operation (raw mode)
45 as well as the habitual terminal line editing capabilities (cooked mode).
46 .TP
47 .BR SLIP ( 1 )
48 Serial Line IP (SLIP) protocol processor
49 for transmitting TCP/IP packets over serial lines.
50 .TP
51 .BR MOUSE ( 2 )
52 Device driver for RS232 connected pointing devices (serial mice).
53 .TP
54 .BR PPP ( 3 )
55 Point to Point Protocol (PPP) processor
56 for transmitting network packets over serial lines.
57 .TP
58 .BR STRIP ( 4 )
59 .TP
60 .BR AX25 ( 5 )
61 .TP
62 .BR X25 ( 6 )
63 Line driver for transmitting X.25 packets over asynchronous serial lines.
64 .TP
65 .BR 6PACK ( 7 )
66 .TP
67 .BR R3964 ( 9 )
68 Driver for Simatic R3964 module.
69 .TP
70 .BR IRDA ( 11 )
71 Linux IrDa (infrared data transmission) driver -
72 see http://irda.sourceforge.net/
73 .TP
74 .BR HDLC ( 13 )
75 Synchronous HDLC driver.
76 .TP
77 .BR SYNC_PPP ( 14 )
78 Synchronous PPP driver.
79 .TP
80 .BR HCI ( 15 )
81 Bluetooth HCI UART driver.
82 .TP
83 .BR GIGASET_M101 ( 16 )
84 Driver for Siemens Gigaset M101 serial DECT adapter.
85 .TP
86 .BR PPS ( 18 )
87 Driver for serial line Pulse Per Second (PPS) source.
88 .SH OPTIONS
89 .TP
90 \fB-d\fP | \fB--debug\fP
91 Causes
92 .B ldattach
93 to stay in the foreground so that it can be interrupted or debugged,
94 and to print verbose messages about its progress to the standard error output.
95 .TP
96 \fB-h\fP | \fB--help\fP
97 Prints a usage message and exits.
98 .TP
99 \fB-V\fP | \fB--version\fP
100 Prints the program version.
101 .TP
102 \fB-s\fP \fIvalue\fP | \fB--speed\fP \fIvalue\fP
103 Set the speed of the serial line to the specified value.
104 .TP
105 \fB-7\fP | \fB--sevenbits\fP
106 Sets the character size of the serial line to 7 bits.
107 .TP
108 \fB-8\fP | \fB--eightbits\fP
109 Sets the character size of the serial line to 8 bits.
110 .TP
111 \fB-n\fP | \fB--noparity\fP
112 Sets the parity of the serial line to none.
113 .TP
114 \fB-e\fP | \fB--evenparity\fP
115 Sets the parity of the serial line to even.
116 .TP
117 \fB-o\fP | \fB--oddparity\fP
118 Sets the parity of the serial line to odd.
119 .TP
120 \fB-1\fP | \fB--onestopbit\fP
121 Sets the number of stop bits of the serial line to one.
122 .TP
123 \fB-2\fP | \fB--twostopbits\fP
124 Sets the number of stop bits of the serial line to two.
125 .SH "SEE ALSO"
126 .BR inputattach (1),
127 .BR ttys (4)
128 .SH AUTHOR
129 .nf
130 Tilman Schmidt (tilman@imap.cc)
131 .fi
132 .SH AVAILABILITY
133 The ldattach command is part of the util-linux-ng package
134 and is available from
135 ftp://ftp.kernel.org/pub/linux/utils/util-linux-ng/.