gpgconf - En ligne dans le Cloud

PROGRAMME:

Nom

gpgconf - Modifier les répertoires personnels .gnupg

SYNOPSIS

gpgconf [Options] --list-composants
gpgconf [Options] --list-options composant
gpgconf [Options] --changer-options composant

DESCRIPTION

Le manuel de formation gpgconf est un utilitaire pour interroger et modifier automatiquement et raisonnablement en toute sécurité
fichiers de configuration dans le '.gnupg' répertoire personnel. Il est conçu pour ne pas être invoqué
manuellement par l'utilisateur, mais automatiquement par les interfaces utilisateur graphiques (GUI). ([Veuillez noter
qu'actuellement aucun verrouillage n'est effectué, l'accès concurrent doit donc être évité. Il y a quelques
précautions pour éviter la corruption avec une utilisation simultanée, mais les résultats peuvent être incohérents et
certains changements peuvent être perdus. La conception sans état rend difficile de fournir plus
garanties.])

gpgconf donne accès à la configuration d'un ou plusieurs composants du GnuPG
système. Ces composants correspondent plus ou moins aux programmes qui existent dans le GnuPG
framework, comme GnuPG, GPGSM, DirMngr, etc. Mais ce n'est pas un strict one-to-one
relation amoureuse. Toutes les options de configuration ne sont pas disponibles via gpgconf. gpgconf
fournit une méthode générique et abstraite pour accéder aux options de configuration les plus importantes
qui peut être contrôlé via un tel mécanisme.

gpgconf peut être utilisé pour rassembler et modifier les options disponibles dans chaque composant, et peut
fournissent également leurs valeurs par défaut. gpgconf donnera des informations de type détaillées qui peuvent
être utilisé pour restreindre la saisie de l'utilisateur sans tenter de valider les modifications.

gpgconf fournit le backend d'un éditeur de configuration. L'éditeur de configuration
généralement un programme d'interface utilisateur graphique, qui permet d'afficher les options en cours,
leurs valeurs par défaut et permet à l'utilisateur de modifier les options. Ces changements
peut alors être activé avec gpgconf de nouveau. Un tel programme qui utilise gpgconf de cette façon
sera appelé GUI tout au long de cette section.

COMMANDES

Une des commandes suivantes doit être donnée :

--list-composants
Lister tous les composants. Il s'agit de la commande par défaut utilisée si aucune n'est spécifiée.

--check-programmes
Répertoriez tous les programmes backend disponibles et testez s'ils sont exécutables.

--list-options composant
Lister toutes les options du composant composant.

--changer-options composant
Modifier les options du composant composant.

--check-options composant
Vérifiez les options du composant composant.

--apply-defaults
Mettre à jour tous les fichiers de configuration avec les valeurs extraites du fichier de configuration global
(d'habitude '/etc/gnupg/gpgconf.conf»).

--list-répertoires
Répertorie les répertoires utilisés par gpgconf. Un répertoire est répertorié par ligne, et chaque
La ligne se compose d'une liste séparée par des deux-points où le premier champ nomme le répertoire
taper (par exemple rép.sysconf) et le deuxième champ contient le pourcentage échappé
annuaire. Bien qu'il ne s'agisse pas de répertoires, les noms de fichiers socket utilisés par gpg-
agent et directeur sont également imprimés. Notez que les noms de fichiers de socket et le
répertoire les lignes sont les noms par défaut et ils peuvent être remplacés par la ligne de commande
interrupteurs.

--list-config [nom de fichier]
Répertoriez le fichier de configuration globale dans un format séparé par deux points. Si nom de fichier is
donné, vérifiez ce fichier à la place.

--check-config [nom de fichier]
Exécutez une vérification de syntaxe sur le fichier de configuration globale. Si nom de fichier est donné, vérifiez
ce fichier à la place.

--recharger [composant]
Recharger tout ou le composant donné. C'est fondamentalement la même chose que d'envoyer un SIGHUP
au composant. Les composants qui ne prennent pas en charge le rechargement sont ignorés.

--lancement [composant]
Si la composant n'est pas déjà en cours d'exécution, démarrez-le. composant doit être un démon.
Ceci n'est généralement pas nécessaire car le système démarre ces démons selon les besoins.
Cependant, les logiciels externes utilisant directement agent-gpg or directeur peut utiliser ce
commande pour s'assurer qu'ils sont démarrés.

