os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Changed printer name tagging from <hostid> to <literal>

Browse source 
Added <hostid> tags for hosts rose and orchid
Changed (where necessary) job's --> job is
                          queue's --> queue is
                          printer's --> printer is
                          bamboo's --> bamboo is
                          She's --> She is

PR:		29729
Submitted by:	John Murphy <jfm@blueyonder.co.uk>
Approved by:	murray
This commit is contained in:
Valentino Vaschetto 2001-08-15 18:41:10 +00:00
parent 127f34c7ea
commit 354b853191
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=10366
1 changed files with 38 additions and 37 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

75
en_US.ISO8859-1/books/handbook/printing/chapter.sgml
View file

@ -1,7 +1,7 @@
<!-- <!--
The FreeBSD Documentation Project The FreeBSD Documentation Project
$FreeBSD: doc/en_US.ISO8859-1/books/handbook/printing/chapter.sgml,v 1.43 2001/08/02 02:32:17 nik Exp $ $FreeBSD: doc/en_US.ISO8859-1/books/handbook/printing/chapter.sgml,v 1.44 2001/08/09 23:42:34 chern Exp $
--> -->
<chapter id="printing"> <chapter id="printing">
@ -1116,8 +1116,8 @@ bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\
<literal>lp</literal> capability.</para> <literal>lp</literal> capability.</para>
<para>In our running example, let us assume that <para>In our running example, let us assume that
<hostid>rattan</hostid> is on the first parallel port, and <literal>rattan</literal> is on the first parallel port, and
<hostid>bamboo</hostid> is on a sixth serial port; here are <literal>bamboo</literal> is on a sixth serial port; here are
the additions to <filename>/etc/printcap</filename>:</para> the additions to <filename>/etc/printcap</filename>:</para>
<programlisting># <programlisting>#
@ -1563,7 +1563,7 @@ $%&amp;'()*+,-./01234567
<term><option>-c</option></term> <term><option>-c</option></term>
<listitem> <listitem>
<para>appears if the job's submitted with <command>lpr <para>appears if the job is submitted with <command>lpr
-l</command></para> -l</command></para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -1884,7 +1884,7 @@ if [ "$first_two_chars" = "%!" ]; then
&amp;&amp; exit 0 &amp;&amp; exit 0
else else
# #
# Plain text or HP/PCL, so just print it directly; print a form # Plain text or HP/PCL, so just print it directly; print a form feed
# at the end to eject the last page. # at the end to eject the last page.
# #
echo $first_line &amp;&amp; cat &amp;&amp; printf "\033&amp;l0H" &amp;&amp; echo $first_line &amp;&amp; cat &amp;&amp; printf "\033&amp;l0H" &amp;&amp;
@ -2538,7 +2538,7 @@ teak|hp|laserjet|Hewlett Packard LaserJet 3Si:\
<para>By enabling header pages, LPD will produce a <emphasis>long <para>By enabling header pages, LPD will produce a <emphasis>long
header</emphasis>, a full page of large letters identifying the header</emphasis>, a full page of large letters identifying the
user, host, and job. Here is an example (kelly printed the job user, host, and job. Here is an example (kelly printed the job
named outline from host rose):</para> named outline from host <hostid>rose</hostid>):</para>
<programlisting> k ll ll <programlisting> k ll ll
k l l k l l
@ -2972,13 +2972,14 @@ done
<para>Here is an example. The host <hostid>rose</hostid> has two <para>Here is an example. The host <hostid>rose</hostid> has two
printers, <literal>bamboo</literal> and <literal>rattan</literal>. printers, <literal>bamboo</literal> and <literal>rattan</literal>.
We will enable users on the host orchid to print to those printers. We will enable users on the host <hostid>orchid</hostid> to print
to those printers.
Here is the <filename>/etc/printcap</filename> file for Here is the <filename>/etc/printcap</filename> file for
<hostid>orchid</hostid> (back from section <link <hostid>orchid</hostid> (back from section <link
linkend="printing-advanced-header-pages-enabling">Enabling Header linkend="printing-advanced-header-pages-enabling">Enabling Header
Pages</link>). It already had the entry for the printer Pages</link>). It already had the entry for the printer
<literal>teak</literal>; we have added entries for the two printers <literal>teak</literal>; we have added entries for the two printers
on the host rose:</para> on the host <hostid>rose</hostid>:</para>
<programlisting># <programlisting>#
# /etc/printcap for host orchid - added (remote) printers on rose # /etc/printcap for host orchid - added (remote) printers on rose
@ -3014,17 +3015,18 @@ bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\
<para>Now, users on <hostid>orchid</hostid> can print to <para>Now, users on <hostid>orchid</hostid> can print to
<literal>rattan</literal> and <literal>bamboo</literal>. If, for <literal>rattan</literal> and <literal>bamboo</literal>. If, for
example, a user on orchid typed example, a user on <hostid>orchid</hostid> typed
<screen>&prompt.user; <userinput>lpr -P bamboo -d sushi-review.dvi</userinput></screen> <screen>&prompt.user; <userinput>lpr -P bamboo -d sushi-review.dvi</userinput></screen>
the LPD system on orchid would copy the job to the spooling the LPD system on <hostid>orchid</hostid> would copy the job to the spooling
directory <filename>/var/spool/lpd/bamboo</filename> and note that directory <filename>/var/spool/lpd/bamboo</filename> and note that it was a
it was a DVI job. As soon as the host rose has room in its DVI job. As soon as the host <hostid>rose</hostid> has room in its
<hostid>bamboo</hostid> spooling directory, the two LPDs would <literal>bamboo</literal> spooling directory, the two LPDs would transfer the
transfer the file to rose. The file would wait in rose's queue file to <hostid>rose</hostid>. The file would wait in <hostid>rose</hostid>'s
until it was finally printed. It would be converted from DVI to queue until it was finally printed. It would be converted from DVI to
PostScript (since bamboo is a PostScript printer) on rose.</para> PostScript (since <literal>bamboo</literal> is a PostScript printer) on
<hostid>rose</hostid>.</para>
</sect3> </sect3>
<sect3 id="printing-advanced-network-net-if"> <sect3 id="printing-advanced-network-net-if">
@ -3138,7 +3140,7 @@ exec /usr/libexec/lpr/lpf "$@" | /usr/local/libexec/netprint scrivener 5100</pro
<filename>/etc/printcap</filename> file for the host <filename>/etc/printcap</filename> file for the host
<hostid>rose</hostid>. The printer <literal>rattan</literal> is <hostid>rose</hostid>. The printer <literal>rattan</literal> is
quite hearty, so we will allow multiple copies, but the laser quite hearty, so we will allow multiple copies, but the laser
printer <literal>bamboo</literal>'s a bit more delicate, so we will printer <literal>bamboo</literal> is a bit more delicate, so we will
disable multiple copies by adding the <literal>sc</literal> disable multiple copies by adding the <literal>sc</literal>
capability:</para> capability:</para>
@ -3376,9 +3378,9 @@ madrigal.fishbaum.de</programlisting>
<filename>minfree</filename> file.</para> <filename>minfree</filename> file.</para>
<para>For example, let us add a <filename>minfree</filename> <para>For example, let us add a <filename>minfree</filename>
file for the printer <hostid>bamboo</hostid>. We examine file for the printer <literal>bamboo</literal>. We examine
<filename>/etc/printcap</filename> to find the spooling <filename>/etc/printcap</filename> to find the spooling
directory for this printer; here is <hostid>bamboo</hostid>'s directory for this printer; here is <literal>bamboo</literal>'s
entry:</para> entry:</para>
<programlisting>bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\ <programlisting>bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\
@ -3387,14 +3389,13 @@ madrigal.fishbaum.de</programlisting>
:if=/usr/local/libexec/psif:\ :if=/usr/local/libexec/psif:\
:df=/usr/local/libexec/psdf:</programlisting> :df=/usr/local/libexec/psdf:</programlisting>
<para>The spooling directory is the given in the <para>The spooling directory is given in the <literal>sd</literal>
<literal>sd</literal> capability. We will make three capability. We will make three megabytes (which is 6144 disk blocks)
megabytes (which is 6144 disk blocks) the amount of free disk the amount of free disk space that must exist on the filesystem for
space that must exist on the filesystem for LPD to accept LPD to accept remote jobs:</para>
remote jobs:</para>
<screen>&prompt.root; <userinput>echo 6144 &gt; /var/spool/lpd/bam <screen>&prompt.root; <userinput>echo 6144 &gt; /var/spool/lpd/bamboo/minfree
boo/minfree</userinput></screen> </userinput></screen>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -3417,7 +3418,7 @@ boo/minfree</userinput></screen>
giving them accounts on your systems, they can use your giving them accounts on your systems, they can use your
printers from their own departmental systems. If you would printers from their own departmental systems. If you would
rather allow them to use <emphasis>only</emphasis> your rather allow them to use <emphasis>only</emphasis> your
printers and not your compute resources, you can give them printers and not your computer resources, you can give them
<quote>token</quote> accounts, with no home directory and a <quote>token</quote> accounts, with no home directory and a
useless shell like <filename>/usr/bin/false</filename>.</para> useless shell like <filename>/usr/bin/false</filename>.</para>
</listitem> </listitem>
@ -3524,8 +3525,8 @@ boo/minfree</userinput></screen>
<para>You should use a separate accounting file for each printer, as <para>You should use a separate accounting file for each printer, as
<command>lpf</command> has no file locking logic built into it, and <command>lpf</command> has no file locking logic built into it, and
two <command>lpf</command>s might corrupt each other's entries if two <command>lpf</command>s might corrupt each other's entries if
they were to write to the same file at the same time. A easy way to they were to write to the same file at the same time. An easy way
insure a separate accounting file for each printer is to use to insure a separate accounting file for each printer is to use
<literal>af=acct</literal> in <filename>/etc/printcap</filename>. <literal>af=acct</literal> in <filename>/etc/printcap</filename>.
Then, each accounting file will be in the spooling directory for a Then, each accounting file will be in the spooling directory for a
printer, in a file named <filename>acct</filename>.</para> printer, in a file named <filename>acct</filename>.</para>
@ -3821,7 +3822,7 @@ total 337.00 154 $ 6.74</screen>
<screen>&prompt.user; <userinput>lpq -P bamboo</userinput></screen> <screen>&prompt.user; <userinput>lpq -P bamboo</userinput></screen>
shows the queue for the printer named <hostid>bamboo</hostid>. Here shows the queue for the printer named <literal>bamboo</literal>. Here
is an example of the output of the <command>lpq</command> is an example of the output of the <command>lpq</command>
command:</para> command:</para>
@ -3845,7 +3846,7 @@ active kelly 9 /etc/host.conf, /etc/hosts.equiv 88 bytes
be currently printing that job. The second job consists of data be currently printing that job. The second job consists of data
passed as the standard input to the &man.lpr.1; command. The third passed as the standard input to the &man.lpr.1; command. The third
job came from user <username>mary</username>; it is a much larger job came from user <username>mary</username>; it is a much larger
job. The pathname of the files she's trying to print is too long to job. The pathname of the file she is trying to print is too long to
fit, so the &man.lpq.1; command just shows three dots.</para> fit, so the &man.lpq.1; command just shows three dots.</para>
<para>The very first line of the output from &man.lpq.1; is also useful: <para>The very first line of the output from &man.lpq.1; is also useful:
@ -3883,7 +3884,7 @@ mary: 3rd [job 011rose]
<para>To remove the job from a specific printer, add the <para>To remove the job from a specific printer, add the
<option>-P</option> option. The following command removes job number <option>-P</option> option. The following command removes job number
10 from the queue for the printer <hostid>bamboo</hostid>:</para> 10 from the queue for the printer <literal>bamboo</literal>:</para>
<screen>&prompt.user; <userinput>lprm -P bamboo 10</userinput></screen> <screen>&prompt.user; <userinput>lprm -P bamboo 10</userinput></screen>
@ -4277,7 +4278,7 @@ cfA013rose dequeued
to get printer status and to restart a hung printer only.</para> to get printer status and to restart a hung printer only.</para>
<para>Here is a summary of the &man.lpc.8; commands. Most of the <para>Here is a summary of the &man.lpc.8; commands. Most of the
commands takes a <replaceable>printer-name</replaceable> argument to commands take a <replaceable>printer-name</replaceable> argument to
tell on which printer to operate. You can use <literal>all</literal> tell on which printer to operate. You can use <literal>all</literal>
for the <replaceable>printer-name</replaceable> to mean all printers for the <replaceable>printer-name</replaceable> to mean all printers
listed in <filename>/etc/printcap</filename>.</para> listed in <filename>/etc/printcap</filename>.</para>
@ -4289,7 +4290,7 @@ cfA013rose dequeued
<listitem> <listitem>
<para>Cancel the current job and stop the printer. Users can <para>Cancel the current job and stop the printer. Users can
still submit jobs if the queue's enabled.</para> still submit jobs if the queue is enabled.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -4312,7 +4313,7 @@ cfA013rose dequeued
<replaceable>printer-name</replaceable></command></term> <replaceable>printer-name</replaceable></command></term>
<listitem> <listitem>
<para>Disable queuing of new jobs. If the printer's started, it <para>Disable queuing of new jobs. If the printer is running, it
will continue to print any jobs remaining in the queue. The will continue to print any jobs remaining in the queue. The
superuser (root) can always submit jobs, even to a disabled superuser (root) can always submit jobs, even to a disabled
queue.</para> queue.</para>
@ -4608,9 +4609,9 @@ printf "\033&amp;k2G" &amp;&amp; cat &amp;&amp; printf "\033&amp;l0H" &amp;&amp;
exit 2</programlisting> exit 2</programlisting>
<para>Here is an example <filename>/etc/printcap</filename> <para>Here is an example <filename>/etc/printcap</filename>
from a host called orchid. It has a single printer from a host called <hostid>orchid</hostid>. It has a single printer
attached to its first parallel port, a Hewlett Packard attached to its first parallel port, a Hewlett Packard
LaserJet 3Si named <hostid>teak</hostid>. It is using the LaserJet 3Si named <literal>teak</literal>. It is using the
above script as its text filter:</para> above script as its text filter:</para>
<programlisting># <programlisting>#