Node:Opciones Globales, Next:add, Previous:Formatos de Fecha, Up:Ordenes y Opciones

Opciones Globales

Aqu� est�n todas las opciones globales de CVS.

--allow-root=REPOSITORY

La primera opci�n global alfab�ticamente es una que no se usa nunca en la l�nea de mandatos. La opci�n -alow-root se usa con el mandato pserver para permitir acceso acreditado al repositorio dicho (que es el nivel alto de un repositorio, como /usr/local/newrepos, no un subdirectorio de proyecto como /usr/local/newrepos/myproj).

Esta opci�n global no se usa virtualmente nunca en la l�nea de mandatos. Normalmente el �nico sitio donde lo usar�a es en los ficheros /etc/inetd.conf (ver Administracion del Repositorio), que es tambi�n casi el �nico sitio donde el mandato pserver se usa.

Cada repositorio a ser accedido v�a cvs pserver en un servidor dado, necesita la correspondiente opci�n -allow-root en /etc/inetd.conf. �ste es un dispositivo de seguridad, pensado para asegurar que cualquiera no puede usar un pserver de CVS para conseguir acceso a repositorios privados.

(Ver El servidor de autentificacion de contrasen~as tambi�n en el nodo Servidor Acreditado por Clave en el manual Cederqvist.)

-a

Esto acredita todas las comunicaciones con el servidor. Esta opci�n no tiene efecto a no ser que se est� conectado v�a servidor GSSAPI (gserver). Las conexiones GSSAPI no se cubren en este libro, porque son todav�a usadas raramente (aunque esto puede cambiar). (Ver las notas Opciones Globales y Acreditaci�n GSSAPI en el manual Cederqvist para obtener m�s informaci�n.)

-b (Ca�do en desuso)

Esta opci�n especifica formalmente el directorio donde los ejecutables del RCS se encuentran. CVS ahora implementa las funciones RCS internamente, por lo que esta opci�n no surte efecto (se mantiene s�lo por compatibilidad retrospectiva).

-d REPOSITORIO

Esto especifica el repositorio, que puede ser una ruta absoluta o una expresi�n m�s compleja involucrando m�todo de conexi�n, nombre de usuario, servidor y ruta. Si es una expresi�n especificando un m�todo de conexi�n, la sintaxis general es:

:M�TODO:USUARIO@NOMBRE_DEL_SERVIDOR:RUTA_AL_REPOSITORIO

Aqu� hay ejemplos usando cada uno de los m�todos de conexi�n:

• :ext:jcualquiera@floss.red-bean.com:/usr/local/newrepos - Conecta usando rsh, ssh, o alg�n otro programa de conexi�n externo. Si la variable de entorno $CVS_RSH no est� especificada, la opci�n por omisi�n es rsh; de otro modo, usa el valor de esta variable.
• :server:jcualquiera@floss.red-bean.com:/usr/local/newrepos - Como :ext:, pero usa la implementaci�n interna de rsh. (Esto puede no estar disponible en todas las plataformas.)
• :pserver:jcualquiera@floss.red-bean.com:/usr/local/newrepos - Conecta usando el servidor de acreditaci�n de claves (ver El servidor de autentificacion de contrasen~as en Administracion del Repositorio; ver tambi�n el mandato login.)
• :kserver:jrandom@floss.red-bean.com:/usr/local/newrepos - Conecta usando acreditaci�n Kerberos.
• :gserver:jrandom@floss.red-bean.com:/usr/local/newrepos - Conecta usando acreditaci�n GSSAPI.
• :fork:jcualquiera@floss.red-bean.com:/usr/local/newrepos - Conecta a un repositorio local, pero usando el protocolo de red cliente/servidor en vez de acceder directamente a los ficheros del repositorio. Esto es �til para comprobar y depurar comportamientos de CVS en remoto desde su m�quina local.
• :local:jcualquiera@floss.red-bean.com:/usr/local/newrepos - Accede a un repositorio local directamente, como si se diera s�lo la ruta absoluta al respositorio.

-e EDITOR

