APT-CONFIG(8)

NOME
apt-config - Programa de Consulta de Configuração do APT

SINOPSE

apt-config [--empty] [--format '%f "%v";%n'] [-o=config_string] [-c=ficheiro_de_configuração] {shell | dump | {-v | --version} | {-h | --help}}

DESCRIÇÃO

apt-config é um programa interno usado por várias partes da suite APT para fornecer uma configurabilidade consistente. Acede ao ficheiro de configuração principal /etc/apt/apt.conf de um modo que é fácil de usar para aplicações em script.

A menos que a opção -h, ou --help seja fornecida, um dos comandos abaixo têm que estar presentes.

shell
    shell é usado para aceder à informação de configuração a partir de um script shell. É fornecido pares de argumentos, sendo o primeiro uma variável de shell e o segundo o valor de configuração a consultar. Como resultado cria uma lista de comandos atribuídos a shell para cada valor presente. Num script shell deverá ser usado como se segue:

        OPTS="-f"
        RES=`apt-config shell OPTS MyApp::options`
        eval $RES
    Isto irá definir a variável de ambiente shell $OPTS ao valor de MyApp::options com uma predefinição de -f.

    O item de configuração pode ser pós-fixado com um /[fdbi]. f devolve nomes de ficheiros, d devolve directórios, b devolve verdadeiro ou falso e i devolve um número inteiro. Cada um dos valores devolvidos é normalizado e verificado internamente.

dump
    Apenas mostra o conteúdo do espaço de configuração.

OPÇÕES

Todas as opções de linha de comandos podem ser definidas usando o ficheiro de configuração, as descrições indicam a opção de configuração a definir. Para opções booleanas você pode sobre por o ficheiro de configuração usando algo como -f-,--no-f, -f=no ou várias outras variantes.

--empty
    Inclui opções que têm um valor vazio. Isto é a predefinição, então use --no-empty para remove-las dos resultados.

--format '%f "%v";%n'
    Define a saída de cada opção de configuração. %t irá ser substituído com o seu nome individual, %f com o seu nome hierárquico e %v com o seu valor. O uso de letras maiúsculas e caracteres especiais no valor será codificado para assegurar que pode, por exemplo, ser usado em segurança numa string citada como definido por RFC822. Adicionalmente %n será substituído por uma nova linha, e %N por um separador. Um % pode ser escrito ao usar %%.

-h, --help
    Mostra um sumário curto da utilização.

-v, --version
    Mostra a versão do programa.

--audit
    -Mostra mensagens audit (e notificações). Isto sobrepõe a opção quiet, mas apenas para mensagens de notificação, não as de progresso.

-c, --config-file
    Ficheiro de Configuração; Especifica o ficheiro de configuração a usar. O programa irá ler o ficheiro de configuração predefinido e depois este ficheiro de configuração. Se as definições de configuração precisarem de ser definidas antes, os ficheiros de configuração predefinidos são analisados especificando um ficheiro com a variável de ambiente APT_CONFIG. Veja apt.conf(5) para informação de sintaxe.

-o, --option
    Define uma Opção de Configuração; Isto irá definir uma opção de configuração arbitrária. A sintaxe é -o Foo::Bar=bar. -o e --option podem ser usadas várias vezes para definir opções diferentes.

--cli-version
    Requests a specific CLI version. This is a pattern that takes a MAJOR.MINOR version. You may omit the MINOR version, in which case the latest supported minor level will be used.

    Version tracks are presented as follows: The version 3.2 has equivalent versions 0.32, 1.22, and 2.12, implementing new features for their specified major versions.

    A special case is the X.9 version pattern: A version like 2.9 is followed by 3.0, but 2.10 follows directly on 2.8; given that we use odd version numbers as development series (2.9 is the 3.0 development series).

    This feature has been introduced in APT 3.1.10, and replaces the binary-specific configuration. You may use the APT::Version to similar effect on older binaries, for example, use -o APT::Version=2 to make apt(8) behave like the 2.x series.

    The default value is the current APT version for apt(8) and 0.(10 * major + minor) for the classic commands. The 0.X series is soft-deprecated and the other commands will roll over to the 2.x series in the future.

--no-color, --color
    Liga e desliga cores. As cores estão ligadas por predefinição nos terminais suportados para apt(8) e também podem ser desactivadas usando as variáveis de ambiente NO_COLOR ou APT_NO_COLOR, ou também configuradas pela opção de configuração e escopo APT::Color, veja apt.conf(5) para informação sobre isso.

VEJA TAMBÉM

apt.conf(5)

DIAGNÓSTICO

apt-config devolve zero em operação normal, 100 decimal em erro.

BUGS

página de bugs do APT[1]. Se deseja reportar um bug no APT, por favor veja /usr/share/doc/debian/bug-reporting.txt ou o comando reportbug(1).

TRADUÇÃO

A tradução Portuguesa foi feita por Américo Monteiro <a_monteiro@netcabo.pt> de 2009 a 2012. A tradução foi revista pela equipa de traduções portuguesas da Debian <traduz@debianpt.org>.

Note que este documento traduzido pode conter partes não traduzidas. Isto é feito propositadamente, para evitar perdas de conteúdo quando a tradução está atrasada relativamente ao conteúdo original.

AUTORES

Jason Gunthorpe

Equipa do APT

NOTAS

1.  página de bugs do APT
    https://bugs.debian.org/src:apt