Command-Line Printer Administration

This help document describes how to configure and manage destinations with CUPS.

Introduction

Destinations are individual printers and classes (pools) of printers. Printers use a description file with one or more driver («filter») programs that communicate with the printer through a «backend» program. CUPS currently uses PPD (PostScript Printer Description) files to describe the printer and driver programs needed, some of which come with CUPS while others come with your operating system or Linux distribution. Backends are specified using a URI (Universal Resource Identifier) where the URI scheme is the backend name, e.g., «ipp://11.22.33.44/ipp/print» specifies the «ipp» backend — like PPD files, some backends come with CUPS while others come with your operating system.

Classes are associated with one or more printers and are typically used to distribute print jobs amongst a group of printers or provide redundancy or high availability when printing. Print jobs sent to a class are forwarded to the next available printer in the class.

The lpadmin(8) program is used to add, modify, or delete destinations, while the lpinfo(8) command is used to list the available printer drivers and backends. The cupsctl(8) program is used to manage the printing system as a whole, including things like debug logging and printer sharing. The CUPS web interface («http://localhost:631» or «https://servername:631») can also be used, and most operating systems provide their own GUI administration tools.

Managing Printers

The lpadmin command is used to create, modify, or delete a printer. The -p option specifies a printer to create or modify:

The lpadmin accepts several additional options after -p printername when adding or modifying a printer:

-D «description» Sets the description of the printer which is often shown instead of the printer name, for example «HP LaserJet». -E Enables the printer and accepts new print jobs. -L «location» Sets the location of the printer, for example «Conference Room». -m model Sets the printer driver using the model name. -o option=value Sets the named option. -v device-uri Sets the URI for the printer.

The -x option deletes the named printer:

Printer Drivers and PPDs

The -m option to lpadmin specifies the driver («model») to use for the printer. You can run the lpinfo -m command to list all of the available drivers («models») on your system:

Each line contains the driver name followed by its description, for example:

The everywhere driver is used for nearly all modern networks printers sold since about 2009. For example, the following command creates a destination for a printer at IP address 11.22.33.44:

The CUPS sample drivers (the «drv:///sample.drv/. » lines above) can be used for «legacy» printers. For example, the following command creates a destination for a HP LaserJet printer at IP address 11.22.33.44:

Note: The CUPS sample drivers are designed to provide basic printing capabilities for the broadest range of printers possible, but generally do not exercise the full potential of the printers or CUPS. Other drivers (including the everywhere driver) provide greater printing capabilities and better print quality.

Device URIs (Backends)

CUPS comes with several standard backends that communicate with printers:

1. dnssd : The Bonjour (DNS-SD) protocol.
2. ipp : The Internet Printing Protocol (IPP) with optional encryption.
3. ipps : The Internet Printing Protocol with mandatory encryption.
4. lpd : The Line Printer Daemon protocol.
5. socket : The AppSocket (JetDirect) protocol.
6. usb : The Universal Serial Bus (USB) printer class.

Run the lpinfo -v command to list the available backends and printers:

Each line contains the backend «class» followed by the backend name or a full printer device URI, for example:

The network class of backends is used for all network protocols. The Using Network Printers help document describes how to use the standard CUPS network backends. The direct class of backends is used for directly-connected printers such as USB and Bluetooth. Because these backends use a system-specific identifier, you should only use the reported device URIs.

Once you know the correct URI for the printer, set it using the lpadmin command’s -v option:

Printer Options

The lpadmin command allows you to set various options for a printer:

-o cupsIPPSupplies=false Turns off IPP supply level reporting for a printer. -o cupsSNMPSupplies=false Turns off SNMP supply level reporting for a printer. -o name=value Sets the default value for the named PPD option. For example, -o PageSize=Legal sets the default page size to US Legal. -o printer-error-policy=name Sets the policy for errors such as printers that cannot be found or accessed, don’t support the format being printed, fail during submission of the print data, or cause one or more filters to crash: abort-job Aborts the job on error. retry-job Retries the job at a future time. retry-current-job Retries the current job immediately. stop-printer Stops the printer on error. -o printer-is-shared=true/false Enables/disables per-printer sharing. See the section on Printer Sharing for more information. -o printer-op-policy=name Sets the operation policy associated with the printer. See the Managing Operation Policies help document for more information. -u allow:<,user|,@group>* -u allow:all -u deny:<,user|,@group>* -u deny:none Sets user-level access control for the printer. The allow: list defines a whitelist of users and groups while the deny: list defines a blacklist of users and groups.

Printer Sharing

CUPS supports sharing of printers with other computers and mobile devices. Two cupsctl options control the general printer sharing features:

—share-printers Enables sharing of printers with other computers and mobile devices on your local network. —remote-any Expands printer sharing to any network that can reach your server.

Once you have enabled printer sharing, you then must select which printers will be shared using the lpadmin command and the -o printer-is-shared=true option.

For example, to share two printers («foo» and «bar») on the local network, run the following commands:

Managing Classes

The lpadmin command is used to create, modify, or delete a class. The -c option specifies a class to create or modify and is combined with the -p option:

The -r option specifies that the named printer is removed from the class:

The -x option deletes the named class:

Debug Logging and Troubleshooting

The printing system log files track the activity of the scheduler, printer drivers, and backends. If problems occur and the log files do not provide sufficient details to diagnose the problem, you can enable debug logging using the cupsctl command:

To disable debug logging, run the same command with the —no-debug-logging option:

как прикрутить к CUPS расшаренный в винде принтер ?

есть моя машина , с слакой и CUPS

добавляю в нем Windows printer via SAMBA

Device URI: smb://NATASHA/LexmarkE

выбираю driver Generic PCL 5c foomatic бла бла .

пробую печатать тестовую страницу — Unable to connect to CIFS host after (tried 3 times)»

Re: как прикрутить к CUPS расшаренный в винде принтер ?

в какую сторону копать ?

Re: как прикрутить к CUPS расшаренный в винде принтер ?

судя по зловещему молчанию , копать предлагают вниз .

Re: как прикрутить к CUPS расшаренный в винде принтер ?

>судя по зловещему молчанию
Ты что в круглосуточную службу поддержки обратился? Ночью люди спят, сюрприз!

З.Ы. бери smbclient, подключайся к принтеру и смотри чего ей (самбе) не хватает. Когда успешно подключишься, тогда и начинай CUPS настраивать.

Re: как прикрутить к CUPS расшаренный в винде принтер ?

а имя NATASHA кто резолвит ? попробуй вписать так:
Device URI: smb://guest@ip_address_of_NATASHA/LexmarkE

Re: как прикрутить к CUPS расшаренный в винде принтер ?

>Ночью люди спят, сюрприз!

а я подумал что меня просто никто не любит . 🙂

я xfsamba ковырял.
в шелле выдает

$ smbclient -N -L //NATAHSA
Anonymous login successful
Domain=[DOMA] OS=[Windows 5.1] Server=[Windows 2000 LAN Manager]

Sharename Type Comment
——— —- ——-
cli_rpc_pipe_open: cli_nt_create failed on pipe \srvsvc to machine NATAHSA. Error was NT_STATUS_ACCESS_DENIED
Error returning browse list: NT_STATUS_ACCESS_DENIED
Anonymous login successful
Domain=[DOMA] OS=[Windows 5.1] Server=[Windows 2000 LAN Manager]

Server Comment
——— ——-
BLOODMERI Samba Server
NATAHSA

Workgroup Master
——— ——-
DOMA NATAHSA

Расшаривание CUPS-принтера в винду

дистр — centos 6.4. Есть комп с восьмой вендой, надо подключить расшаренный cups-принтер. По адресу http://192.168.1.241:631/printers/epson венда его не видит, мол не подключен, бла-бла.

Что могло сломаться? С других линукс-машин печатает. SELinux и iptables/ip6tables выключены.

а samba тут ни при чём?

Если винда умеет в IPP, зачем самба?

авторизация виндового пользователя в линуксе есть?

а с браузера клиентского по адресу http://192.168.1.241:631/printers/epson заходишь без проблем?

Совершенно верно, и другие линукс-машины по IPP печатают нормально. Проблема, видимо, с самой вендой. Как всегда.

В микрософт, в техподдержку обращался?

Все-таки что-то с авторизацией. xp печатает нормально.

Попробуй дрова под этот принтак с сайта производителя по 8-ку поставить.

Не в дровах дело, оно не подключается вообще.

а ping до cups-а и принтера есть?

да еще брэндмауры и файрволы на 8-ке попробуй погасить

Вы бы еще спросили, включен ли принтер и компьютер. Конечно.

Проблема решилась установкой DefaultAuthType Basic вместо None, хотя это и похоже на костыль. Спасибо за помощь, буду копать.

Пуск -> Панель управления -> Администрирование -> Локальная политика безопасности. Далее заходим в Локальная политика -> Параметры безопасности и меняем следующие параметры: «Сетевая безопасность: Уровень проверки подлинности LAN Manager» — поставить значение «Отправлять LM- и NTML-ответы».

если этого будет недостаточно, тогда еще:
«Сетевая безопасность: Минимальная сеансовая безопасность для клиентов (серверов) на базе NTLM SSP» — отключить пункт «Требовать 128-битное шифрование».

CUPS (Русский)

CUPS — это стандартная система печати с открытым исходным кодом, разработанная Apple Inc. для MacOS® и других UNIX®-подобных операционных систем.

Contents

Установка

Если вы намерены «распечатать» в документ PDF, тогда вам необходимо установить пакет cups-pdf . По умолчанию файлы PDF хранятся в /var/spool/cups-pdf/имя_пользователя . Местоположение можно изменить в /etc/cups/cups-pdf.conf .

Сокет-активация

cups предоставляет юнит cups.socket . Если сокет cups.socket включен (а служба cups.service отключена), systemd не будет запускать CUPS сразу, а просто будет слушать соответствующие сокеты. Затем всякий раз, когда программа пытается обратиться к одному из этих сокетов, systemd будет запускать службу cups.service и прозрачно передавать управление этими портами процессу CUPS.

Таким образом, CUPS запускается только тогда, когда программа хочет его использовать.

Интерфейсы подключения

Дополнительные шаги для обнаружения принтера приведены ниже для различных интерфейсов подключения.

Чтобы узнать, обнаружен ли ваш USB-принтер:

Параллельный порт

Чтобы использовать принтер с параллельным портом, требуются модули ядра lp , parport и parport_pc .

Чтобы обнаружить или предоставить общий доступ к принтерам с помощью DNS-SD/mDNS, настройте разрешение имени узла .local через Avahi и перезапустите службу cups.service .

Для предоставления общего доступа к принтерам с помощью Samba, например, если система должна быть сервером печати для клиентов Windows, необходим пакет samba .

Драйверы принтеров

Драйверы для принтеров можно получить из любого из источников, приведенных ниже. Смотрите CUPS/Принтероспецифичные проблемы для неполного списка драйверов, которые работают.

Для управления принтером CUPS требуется файл PPD, а для большинства принтеров — некоторые фильтры. Подробнее о том, как CUPS использует PPD и фильтры, смотрите на [1].

Список принтеров OpenPrinting содержит рекомендации для драйверов для многих принтеров. Он также поставляет файлы PPD для каждого принтера, но большинство из них доступны через foomatic или рекомендованный пакет драйверов.

Когда файлы PPD предоставляются CUPS, тогда сервер CUPS будет регенерировать файлы PPD и сохранять их в /etc/cups/ppd/ .

CUPS обеспечивает поддержку принтеров AirPrint и IPP Everywhere.

Фильтры OpenPrinting CUPS

Рабочая группа OpenPrinting в Linux Foundation предоставляет cups-filters. Это бэкэнды, фильтры и другие двоичные файлы, которые когда-то были частью CUPS, но больше не поддерживаются Apple. Они доступны в пакете cups-filters , который является зависимостью для cups .

Для принтеров Non-PostScript требуется установить ghostscript . Для ghostscript также может потребоваться gsfonts .

Foomatic

Рабочая группа foomatic в OpenPrinting в Linux Foundation предоставляет PPD для многих драйверов принтеров, как свободных, так и проприетарных. Для получения дополнительной информации о том, что делает foomatic, смотрите Обзор foomatic от разработчиков.

Чтобы использовать foomatic, установите foomatic-db-engine и по крайней мере один из пакетов:

• foomatic-db — коллекция файлов XML, используемая foomatic-db-engine для генерации файлов PPD.
• foomatic-db-ppds — прекомпилированные файлы PPD.
• foomatic-db-nonfree — коллекция файлов XML под несвободными лицензиями от производителей принтеров, используемая foomatic-db-engine для генерации файлов PPD.
• foomatic-db-nonfree-ppds — прекомпилированные файлы PPD под несвободными лицензиями.

Для PPD foomatic могут потребоваться дополнительные фильтры, такие как min12xxw AUR .

Gutenprint

Проект Gutenprint предоставляет драйвера для Canon, Epson, Lexmark, Sony, Olympus, и принтеров PCL для использования с CUPS и GIMP.

Специфические для производителя драйвера

Многие производители принтеров поставляют свои собственные драйверы Linux. Они часто доступны в официальных хранилищах Arch или в AUR.

Некоторые из этих драйверов описаны более подробно в CUPS/Принтероспецифичные проблемы.

URI принтера

Ниже перечислены дополнительные шаги для ручного создания URI, если это необходимо. Для некоторых принтеров или драйверов нужны особые URI, описанные в CUPS/Принтероспецифичные проблемы.

CUPS должен иметь возможность автоматически генерировать URI для USB-принтеров, например usb://HP/DESKJET%20940C?serial=CN16E6C364BH .

Если этого не происходит, смотрите CUPS/Решение проблем#USB-принтеры для получения информации об устранении неполадок.

Параллельный порт

URI должен иметь вид parallel:device . Например, если принтер подключен к /dev/lp0 , используйте parallel:/dev/lp0 . Если вы используете адаптер USB для параллельного порта, используйте parallel:/dev/usb/lp0 в качестве URI принтера.

Если вы настроили Avahi, как в #Сеть, CUPS должен определить URI принтера. Вы также можете использовать avahi-discover , чтобы найти имя вашего принтера и его адрес (например, BRN30055C6B4C7A.local/10.10.0.155:631 ).

URI также можно создать вручную, не используя Avahi. Список доступных схем URI для сетевых принтеров доступен в документации CUPS. Поскольку точные данные URI отличаются между принтерами, проверьте руководство принтера или CUPS/Принтероспецифичные проблемы.

URI для сетевых принтеров SMB описаны на справочной странице smbspool(8) .

К удаленным серверам печати CUPS можно получить доступ через URI формы ipp://hostname:631/printers/queue_name . Подробнее о настройке удаленного сервера печати смотрите CUPS/Printer sharing#Between GNU/Linux systems [ссылка недействительна: раздел не найден] .

Смотрите CUPS/Решение проблем#Проблемы с сетью для получения дополнительной информации о проблемах и их решений.

Использование

CUPS можно полностью контролировать с помощью инструментов командной строки (CLI) из пакетов lp* и cups*. В качестве альтернативы можно использовать #Веб интерфейс или одно из нескольких #Приложения с GUI.

• Имя принтера — короткое, но описательное имя, используемое в системе для идентификации принтера. Это имя не должно содержать пробелов или специальных символов. Например, принтер, соответствующий HP LaserJet 5P, может быть назван «hpljet5p». С каждым физическим принтером можно связать более одной очереди.
• Расположение — это описание физического расположения принтера (например, «спальня», или «кухня»). Это помогает поддерживать несколько принтеров.
• Описание — полное описание принтера. Обычно используется полное имя принтера (например, «HP LaserJet 5P»).

Инструменты CLI

Смотрите локальную документацию CUPS для получения дополнительных сведений об инструментах командной строки.

This article or section needs language, wiki syntax or style improvements. See Help:Style for reference.

Имя принтера зависит от тебя. Например:

Проверка cостояния принтера Отключение принтера Включение принтера Настройка принтера для приема заданий Удаление принтера

Сначала настройте принтер для отклонения всех входящих записей:

Затем отключите его.

Наконец, удалите его.

Печать файла Проверка очереди Очистка очереди

Веб интерфейс

Сервером CUPS можно полностью управлять через веб-интерфейс, доступный по адресу http://localhost:631/.

Для выполнения административных задач требуется аутентификация веб-интерфейса. Аутентифицируйте себя либо как root , либо убедитесь, что ваш пользователь входит в группу с полномочиями управления принтерами, для получения дополнительной информации смотрите #Настройка.

Перейдите на вкладку Администрирование.

Изменение существующих принтеров

Перейдите на вкладку Принтеры и выберите принтер для изменения.

Перейдите на вкладку Принтеры и выберите принтер.

Приложения с GUI

Если у вашего пользователя нет достаточных привилегий для администрирования CUPS, приложения будут запрашивать пароль root при запуске. Чтобы предоставить пользователям права администратора без необходимости доступа root, смотрите #Настройка.

Настройка

Настройки сервера CUPS находятся в /etc/cups/cupsd.conf и /etc/cups/cups-files.conf (смотрите cupsd.conf(5) и cups-files.conf(5) ). После редактирования любого из этих файлов, перезапустите cups.service , чтобы применить произведенные изменения. Настройки по умолчанию подходят для большинства пользователей.

Группы с правами администрирования принтера определены в SystemGroup в /etc/cups/cups-files.conf . Группы sys и root используется по умолчанию.

Пакет cups собран с поддержкой libpaper и значением по умолчанию для формата бумаги Письмо для файла libpaper. Чтобы избежать необходимости изменять размер бумаги для каждого принтера, отредактируйте /etc/papersize и задайте размер бумаги по умолчанию для вашей системы. Для получения дополнительной информации смотрите papersize(5) .

По умолчанию все журналы отправляются в файлы в /var/log/cups/ . Изменив значения директив AccessLog , ErrorLog и PageLog в /etc/cups/cups-files.conf на syslog , то CUPS сможет отправлять логи в журнал systemd. Смотрите вики-страницу fedora для получения информации об исходном предлагаемом изменении.

cups-browsed

This article or section is out of date.

CUPS может использовать Avahi для обнаружения неизвестных общих принтеров в вашей сети. Это может быть полезно в крупных сетях, где сервер неизвестен. Чтобы использовать эту функцию, настройте разрешение .local hostname и запустите службы avahi-daemon.service и cups-browsed.service . Задания отправляются непосредственно на принтер без какой-либо обработки, поэтому созданные очереди могут не работать, однако для принтеров, не требущих драйверов, такие как те, которые поддерживают IPP Everywhere или AirPrint все должно работать из коробки.

Серверы печати и удаленное администрирование

Разрешение аутентификации администратора через PolicyKit

PolicyKit можно настроить так, чтобы пользователи могли настраивать принтеры с помощью графического интерфейса без пароля администратора.

Вот пример, который позволяет членам группы wheel управлять принтерами без пароля:

Без локального сервера CUPS

CUPS можно настроить для прямого подключения к удаленным серверам принтеров вместо запуска локального сервера печати. Для этого потребуется установить пакет libcups . Некоторым приложениям по-прежнему потребуется пакет cups для печати.

Чтобы использовать удаленный сервер CUPS, установите переменную окружения CUPS_SERVER в printerserver.mydomain:port . Например, если вы хотите использовать другой сервер печати для одного экземпляра Firefox (замените printserver.mydomain:port на имя/порт своего сервера печати):

Решение проблем

Для получения дополнительной информации смотрите CUPS/Решение проблем.