Invoca EDITOR para su mensaje de entrega, si el mensaje de entrega no se especifica en la l�nea de mandatos con la opci�n -m. Normalmente, si no da un mensaje con la opci�n -m, CVS invoca el editor basado en las variables de entorno $CVSEDITOR, $VISUAL, o $EDITOR, que comprueba en este orden. Fallado esto, invoca el editor popular de Unix vi.

Si pasa tanto la opci�n -e como la -m en una entrega, el -e no se tiene en cuenta a favor del mensaje de entrega dado en la l�nea de mandatos (de este modo es seguro usar -e en un fichero .cvsrc).

-f

Esta opci�n global suprime la lectura del fichero .cvsrc.

--help [MANDATO] o -H [MANDATO]

Estas dos opciones son sin�nimas. Si no se especifica MANDATO, se imprime un mensaje de uso b�sico a la salida est�ndar. Si se especifica MANDATO, se imprime un mensaje de uso para ese mandato.

--help-options

Imprime una lista con todas las opciones globales de CVS, con breves explicaciones.

--help-synonyms

Imprime una lista de mandatos CVS y sus formatos cortos ("up" para "update", y as� sucesivamente).

-l

Suprime el registro del mandato en el fichero CVSROOT/history en el repositorio. El mandato se ejecuta normalmente, pero no se realiza ninguna archivaci�n en el fichero de historial.

-n

No cambia ning�n fichero en la copia de trabajo o en el repositorio. En otras palabras, el mandato se ejecuta como una "ejecuci�n en seco" - CVS corre a trav�s de la mayor�a de los pasos del mandato pero evita cualquier clase de ejecuci�n.

�sto es �til cuando quiere ver qu� habr�a hecho el mandato si usted lo hubiera ejecutado. Un escenario com�n es cuando quiere ver qu� ficheros de su directorio de trabajo han sido alterados, pero no una actualizaci�n completa (que podr� traer cambios del repositorio). Ejecutando cvs -n update, puede ver un sumario de qu� ha sido hecho localmente, sin cambiar su copia de trabajo.

-q

Esto pide a CVS ser moderadamente silencioso, suprimiendo la impresi�n de mensajes de informaci�n no importantes. Qu� es considerado "importante" depende del mandato. Por ejemplo, en actualizaciones, los mensajes que CVS imprime normalmente al entrar en cada subdirectorio de la copia de trabajo se suprimen, pero los mensajes de estado de una l�nea para los ficheros modificados o actualizados se siguen imprimiendo.

-Q

Esto pide a CVS ser muy silencioso suprimiendo toda la salida excepto los que son absolutamente necesario para completar el mandato. Los mandatos cuyo �nico prop�sito es producir alguna salida (como diff o annotate), de hecho, siguen dando esa salida. Sin embargo, los mandatos que podr�an tener un efecto independiente de cualquier mensaje que pudieran imprimir (como update o commit) no imprimen nada.

-r

Hace que los ficheros de trabajo sean creados como de s�lo lectura (el mismo efecto que configurando la variable de entorno CVSREAD).

Si usted pasa esta opci�n, las obtenciones y las entregas hacen los ficheros de s�lo lectura en su copia de trabajo (asumiendo que su sistema operativo lo permita). Francamente, no s� por qu� alguien podr�a querer usar alguna vez esta opci�n.

-s VARIABLE=VALOR

Esto asigna el VALOR a la variable interna de CVS llamada VARIABLE.