--tuer [composant]
Tuez le composant donné. Les composants qui prennent en charge la destruction sont gpg-agent et
scdaemon. Les composants qui ne prennent pas en charge le rechargement sont ignorés. A noter qu'à partir du
maintenant recharger et tuer ont le même effet pour scdaemon.

OPTIONS

Les options suivantes peuvent être utilisées :

-o filet

--output filet
Écrire la sortie dans filet. La valeur par défaut est d'écrire sur stdout.

-v

--verbeux
Affiche des informations supplémentaires pendant l'exécution. Plus précisément, cela étend numérique
valeurs de champ par des descriptions lisibles par l'homme.

-q

--silencieux
Essayez d'être aussi silencieux que possible.

-n

- à sec
Ne changez rien en fait. Ceci n'est actuellement mis en œuvre que pour --monnaie-
Options et peut être utilisé à des fins de test.

-r

--Durée
Utilisé uniquement avec --changer-options. Si l'une des options modifiées peut être
modifié dans un processus de démon en cours d'exécution, signalez au démon en cours d'exécution de lui demander d'analyser
son fichier de configuration après modification.

Cela signifie que les modifications prendront effet au moment de l'exécution, dans la mesure où cela est
possible. Dans le cas contraire, elles prendront effet au prochain démarrage de la
programmes principaux.

UTILISATION

La commande --list-composants listera tous les composants qui peuvent être configurés avec
gpgconf. Habituellement, un composant correspondra à un programme lié à GnuPG et contiendra
les options de ce fichier de configuration de programmes qui peuvent être modifiés en utilisant gpgconf.
Toutefois, ce n'est pas necessairement le cas. Un composant peut également être un groupe de
options de plusieurs programmes, ou contiennent des options entièrement virtuelles qui ont un
effet plutôt que de changer exactement une option dans un fichier de configuration.

Un composant est un ensemble d'options de configuration qui vont sémantiquement ensemble.
De plus, plusieurs modifications d'un composant peuvent être effectuées de manière atomique avec un seul
opération. L'interface graphique pourrait par exemple fournir un menu avec une entrée pour chaque composant, ou
une fenêtre avec une feuille de tabulation par composant.

L'argument de commande --list-composants répertorie tous les composants disponibles, un par ligne. Les
le format de chaque ligne est :

prénom:la description:nompgm:

prénom Ce champ contient une étiquette de nom du composant. La balise name est utilisée pour spécifier
le composant dans toutes les communications avec gpgconf. L'étiquette de nom doit être utilisée
mot pour mot. Il n'est donc dans aucun format échappé.

la description
Le manuel de formation un magnifique dans ce champ contient une description lisible du composant.
Il peut être affiché à l'utilisateur de l'interface graphique à des fins d'information. Il est
pourcentage échappé et localisée.

nompgm
Le manuel de formation un magnifique dans ce champ contient le nom absolu du fichier du programme. Ça peut
être utilisé pour invoquer sans ambiguïté ce programme. Il est pourcentage échappé.

Exemple :
$ gpgconf --list-components
gpg:GPG pour OpenPGP :/usr/local/bin/gpg2 :
gpg-agent:GPG Agent :/usr/local/bin/gpg-agent :
scdaemon:Démon de carte à puce :/usr/local/bin/scdaemon :
gpgsm:GPG pour S/MIME :/usr/local/bin/gpgsm :
dirmngr:Directory Manager:/usr/local/bin/dirmngr :

Vérification tout proche.

La commande --check-programmes est similaire à --list-composants mais fonctionne sur les programmes backend
et non sur les composants. Il exécute chaque programme pour tester s'il est installé et exécutable.
Cela inclut également une vérification de la syntaxe de toutes les options du fichier de configuration du programme.

L'argument de commande --check-programmes répertorie tous les programmes disponibles, un par ligne. Les
le format de chaque ligne est :

prénom:la description:nompgm:profiter:bien:fichiercfg:en ligne:erreur:

prénom Ce champ contient une étiquette de nom du programme qui est identique au nom du
composant. L'étiquette de nom doit être utilisée mot pour mot. Il n'est donc en aucun cas échappé
format. Ce champ peut être vide pour indiquer une suite de descriptions d'erreurs
pour le nom de famille. Les champs description et pgmname sont alors également vides.

