Options de la commande db

Introduction

Comme nous l'avons vu dans le chapitre consacré aux templates, à chaque fois que l'on veut modifier manuellement la configuration de base de SME, il faut passer par la commande db (ou pour être précis /sbin/e-smith/db).

Pour mémoire, je vous rappelle que les fichiers contenant la configuration de votre serveur se trouvent dans /home/e-smith/db/ et que chaque fichier est constitué de lignes définissant chacune un élément propre au système.

La structure de chaque ligne est toujours la même :

clé=type|propriété1|valeur1|propriété2|valeur2|etc.

Le nom de la clé est unique dans le fichier ; notez que ceci peut être une contrainte dans certains cas car cela interdit, par exemple, d'avoir un utilisateur, un pseudonyme, un groupe ou une i-bay ayant le même nom.
Le type dépend de l'élément. Dans certains cas particuliers, il ne s'agit pas du type de l'élément, mais de sa valeur ; il n'y a alors pas de propriétés associées.
Suivent éventuellement ensuite un nombre indéterminé de propriétés et de valeurs associées à la clé.

db dbfile keys

Permet d'obtenir la liste de toutes les clés définies dans le fichier spécifié.
Exemple :

db domains keys
grand-pa.dyndns.org
grand-pa.myphotos.cc
smeserver.fr

db dbfile print [key]

Affiche l'ensemble des clés du fichier spécifié ou uniquement la ligne de la clé spécifiée.
Exemple :

db accounts print admin
admin=system|FirstName|Local|LastName|Administrator|Lockable|no|PasswordSet|yes|Removable|no|Shell|/sbin/e-smith/console|VPNClientAccess|no

db dbfile show [key]

Affiche l'ensemble des clés du fichier spécifié ou uniquement la clé spécifiée avec une mise en forme particulière où chaque propriété est affichée sur une ligne distincte.
Exemple :

db accounts show admin
admin=system
    FirstName=Local
    LastName=Administrator
    Lockable=no
    PasswordSet=yes
    Removable=no
    Shell=/sbin/e-smith/console
    VPNClientAccess=no

db dbfile get key

Permet d'obtenir toutes les propriétés de la clé spécifiée.
Exemple :

db accounts get admin
system|FirstName|Local|LastName|Administrator|Lockable|no|PasswordSet|yes|Removable|no|Shell|/sbin/e-smith/console|VPNClientAccess|no

db dbfile set key type [prop1 val1] [prop2 val2] ...

Permet de (re)définir une clé avec son type (ou sa valeur associée) et ses éventuelles propriétés.

db accounts set webmaster pseudonym Account grand-pa

Attention : si la clé existe déjà, elle est entièrement écrasée (pas de mise à jour) !

db dbfile setdefault key type [prop1 val1] [prop2 val2] ...

Fonction inconnue, touche à ton c*l.

db accounts setdefault webmaster pseudonym Account grand-pa

db dbfile delete key

Supprime la clé spécifiée.

db accounts delete webmaster

db dbfile printtype [key]

Affiche le nom de la clé spécifiée et son type (ou sa valeur associée).

db accounts printtype webmaster
webmaster=pseudonym

db dbfile gettype key

Renvoie le type de la clé spécifiée.

db accounts gettype webmaster
pseudonym

db dbfile settype key type

Permet de redéfinir le type de la clé spécifiée (la clé doit déjà exister)

db accounts settype webmaster user

db dbfile printprop key [prop1] [prop2] [prop3] ...

Renvoie les propriétés indiquées et leurs valeurs pour la clé spécifiée.

db accounts printprop admin FirstName LastName
FirstName=Local
LastName=Administrator

db dbfile getprop key prop

Renvoie la valeur de la propriété indiquée pour la clé spécifié.

db accounts getprop webmaster Account
grand-pa

db dbfile setprop key prop1 val1 [prop2 val2] [prop3 val3] ...

Permet de (re)définir les valeurs des propriétés définies pour la clé spécifiée.

db accounts setprop webmaster Account admin Visible internal

db dbfile delprop key prop1 [prop2] [prop3] ...

Permet de supprimer les propriétés définies de la clé spécifiée.

db accounts delprop webmaster Visible