admin |
Administrer |
|---|---|
| Unix | Externe |
Syntaxe
| admin [-n] [-i[name]] [-rrel] [-t[name]] [-fflag[flag-val]] [-dflag[flag-val]] [-alogin] [-elogin] [-m[mrlist]] [-y[comment]] [-h] [-z] files |
Paramètres
| Nom | Description | ||
|---|---|---|---|
| -alogin | Ce paramètre permet d'indiquer un nom de connexion, ou un identificateur de groupe UNIX numérique, à ajouter à la liste des utilisateurs pouvant apporter des deltas (modifications) au fichier SCCS. Un identificateur de groupe équivaut à spécifier tous les noms de connexion communs à cet identificateur de groupe. Plusieurs lettres clefs peuvent être utilisées sur une seule ligne de commande admin. Autant avec la connexion, ou de l'identificateur de groupe numériques, que vous le souhaitez peuvent figurer simultanément sur la liste. Si la liste des utilisateurs est vide, n'importe qui peut ajouter des deltas. | ||
| -dflag | Ce paramètre permet de provoquer la suppression (suppression) du drapeau spécifié d'un fichier SCCS. La lettre clef -d ne peut être spécifiée que lors du traitement de fichiers SCCS existants. Plusieurs lettres clefs -d peuvent être fournies sur une seule commande d'administration. Voir la lettre-clef -f pour les noms de drapeaux autorisés. | ||
| Valeur | Description | ||
| llist | Cette valeur permet d'indiquer une liste des versions à "déverrouiller". Voir la lettre-clef -f pour une description du drapeau l et la syntaxe d'une liste. | ||
| -elogin | Ce paramètre permet d'indiquer un nom de connexion, ou un identificateur de groupe numérique, à effacer de la liste des utilisateurs autorisés à apporter des deltas (modifications) au fichier SCCS. Spécifier un identificateur de groupe équivaut à spécifier tous les noms de connexion communs à cet identificateur de groupe. Plusieurs lettres clefs électroniques peuvent être utilisées sur une seule ligne de commande admin. | ||
| -fflag | Ce paramètre permet d'indiquer un drapeau et, éventuellement, une valeur pour le drapeau, à placer dans le fichier SCCS. Plusieurs lettres clefs (peuvent être fournies sur une seule ligne de commande admin. Les drapeaux autorisés et leurs valeurs sont : | ||
| Valeur | Description | ||
| b | Cette valeur permet d'autoriser l'utilisation de la lettre-clef -b sur une commande get pour créer des deltas de branche. | ||
| cceil | Cette valeur permet d'indiquer la version la plus élevée (c'est-à-dire, "plafond"), un nombre inférieur ou égal à 9999, pouvant être récupéré par une commande get pour l'édition. La valeur par défaut pour un drapeau c non spécifié est 9999. | ||
| dSID | Cette valeur permet d'indiquer le numéro delta par défaut (SID) à utiliser par une commande get. | ||
| ffloor | Cette valeur permet d'indiquer la version la plus basse (c'est-à-dire "plancher"), un nombre supérieur à 0 mais inférieur à 9999, pouvant être récupéré par une commande get pour l'édition. La valeur par défaut pour un drapeau f non spécifié est 1. | ||
| i | Cette valeur permet d'indiquer que le message "No id keywords (ge6)" émis par get ou delta est traité comme une erreur fatale. En l'absence de ce drapeau, le message n'est qu'un avertissement. Le message est émis si aucun mot-clef d'identification SCCS (voir get) n'est trouvé dans le texte récupéré ou entreposé dans le fichier SCCS. | ||
| j | Cette valeur permet d'indiquer qu'il Autorise les commandes get simultanées pour l'édition sur le même SID d'un fichier SCCS. Cela permet plusieurs mises à jour simultanées de la même version du fichier SCCS. | ||
| llist | Cette valeur permet d'indiquer une liste des versions auxquelles les deltas ne peuvent plus être faits (get -e contre l'une de ces versions "verrouillées" échoue). La liste a la syntaxe suivante :
Le caractère a dans la liste équivaut à spécifier toutes les versions pour le fichier SCCS nommé. |
||
| mmod | Cette valeur permet d'indiquer le nom de module du fichier SCCS remplacé par toutes les occurrences du mot-clef %M% dans le texte du fichier SCCS récupéré par get. Si l'indicateur m n'est pas spécifié, la valeur attribuée est le nom du fichier SCCS précédé du «s.» supprimé. | ||
| n | Cette valeur permet de faire en sorte que delta crée un delta "null" dans chacune de ces versions (le cas échéant) ignorées lorsqu'un delta est créé dans une nouvelle version (par exemple, en créant delta 5.1 après delta 2.7, les versions 3 et 4 sont ignorées) . Ces deltas nuls servent de "points d'ancrage" afin que des deltas de branche puissent ensuite être créés à partir d'eux. L'absence de ce drapeau fait que les versions ignorées sont inexistantes dans le fichier SCCS, empêchant la création de deltas de branche à partir d'eux à l'avenir. | ||
| qtext | Cette valeur permet d'indiquer le texte définissable par l'utilisateur remplacé par toutes les occurrences du mot-clef %Q% dans le texte du fichier SCCS récupéré par get. | ||
| ttype | Cette valeur permet d'indiquer le type de module dans le fichier SCCS remplacé par toutes les occurrences du mot-clef %Y% dans le texte du fichier SCCS récupéré par get. | ||
| v[pgm] | Cette valeur permet de faire en sorte que delta demande des numéros de demande de modification (MR) comme raison de la création d'un delta. La valeur facultative spécifie le nom d'un programme de vérification de la validité des numéros MR (voir delta). (Si ce drapeau est défini lors de la création d'un fichier SCCS, la lettre-clef m doit également être utilisée même si sa valeur est null). | ||
| -h | Ce paramètre permet de demander à l'administrateur de vérifier la structure du fichier SCCS et de comparer une somme de contrôle nouvellement calculée (la somme de tous les caractères du fichier sees sauf ceux de la première ligne) avec la somme de contrôle étant entreposé dans la première ligne du fichier SCCS. Des diagnostics d'erreur appropriés sont générés. Cette lettre-clef empêche l'écriture sur le fichier, de sorte qu'elle annule l'effet de toute autre lettre-clef fournie, et n'a donc de sens que lors du traitement de fichiers existants. | ||
| -i[name] | Ce paramètre permet d'indiquer le nom d'un fichier à partir duquel le texte d'un nouveau fichier SCCS doit être extrait. Le texte constitue le premier delta du fichier. Si le keyletter i est utilisée, mais que le nom de fichier est omis, le texte est obtenu en lisant l'entrée standard jusqu'à ce qu'une fin de fichier soit rencontrée. Si cette keyletter est omise, le fichier SCCS est créé vide. Un seul fichier SCCS peut être créé par une commande d'administration sur laquelle la keyletter i est fournie. L'utilisation d'un seul administrateur pour créer deux fichiers SCCS ou plus nécessite qu'ils soient créés vides (pas de -i keyletter). Notez que -i keyletter implique -n keyletter. | ||
| -m[mrlist] | Ce paramètre permet d'indiquer la liste des numéros de demande de modification (MR) est insérée dans le fichier SCCS comme motif de création du delta initial d'une manière identique à delta. Le drapeau v doit être défini et les numéros MR sont validés si le drapeau v a une valeur (le nom d'un programme de validation des numéros MR). Les diagnostics se produiront si le drapeau v n'est pas défini ou si la validation MR échoue. | ||
| -n | Ce paramètre permet d'indiquer qu'un nouveau fichier SCCS doit être créé. | ||
| -rrel | Ce paramètre permet d'indiquer la version dans laquelle le delta initial est inséré. Cette lettre-clef ne peut être utilisée que si la lettre-clef -i est également utilisée. Si la lettre-clef -r n'est pas utilisée, le delta initial est inséré dans la version 1. Le niveau du delta initial est toujours 1 (par défaut, les deltas initiaux sont nommés 1.1). | ||
| -t[name] | Ce paramètre permet d'indiquer le nom d'un fichier à partir duquel le texte descriptif du fichier SCCS doit être extrait. Si la lettre clef -t est utilisée et que l'administrateur crée un nouveau fichier SCCS (les lettres clefs -n et/ou -i sont également utilisées), le nom du fichier texte descriptif doit également être fourni. Dans le cas de fichiers SCCS existants : (1) une lettre-clef -t sans nom de fichier entraîne la suppression du texte descriptif (le cas échéant) actuellement dans le fichier SCCS, et (2) une lettre-clef -t avec un nom de fichier entraîne la suppression du texte (le cas échéant) si n'importe quel fichier nommé à remplacer le texte descriptif (le cas échéant) actuellement dans le fichier SCCS. | ||
| -y[comment] | Ce paramètre permet d'indiquer le texte du commentaire est inséré dans le fichier SCCS en tant que commentaire pour le delta initial d'une manière identique à celle du delta. L'omission de la lettre-clef -y entraîne l'insertion d'une ligne de commentaire par défaut dans le formulaire :
La lettre-clef -y n'est valide que si les lettres-clef -i et/ou -o sont spécifiées (c'est-à-dire qu'un nouveau fichier SCCS est en cours de création). |
||
| -z | Ce paramètre permet d'indiquer la somme de contrôle du fichier SCCS est recalculée et entreposée dans la première ligne du fichier SCCS. Notez que l'utilisation de cette lettre-clef sur un fichier vraiment corrompu peut empêcher la détection future de la corruption. | ||
Description
Cette commande permet de créer et d'administrer des fichiers SCCS.
Remarques
- La commande admin est utilisé pour créer de nouveaux fichiers SCCS et modifier les paramètres des fichiers existants. Les paramètres de admin, pouvant apparaître dans n'importe quel ordre, se composent de paramètre de keyletter, commençant par -, et de fichiers nommés (notez que les noms de fichiers SCCS doivent commencer par les caractères s.). Si un fichier nommé n'existe pas, il est créé et ses paramètres sont initialisés en fonction des paramètres du keyletter spécifiés. Les paramètres non initialisés par un paramètre keyletter se voient attribuer une valeur par défaut. S'il existe un fichier nommé, les paramètres correspondant aux paramètres keyletter spécifiés sont modifiés et les autres paramètres restent tels quels.
- Si un répertoire est nommé, l'administrateur se comporte comme si chaque fichier du répertoire était spécifié comme fichier nommé, sauf que les fichiers non SCCS (la dernière composante du nom de chemin ne commence pas par s.) Et les fichiers illisibles sont ignorés en silence. Si un nom de - est spécifié, l'entrée standard est lue; chaque ligne de l'entrée standard est considérée comme le nom d'un fichier SCCS à traiter. Encore une fois, les fichiers non SCCS et les fichiers illisibles sont ignorés en silence.
- Les paramètres keyletter sont les suivants. Chacun est expliqué comme si un seul fichier spécifié devait être traité car les effets des paramètres s'appliquent indépendamment à chaque fichier spécifié.
- La dernière composante de tous les noms de fichier SCCS doit être de la forme s.file-name. Les nouveaux fichiers SCCS reçoivent le mode 444 (voir chmod). L'autorisation d'écriture dans le répertoire pertinent est, bien sûr, nécessaire pour créer un fichier. Toutes les écritures effectuées par l'administrateur se font dans un fichier x temporaire, appelé x.file-name, (voir get), créé avec le mode 444 si la commande admin crée un nouveau fichier SCCS, ou avec le même mode que le voit le fichier s'il existe. Après une exécution réussie de admin, le fichier SCCS est supprimé (s'il existe) et le fichier x est renommé avec le nom du fichier SCCS. Cela garantit que les modifications sont apportées au fichier SCCS uniquement si aucune erreur ne s'est produite.
- Il est recommandé que les répertoires contenant des fichiers soient en mode 755 et que les fichiers eux-mêmes soient en mode 444. Le mode des répertoires permet uniquement au propriétaire de modifier les fichiers contenus dans les répertoires. Le mode des fichiers SCCS empêche toute modification sauf par les commandes SCCS.
- S'il s'avère nécessaire de corriger un fichier SCCS pour une raison quelconque, le mode peut être changé en 644 par le propriétaire permettant l'utilisation de ed. Le fichier édité doit toujours être traité par un admin -h pour vérifier la corruption suivi d'un admin -z pour générer une somme de contrôle appropriée. Un autre admin -h est recommandé pour s'assurer que le fichier SCCS est valide.
- La commande admin utilise également un fichier de verrouillage transitoire (appelé z.file-name), étant utilisé pour empêcher les mises à jour simultanées du fichier SCCS par différents utilisateurs.
Voir également
Système d'exploitation - Unix - Références de commandes et de programmes - delta
Système d'exploitation - Unix - Références de commandes et de programmes - ed
Système d'exploitation - Unix - Références de commandes et de programmes - get
Système d'exploitation - Unix - Références de commandes et de programmes - help
Système d'exploitation - Unix - Références de commandes et de programmes - prs
Système d'exploitation - Unix - Références de commandes et de programmes - what
Système d'exploitation - Unix - Références de commandes et de programmes - sccsfile
Dernière mise à jour : Mercredi, le 3 août 2016