Commande prs (SCCS)

Objectif

Affiche un fichier SCCS (Source Code Control System).

Syntaxe

prs [ -a] [ -d  String ] [ -r [ SID ] | [ -c Cutoff ] ] [ -e | -l ] File ...

Descriptif

La commande prs lit d'abord les fichiers spécifiés, puis écrit dans la sortie standard une partie ou la totalité d'un fichier SCCS (Source Code Control System). Si vous spécifiez un répertoire pour le paramètre Fichier , la commande prs exécute les actions demandées sur tous les fichiers SCCS (ceux avec le préfixe s. ). Si vous spécifiez un - (moins) pour le paramètre Fichier , la commande prs lit l'entrée standard et interprète chaque ligne comme le nom d'un fichier SCCS. La commande prs continue de lire l'entrée jusqu'à ce qu'elle atteigne un caractère de fin de fichier.

Mots clés de données

Les mots clés de données indiquent les parties d'un fichier SCCS à extraire et à écrire dans la sortie standard. Toutes les parties d'un fichier SCCS possèdent un mot clé de données associé. Il n'y a pas de limite au nombre de fois qu'un mot clé de données peut se trouver dans un fichier spécifié.

Les informations affichées par la commande prs sont constituées de texte fourni par l'utilisateur et de valeurs appropriées (extraites du fichier SCCS) substituées aux mots clés de données reconnus dans l'ordre dans lequel ils sont affichés dans le fichier spécifié . Le format d'une valeur de mot clé de données est simple, dans lequel la substitution de mot clé est directe, ou multiligne, dans laquelle la substitution est suivie d'un retour chariot. Le texte est composé de tous les caractères autres que les mots clés de données reconnus. Spécifiez un caractère de tabulation avec \t (barre oblique inversée, lettre t) et un retour chariot ou un caractère de nouvelle ligne avec \n (barre oblique inversée, lettre n). N'oubliez pas d'utiliser \t et \n avec une \ supplémentaire (barre oblique inversée) pour empêcher le shell d'interpréter le \ et de transmettre uniquement la lettre t ou n à la commande prs sous forme de texte.

Le tableau suivant répertorie les mots clés associés aux informations de la table delta du fichier SCCS. Tous les mots clés ont un format simple, sauf indication contraire.

Tableau 1. Mots clés de la table delta
Mot clé	Données présentées	Valeur
`:R:`	Numéro de version	nombre
`:L:`	Numéro de niveau	nombre
`:B:`	Numéro de branche	nombre
`:S:`	Numéro de séquence	nombre
`:I:`	Chaîne d'ID SCCS (SID)	:R ::L ::B ::S:
`:Dy:`	Delta de l'année créée	AA
`:Dm:`	Delta du mois créé	EM
`:Dd:`	Delta de jour créé	JJ
`:D:`	Date delta créée	AA/MM/JJ
`:Th:`	Delta de l'heure créée	HH
`:Tm:`	Delta de minute créé	EM
`:Ts:`	Le deuxième delta créé	SS (Status Store)
`:T:`	Delta de temps créé	HH / MM/SS
`:DT:`	Type delta	D ou R