la description
Le manuel de formation un magnifique dans ce champ contient une description lisible du composant.
Il peut être affiché à l'utilisateur de l'interface graphique à des fins d'information. Il est
pourcentage échappé et localisée.

nompgm
Le manuel de formation un magnifique dans ce champ contient le nom absolu du fichier du programme. Ça peut
être utilisé pour invoquer sans ambiguïté ce programme. Il est pourcentage échappé.

profiter Le manuel de formation booléen Plus-value dans ce champ indique si le programme est installé et
exécutable.

bien Le manuel de formation booléen Plus-value dans ce champ indique si le fichier de configuration du programme est
syntaxiquement correct.

fichiercfg
Si une erreur s'est produite dans le fichier de configuration (comme indiqué par une valeur fausse dans
le champ bien), ce champ porte le nom du fichier de configuration défaillant. Il est
pourcentage échappé.

en ligne Si une erreur s'est produite dans le fichier de configuration, ce champ a le numéro de ligne de
l'instruction défaillante dans le fichier de configuration. C'est un non signé nombre.

erreur Si une erreur s'est produite dans le fichier de configuration, ce champ a le texte d'erreur de
l'instruction défaillante dans le fichier de configuration. Il est pourcentage échappé et
localisée.

Dans l'exemple suivant, le directeur n'est pas exécutable et le fichier de configuration de
scdaemon n'est pas d'accord.

$ gpgconf --check-programmes
gpg:GPG pour OpenPGP :/usr/local/bin/gpg2:1:1 :
gpg-agent:GPG Agent :/usr/local/bin/gpg-agent:1:1 :
scdaemon:Démon de carte à puce :/usr/local/bin/scdaemon:1:0 :
gpgsm:GPG pour S/MIME :/usr/local/bin/gpgsm:1:1 :
dirmngr:Directory Manager:/usr/local/bin/dirmngr:0:0 :

Le fichier de configuration des commandes de la même manière que --check-programmes, mais seulement pour le
composant composant.

inscription Options

Chaque composant contient une ou plusieurs options. Les options peuvent être regroupées en groupes d'options
pour permettre à l'interface graphique de donner des indications visuelles à l'utilisateur sur les options liées.

L'argument de commande répertorie toutes les options (et les groupes auxquels elles appartiennent) dans le composant
composant, un par ligne. composant doit être la chaîne dans le champ prénom à la sortie de
le --list-composants commander.

Il y a une ligne pour chaque option et chaque groupe. Viennent d'abord toutes les options qui ne sont pas dans
n'importe quel groupe. Vient ensuite une ligne décrivant un groupe. Viennent ensuite toutes les options qui appartiennent à
chaque groupe. Vient ensuite le groupe suivant et ainsi de suite. Il n'y a pas besoin de groupe
(et dans ce cas la sortie s'arrêtera après la dernière option non groupée).

Le format de chaque ligne est :

prénom:drapeaux:niveau:la description:type:type alt:nom_argument:défaut:argdef:Plus-value

prénom Ce champ contient une étiquette de nom pour le groupe ou l'option. L'étiquette de nom est utilisée pour
spécifier le groupe ou l'option dans toutes les communications avec gpgconf. L'étiquette de nom est de
être utilisés mot pour mot. Il n'est donc dans aucun format échappé.

drapeaux Le champ flags contient un non signé nombre. Sa valeur est la combinaison OR-wise
des valeurs d'indicateur suivantes :

groupe (1)
Si ce drapeau est défini, il s'agit d'une ligne décrivant un groupe et non une option.

Les valeurs d'indicateur suivantes ne sont définies que pour les options (c'est-à-dire si le groupe le drapeau n'est pas
utilisé).

facultatif arg (2)
Si cet indicateur est défini, l'argument est facultatif. Ce n'est jamais réglé pour type 0
(aucune) option.

liste (4)
Si ce drapeau est défini, l'option peut être donnée plusieurs fois.

d'exécution (8)
Si cet indicateur est défini, l'option peut être modifiée au moment de l'exécution.

défaut (16)
Si cet indicateur est défini, une valeur par défaut est disponible.

