Changeset 47dc0bf


Ignore:
Timestamp:
12/22/2011 01:31:44 PM (10 years ago)
Author:
Andrew Benton <andy@…>
Branches:
10.0, 10.1, 11.0, 11.1, 7.10, 7.4, 7.5, 7.6, 7.6-blfs, 7.6-systemd, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, gnome, kde5-13430, kde5-14269, kde5-14686, krejzi/svn, lazarus, nosym, perl-modules, qt5new, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/test-20220226
Children:
176d88e
Parents:
f4b5ef9
Message:

Changed the Cups page to use the kernel usblp driver
added a section about kernel config
added the --localstatedir=/var option
added --disable-libusb to avoid conflict with the kernel driver

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@9133 af4574ff-66df-0310-9fd7-8a98e5e911e0

Files:
2 edited

Legend:

Unmodified
Added
Removed
  • multimedia/videoutils/ffmpeg.xml

    rf4b5ef9 r47dc0bf  
    117117make</userinput></screen>
    118118
    119     <para>The Ffmpeg source contains a tool called
     119    <para>The <application>FFmpeg</application> source contains a tool called
    120120    <command>qt-faststart</command> that can modify QuickTime formatted movies
    121121    (mov or mp4) so that the header information is located at the beginning of
  • pst/printing/cups.xml

    rf4b5ef9 r47dc0bf  
    1313]>
    1414
    15 <sect1 id="cups" xreflabel="CUPS-&cups-version;">
     15<sect1 id="cups" xreflabel="Cups-&cups-version;">
    1616  <?dbhtml filename="cups.html"?>
    1717
     
    2121  </sect1info>
    2222
    23   <title>CUPS-&cups-version;</title>
     23  <title>Cups-&cups-version;</title>
    2424
    2525  <indexterm zone="cups">
    26     <primary sortas="a-CUPS">CUPS</primary>
     26    <primary sortas="a-Cups">Cups</primary>
    2727  </indexterm>
    2828
    2929  <sect2 role="package">
    30     <title>Introduction to CUPS</title>
     30    <title>Introduction to Cups</title>
    3131
    3232    <para>The Common Unix Printing System (CUPS) is a print spooler and
     
    5858      </listitem>
    5959    </itemizedlist>
    60 <!--
    61     <bridgehead renderas="sect3">Additional Downloads</bridgehead>
    62     <itemizedlist spacing="compact">
    63       <listitem>
    64         <para>Required patch: <ulink
    65         url="&patch-root;/cups-&cups-version;-fix_broken_locking-1.patch"/></para>
    66       </listitem>
    67     </itemizedlist>
    68 -->
    69     <bridgehead renderas="sect3">CUPS Dependencies</bridgehead>
     60
     61    <bridgehead renderas="sect3">Cups Dependencies</bridgehead>
    7062
    7163    <bridgehead renderas="sect4">Recommended</bridgehead>
     
    10496  </sect2>
    10597
     98  <sect2 role="kernel" id="cups-kernel">
     99    <title>Kernel Configuration</title>
     100
     101    <para>If you have a parallel printer enable the following options in your
     102    kernel configuration and recompile the kernel:</para>
     103
     104<screen><literal>Device Drivers  ---&gt;
     105  [*] Parallel port support  ---&gt;
     106    [*]   PC-style hardware
     107...
     108  Character devices  ---&gt;
     109    [*] Parallel printer support</literal></screen>
     110
     111    <note><para>If you have a USB printer there is a conflict between the
     112    <application>Cups</application> <application>libusb</application>
     113    backend and the kernel driver. If you want to use
     114    <application>Cups</application> with <application>libusb</application>
     115    support <emphasis>do not</emphasis> enable USB Printer support in your
     116    kernel and remove the <option>--disable-libusb</option> when you
     117    configure <application>Cups</application>.</para></note>
     118
     119    <para>If you want to use the kernel usblp driver enable the following
     120    options in your kernel configuration and recompile the kernel:</para>
     121
     122<screen>Device Drivers  ---&gt;
     123  [*] USB support  ---&gt;
     124...
     125Enable support for either UHCI or OHCI, not both:
     126    [*]   OHCI HCD support
     127    [*]   UHCI HCD (most Intel and VIA) support
     128...
     129    [*]   USB Printer support</screen>
     130
     131    <indexterm zone="cups cups-kernel">
     132      <primary sortas="d-cups">cups</primary>
     133    </indexterm>
     134
     135  </sect2>
     136
    106137  <sect2 role="installation">
    107     <title>Installation of CUPS</title>
     138    <title>Installation of Cups</title>
    108139
    109140    <para>Create an <systemitem class="username">lp</systemitem> user, as
    110     <application>CUPS</application> will create some files owned by this user.
     141    <application>Cups</application> will create some files owned by this user.
    111142    (The <systemitem class="username">lp</systemitem> user is the default used
    112     by <application>CUPS</application>, but may be changed to a different user
     143    by <application>Cups</application>, but may be changed to a different user
    113144    by passing a parameter to the <command>configure</command> script.) Use the
    114145    following command as the <systemitem class="username">root</systemitem>
     
    117148<screen role="root"><userinput>useradd -c "Print Service User" -d /dev/null -g lp -s /bin/false -u 9 lp</userinput></screen>
    118149
    119     <note>
    120       <para>If you plan to use a USB printer with
    121       <application>CUPS</application>, do not enable the
    122       <quote>usblp</quote> driver as either built-in or as a module in
    123       your kernel configuration as it will cause the new
    124       <application>CUPS</application> USB backend to fail.
    125       <filename>/var/log/sys.log</filename> will contain entries similar to the
    126       following:</para>
    127 
    128       <screen>kernel: [54631.796465] usb 4-1: usbfs: interface 0 claimed by usblp while 'usb'
    129 sets config #1</screen>
    130 
    131       <para>The kernel config option is
    132       <parameter>CONFIG_USB_PRINTER</parameter> and can be found in menuconfig
    133       under <quote>Device Drivers ---> USB support ---> USB Printer
    134       support</quote>.</para>
    135     </note>
    136 
    137     <para>Install <application>CUPS</application> by running the
     150    <para>Install <application>Cups</application> by running the
    138151    following commands:</para>
    139152
    140 <screen><userinput>./configure --prefix=/usr &amp;&amp;
     153<screen><userinput>sed -i 's#@CUPS_HTMLVIEW@#firefox#' desktop/cups.desktop.in &amp;&amp;
     154./configure --localstatedir=/var --disable-libusb --with-rcdir=/tmp &amp;&amp;
    141155make</userinput></screen>
    142156
    143157    <para>To test the results, issue: <command>make check</command>. This will
    144158    run a basic test suite without any load testing. If you wish to run the
    145     tests specifying non-default parameters, issue: <command>make test</command>.
    146     Note that the <quote>torture load testing</quote> test uses more resources
    147     than those displayed in the prompt.</para>
    148 
    149     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     159    tests specifying non-default parameters, issue:
     160    <command>make test</command>. Note that the <quote>torture load
     161    testing</quote> test uses more resources than those displayed in the
     162    prompt.</para>
     163
     164    <para>Now, as the <systemitem class="username">root</systemitem>
     165    user:</para>
    150166
    151167<screen role="root"><userinput>make install &amp;&amp;
     
    153169
    154170    <para>The <application>man</application> files are installed in compressed
    155     (<filename class='extension'>.gz</filename>) format. If desired, use the
     171    (<filename class="extension">.gz</filename>) format. If desired, use the
    156172    following commands to uncompress them as the
    157173    <systemitem class="username">root</systemitem> user:</para>
     
    172188    <title>Command Explanations</title>
    173189
    174     <para>The basic default behavior of the installation is appropriate for
    175     LFS systems. <application>CUPS</application> files are placed in
    176     <filename class="directory">/usr/{bin,include,lib,sbin,share/cups}</filename>,
    177     <filename class="directory">/var/{cache,log,run,spool}</filename>, and
    178     <filename class="directory">/etc/{cups,pam.d,dbus-1/system.d}</filename></para>
     190    <para><command>sed -i 's#@CUPS_HTMLVIEW@#firefox#' ...</command>: This
     191     changes the browser that the <application>Cups</application> desktop file
     192     uses for its web interface.</para>
     193
     194    <para><option>--localstatedir=/var</option>: This changes the location of
     195    the cache, log, run and spool directories from /usr/var to /var.</para>
     196
     197    <para><option>--disable-libusb</option>: This disables the
     198    <application>Cups</application> <application>libusb</application> backend.
     199    If you&apos;d like <application>Cups</application> to use
     200    <application>libusb</application>, delete this option and make sure you
     201    compile your kernel with: # CONFIG_USB_PRINTER is not set</para>
     202
     203    <para><option>--with-rcdir=/tmp</option>: This option makes it install its
     204    bootscript into <filename class="directory">/tmp</filename> instead of
     205    <filename class="directory">/etc/rc.d</filename>.</para>
    179206
    180207  </sect2>
    181208
    182209  <sect2 role="configuration">
    183     <title>Configuring CUPS</title>
    184 
    185     <para>Configuration of <application>CUPS</application> is dependent on
     210    <title>Configuring Cups</title>
     211
     212    <para>Configuration of <application>Cups</application> is dependent on
    186213    the type of printer and can be complex. Generally, PostScript printers
    187214    are easier. For detailed instructions on configuration and use of
    188     <application>CUPS</application>, see <ulink
     215    <application>Cups</application>, see <ulink
    189216    url="http://www.cups.org/documentation.php"/>. The Software Administrators
    190217    Manual and Software Users Manual are particularly useful.</para>
    191218
    192219    <para>For non-PostScript printers to print with
    193     <application>CUPS</application>, you need to install
    194     <xref linkend="gs"/> to convert PostScript to raster images
    195     and a driver (e.g., from <xref linkend="gutenprint"/>) to convert
    196     the resulting raster images to a form that the printer understands.
     220    <application>Cups</application>, you need to install <xref linkend="gs"/>
     221    to convert PostScript to raster images and a driver (e.g., from
     222    <xref linkend="gutenprint"/>) to convert the resulting raster images to a
     223    form that the printer understands.
    197224    <ulink url="http://www.linuxprinting.org/foomatic.html">Foomatic</ulink>
    198225    drivers use Ghostscript to convert PostScript to a printable form directly,
    199226    but this is considered to be a hack by
    200     <application>CUPS</application> developers.</para>
    201 
    202 <!-- This should be obvious, not to mention the new problem with usblp.
    203      Omitting completely for now.
    204 
    205     <sect3 role="kernel" id="cups-kernel">
    206       <title>Kernel Configuration</title>
    207 
    208       <para>To use your printer you will likely need the appropriate drivers
    209       enabled in the kernel &mdash; for example, <quote>Parallel printer
    210       support</quote> if you have a parallel port printer, or <quote>USB Printer
    211       support</quote> for a USB printer.</para>
    212 
    213     </sect3>
    214 -->
     227    <application>Cups</application> developers.</para>
    215228
    216229    <sect3 id="cups-init">
    217230      <title>Boot Script</title>
    218231
    219       <para>During the installation, <application>CUPS</application> added
    220       startup files in <filename class="directory">/etc/rc.d</filename>.
    221       These scripts will work in most cases, but will fail if you provide
    222       printers to <application>Samba</application> clients.  Additionally,
    223       they are not consistent with standard LFS style scripts.  Replace the
    224       installed scripts with the scripts and symlinks included in the
    225       <xref linkend="bootscripts"/> package:</para>
     232      <para>If you want the <application>Cups</application> to start
     233      automatically when the system is booted, install the init script included
     234      in the <xref linkend="bootscripts"/> package:</para>
    226235
    227236      <indexterm zone="cups cups-init">
     
    247256        cupsd, cupsdisable, cupsenable, cupsfilter, cupsreject, cupstestdsc,
    248257        cupstestppd, lp, lpadmin, lpc, lpinfo, lpmove, lpoptions, lppasswd,
    249         lpq, lpr, lprm, lpstat, ppdc, ppdhtml, ppdi, ppdmerge, ppdpo, reject</seg>
    250         <seg>libcups.{so,a}, libcupscgi.{so,a}, libcupsdriver.{so,a},
    251         libcupsimage.{so,a}, libcupsmime.{so,a}, libcupsppdc.{so,a}, and
     258        lpq, lpr, lprm, lpstat, ppdc, ppdhtml, ppdi, ppdmerge, ppdpo,
     259        reject</seg>
     260        <seg>libcups.so, libcupscgi.so, libcupsdriver.so,
     261        libcupsimage.so, libcupsmime.so, libcupsppdc.so, and
    252262        various filters and backend drivers</seg>
    253         <seg>/etc/cups, /usr/{include,lib,share}/cups, /usr/share/doc/cups-&cups-version;, and
    254         /var/{cache,log,run,spool}/cups</seg>
     263        <seg>/etc/cups, /usr/include/cups, /usr/lib/cups, /usr/share/cups,
     264        /usr/share/doc/cups-&cups-version;, /var/cache/cups, /var/log/cups,
     265        /var/run/cups and /var/spool/cups.</seg>
    255266      </seglistitem>
    256267    </segmentedlist>
     
    285296        <term><command>cups-config</command></term>
    286297        <listitem>
    287           <para>is a <application>CUPS</application>
     298          <para>is a <application>Cups</application>
    288299          program configuration utility.</para>
    289300          <indexterm zone="cups cups-config">
     
    358369        <listitem>
    359370          <para>configures printer and class queues provided by
    360           <application>CUPS</application>.</para>
     371          <application>Cups</application>.</para>
    361372          <indexterm zone="cups lpadmin">
    362373            <primary sortas="b-lpadmin">lpadmin</primary>
     
    369380        <listitem>
    370381          <para> provides limited control over printer and class queues
    371           provided by <application>CUPS</application>.</para>
     382          provided by <application>Cups</application>.</para>
    372383          <indexterm zone="cups lpc-cups">
    373384            <primary sortas="b-lpc">lpc</primary>
     
    380391        <listitem>
    381392          <para>lists the available devices or drivers known to the
    382           <application>CUPS</application> server.</para>
     393          <application>Cups</application> server.</para>
    383394          <indexterm zone="cups lpinfo">
    384395            <primary sortas="b-lpinfo">lpinfo</primary>
     
    411422        <listitem>
    412423          <para>adds, changes or deletes passwords in the
    413           <application>CUPS</application> digest password file
     424          <application>Cups</application> digest password file
    414425          <filename>passwd.md5</filename>.</para>
    415426          <indexterm zone="cups lppasswd">
Note: See TracChangeset for help on using the changeset viewer.