freebsd-dev/usr.sbin/lptcontrol/lptcontrol.8

.\"
.\" lptcontrol - a utility for manipulating the lpt driver
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 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.
.\"
.\" $FreeBSD$
.Dd September 3, 1994
.Dt LPTCONTROL 8
.Os
.Sh NAME
.Nm lptcontrol
.Nd a utility for manipulating the lpt printer driver
.Sh SYNOPSIS
.Nm
.Fl i | p | e | s
.Op Fl d Ar device
.Sh DESCRIPTION
The
.Nm
utility is used to set either the interrupt-driven, extended or polling mode
of individual
.Xr lpt 4
devices.
When a printer is switched from
a mode to another, this change will only take effect
the next time the device is opened.
.Pp
Extended mode is anything the parallel port interface can support.
For an
ECP/ISA parallel port, it may be FIFO+DMA or ECP.
.Pp
The following command line options are supported:
.Bl -tag -width indent
.It Fl i
Turn on interrupt-driven mode.
.It Fl p
Turn on polled mode.
.It Fl e
Turn on extended mode.
.It Fl s
Turn on standard mode, i.e. turn off extended mode.
.It Fl d Ar device
Set the mode of the printer device specified by
.Ar device .
The default value for
.Ar device
is
.Pa /dev/lpt0 .
.El
.Pp
One of
.Fl i , p
or
.Fl e
must be specified.
.Sh FILES
.Bl -tag -width /sys/i386/conf/GENERIC -compact
.It Pa /dev/lpt?
printer devices
.It Pa /dev/lpctl?
printer control devices
.It Pa /sys/i386/conf/GENERIC
kernel configuration file
.El
.Sh BUGS
Sure to be some.
.Sh SEE ALSO
.Xr lpt 4
.Sh AUTHORS
.An Geoffrey M. Rehmet
.Sh HISTORY
The
.Nm
utility
first appeared in
.Fx 1.1.5
Bring in lptcontrol from 1.1.5.1 Submitted by: Geoff 1994-09-03 13:10:09 +00:00			`.\"`
			`.\" lptcontrol - a utility for manipulating the lpt driver`
			`.\"`
			`.\" Redistribution and use in source and binary forms, with or without`
			`.\" modification, are permitted provided that the following conditions`
			`.\" are met:`
			`.\" 1. Redistributions of source code must retain the above copyright`
			`.\" notice, this list of conditions and the following disclaimer.`
			`.\" 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.`
			`.\"`