défaut desc (32)
Si cet indicateur est défini, une valeur par défaut (d'exécution) est disponible. Ceci et le défaut
flag sont mutuellement exclusifs.

aucune arg desc (64)
Si cet indicateur est défini et que le facultatif arg est défini, alors l'option a un
signification particulière si aucun argument n'est donné.

aucune Change (128)
Si cet indicateur est défini, gpgconf ignore les demandes de modification de la valeur. IHM graphique
les frontends doivent griser cette option. Notez que les changements manuels du
les fichiers de configuration sont toujours possibles.

niveau Ce champ est défini pour les options et pour les groupes. Il contient un non signé nombre
qui spécifie le niveau d'expert sous lequel ce groupe ou cette option devrait être
affiché. Les niveaux experts suivants sont définis pour les options (ils ont
sens analogue pour les groupes):

Essentiel (0)
Cette option doit toujours être offerte à l'utilisateur.

Avancée (1)
Cette option peut être proposée aux utilisateurs avancés.

expert (2)
Cette option ne doit être proposée qu'aux utilisateurs experts.

invisible (3)
Cette option ne devrait normalement jamais être affichée, même pas pour les utilisateurs experts.

interne (4)
Cette option est à usage interne uniquement. Ignorez-le.

Le niveau d'un groupe sera toujours le niveau le plus bas de toutes les options qu'il contient.

la description
Ce champ est défini pour les options et les groupes. Les un magnifique dans ce champ contient un
description lisible par l'homme de l'option ou du groupe. Il peut être affiché à l'utilisateur
de l'interface graphique à des fins d'information. Il est pourcentage échappé et localisée.

type Ce champ n'est défini que pour les options. Il contient un non signé nombre qui
spécifie le type de l'argument de l'option, le cas échéant. Les types suivants sont
défini :

Types de base :

aucun (0)
Aucun argument autorisé.

un magnifique (1)
An non formaté un magnifique.

int32 (2)
A signé nombre.

uint32 (3)
An non signé nombre.

Types complexes :

chemin d'accès (32)
A un magnifique qui décrit le chemin d'accès d'un fichier. Le fichier ne
nécessairement besoin d'exister.

ldap serveur (33)
A un magnifique qui décrit un serveur LDAP au format :

nom d'hôte:port:Nom d'utilisateur: :base_dn

clé empreinte digitale (34)
A un magnifique avec une empreinte digitale à 40 chiffres spécifiant un certificat.

pub clé (35)
A un magnifique qui décrit un certificat par ID utilisateur, ID de clé ou empreinte digitale.

s. clé (36)
A un magnifique qui décrit un certificat avec une clé par ID utilisateur, ID de clé ou
empreinte digitale.

alias liste (37)
A un magnifique qui décrit une liste d'alias, comme celle utilisée avec le groupe de gpg
option. La liste se compose d'une clé, d'un signe égal et d'un espace séparé
valeurs.

D'autres types seront ajoutés à l'avenir. S'il vous plaît voir le type alt champ pour obtenir des informations sur
comment faire face aux types inconnus.

type alt
Ce champ est identique à type, sauf que seuls les types 0 à 31 sont autorisés.
L'interface graphique est censée présenter à l'utilisateur l'option dans le format spécifié par type.
Mais si le type d'argument type n'est pas pris en charge par l'interface graphique, il peut toujours afficher le
option dans le type de base plus générique type alt. L'interface graphique doit prendre en charge tous les
types de base définis pour pouvoir afficher toutes les options. Des types plus basiques peuvent être
ajouté dans les versions futures. Si l'interface graphique rencontre un type de base qu'elle ne prend pas en charge,
il devrait signaler une erreur et annuler l'opération.

nom_argument
Ce champ n'est défini que pour les options avec un type d'argument type ce n'est pas 0.
Dans ce cas, il peut contenir un pourcentage échappé et localisé un magnifique cela donne un
nom abrégé de l'argument. Le champ peut également être vide, auquel cas un
le nom abrégé n'est pas connu.

défaut
Ce champ est défini uniquement pour les options pour lesquelles le défaut or défaut desc drapeau
est réglé. Si la défaut flag est positionné, son format est celui d'un option argument (voir:
[Conventions de format], pour plus de détails). Si la valeur par défaut est vide, alors pas de valeur par défaut
est connu. Sinon, la valeur spécifie la valeur par défaut pour cette option. Si
le défaut desc est défini, le champ est soit vide, soit contient une description
de l'effet si l'option n'est pas donnée.