En el lado del repositorio, los fichero disparadores CVSROOT/*info puede expandir tales variables a valores que fueron asignados en la opci�n -s. Por ejemplo, si CVSROOT/loginfo contiene una l�nea como esta

miproyecto  /usr/local/bin/foo.pl ${=PEZ}

y alguien ejecuta una entrega desde una copia de trabajo miproyecto as�

floss$ cvs -s PEZ=carpa commit -m "arreglado el bug cebo"

el script foo.pl se invoca con carpa como un argumento. Note la sintaxis chula, as�: El signo del d�lar, igual y las llaves son todas necesarias - si alguno de ellos falta, la expansi�n no toma lugar (al menos no como se trataba). Los nombres de variables s�lo pueden contener alfanum�ricos y subrayados. Aunque no se requiere que est�n en may�sculas, la mayor�a de la gente parece seguir esta convenci�n.

Puede usar el indicador -s tantas veces como quiera en un mandato simple. Sin embargo, si el script disparador se refiere a variables que no son asignadas en una invocaci�n particular de CVS, el mandato tambi�n tiene �xito, pero ninguna de las variables se expande, y el usuario ve un aviso. Por ejemplo, si loginfo tiene esto

miproyecto  /usr/local/bin/foo.pl  ${=PEZ}  ${=AVE}

pero el mismo mandato de antes se ejecuta

floss$ cvs -s PEZ=carpa commit -m "arreglado el bug cebo"

la persona que ejecuta el mandato ve un mensaje de aviso como este (puesto al final de la salida)

loginfo:31: no such user variable ${=AVE}

(loginfo:31: variable de usuario inexistente) y el script foo.pl se invoca sin argumentos. Pero si se ejecuta este mandato

floss$ cvs -s PEZ=carpa -s AVE=buitre commit -m "arreglado el bug cebo"

aqu� no habr�a aviso, y tanto ${=PEZ} como ${=AVE} en loginfo estar�an correctamente expandidos. En cualquier caso, la entrega en s� misma, tendr�a �xito.

Aunque estos ejemplos usan todos commit, la expansi�n de variables puede hacerse con cualquier mandato CVS que pueda ser notificado en un fichero disparador CVSROOT/ - que es por lo que la opci�n -s es global.

(Vea la secci�n Ficheros de Administracion del Repositorio m�s adelante en este cap�tulo para obtener m�s detalles sobre la expansi�n de variables en ficheros disparadores.)

-T DIRECTORIO

Guarda cualquier fichero temporal en el DIRECTORIO en vez de donde CVS lo pone normalmente (espec�ficamente, esto sustituye el valor de la variable de entorno $TMPDIR, si existiera). DIRECTORIO deber�a ser una ruta absoluta.

Esta opci�n es �til cuando usted no tiene que permiso de escritura (y, por tanto, CVS tampoco) a los directorios temporales usuales.

-t

Traza la ejecuci�n del mandato de CVS. Esto hace a CVS imprimir mensajes mostrando los pasos que se dan a lo largo de la ejecuci�n de un mandato. Puede encontrarlo particularmente �til en conjunci�n con la opci�n global -n, para prever los efectos de un mandato poco familiar antes de ejecutarlo de verdad. Tambi�n puede ser �til cuando intenta descubrir por qu� un mandato fall�.

-v o --version

Hace que CVS imprima informaci�n de sus versiones y derechos de copia y despu�s salga sin error.

-w

Hace que los ficheros de trabajo sean creados como lectura-escritura (remplaza cualquier configuraci�n de las variables de entorno $CVSREAD). Debido, de todos modos, a que los ficheros se crean por omisi�n en modo lectura-escritura, esta opci�n se usa raramente.

Si tanto -r como -w se pasan, -w domina.

-x

Encripta todas las comunicaciones con el servidor. Esta opci�n no tiene efecto a no ser que est� conectando v�a servidor GSSAPI (gserver). Las conexiones GSSAPI no se cubren en este libro, porque son todav�a raramente usadas (aunque esto puede cambiar). (Ver los nodos Opciones Globales y Acreditaci�n GSSAPI en el manual Cederqvist para ampliar informaci�n.)

-z NIVEL-GZIP

Ajusta el nivel de compresi�n en las comunicaciones con el servidor. El argumento NIVEL-GZIP debe ser un n�mero entre el uno y el nueve. El nivel uno es compresi�n m�nima (muy r�pida, pero poca compresi�n). El nivel nueve es la compresi�n m�s alta (aunque es mucho tiempo de CPU, pero asegura que comprime los datos). El nivel nueve es solamente �til en conexiones de red muy rapidas. La mayor parte de la gente encuentra los niveles entre el tres y el cinco los m�s benificiosos.

Un espacio entre -z y su argumento es opcional.