Mandato de administración (SCCS)

Finalidad

Crea y controla archivos SCCS (Código de código fuente).

Sintaxis

Descripción

El comando ' admin ' crea nuevos archivos del Sistema de Control de Código Fuente (SCCS) o cambia los parámetros especificados en los archivos SCCS existentes.

El comando ' admin ' puede cambiar los parámetros que controlan cómo el comando ' get ' construye los archivos que puedes editar. Los parámetros también pueden establecer condiciones sobre quién puede acceder al archivo y qué versiones de los archivos se pueden editar.

Si el archivo especificado por el parámetro Archivo existe, el mandato admin modifica el archivo tal como lo especifican los distintivos. Si el archivo no existe y se indica " -i " o " -n, el comando " admin " crea un nuevo archivo y proporciona valores por defecto para los indicadores no especificados.

Si especifica un nombre de directorio para el parámetro Archivo , el mandato admin realiza las acciones solicitadas en todos los archivos SCCS de ese directorio. Todos los archivos SCCS contienen el prefijo " s. " antes del nombre del archivo. Si utiliza ' - (signo menos) para el parámetro Archivo, el comando ' admin ' lee la entrada estándar e interpreta cada línea como el nombre de un archivo SCCS. Un carácter de fin de archivo finaliza la entrada.

Debe tener permiso de escritura en el directorio para crear un archivo. Todos los nombres de archivo SCCS deben tener la forma ' s.Nombre. Los nuevos archivos SCCS se crean con permiso de sólo lectura. El comando ' admin ' escribe en un archivo x temporal, al que llama ' x.Nombre. Si existe, el archivo x tiene los mismos permisos que el archivo SCCS original. El archivo x es de sólo lectura si el comando ' admin ' debe crear un nuevo archivo. Una vez completado con éxito el comando ' admin ', el archivo x se mueve al nombre del archivo SCCS. De este modo se garantiza que sólo se realicen cambios en el archivo SCCS si el comando ' admin ' no detecta ningún error durante su ejecución.

Los directorios que contienen archivos SCCS deben crearse con el código de permiso 755 (permisos de lectura, escritura y ejecución para el propietario, permisos de lectura y ejecución para los miembros del grupo y otros). Los propios archivos SCCS deben crearse como archivos de sólo lectura (444). Con estos permisos, sólo el propietario puede utilizar mandatos no SCCS para modificar archivos SCCS. Si un grupo puede acceder y modificar los archivos SCCS, los directorios deben incluir el permiso de escritura de grupo.