argdef Ce champ est défini uniquement pour les options pour lesquelles le facultatif arg le drapeau est défini. Si
le aucune arg desc flag n'est pas défini, son format est celui d'un option argument (voir:
[Conventions de format], pour plus de détails). Si la valeur par défaut est vide, alors pas de valeur par défaut
est connu. Sinon, la valeur spécifie l'argument par défaut pour cette option. Si
le aucune arg desc est défini, le champ est vide ou contient une description de
l'effet de cette option si aucun argument n'est donné.

Plus-value Ce champ est défini uniquement pour les options. Son format est celui d'un option argument.
S'il est vide, alors l'option n'est pas explicitement définie dans la configuration actuelle,
et la valeur par défaut s'applique (le cas échéant). Sinon, il contient la valeur actuelle du
option. Notez que ce champ est également significatif si l'option elle-même ne prend pas
un argument réel (dans ce cas, il contient le nombre d'apparitions de l'option).

Changer Options

La commande pour changer les options du composant composant aux valeurs spécifiées.
composant doit être la chaîne dans le champ prénom à la sortie du --list-composants
commander. Vous devez fournir les options qui seront modifiées dans le format suivant sur
entrée standard :

prénom:drapeaux:nouvelle-valeur

prénom Il s'agit du nom de l'option à modifier. prénom doit être la chaîne dans le champ
prénom à la sortie du --list-options commander.

drapeaux Le champ flags contient un non signé nombre. Sa valeur est la combinaison OR-wise
des valeurs d'indicateur suivantes :

défaut (16)
Si cet indicateur est défini, l'option est supprimée et la valeur par défaut est utilisée
à la place (le cas échéant).

nouvelle-valeur
La nouvelle valeur de l'option. Ce champ n'est défini que si le défaut le drapeau est
pas encore défini. Le format est celui d'un option argument. S'il est vide (ou le champ
est omis), l'argument par défaut est utilisé (autorisé uniquement si l'argument est facultatif
pour cette option). Sinon, l'option sera définie sur la valeur spécifiée.

La sortie de la commande est la même que celle de --check-options pour le modifié
fichier de configuration.

Exemples :

Pour définir l'option de force, qui est de type basique aucun (0):

$ echo 'force:0:1' | gpgconf --change-options dirmngr

Pour supprimer l'option forcer :

$ echo 'force:16:' | gpgconf --change-options dirmngr

Le manuel de formation --Durée L'option peut influencer le moment où les modifications prennent effet.

inscription de défis Options

Parfois, il est utile pour les applications de consulter le fichier d'options globales 'gpgconf.conf".
Le format de liste séparé par deux points est orienté enregistrement et utilise le premier champ pour identifier
le type d'enregistrement :

k Ceci décrit un enregistrement de clé pour démarrer la définition d'un nouvel ensemble de règles pour un
utilisateur/groupe. Le format d'un enregistrement de clé est :

k:utilisateur:groupe:

utilisateur Il s'agit du champ utilisateur de la clé. C'est pour cent échappé. Voir le
définition du format gpgconf.conf pour plus de détails.

groupe Il s'agit du champ de groupe de la clé. C'est pour cent échappé.

r Ceci décrit un enregistrement de règle. Tous les enregistrements de règles jusqu'à l'enregistrement de clé suivant constituent un
ensemble de règles pour cette clé. Le format d'un enregistrement de règle est :

r :::composant:option:drapeaux:Plus-value:

composant
C'est la partie constitutive d'une règle. C'est une chaîne simple.

option Il s'agit de la partie optionnelle d'une règle. C'est une chaîne simple.

drapeau C'est la partie drapeaux d'une règle. Il peut n'y avoir qu'un seul drapeau par règle, mais
en utilisant le même composant et la même option, plusieurs drapeaux peuvent être assignés à un
option. C'est une chaîne simple.

Plus-value Il s'agit de la valeur facultative de l'option. C'est une chaîne de pourcentage échappée
avec un guillemet simple pour indiquer une chaîne. Le guillemet est
uniquement requis pour faire la distinction entre aucune valeur spécifiée et une chaîne vide.

Les types d'enregistrement inconnus doivent être ignorés. Notez qu'il n'y a intentionnellement aucune fonctionnalité à
modifier le fichier d'options global via gpgconf.

Utiliser gpgconf en ligne à l'aide des services onworks.net