Article	Descriptif	Valeur
`:P:`	Utilisateur ayant créé le delta	nom de connexion
`:DS:`	Numéro de séquence delta	nombre
`:DP:`	Numéro de séquence delta précédent	nombre
`:Dt:`	Informations delta	:DT ::I ::D ::T ::P ::DS: :DP:
`:Dn:`	Les numéros de séquence des deltas sont inclus	`:DS: . . .`
`:Dx:`	Numéros de séquence des deltas exclus	`:DS: . . .`
`:Dg:`	Numéros de séquence des deltas ignorés	`:DS: . . .`
`:DI:`	Numéros de séquence des deltas inclus, exclus et ignorés	`:Dn:/:Dx:/:Dg:`
`:Li:`	Lignes insérées par delta	nombre
`:Ld:`	Lignes supprimées par le delta	nombre
`:Lu:`	Lignes modifiées par delta	nombre
`:DL:`	Statistiques de ligne delta	`:Li:/:Ld:/:Lu:`
`:MR:` (format multiligne)	Numéros MR pour delta	texte
`:C:` (format multiligne	Commentaires pour le delta	texte

Le tableau suivant répertorie les mots clés associés aux indicateurs d'en-tête dans le fichier SCCS. Tous les mots clés ont un format simple, sauf indication contraire.

Tableau 2. Mots clés de l'indicateur d'en-tête
Mot clé	Données présentées	Valeur
`:Y:`	Type de module	texte
`:MF:`	Indicateur de validation MR défini	oui ou non
`:MP:`	Nom du programme de validation MR	texte
`:KF:`	Mot clé / indicateur d'erreur défini	oui ou non
`:BF:`	Indicateur de branche défini	oui ou non
`:J:`	Indicateur d'édition conjointe défini	oui ou non
`:LK:`	Rejets verrouillés	`:R: . . .`
`:Q:`	Mot clé défini par l'utilisateur	texte
`:M:`	Nom du module	texte
`:FB:`	Limite d'étage	`:R:`
`:CB:`	Limite de plafond	:R :
`:Ds:`	SID par défaut	`:I:`
`:ND:`	Indicateur de valeur de delta nul	oui ou non
`:FL:` (format multiligne)	Liste des indicateurs d'en-tête	texte

Le tableau suivant répertorie les mots clés associés à d'autres parties du fichier SCCS. Tous les mots clés ont un format simple, sauf indication contraire.

Tableau 3. Autres mots clés
Mot clé	Données présentées	Valeur
`:UN:` (format multiligne)	Noms d'utilisateur	texte
`:FD:` (format multiligne)	Texte descriptif	texte
`:BD:` (format multiligne)	Corps du texte	texte
`:GB:` (format multiligne)	Texte dans un fichier g	texte
`:W:`	Une chaîne de caractères	`:Z::M: \tab :I:`
`:A:`	Une chaîne de caractères	`:Z::Y::M::I::Z:`
`:Z:`	Un délimiteur de chaîne	`@(#)`
`:F:`	Nom de fichier SCCS	texte
`:PN:`	Nom du chemin d'accès au fichier SCCS	texte

Indicateurs

Chaque indicateur ou groupe d'indicateurs s'applique indépendamment à chaque fichier nommé.

Tableau 4. Indicateurs
Article	Descriptif
-a	Ecrit des informations pour les deltas spécifiés, qu'ils aient été supprimés ou non (voir la commande rmdel ). Si vous ne spécifiez pas l'indicateur -a , la commande prs fournit des informations uniquement pour les deltas spécifiés qui n'ont pas été supprimés.
-c `Limite`	Indique une date et une heure de césure pour les indicateurs -e et -l . Spécifiez la valeur `Valeur limite` sous la forme suivante: `YY[MM[DD[HH[MM[SS]]]]]` Tous les éléments omis ayant la valeur maximale par défaut, la spécification de `-c8402` est identique à la spécification de `-c840229235959`. Vous pouvez séparer les zones avec n'importe quel caractère non numérique. Par exemple, vous pouvez spécifier `-c84/2/20,9:22:25` , `-c"84/2/20 9:22:25"` ou `"-c84/2/20 9:22:25"`. L'indicateur -c ne peut pas être spécifié avec l'indicateur -r .
-d `Chaîne`	Indique les éléments de données à afficher. La chaîne est constituée de texte facultatif et de mots clés de données SCCS. La chaîne peut inclure des caractères MBCS (jeu de caractères multi-octets). Si la chaîne contient des espaces, vous devez placer la chaîne entre guillemets.
-e	Demande des informations pour tous les deltas créés avant et y compris le delta spécifié par l'indicateur -r .
-l	Demande des informations pour tous les deltas créés ultérieurement, y compris le delta spécifié par l'indicateur -r .
-r [`SID` ]	Indique la chaîne d'ID SCCS (SID) du delta pour lequel la commande prs extrait des informations. N'entrez pas d'espace entre l'indicateur -r et le paramètre SID facultatif. Si aucun SID n'est spécifié, la commande extrait les informations relatives au SID du delta le plus élevé. L'indicateur -r ne peut pas être spécifié avec l'indicateur -c .

Statut de sortie

Cette commande renvoie les valeurs de sortie suivantes :

Tableau 5. état de sortie
Article	Descriptif
0 %	L'opération a abouti.
>0	Une erreur s'est produite.

Exemples

Pour afficher des informations sur tous les deltas générés pour le nom de fichier SCCS s.test.c (y compris tous les deltas supprimés à l'aide de la commande rmdel ), entrez:
```
prs -a s.test.c
```
Pour afficher le nom de connexion de l'utilisateur, le nombre de lignes insérées par delta et le nombre de lignes supprimées par delta pour le SID 1.2 de s.test.c, entrez:
```
prs -r1.2 -d":P:\n:Li:\n:Ld:" s.test.c
```

Fichiers

Tableau 6. fichiers
Article	Descriptif
/usr/bin/prs	Contient la prs commande `.`