Path: blob/main/documentation/content/en/articles/cups/_index.po
18096 views
# SOME DESCRIPTIVE TITLE # Copyright (C) YEAR The FreeBSD Project # This file is distributed under the same license as the FreeBSD Documentation package. # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: FreeBSD Documentation VERSION\n" "POT-Creation-Date: 2023-05-21 14:43-0300\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <[email protected]>\n" "Language: \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. type: YAML Front Matter: description #: documentation/content/en/articles/cups/_index.adoc:1 #, no-wrap msgid "How to install and use CUPS on FreeBSD" msgstr "" #. type: Title = #: documentation/content/en/articles/cups/_index.adoc:1 #: documentation/content/en/articles/cups/_index.adoc:11 #, no-wrap msgid "CUPS on FreeBSD" msgstr "" #. type: Plain text #: documentation/content/en/articles/cups/_index.adoc:44 msgid "Abstract" msgstr "" #. type: Plain text #: documentation/content/en/articles/cups/_index.adoc:46 msgid "An article about configuring CUPS on FreeBSD." msgstr "" #. type: Plain text #: documentation/content/en/articles/cups/_index.adoc:48 msgid "'''" msgstr "" #. type: Title == #: documentation/content/en/articles/cups/_index.adoc:52 #, no-wrap msgid "An Introduction to the Common Unix Printing System (CUPS)" msgstr "" #. type: Plain text #: documentation/content/en/articles/cups/_index.adoc:56 msgid "" "CUPS, the Common UNIX Printing System, provides a portable printing layer " "for UNIX(R)-based operating systems. It has been developed by Easy Software " "Products to promote a standard printing solution for all UNIX(R) vendors and " "users." msgstr "" #. type: Plain text #: documentation/content/en/articles/cups/_index.adoc:61 msgid "" "CUPS uses the Internet Printing Protocol (IPP) as the basis for managing " "print jobs and queues. The Line Printer Daemon (LPD), Server Message Block " "(SMB), and AppSocket (aka JetDirect) protocols are also supported with " "reduced functionality. CUPS adds network printer browsing and PostScript " "Printer Description (PPD) based printing options to support real-world " "printing under UNIX(R). As a result, CUPS is ideally-suited for sharing and " "accessing printers in mixed environments of FreeBSD, Linux(R), Mac OS(R) X, " "or Windows(R)." msgstr "" #. type: Plain text #: documentation/content/en/articles/cups/_index.adoc:63 msgid "The main site for CUPS is http://www.cups.org/[http://www.cups.org/]." msgstr "" #. type: Title == #: documentation/content/en/articles/cups/_index.adoc:65 #, no-wrap msgid "Installing the CUPS Print Server" msgstr "" #. type: Plain text #: documentation/content/en/articles/cups/_index.adoc:68 msgid "" "To install CUPS using a precompiled binary, issue the following command from " "a root terminal:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/articles/cups/_index.adoc:72 #, no-wrap msgid "# pkg install cups\n" msgstr "" #. type: Plain text #: documentation/content/en/articles/cups/_index.adoc:76 msgid "" "Other optional, but recommended, packages are package:print/gutenprint[] and " "package:print/hplip[], both of which add drivers and utilities for a variety " "of printers. Once installed, the CUPS configuration files can be found in " "the directory [.filename]#/usr/local/etc/cups#." msgstr "" #. type: Title == #: documentation/content/en/articles/cups/_index.adoc:78 #, no-wrap msgid "Configuring the CUPS Print Server" msgstr "" #. type: Plain text #: documentation/content/en/articles/cups/_index.adoc:82 msgid "" "After installation, a few files must be edited to configure the CUPS " "server. First, create or modify, as the case may be, the file [.filename]#/" "etc/devfs.rules# and add the following information to set the proper " "permissions on all potential printer devices and to associate printers with " "the `cups` user group:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/articles/cups/_index.adoc:90 #, no-wrap msgid "" "[system=10]\n" "add path 'unlpt*' mode 0660 group cups\n" "add path 'ulpt*' mode 0660 group cups\n" "add path 'lpt*' mode 0660 group cups\n" "add path 'usb/X.Y.Z' mode 0660 group cups\n" msgstr "" #. type: delimited block = 4 #: documentation/content/en/articles/cups/_index.adoc:96 msgid "" "Note that _X_, _Y_, and _Z_ should be replaced with the target USB device " "listed in the [.filename]#/dev/usb# directory that corresponds to the " "printer. To find the correct device, examine the output of man:dmesg[8], " "where [.filename]#ugenX.Y# lists the printer device, which is a symbolic " "link to a USB device in [.filename]#/dev/usb#." msgstr "" #. type: Plain text #: documentation/content/en/articles/cups/_index.adoc:99 msgid "Next, add two lines to [.filename]#/etc/rc.conf# as follows:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/articles/cups/_index.adoc:104 #, no-wrap msgid "" "cupsd_enable=\"YES\"\n" "devfs_system_ruleset=\"system\"\n" msgstr "" #. type: Plain text #: documentation/content/en/articles/cups/_index.adoc:107 msgid "" "These two entries will start the CUPS print server on boot and invoke the " "local devfs rule created above, respectively." msgstr "" #. type: Plain text #: documentation/content/en/articles/cups/_index.adoc:109 msgid "" "To enable CUPS printing under certain Microsoft(R) Windows(R) clients, the " "line below should be uncommented in [.filename]#/usr/local/etc/cups/mime." "types# and [.filename]#/usr/local/etc/cups/mime.convs#:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/articles/cups/_index.adoc:113 #, no-wrap msgid "application/octet-stream\n" msgstr "" #. type: Plain text #: documentation/content/en/articles/cups/_index.adoc:116 msgid "" "Once these changes have been made, the man:devfs[8] and CUPS systems must " "both be restarted, either by rebooting the computer or issuing the following " "two commands in a root terminal:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/articles/cups/_index.adoc:121 #, no-wrap msgid "" "# service devfs restart\n" "# service cupsd restart\n" msgstr "" #. type: Title == #: documentation/content/en/articles/cups/_index.adoc:124 #, no-wrap msgid "Configuring Printers on the CUPS Print Server" msgstr "" #. type: Plain text #: documentation/content/en/articles/cups/_index.adoc:128 msgid "" "After the CUPS system has been installed and configured, the administrator " "can begin configuring the local printers attached to the CUPS print server. " "This part of the process is very similar, if not identical, to configuring " "CUPS printers on other UNIX(R)-based operating systems, such as a Linux(R) " "distribution." msgstr "" #. type: Plain text #: documentation/content/en/articles/cups/_index.adoc:133 msgid "" "The primary means for managing and administering the CUPS server is through " "the web-based interface, which can be found by launching a web browser and " "entering http://localhost:631[http://localhost:631] in the browser's URL " "bar. If the CUPS server is on another machine on the network, substitute " "the server's local IP address for `localhost`. The CUPS web interface is " "fairly self-explanatory, as there are sections for managing printers and " "print jobs, authorizing users, and more. Additionally, on the right-hand " "side of the Administration screen are several check-boxes allowing easy " "access to commonly-changed settings, such as whether to share published " "printers connected to the system, whether to allow remote administration of " "the CUPS server, and whether to allow users additional access and privileges " "to the printers and print jobs." msgstr "" #. type: Plain text #: documentation/content/en/articles/cups/_index.adoc:137 msgid "" "Adding a printer is generally as easy as clicking \"Add Printer\" at the " "Administration screen of the CUPS web interface, or clicking one of the " "\"New Printers Found\" buttons also at the Administration screen. When " "presented with the \"Device\" drop-down box, simply select the desired " "locally-attached printer, and then continue through the process. If one has " "added the package:print/gutenprint-cups[] or package:print/hplip[] ports or " "packages as referenced above, then additional print drivers will be " "available in the subsequent screens that might provide more stability or " "features." msgstr "" #. type: Title == #: documentation/content/en/articles/cups/_index.adoc:139 #, no-wrap msgid "Configuring CUPS Clients" msgstr "" #. type: Plain text #: documentation/content/en/articles/cups/_index.adoc:143 msgid "" "Once the CUPS server has been configured and printers have been added and " "published to the network, the next step is to configure the clients, or the " "machines that are going to access the CUPS server. If one has a single " "desktop machine that is acting as both server and client, then much of this " "information may not be needed." msgstr "" #. type: Title === #: documentation/content/en/articles/cups/_index.adoc:145 #, no-wrap msgid "UNIX(R) Clients" msgstr "" #. type: Plain text #: documentation/content/en/articles/cups/_index.adoc:151 msgid "" "CUPS will also need to be installed on your UNIX(R) clients. Once CUPS is " "installed on the clients, then CUPS printers that are shared across the " "network are often automatically discovered by the printer managers for " "various desktop environments such as GNOME or KDE. Alternatively, one can " "access the local CUPS interface on the client machine at http://" "localhost:631[http://localhost:631] and click on \"Add Printer\" in the " "Administration section. When presented with the \"Device\" drop-down box, " "simply select the networked CUPS printer, if it was automatically " "discovered, or select `ipp` or `http` and enter the IPP or HTTP URI of the " "networked CUPS printer, usually in one of the two following syntaxes:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/articles/cups/_index.adoc:155 #, no-wrap msgid "ipp://server-name-or-ip/printers/printername\n" msgstr "" #. type: delimited block . 4 #: documentation/content/en/articles/cups/_index.adoc:160 #: documentation/content/en/articles/cups/_index.adoc:182 #, no-wrap msgid "http://server-name-or-ip:631/printers/printername\n" msgstr "" #. type: Plain text #: documentation/content/en/articles/cups/_index.adoc:163 msgid "" "If the CUPS clients have difficulty finding other CUPS printers shared " "across the network, sometimes it is helpful to add or create a file [." "filename]#/usr/local/etc/cups/client.conf# with a single entry as follows:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/articles/cups/_index.adoc:167 #, no-wrap msgid "ServerName server-ip\n" msgstr "" #. type: Plain text #: documentation/content/en/articles/cups/_index.adoc:170 msgid "" "In this case, _server-ip_ would be replaced by the local IP address of the " "CUPS server on the network." msgstr "" #. type: Title === #: documentation/content/en/articles/cups/_index.adoc:172 #, no-wrap msgid "Windows(R) Clients" msgstr "" #. type: Plain text #: documentation/content/en/articles/cups/_index.adoc:178 msgid "" "Versions of Windows(R) prior to XP did not have the capability to natively " "network with IPP-based printers. However, Windows(R) XP and later versions " "do have this capability. Therefore, to add a CUPS printer in these versions " "of Windows(R) is quite easy. Generally, the Windows(R) administrator will " "run the Windows(R) `Add Printer` wizard, select `Network Printer` and then " "enter the URI in the following syntax:" msgstr "" #. type: Plain text #: documentation/content/en/articles/cups/_index.adoc:185 msgid "" "If one has an older version of Windows(R) without native IPP printing " "support, then the general means of connecting to a CUPS printer is to use " "package:net/samba416[] and CUPS together, which is a topic outside the scope " "of this chapter." msgstr "" #. type: Title == #: documentation/content/en/articles/cups/_index.adoc:187 #, no-wrap msgid "CUPS Troubleshooting" msgstr "" #. type: Plain text #: documentation/content/en/articles/cups/_index.adoc:196 msgid "" "Difficulties with CUPS often lies in permissions. First, double check the " "man:devfs[8] permissions as outlined above. Next, check the actual " "permissions of the devices created in the file system. It is also helpful " "to make sure your user is a member of the `cups` group. If the permissions " "check boxes in the Administration section of the CUPS web interface do not " "seem to be working, another fix might be to manually backup the main CUPS " "configuration file located at [.filename]#/usr/local/etc/cups/cupsd.conf# " "and edit the various configuration options and try different combinations of " "configuration options. One sample [.filename]#/usr/local/etc/cups/cupsd." "conf# to test is listed below. Please note that this sample [." "filename]#cupsd.conf# sacrifices security for easier configuration; once the " "administrator successfully connects to the CUPS server and configures the " "clients, it is advisable to revisit this configuration file and begin " "locking down access." msgstr "" #. type: delimited block . 4 #: documentation/content/en/articles/cups/_index.adoc:202 #, no-wrap msgid "" "# Log general information in error_log - change \"info\" to \"debug\" for\n" "# troubleshooting...\n" "LogLevel info\n" msgstr "" #. type: delimited block . 4 #: documentation/content/en/articles/cups/_index.adoc:205 #, no-wrap msgid "" "# Administrator user group...\n" "SystemGroup wheel\n" msgstr "" #. type: delimited block . 4 #: documentation/content/en/articles/cups/_index.adoc:210 #, no-wrap msgid "" "# Listen for connections on Port 631.\n" "Port 631\n" "#Listen localhost:631\n" "Listen /var/run/cups.sock\n" msgstr "" #. type: delimited block . 4 #: documentation/content/en/articles/cups/_index.adoc:217 #, no-wrap msgid "" "# Show shared printers on the local network.\n" "Browsing On\n" "BrowseOrder allow,deny\n" "#BrowseAllow @LOCAL\n" "BrowseAllow 192.168.1.* # change to local LAN settings\n" "BrowseAddress 192.168.1.* # change to local LAN settings\n" msgstr "" #. type: delimited block . 4 #: documentation/content/en/articles/cups/_index.adoc:221 #, no-wrap msgid "" "# Default authentication type, when authentication is required...\n" "DefaultAuthType Basic\n" "DefaultEncryption Never # comment this line to allow encryption\n" msgstr "" #. type: delimited block . 4 #: documentation/content/en/articles/cups/_index.adoc:228 #, no-wrap msgid "" "# Allow access to the server from any machine on the LAN\n" "<Location />\n" " Order allow,deny\n" " #Allow localhost\n" " Allow 192.168.1.* # change to local LAN settings\n" "</Location>\n" msgstr "" #. type: delimited block . 4 #: documentation/content/en/articles/cups/_index.adoc:236 #, no-wrap msgid "" "# Allow access to the admin pages from any machine on the LAN\n" "<Location /admin>\n" " #Encryption Required\n" " Order allow,deny\n" " #Allow localhost\n" " Allow 192.168.1.* # change to local LAN settings\n" "</Location>\n" msgstr "" #. type: delimited block . 4 #: documentation/content/en/articles/cups/_index.adoc:245 #, no-wrap msgid "" "# Allow access to configuration files from any machine on the LAN\n" "<Location /admin/conf>\n" " AuthType Basic\n" " Require user @SYSTEM\n" " Order allow,deny\n" " #Allow localhost\n" " Allow 192.168.1.* # change to local LAN settings\n" "</Location>\n" msgstr "" #. type: delimited block . 4 #: documentation/content/en/articles/cups/_index.adoc:256 #, no-wrap msgid "" "# Set the default printer/job policies...\n" "<Policy default>\n" " # Job-related operations must be done by the owner or an administrator...\n" " <Limit Send-Document Send-URI Hold-Job Release-Job Restart-Job Purge-Jobs \\\n" "Set-Job-Attributes Create-Job-Subscription Renew-Subscription Cancel-Subscription \\\n" "Get-Notifications Reprocess-Job Cancel-Current-Job Suspend-Current-Job Resume-Job \\\n" "CUPS-Move-Job>\n" " Require user @OWNER @SYSTEM\n" " Order deny,allow\n" " </Limit>\n" msgstr "" #. type: delimited block . 4 #: documentation/content/en/articles/cups/_index.adoc:267 #, no-wrap msgid "" " # All administration operations require an administrator to authenticate...\n" " <Limit Pause-Printer Resume-Printer Set-Printer-Attributes Enable-Printer \\\n" "Disable-Printer Pause-Printer-After-Current-Job Hold-New-Jobs Release-Held-New-Jobs \\\n" "Deactivate-Printer Activate-Printer Restart-Printer Shutdown-Printer Startup-Printer \\\n" "Promote-Job Schedule-Job-After CUPS-Add-Printer CUPS-Delete-Printer CUPS-Add-Class \\\n" "CUPS-Delete-Class CUPS-Accept-Jobs CUPS-Reject-Jobs CUPS-Set-Default>\n" " AuthType Basic\n" " Require user @SYSTEM\n" " Order deny,allow\n" " </Limit>\n" msgstr "" #. type: delimited block . 4 #: documentation/content/en/articles/cups/_index.adoc:273 #, no-wrap msgid "" " # Only the owner or an administrator can cancel or authenticate a job...\n" " <Limit Cancel-Job CUPS-Authenticate-Job>\n" " Require user @OWNER @SYSTEM\n" " Order deny,allow\n" " </Limit>\n" msgstr "" #. type: delimited block . 4 #: documentation/content/en/articles/cups/_index.adoc:278 #, no-wrap msgid "" " <Limit All>\n" " Order deny,allow\n" " </Limit>\n" "</Policy>\n" msgstr ""