.\" .\" Backend man page for CUPS. .\" .\" Copyright © 2021-2023 by OpenPrinting. .\" Copyright © 2007-2019 by Apple Inc. .\" Copyright © 1997-2006 by Easy Software Products. .\" .\" Licensed under Apache License v2.0. See the file "LICENSE" for more .\" information. .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH backend 7 CUPS 2021\-02\-28 OpenPrinting .SH NOME backend \- interfaces de transmissão de backen de cups .SH RESUMO \fBbackend\fP .br \fBbackend\fP \fIjob\fP \fIuser\fP \fItitle\fP \fInum\-copies\fP \fIoptions\fP [ \fIfilename\fP ] .nf \fB#include \fP \fBconst char *cupsBackendDeviceURI\fP(\fBchar **\fP\fIargv\fP); \fBvoid cupsBackendReport\fP(\fBconst char *\fP\fIdevice_scheme\fP, \fBconst char *\fP\fIdevice_uri\fP, \fBconst char *\fP\fIdevice_make_and_model\fP, \fBconst char *\fP\fIdevice_info\fP, \fBconst char *\fP\fIdevice_id\fP, \fBconst char *\fP\fIdevice_location\fP); \fBssize_t cupsBackChannelWrite\fP(\fBconst char *\fP\fIbuffer\fP, \fBsize_t \fP\fIbytes\fP, \fBdouble \fP\fItimeout\fP); \fBint cupsSideChannelRead\fP(\fBcups_sc_command_t *\fP\fIcommand\fP, \fBcups_sc_status_t *\fP\fIstatus\fP, \fBchar *\fP\fIdata\fP, \fBint *\fP\fIdatalen\fP, \fBdouble \fP\fItimeout\fP); \fBint cupsSideChannelWrite\fP(\fBcups_sc_command_t \fP\fIcommand\fP, \fBcups_sc_status_t \fP\fIstatus\fP, \fBconst char *\fP\fIdata\fP, \fBint \fP\fIdatalen\fP, \fBdouble \fP\fItimeout\fP); .fi .SH DESCRIÇÃO Backends são tipos especiais de \fBfilter\fP(7) que são usados para enviar dados de impressão e descobrir dispositivos diferentes no seu sistema. .LP Tal como os filtros, os backends têm de ser capazes de ler a partir de um nome de ficheiro na linha de comandos ou a partir da entrada standard, copiando a entrada standard para um ficheiro temporário como requerido pela interface física. .LP O nome do comando (\fIargv[0]\fP) é definido no URI do dispositivo da impressora de destino. A informação de autenticação em \fIargv[0]\fP é removida, assim os desenvolvedores do backend são instados a usar a variável de ambiente \fBDEVICE_URI\fP sempre que é requerida informação de autenticação. A função \fBcupsBackendDeviceURI\fP() pode ser usada para obter o URI correcto do dispositivo. .LP Dados do canal\-traseiro a partir do dispositivo devem ser retransmitidos para os filtros de trabalhos usando a função \fIcupsBackChannelWrite\fP. .LP Backends são responsáveis por ler pedidos de canal\-lateral usando a função \fBcupsSideChannelRead\fP() e respondendo com a função \fBcupsSideChannelWrite\fP(). A constante \fBCUPS_SC_FD\fP define o descritor de ficheiro que deve ser monitorizado para chegada de pedido. .SS "DESCOBERTA DE DISPOSITIVOS" Quando corrido sem argumentos, o backend deve listar os dispositivos e esquemas que suporta ou anuncia na saída standard. O resultado consiste de zero ou mais linhas consistindo em qualquer dos seguintes formatos: .nf device\-class scheme "Unknown" "device\-info" device\-class device\-uri "device\-make\-and\-model" "device\-info" device\-class device\-uri "device\-make\-and\-model" "device\-info" "device\-id" device\-class device\-uri "device\-make\-and\-model" "device\-info" "device\-id" "device\-location" .fi .LP A função \fBcupsBackendReport\fP() pode ser usada para gerar estas linhas e lidar com qualquer escape necessário de caracteres nas várias strings. .LP O campo \fIdevice\-class\fP é um dos seguintes valores: .TP 5 \fBdirect\fP O uri\-do\-dispositivo refere\-se a um dispositivo de acesso\-direto específico sem opções, tal como dispositivo paralelo, USB ou SCSI. .TP 5 \fBfile\fP O uri\-do\-dispositivo refere\-se a um ficheiro no disco. .TP 5 \fBnetwork\fP O uri\-do\-dispositivo refere\-se a um dispositivo em rede e está em conformidade com o formato geral para URIs de rede. .TP 5 \fBserial\fP O uri\-de\-dispositivo refere\-se a um dispositivo série com taxa de transmissão configurável e outras opções. Se o dispositivo conter um valor baud, este representa a taxa de transmissão (baud rate) máxima suportada pelo dispositivo. .LP O campo \fIscheme\fP fornece o esquema URI que é suportado pelo backend. Backends devem usar este formato apenas quando o backend suporta qualquer URI que use esse esquema. O campo \fIdevice\-uri\fP especifica o URI completo a usar quando se comunica com o dispositivo. .LP O campo \fIdevice\-make\-and\-model\fP especifica a marca e modelo do dispositivo, ex. "Exemplo Foojet 2000". Se a marca e modelo não forem conhecidas, você deve reportar "Unknown". .LP O campo \fIdevice\-info\fP especifica informação adicional acerca do dispositivo. Tipicamente isto inclui a marca e modelo juntamente com o número de porto ou endereço de rede, ex. "Exemplo Foojet 2000 USB #1". .LP O campo opcional \fIdevice\-id\fP especifica a string ID de dispositivo IEEE\-1284 para o dispositivo, o que é usado para selecionar uma driver correspondente. .LP O campo opcional \fIdevice\-location\fP especifica a localização física do dispositivo, o que é muitas vezes usado para pré\-preencher o atributo localização\-da\-impressora quando se adiciona uma impressora. .SS PERMISSÕES Backends sem permissões de ler e executar correm como utilizador root. Caso contrário, o backend corre usando uma conta de utilizador sem privilégios, tipicamente "lp". .SH "ESTADO DE SAÍDA" Os seguintes códigos de saída estão definidos para backends: .TP 5 \fBCUPS_BACKEND_OK\fP O ficheiro de impressão foi transmitido com sucesso para o dispositivo ou servidor remoto. .TP 5 \fBCUPS_BACKEND_FAILED\fP .br The print file was not successfully transmitted to the device or remote server. The scheduler will respond to this by canceling the job, retrying the job, or stopping the queue depending on the state of the \fIprinter\-error\-policy\fP attribute. .TP 5 \fBCUPS_BACKEND_AUTH_REQUIRED\fP O ficheiro de impressão não foi transmitido com sucesso porque é necessário informação de autenticação válida. O agendador irá responder a isto ao segurar o trabalho e adicionar a palavra\-chave "cups\-held\-for\-authentication' ao atributo "job\-reasons" Job Description. .TP 5 \fBCUPS_BACKEND_HOLD\fP O ficheiro de impressão não foi transmitido com sucesso porque não pode ser imprimido nesta altura. O agendador irá responder a isto ao segurar o trabalho. .TP 5 \fBCUPS_BACKEND_STOP\fP O ficheiro de impressão não foi transmitido com sucesso porque não pode ser imprimido nesta altura. O agendador irá responder a isto ao parar a fila de espera. .TP 5 \fBCUPS_BACKEND_CANCEL\fP O ficheiro de impressão não foi transmitido com sucesso porque um ou mais atributos não são suportados ou o trabalho foi cancelado na impressora. O agendador irá responder a isto ao cancelar o trabalho. .TP 5 \fBCUPS_BACKEND_RETRY\fP O ficheiro de impressão não foi transmitido com sucesso devido a um problema temporário. O agendador irá re\-tentar o trabalho no futuro \- outros trabalhos podem ser imprimidos antes deste. .TP 5 \fBCUPS_BACKEND_RETRY_CURRENT\fP O ficheiro de impressão não foi transmitido com sucesso devido a um problema temporário. O agendador irá re\-tentar o trabalho imediatamente sem permitir trabalhos intermédios. .PP Todos os outros códigos de saída são reservados. .SH AMBIENTE Adicionalmente às variáveis de ambiente listadas em \fBcups\fP(1) e \fBfilter\fP(7), os backends do CUPS podem esperar a seguinte variável de ambiente: .TP 5 \fBDEVICE_URI\fP O URI de dispositivo associado à impressora. .SH FICHEIROS \fI/etc/cups/cups\-files.conf\fP .SH NOTAS Os backends do CUPS geralmente não são desenhados para correrem diretamente pelo utilizador. backends are not generally designed to be run directly by the user. Aparte da questão do URI de dispositivo ( \fIargv[0]\fP e a variável de ambiente \fBDEVICE_URI\fP contêm o URI do dispositivo), os backends do CUPS também esperam variáveis de ambiente específicas e descritores de ficheiro, e tipicamente correm numa sessão de utilizador que (no macOS) tem restrições adicionais que afectam como eles correm. Backends também podem ser instalados com permissões restritas (0500 ou 0700) que diz ao agendador para os correr como o utilizador "root" em vez de um utilizador sem privilégios (tipicamente "lp") no sistema. .LP A menos que você seja um desenvolvedor e saiba o que está a fazer, por favor não corra backends diretamente. Em vez disso, use os programas \fBlp\fP(1) ou \fBlpr\fP(1) para enviar trabalhos de impressão ou \fBlpinfo\fP(8) para consultar por impressoras disponíveis que usam o backend. A excepção é o backend SNMP \- veja \fBcups\-snmp\fP(8) para mais informação. .SH NOTAS Drivers de impressoras e backends do CUPS estão descontinuados e não irão ser mais suportados num futuro lançamento do CUPS. Impressoras que não suportem IPP podem ser suportadas usando aplicações como a \fBippeveprinter\fP(1). .SH "VEJA TAMBÉM" \fIcups\fP(1), \fIcups\-files.conf\fP(5), \fIcups\-snmp\fP(8), \fIcupsd\fP(8), \fIfilter\fP(7), \fIlp\fP(1), \fIlpinfo\fP(8), \fIlpr\fP(1), .br Ajuda Online do CUPS (http://localhost:631/help) .SH COPYRIGHT Copyright \[co] 2021\-2023 by OpenPrinting.