$Id$ -> $FreeBSD$ 1999-08-28 01:35:59 +00:00			`.\" $FreeBSD$`
Make it possible to run lptcontrol on a printer port which does not actually have a printer connected or online: - MAKEDEV: remove all signs of lpa add lpctl? devices (minor # = unit + 128) - usr.sbin/Makefile add lptcontrol - sys/i386/isa/lpt.c implement the LP_BYPASS flag: when a unit is opened with this flag set, the printer is not primed, and no check is made to see that the printer is online. This can only be used to pass ioctls. (giving us /dev/lpctl?) - lptcontrol.c use /dev/lpctl? (LP_BYPASS) -f flag removed, -u flag added - lptcontrol.8 document changes in lptcontrol rewrite using mandoc macros Submitted by: Geoff. 1994-09-03 22:47:08 +00:00			`.Dd September 3, 1994`
			`.Dt LPTCONTROL 8`
mdoc(7) police: removed HISTORY info from the .Os call. 2001-07-10 15:12:08 +00:00			`.Os`
Make it possible to run lptcontrol on a printer port which does not actually have a printer connected or online: - MAKEDEV: remove all signs of lpa add lpctl? devices (minor # = unit + 128) - usr.sbin/Makefile add lptcontrol - sys/i386/isa/lpt.c implement the LP_BYPASS flag: when a unit is opened with this flag set, the printer is not primed, and no check is made to see that the printer is online. This can only be used to pass ioctls. (giving us /dev/lpctl?) - lptcontrol.c use /dev/lpctl? (LP_BYPASS) -f flag removed, -u flag added - lptcontrol.8 document changes in lptcontrol rewrite using mandoc macros Submitted by: Geoff. 1994-09-03 22:47:08 +00:00			`.Sh NAME`
mdoc(7) police: split punctuation characters + misc fixes. 2001-02-01 16:44:04 +00:00			`.Nm lptcontrol`
Use err(3). 1997-09-25 06:36:29 +00:00			`.Nd a utility for manipulating the lpt printer driver`
Make it possible to run lptcontrol on a printer port which does not actually have a printer connected or online: - MAKEDEV: remove all signs of lpa add lpctl? devices (minor # = unit + 128) - usr.sbin/Makefile add lptcontrol - sys/i386/isa/lpt.c implement the LP_BYPASS flag: when a unit is opened with this flag set, the printer is not primed, and no check is made to see that the printer is online. This can only be used to pass ioctls. (giving us /dev/lpctl?) - lptcontrol.c use /dev/lpctl? (LP_BYPASS) -f flag removed, -u flag added - lptcontrol.8 document changes in lptcontrol rewrite using mandoc macros Submitted by: Geoff. 1994-09-03 22:47:08 +00:00			`.Sh SYNOPSIS`
mdoc(7) police: use the new features of the Nm macro. 2000-11-20 20:10:44 +00:00			`.Nm`
mdoc(7) police: split punctuation characters + misc fixes. 2001-02-01 16:44:04 +00:00			`.Fl i \| p \| e \| s`
Add -e option and change unit to device access in lptcontrol.8 Change unit to device access in lptcontrol.c. Now usage is lptcontrol -i \| -p \| -e [-d /dev/lpt?] 1999-02-14 12:23:49 +00:00			`.Op Fl d Ar device`
Make it possible to run lptcontrol on a printer port which does not actually have a printer connected or online: - MAKEDEV: remove all signs of lpa add lpctl? devices (minor # = unit + 128) - usr.sbin/Makefile add lptcontrol - sys/i386/isa/lpt.c implement the LP_BYPASS flag: when a unit is opened with this flag set, the printer is not primed, and no check is made to see that the printer is online. This can only be used to pass ioctls. (giving us /dev/lpctl?) - lptcontrol.c use /dev/lpctl? (LP_BYPASS) -f flag removed, -u flag added - lptcontrol.8 document changes in lptcontrol rewrite using mandoc macros Submitted by: Geoff. 1994-09-03 22:47:08 +00:00			`.Sh DESCRIPTION`
Bring in lptcontrol from 1.1.5.1 Submitted by: Geoff 1994-09-03 13:10:09 +00:00			`The`
Use err(3). 1997-09-25 06:36:29 +00:00			`.Nm`
The .Nm utility 2002-07-14 14:47:15 +00:00			`utility is used to set either the interrupt-driven, extended or polling mode`
Remove whitespace at EOL. 2001-07-15 08:06:20 +00:00			`of individual`
Make it possible to run lptcontrol on a printer port which does not actually have a printer connected or online: - MAKEDEV: remove all signs of lpa add lpctl? devices (minor # = unit + 128) - usr.sbin/Makefile add lptcontrol - sys/i386/isa/lpt.c implement the LP_BYPASS flag: when a unit is opened with this flag set, the printer is not primed, and no check is made to see that the printer is online. This can only be used to pass ioctls. (giving us /dev/lpctl?) - lptcontrol.c use /dev/lpctl? (LP_BYPASS) -f flag removed, -u flag added - lptcontrol.8 document changes in lptcontrol rewrite using mandoc macros Submitted by: Geoff. 1994-09-03 22:47:08 +00:00			`.Xr lpt 4`
mdoc(7) police: split punctuation characters + misc fixes. 2001-02-01 16:44:04 +00:00			`devices.`
			`When a printer is switched from`
Add -e option and change unit to device access in lptcontrol.8 Change unit to device access in lptcontrol.c. Now usage is lptcontrol -i \| -p \| -e [-d /dev/lpt?] 1999-02-14 12:23:49 +00:00			`a mode to another, this change will only take effect`
Bring in lptcontrol from 1.1.5.1 Submitted by: Geoff 1994-09-03 13:10:09 +00:00			`the next time the device is opened.`
Add -e option and change unit to device access in lptcontrol.8 Change unit to device access in lptcontrol.c. Now usage is lptcontrol -i \| -p \| -e [-d /dev/lpt?] 1999-02-14 12:23:49 +00:00			`.Pp`
Remove single-space hard sentence breaks. These degrade the quality of the typeset output, tend to make diffs harder to read and provide bad examples for new-comers to mdoc. 2000-03-01 14:09:25 +00:00			`Extended mode is anything the parallel port interface can support.`
			`For an`
Add -e option and change unit to device access in lptcontrol.8 Change unit to device access in lptcontrol.c. Now usage is lptcontrol -i \| -p \| -e [-d /dev/lpt?] 1999-02-14 12:23:49 +00:00			`ECP/ISA parallel port, it may be FIFO+DMA or ECP.`
Remove incorrect section name. Use .Pa or .Ar instead of .Em. 1999-11-27 16:54:36 +00:00			`.Pp`
Make it possible to run lptcontrol on a printer port which does not actually have a printer connected or online: - MAKEDEV: remove all signs of lpa add lpctl? devices (minor # = unit + 128) - usr.sbin/Makefile add lptcontrol - sys/i386/isa/lpt.c implement the LP_BYPASS flag: when a unit is opened with this flag set, the printer is not primed, and no check is made to see that the printer is online. This can only be used to pass ioctls. (giving us /dev/lpctl?) - lptcontrol.c use /dev/lpctl? (LP_BYPASS) -f flag removed, -u flag added - lptcontrol.8 document changes in lptcontrol rewrite using mandoc macros Submitted by: Geoff. 1994-09-03 22:47:08 +00:00			`The following command line options are supported:`
Remove whitespace at EOL. 2001-07-15 08:06:20 +00:00			`.Bl -tag -width indent`
Make it possible to run lptcontrol on a printer port which does not actually have a printer connected or online: - MAKEDEV: remove all signs of lpa add lpctl? devices (minor # = unit + 128) - usr.sbin/Makefile add lptcontrol - sys/i386/isa/lpt.c implement the LP_BYPASS flag: when a unit is opened with this flag set, the printer is not primed, and no check is made to see that the printer is online. This can only be used to pass ioctls. (giving us /dev/lpctl?) - lptcontrol.c use /dev/lpctl? (LP_BYPASS) -f flag removed, -u flag added - lptcontrol.8 document changes in lptcontrol rewrite using mandoc macros Submitted by: Geoff. 1994-09-03 22:47:08 +00:00			`.It Fl i`
Use err(3). 1997-09-25 06:36:29 +00:00			`Turn on interrupt-driven mode.`
Make it possible to run lptcontrol on a printer port which does not actually have a printer connected or online: - MAKEDEV: remove all signs of lpa add lpctl? devices (minor # = unit + 128) - usr.sbin/Makefile add lptcontrol - sys/i386/isa/lpt.c implement the LP_BYPASS flag: when a unit is opened with this flag set, the printer is not primed, and no check is made to see that the printer is online. This can only be used to pass ioctls. (giving us /dev/lpctl?) - lptcontrol.c use /dev/lpctl? (LP_BYPASS) -f flag removed, -u flag added - lptcontrol.8 document changes in lptcontrol rewrite using mandoc macros Submitted by: Geoff. 1994-09-03 22:47:08 +00:00			`.It Fl p`
Use err(3). 1997-09-25 06:36:29 +00:00			`Turn on polled mode.`
Add -e option and change unit to device access in lptcontrol.8 Change unit to device access in lptcontrol.c. Now usage is lptcontrol -i \| -p \| -e [-d /dev/lpt?] 1999-02-14 12:23:49 +00:00			`.It Fl e`
			`Turn on extended mode.`
Add missing -s option. PR: docs/10378 1999-05-28 02:09:46 +00:00			`.It Fl s`
			`Turn on standard mode, i.e. turn off extended mode.`
mdoc(7) police: split punctuation characters + misc fixes. 2001-02-01 16:44:04 +00:00			`.It Fl d Ar device`
Use err(3). 1997-09-25 06:36:29 +00:00			`Set the mode of the printer device specified by`
mdoc(7) police: split punctuation characters + misc fixes. 2001-02-01 16:44:04 +00:00			`.Ar device .`
Remove whitespace at EOL. 2001-07-15 08:06:20 +00:00			`The default value for`
mdoc(7) police: split punctuation characters + misc fixes. 2001-02-01 16:44:04 +00:00			`.Ar device`
Bring in lptcontrol from 1.1.5.1 Submitted by: Geoff 1994-09-03 13:10:09 +00:00			`is`
Remove incorrect section name. Use .Pa or .Ar instead of .Em. 1999-11-27 16:54:36 +00:00			`.Pa /dev/lpt0 .`
Make it possible to run lptcontrol on a printer port which does not actually have a printer connected or online: - MAKEDEV: remove all signs of lpa add lpctl? devices (minor # = unit + 128) - usr.sbin/Makefile add lptcontrol - sys/i386/isa/lpt.c implement the LP_BYPASS flag: when a unit is opened with this flag set, the printer is not primed, and no check is made to see that the printer is online. This can only be used to pass ioctls. (giving us /dev/lpctl?) - lptcontrol.c use /dev/lpctl? (LP_BYPASS) -f flag removed, -u flag added - lptcontrol.8 document changes in lptcontrol rewrite using mandoc macros Submitted by: Geoff. 1994-09-03 22:47:08 +00:00			`.El`
			`.Pp`
Remove whitespace at EOL. 2001-07-15 08:06:20 +00:00			`One of`
mdoc(7) police: split punctuation characters + misc fixes. 2001-02-01 16:44:04 +00:00			`.Fl i , p`
Add -e option and change unit to device access in lptcontrol.8 Change unit to device access in lptcontrol.c. Now usage is lptcontrol -i \| -p \| -e [-d /dev/lpt?] 1999-02-14 12:23:49 +00:00			`or`
			`.Fl e`
Bring in lptcontrol from 1.1.5.1 Submitted by: Geoff 1994-09-03 13:10:09 +00:00			`must be specified.`
Make it possible to run lptcontrol on a printer port which does not actually have a printer connected or online: - MAKEDEV: remove all signs of lpa add lpctl? devices (minor # = unit + 128) - usr.sbin/Makefile add lptcontrol - sys/i386/isa/lpt.c implement the LP_BYPASS flag: when a unit is opened with this flag set, the printer is not primed, and no check is made to see that the printer is online. This can only be used to pass ioctls. (giving us /dev/lpctl?) - lptcontrol.c use /dev/lpctl? (LP_BYPASS) -f flag removed, -u flag added - lptcontrol.8 document changes in lptcontrol rewrite using mandoc macros Submitted by: Geoff. 1994-09-03 22:47:08 +00:00			`.Sh FILES`
Use err(3). 1997-09-25 06:36:29 +00:00			`.Bl -tag -width /sys/i386/conf/GENERIC -compact`
			`.It Pa /dev/lpt?`
Remove incorrect section name. Use .Pa or .Ar instead of .Em. 1999-11-27 16:54:36 +00:00			`printer devices`
Use err(3). 1997-09-25 06:36:29 +00:00			`.It Pa /dev/lpctl?`
Remove incorrect section name. Use .Pa or .Ar instead of .Em. 1999-11-27 16:54:36 +00:00			`printer control devices`
Use err(3). 1997-09-25 06:36:29 +00:00			`.It Pa /sys/i386/conf/GENERIC`
Remove incorrect section name. Use .Pa or .Ar instead of .Em. 1999-11-27 16:54:36 +00:00			`kernel configuration file`
Make it possible to run lptcontrol on a printer port which does not actually have a printer connected or online: - MAKEDEV: remove all signs of lpa add lpctl? devices (minor # = unit + 128) - usr.sbin/Makefile add lptcontrol - sys/i386/isa/lpt.c implement the LP_BYPASS flag: when a unit is opened with this flag set, the printer is not primed, and no check is made to see that the printer is online. This can only be used to pass ioctls. (giving us /dev/lpctl?) - lptcontrol.c use /dev/lpctl? (LP_BYPASS) -f flag removed, -u flag added - lptcontrol.8 document changes in lptcontrol rewrite using mandoc macros Submitted by: Geoff. 1994-09-03 22:47:08 +00:00			`.El`
			`.Sh BUGS`
			`Sure to be some.`
mdoc(7) police: split punctuation characters + misc fixes. 2001-02-01 16:44:04 +00:00			`.Sh SEE ALSO`
Remove whitespace at EOL. 2001-07-15 08:06:20 +00:00			`.Xr lpt 4`
.Sh AUTHOR -> .Sh AUTHORS. Use .An/.Aq. 1998-03-23 08:31:20 +00:00			`.Sh AUTHORS`
Use err(3). 1997-09-25 06:36:29 +00:00			`.An Geoffrey M. Rehmet`
Make it possible to run lptcontrol on a printer port which does not actually have a printer connected or online: - MAKEDEV: remove all signs of lpa add lpctl? devices (minor # = unit + 128) - usr.sbin/Makefile add lptcontrol - sys/i386/isa/lpt.c implement the LP_BYPASS flag: when a unit is opened with this flag set, the printer is not primed, and no check is made to see that the printer is online. This can only be used to pass ioctls. (giving us /dev/lpctl?) - lptcontrol.c use /dev/lpctl? (LP_BYPASS) -f flag removed, -u flag added - lptcontrol.8 document changes in lptcontrol rewrite using mandoc macros Submitted by: Geoff. 1994-09-03 22:47:08 +00:00			`.Sh HISTORY`
mdoc(7) police: split punctuation characters + misc fixes. 2001-02-01 16:44:04 +00:00			`The`
			`.Nm`
The .Nm utility 2002-07-14 14:47:15 +00:00			`utility`
Use err(3). 1997-09-25 06:36:29 +00:00			`first appeared in`
			`.Fx 1.1.5`