El comando ' admin ' también utiliza un archivo de bloqueo temporal (llamado ' z.Name) para evitar actualizaciones simultáneas del archivo SCCS por parte de distintos usuarios.

Puede especificar distintivos y nombres de archivo de entrada en cualquier orden. Todos los distintivos se aplican a todos los archivos. No ponga un espacio entre una bandera y una variable opcional (variable que va entre corchetes). Los indicadores de cabecera pueden activarse con el indicador " -f " y desactivarse con el indicador " -d ". Los indicadores de cabecera controlan el formato del archivo g que se crea con el comando ' get.

Distintivos

date and time created YY/MM/DD HH:MM:SS by Login

Banderas de cabecera

La siguiente lista contiene los indicadores de cabecera que pueden activarse con el indicador " -f " y desactivarse con el indicador " -d ". Los indicadores de cabecera controlan el formato del archivo g que se crea con el comando ' get.

Tabla 2. Banderas de cabecera

Elemento	Descripción
b	Utilice el indicador " -b " de un comando " get " para crear deltas de rama.
c Número	Hace que la variable Número sea el número de versión más alto que puede utilizar un comando ' get -e '. El valor de la variable Número debe ser mayor que 0 y menor o igual que 9999. (El valor predeterminado es 9999.)
d SID	Hace que la variable SID sea el delta por defecto que se suministra a un comando ' get '.
f Número	Hace que la variable Número sea el número de versión más bajo que puede recuperar un comando ' get -e '. La variable Número debe ser mayor que 0 y menor que 9999. (El valor predeterminado es 1.)
i [Cadena]	Trata el siguiente mensaje informativo, emitido por el comando ' get o ' delta ', como un error: There are no SCCS identification keywords in the file. (cm7) En ausencia de este distintivo, el mensaje es sólo una advertencia. El mensaje se emite si no se encuentran palabras clave de identificación SCCS en el texto recuperado o almacenado en el archivo SCCS (consulte el comando " get "). Si se proporciona una serie, las palabras clave deben coincidir exactamente con la serie dada. La serie debe contener una palabra clave y no tener nuevas líneas incorporadas.
j	Permite comandos ' get ' concurrentes para editar el mismo SID de un archivo SCCS. El uso del indicador de cabecera " j " permite múltiples actualizaciones simultáneas de la misma versión del archivo SCCS.
listal	(L minúscula) Bloquea las versiones especificadas por la variable List para que no se puedan editar, de forma que un comando ' get -e ' contra una de estas versiones falle. La lista tiene la sintaxis siguiente: <List> : : = <Range> | <List> , <Range> <Range> : : = SID | a El carácter " a " de la lista equivale a especificar todas las versiones del archivo SCCS indicado.
m Módulo	Sustituye la variable Module para todas las apariciones de la palabra clave " 59 " en un archivo de texto SCCS que se recupera mediante un comando " get ". La variable Module por defecto es el nombre del archivo SCCS sin el prefijo ' s. '. El nombre de módulo puede incluir caracteres MBCS (juego de caracteres de varios bytes).
n	Hace que el comando ' delta ' cree un delta nulo en las versiones que se saltan cuando se realiza un delta en una nueva versión. Por ejemplo, si establece delta 5.1 después de delta 2.7, los releases 3 y 4 serán nulos. Las versiones 3 y 4 se crearán como entradas delta nulas en la tabla delta del archivo ' s.. Los deltas nulos resultantes pueden servir como puntos desde los que crear deltas de bifurcación. Sin este distintivo, los releases omitidos no aparecen en el archivo SCCS.
q ' Texto	Sustituye el texto especificado por todas las apariciones de la palabra clave " " en un archivo de texto SCCS recuperado por un comando " get ".
t Tipo	Sustituye el tipo especificado por todas las palabras clave ' ' en un archivo g recuperado por un comando ' get '.
v [Programa]	Hace que el comando ' delta ' solicite números de Solicitud de Modificación (MR) como motivo para crear un delta. La variable Programa especifica el nombre de un programa de comprobación de validez de números MR. Si el indicador " v " está definido en el archivo SCCS, también debe utilizarse el indicador " -m ", aunque su valor sea nulo. El nombre del programa puede incluir caracteres MBCS (juego de caracteres de varios bytes).

Localización de archivos SCCS dañados

Aunque SCCS proporciona cierta protección de errores, es posible que tenga que recuperar un archivo que se ha dañado accidentalmente. Estos daños pueden deberse a un mal funcionamiento del sistema, a un error del operador o a la modificación de un archivo SCCS sin utilizar los comandos SCCS

Los mandatos SCCS utilizan la suma de comprobación para determinar si se ha cambiado un archivo desde que se utilizó por última vez. El único comando SCCS que procesa un archivo dañado es el comando " admin " cuando se utiliza con los indicadores " -h o " -z ". El distintivo -h indica al mandato admin que compare la suma de comprobación almacenada en la cabecera del archivo SCCS con la suma de comprobación calculada. El indicador ' -z ' indica al comando que vuelva a calcular la suma de comprobación y la almacene en la cabecera del archivo.

Estado de salida

Este mandato devuelve los siguientes valores de salida:

Ejemplos

Estos ejemplos utilizan un archivo de texto imaginario llamadotest.cy un editor como ' ed ' para editar archivos.

1. En primer lugar, cree un archivo SCCS ordinario. Para crear un archivo SCCS vacío llamado ' s.test.c, introduzca:

   $ admin -n s.test.c

   Si se utiliza el comando " admin " con el indicador " -n ", se crea un archivo SCCS vacío.
2. Para convertir un archivo de texto existente en un archivo SCCS, introduzca:

   $ admin -itest.c s.test.c
   There are no SCCS identification keywords in the file (cm7)
   $ ls
   s.test.c test.c

   si utiliza el indicador ' -i ', el comando ' admin ' crea el delta 1.1 a partir del archivo especificado. Una vez que se ha creado delta 1.1 , cambie el nombre del archivo de texto original para que no interfiera con los mandatos SCCS:

   $ mv test.c back.c

   El mensaje ' There are no SCCS identification keywords in the file (cm7) ' no indica ningún error. SCCS escribe este mensaje cuando no hay palabras clave de identificación en el archivo. Las palabras clave de identificación son variables que se pueden colocar en un archivo SCCS. Los valores de estas variables proporcionan información como fecha, hora, SID o nombre de archivo. Consulte el comando " get " para obtener una explicación de las palabras clave de identificación. Si no existen palabras clave de identificación, SCCS escribe el mensaje. Sin embargo, si el indicador de cabecera " i " está activado en el archivo " s. ", este mensaje provocará un error. Este distintivo lo establece el usuario.

   Asigne al archivo SCCS un nombre cualquiera que empiece por " s.. En el ejemplo anterior, el archivo original y el archivo SCCS tienen el mismo nombre, pero no es necesario.

   Puesto que no ha especificado un número de release, el mandato admin ha otorgado al archivo SCCS un SID de 1.1. SCCS no utiliza el número 0 para identificar deltas. Por lo tanto, un archivo no puede tener un SID de 1.0 o 2.1.1.0, por ejemplo. Todos los nuevos releases empiezan por el nivel 1.

3. Para iniciar eltest.ccon un número de versión 3.1, utilice el indicador " -r " con el comando " admin ", como se muestra a continuación, e introduzca:

   $ admin -itest.c -r3 s.test.c

   Para restringir el permiso de modificación de archivos SCCS a un conjunto específico de ID de usuario, enumere los ID de usuario o los números de ID de grupo en la lista de usuarios del archivo SCCS utilizando el indicador " -a " del comando " admin ". Este distintivo puede aparecer varias veces en la línea de mandatos. A continuación, estos ID aparecen en la cabecera de archivo SCCS. Sin el indicador ' -a ' para restringir el acceso, todos los ID de usuario pueden modificar los archivos SCCS.
4. Para restringir el permiso de edición al ID de usuario ' dan, introduzca:

   $ admin -adan s.test.c

5. Compruebe periódicamente los archivos SCCS para detectar posibles daños. La forma más sencilla de hacerlo es ejecutar el comando ' admin ' con el indicador ' -h ' en todos los archivos SCCS o directorios SCCS, como se indica a continuación:

   $ admin -h s.file1 s.file2 ...
   $ admin -h directory1 directory2 ...

   Si el comando ' admin ' encuentra un archivo en el que la suma de comprobación calculada no es igual a la suma de comprobación que figura en la cabecera del archivo SCCS, muestra este mensaje:

   ERROR [s. filename]:
   1255-057 The file is damaged. (co6)

   Si un archivo se ha dañado, intente editar el archivo de nuevo o leer una copia de seguridad. Después de arreglar el archivo, ejecute el mandato admin con el distintivo -z y el nombre de archivo reparado:

   $ admin -z s.file1

   Esta operación sustituye la suma de comprobación antigua de la cabecera de archivo SCCS por una nueva suma de comprobación basada en el contenido del archivo actual. Otros mandatos SCCS ahora pueden procesar el archivo.

Archivos