Adding upstream version 2.38.1.upstream/2.38.1upstream

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

2 files changed, 327 insertions, 0 deletions

diff --git a/sys-utils/ldattach.8 b/sys-utils/ldattach.8
new file mode 100644
index 0000000..1436090
--- /dev/null
+++ b/sys-utils/ldattach.8
@@ -0,0 +1,198 @@
+'\" t
+.\"     Title: ldattach
+.\"    Author: [see the "AUTHOR(S)" section]
+.\" Generator: Asciidoctor 2.0.15
+.\"      Date: 2022-05-11
+.\"    Manual: System Administration
+.\"    Source: util-linux 2.38.1
+.\"  Language: English
+.\"
+.TH "LDATTACH" "8" "2022-05-11" "util\-linux 2.38.1" "System Administration"
+.ie \n(.g .ds Aq \(aq
+.el       .ds Aq '
+.ss \n[.ss] 0
+.nh
+.ad l
+.de URL
+\fI\\$2\fP <\\$1>\\$3
+..
+.als MTO URL
+.if \n[.g] \{\
+.  mso www.tmac
+.  am URL
+.    ad l
+.  .
+.  am MTO
+.    ad l
+.  .
+.  LINKSTYLE blue R < >
+.\}
+.SH "NAME"
+ldattach \- attach a line discipline to a serial line
+.SH "SYNOPSIS"
+.sp
+\fBldattach\fP [\fB\-1278denoVh\fP] [\fB\-i\fP \fIiflag\fP] [\fB\-s\fP \fIspeed\fP] \fIldisc device\fP
+.SH "DESCRIPTION"
+.sp
+The \fBldattach\fP daemon opens the specified \fIdevice\fP file (which should refer to a serial device) and attaches the line discipline \fIldisc\fP to it for processing of the sent and/or received data. It then goes into the background keeping the device open so that the line discipline stays loaded.
+.sp
+The line discipline \fIldisc\fP may be specified either by name or by number.
+.sp
+In order to detach the line discipline, \fBkill\fP(1) the \fBldattach\fP process.
+.sp
+With no arguments, \fBldattach\fP prints usage information.
+.SH "LINE DISCIPLINES"
+.sp
+Depending on the kernel release, the following line disciplines are supported:
+.sp
+\fBTTY\fP(\fB0\fP)
+.RS 4
+The default line discipline, providing transparent operation (raw mode) as well as the habitual terminal line editing capabilities (cooked mode).
+.RE
+.sp
+\fBSLIP\fP(\fB1\fP)
+.RS 4
+Serial Line IP (SLIP) protocol processor for transmitting TCP/IP packets over serial lines.
+.RE
+.sp
+\fBMOUSE\fP(\fB2\fP)
+.RS 4
+Device driver for RS232 connected pointing devices (serial mice).
+.RE
+.sp
+\fBPPP\fP(\fB3\fP)
+.RS 4
+Point to Point Protocol (PPP) processor for transmitting network packets over serial lines.
+.RE
+.sp
+\fBSTRIP\fP(\fB4\fP); \fBAX25\fP(\fB5\fP); \fBX25\fP(\fB6\fP)
+.RS 4
+Line driver for transmitting X.25 packets over asynchronous serial lines.
+.RE
+.sp
+\fB6PACK\fP(\fB7\fP); \fBR3964\fP(\fB9\fP)
+.RS 4
+Driver for Simatic R3964 module.
+.RE
+.sp
+\fBIRDA\fP(\fB11\fP)
+.RS 4
+Linux IrDa (infrared data transmission) driver \- see \c
+.URL "http://irda.sourceforge.net/" "" ""
+.RE
+.sp
+\fBHDLC\fP(\fB13\fP)
+.RS 4
+Synchronous HDLC driver.
+.RE
+.sp
+\fBSYNC_PPP\fP(\fB14\fP)
+.RS 4
+Synchronous PPP driver.
+.RE
+.sp
+\fBHCI\fP(\fB15\fP)
+.RS 4
+Bluetooth HCI UART driver.
+.RE
+.sp
+\fBGIGASET_M101\fP(\fB16\fP)
+.RS 4
+Driver for Siemens Gigaset M101 serial DECT adapter.
+.RE
+.sp
+\fBPPS\fP(\fB18\fP)
+.RS 4
+Driver for serial line Pulse Per Second (PPS) source.
+.RE
+.sp
+\fBGSM0710\fP(\fB21\fP)
+.RS 4
+Driver for GSM 07.10 multiplexing protocol modem (CMUX).
+.RE
+.SH "OPTIONS"
+.sp
+\fB\-1\fP, \fB\-\-onestopbit\fP
+.RS 4
+Set the number of stop bits of the serial line to one.
+.RE
+.sp
+\fB\-2\fP, \fB\-\-twostopbits\fP
+.RS 4
+Set the number of stop bits of the serial line to two.
+.RE
+.sp
+\fB\-7\fP, \fB\-\-sevenbits\fP
+.RS 4
+Set the character size of the serial line to 7 bits.
+.RE
+.sp
+\fB\-8\fP, \fB\-\-eightbits\fP
+.RS 4
+Set the character size of the serial line to 8 bits.
+.RE
+.sp
+\fB\-d\fP, \fB\-\-debug\fP
+.RS 4
+Keep \fBldattach\fP in the foreground so that it can be interrupted or debugged, and to print verbose messages about its progress to standard error output.
+.RE
+.sp
+\fB\-e\fP, \fB\-\-evenparity\fP
+.RS 4
+Set the parity of the serial line to even.
+.RE
+.sp
+\fB\-i\fP, \fB\-\-iflag\fP \fIvalue\fP...
+.RS 4
+Set the specified bits in the c_iflag word of the serial line. The given \fIvalue\fP may be a number or a symbolic name. If \fIvalue\fP is prefixed by a minus sign, the specified bits are cleared instead. Several comma\-separated values may be given in order to set and clear multiple bits.
+.RE
+.sp
+\fB\-n\fP, \fB\-\-noparity\fP
+.RS 4
+Set the parity of the serial line to none.
+.RE
+.sp
+\fB\-o\fP, \fB\-\-oddparity\fP
+.RS 4
+Set the parity of the serial line to odd.
+.RE
+.sp
+\fB\-s\fP, \fB\-\-speed\fP \fIvalue\fP
+.RS 4
+Set the speed (the baud rate) of the serial line to the specified \fIvalue\fP.
+.RE
+.sp
+\fB\-c\fP, \fB\-\-intro\-command\fP \fIstring\fP
+.RS 4
+Define an intro command that is sent through the serial line before the invocation of \fBldattach\fP. E.g. in conjunction with line discipline GSM0710, the command \(aqAT+CMUX=0\(rsr\(aq is commonly suitable to switch the modem into the CMUX mode.
+.RE
+.sp
+\fB\-p\fP, \fB\-\-pause\fP \fIvalue\fP
+.RS 4
+Sleep for \fIvalue\fP seconds before the invocation of \fBldattach\fP. Default is one second.
+.RE
+.sp
+\fB\-h\fP, \fB\-\-help\fP
+.RS 4
+Display help text and exit.
+.RE
+.sp
+\fB\-V\fP, \fB\-\-version\fP
+.RS 4
+Print version and exit.
+.RE
+.SH "AUTHORS"
+.sp
+.MTO "tilman\(atimap.cc" "Tilman Schmidt" ""
+.SH "SEE ALSO"
+.sp
+\fBinputattach\fP(1),
+\fBttys\fP(4)
+.SH "REPORTING BUGS"
+.sp
+For bug reports, use the issue tracker at \c
+.URL "https://github.com/util\-linux/util\-linux/issues" "" "."
+.SH "AVAILABILITY"
+.sp
+The \fBldattach\fP command is part of the util\-linux package which can be downloaded from \c
+.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "Linux Kernel Archive" "."
\ No newline at end of file
diff --git a/sys-utils/ldattach.8.adoc b/sys-utils/ldattach.8.adoc
new file mode 100644
index 0000000..07549fb
--- /dev/null
+++ b/sys-utils/ldattach.8.adoc
@@ -0,0 +1,129 @@
+//po4a: entry man manual
+////
+Copyright 2008 Tilman Schmidt (tilman@imap.cc)
+May be distributed under the GNU General Public License version 2 or later
+////
+= ldattach(8)
+:doctype: manpage
+:man manual: System Administration
+:man source: util-linux {release-version}
+:page-layout: base
+:command: ldattach
+
+== NAME
+
+ldattach - attach a line discipline to a serial line
+
+== SYNOPSIS
+
+*ldattach* [*-1278denoVh*] [*-i* _iflag_] [*-s* _speed_] _ldisc device_
+
+== DESCRIPTION
+
+The *ldattach* daemon opens the specified _device_ file (which should refer to a serial device) and attaches the line discipline _ldisc_ to it for processing of the sent and/or received data. It then goes into the background keeping the device open so that the line discipline stays loaded.
+
+The line discipline _ldisc_ may be specified either by name or by number.
+
+In order to detach the line discipline, *kill*(1) the *ldattach* process.
+
+With no arguments, *ldattach* prints usage information.
+
+== LINE DISCIPLINES
+
+Depending on the kernel release, the following line disciplines are supported:
+
+*TTY*(*0*)::
+The default line discipline, providing transparent operation (raw mode) as well as the habitual terminal line editing capabilities (cooked mode).
+
+*SLIP*(*1*)::
+Serial Line IP (SLIP) protocol processor for transmitting TCP/IP packets over serial lines.
+
+*MOUSE*(*2*)::
+Device driver for RS232 connected pointing devices (serial mice).
+
+*PPP*(*3*)::
+Point to Point Protocol (PPP) processor for transmitting network packets over serial lines.
+
+*STRIP*(*4*); *AX25*(*5*); *X25*(*6*)::
+Line driver for transmitting X.25 packets over asynchronous serial lines.
+
+*6PACK*(*7*); *R3964*(*9*)::
+Driver for Simatic R3964 module.
+
+*IRDA*(*11*)::
+Linux IrDa (infrared data transmission) driver - see http://irda.sourceforge.net/
+
+*HDLC*(*13*)::
+Synchronous HDLC driver.
+
+*SYNC_PPP*(*14*)::
+Synchronous PPP driver.
+
+*HCI*(*15*)::
+Bluetooth HCI UART driver.
+
+*GIGASET_M101*(*16*)::
+Driver for Siemens Gigaset M101 serial DECT adapter.
+
+*PPS*(*18*)::
+Driver for serial line Pulse Per Second (PPS) source.
+
+*GSM0710*(*21*)::
+Driver for GSM 07.10 multiplexing protocol modem (CMUX).
+
+== OPTIONS
+
+*-1*, *--onestopbit*::
+Set the number of stop bits of the serial line to one.
+
+*-2*, *--twostopbits*::
+Set the number of stop bits of the serial line to two.
+
+*-7*, *--sevenbits*::
+Set the character size of the serial line to 7 bits.
+
+*-8*, *--eightbits*::
+Set the character size of the serial line to 8 bits.
+
+*-d*, *--debug*::
+Keep *ldattach* in the foreground so that it can be interrupted or debugged, and to print verbose messages about its progress to standard error output.
+
+*-e*, *--evenparity*::
+Set the parity of the serial line to even.
+
+*-i*, *--iflag* [*-*]_value_...::
+Set the specified bits in the c_iflag word of the serial line. The given _value_ may be a number or a symbolic name. If _value_ is prefixed by a minus sign, the specified bits are cleared instead. Several comma-separated values may be given in order to set and clear multiple bits.
+
+*-n*, *--noparity*::
+Set the parity of the serial line to none.
+
+*-o*, *--oddparity*::
+Set the parity of the serial line to odd.
+
+*-s*, *--speed* _value_::
+Set the speed (the baud rate) of the serial line to the specified _value_.
+
+*-c*, *--intro-command* _string_::
+Define an intro command that is sent through the serial line before the invocation of *ldattach*. E.g. in conjunction with line discipline GSM0710, the command 'AT+CMUX=0\r' is commonly suitable to switch the modem into the CMUX mode.
+
+*-p*, *--pause* _value_::
+Sleep for _value_ seconds before the invocation of *ldattach*. Default is one second.
+
+include::man-common/help-version.adoc[]
+
+== AUTHORS
+
+mailto:tilman@imap.cc[Tilman Schmidt]
+
+== SEE ALSO
+
+*inputattach*(1),
+*ttys*(4)
+
+include::man-common/bugreports.adoc[]
+
+include::man-common/footer.adoc[]
+
+ifdef::translation[]
+include::man-common/translation.adoc[]
+endif::[]