cscope - Online en la nube

PROGRAMA:

NOMBRE

cscope: examinar de forma interactiva un programa en C

SINOPSIS

alcance [-bCcdehkLlqRTUuVvX] [-FSymfile] [-Frefiliar] [-YOincdir] [-Iarchivo de nombre]
[-0123456789patrón] [-pagn] [-sdir] [archivos]

DESCRIPCIÓN

alcance es una herramienta interactiva orientada a la pantalla que permite al usuario navegar a través de C
archivos fuente para elementos especificados de código.

Por defecto, alcance examina los archivos fuente C (.cy .h), lex (.l) y yacc (.y) en el
directorio actual. alcance también se puede invocar para archivos de origen nombrados en la línea de comando.
En cualquier caso, alcance busca en los directorios estándar los archivos #include que hace
no se encuentra en el directorio actual. alcance utiliza un símbolo de referencia cruzada, llamado
cscope.out por defecto, para localizar funciones, llamadas a funciones, macros, variables y
símbolos de preprocesador en los archivos.

alcance crea la referencia cruzada del símbolo la primera vez que se utiliza en los archivos fuente para
el programa que se está examinando. En una invocación posterior, alcance reconstruye la referencia cruzada
solo si un archivo de origen ha cambiado o la lista de archivos de origen es diferente. Cuando el
se reconstruye la referencia cruzada, los datos de los archivos no modificados se copian del antiguo
referencia cruzada, lo que hace que la reconstrucción sea más rápida que la inicial.

OPCIONES

Algunos argumentos de la línea de comando solo pueden ocurrir como el único argumento en la ejecución de
cscope. Hacen que el programa simplemente imprima algunos resultados y salga de inmediato:

-h Ver la pantalla de ayuda de uso prolongado.

-V Imprima en la primera línea de la pantalla el número de versión de cscope.

--ayuda Igual que -h

--versión
Igual que -V

Las siguientes opciones pueden aparecer en cualquier combinación:

-b Construya solo la referencia cruzada.

-C Ignore mayúsculas y minúsculas al buscar.

-c Utilice solo caracteres ASCII en el archivo de referencia cruzada, es decir, no comprima el
datos.

-d No actualice la referencia cruzada.

-e Suprime el -e símbolo del sistema entre archivos.

-FSymfile
Leer líneas de referencia de símbolo de Symfile. (Un archivo de referencia de símbolo es creado por>
y >>, y también se puede leer con el comando <, que se describe en `` Emitir
Solicitudes posteriores '', a continuación).

-frefiliar
Utilice refiliar como nombre de archivo de referencia cruzada en lugar del predeterminado "cscope.out".

-Iincdir
Pase a ver incdir (antes de buscar en $ INCDIR, el lugar estándar para los archivos de encabezado,
normalmente / usr / include) para cualquier archivo #include cuyos nombres no comiencen con `` / ''
y que no se especifican en la línea de comando o en archivo de nombre debajo. (El #incluir
Los archivos se pueden especificar con comillas dobles o corchetes angulares).
directorio se busca además del directorio actual (que se busca
primero) y la lista estándar (que se busca en último lugar). Si más de una ocurrencia
de -I aparece, los directorios se buscan en el orden en que aparecen en el comando
la línea.

-iarchivo de nombre
Examine todos los archivos de origen cuyos nombres se enumeran en archivo de nombre (nombres de archivo
separados por espacios, tabulaciones o nuevas líneas) en lugar del archivo de lista de nombres predeterminado,
que se llama cscope.files. Si se especifica esta opción, cscope ignora cualquier archivo
nombres que aparecen en la línea de comando. El archivo de nombre del argumento se puede establecer en `` - '' para
aceptar una lista de archivos de la entrada estándar. Nombres de archivo en el archivo de nombre que
contienen espacios en blanco deben estar encerrados entre "comillas dobles". Dentro de los citados
nombres de archivo, cualquier carácter de comillas dobles y barra invertida debe ser escapado por
barras diagonales inversas.

-k `` Modo Kernel '', desactiva el uso del directorio de inclusión predeterminado (generalmente
/ usr / include) al construir la base de datos, ya que los árboles de origen del kernel generalmente
no lo use.

-L Realice una sola búsqueda con salida orientada a líneas cuando se use con el patrón -num
.

-l Interfaz orientada a líneas (consulte `` Interfaz orientada a líneas '' a continuación).

-[0 - 9]patrón
Ir al campo de entrada número (contando desde 0) y encuentre patrón.

-Pcamino Anteponer camino a los nombres de archivo relativos en un archivo de referencia cruzada prediseñado para que lo haga
no es necesario cambiar al directorio donde se creó el archivo de referencia cruzada. Esta
La opción solo es válida con la opción -d.

-pn Mostrar el último n componentes de la ruta de archivo en lugar del predeterminado (1). Usar 0 no
mostrar el nombre del archivo en absoluto.

-q Habilite la búsqueda rápida de símbolos a través de un índice invertido. Esta opción hace que cscope
cree 2 archivos más (nombres predeterminados `` cscope.in.out '' y `` cscope.po.out '') en
además de la base de datos normal. Esto permite un algoritmo de búsqueda de símbolos más rápido que
proporciona un rendimiento de búsqueda notablemente más rápido para proyectos grandes.

-R Recurrir a los subdirectorios durante la búsqueda de archivos de origen.

-sdir Pase a ver dir para archivos fuente adicionales. Esta opción se ignora si los archivos de origen están
dado en la línea de comando.

-T Utilice solo los primeros ocho caracteres para compararlos con los símbolos C. Un habitual
expresión que contenga caracteres especiales que no sean un punto (.) no coincidirá con ningún
símbolo si su longitud mínima es superior a ocho caracteres.

-U Verifique las marcas de tiempo del archivo. Esta opción actualizará la marca de tiempo en la base de datos incluso
si no ha cambiado ningún archivo.

-u Cree incondicionalmente el archivo de referencia cruzada (suponga que todos los archivos tienen
cambió).

-v Sea más detallado en el modo orientado a líneas. Actualizaciones de progreso de salida durante la base de datos
construcción y búsquedas.

-X Elimine el archivo de referencia de cscope y los índices invertidos al salir

archivos Una lista de nombres de archivos sobre los que operar.

Las opciones -I, -c, -k, -p, -q y -T también pueden estar en el archivo cscope.files.

Solicitando el inicial Buscar
Una vez que la referencia cruzada esté lista, cscope mostrará este menú:

Encuentre este vídeo C símbolo:
Encuentre este vídeo función definición:
Encuentre funciones , que son by este vídeo función:
Encuentre funciones llamar este vídeo función:
Encuentre este vídeo texto cuerda:
CAMBIO este vídeo texto cuerda:
Encuentre este vídeo egrep patrón:
Encuentre este vídeo archivo:
Encuentre archivos #incluso este vídeo archivo:
Encuentre asignaciones a este vídeo símbolo:

presione el o teclas repetidamente para moverse al campo de entrada deseado, escriba el texto
para buscar y luego presione el llave.

Emisor posterior solicitudes
Si la búsqueda tiene éxito, se puede utilizar cualquiera de estos comandos de un solo carácter:

0-9a-zA-Z
Edite el archivo al que hace referencia el número de línea dado.


Muestra el siguiente conjunto de líneas coincidentes.

Alternar entre el menú y la lista de líneas coincidentes

Ir al elemento de menú anterior (si el cursor está en el menú) o mover al
línea coincidente anterior (si el cursor está en la lista de líneas coincidentes).

Pasar al siguiente elemento del menú (si el cursor está en el menú) o pasar al siguiente
línea coincidente (si el cursor está en la lista de líneas coincidentes).

+ Muestra el siguiente conjunto de líneas coincidentes.

- Muestra el conjunto anterior de líneas coincidentes.

^e Edite los archivos mostrados en orden.

> Escriba la lista de líneas mostrada en un archivo.

>> Agregue la lista de líneas mostrada a un archivo.

< Leer líneas de un archivo que está en formato de referencia de símbolo (creado por> o >>),
al igual que la opción -F.

^ Filtre todas las líneas a través de un comando de shell y muestre las líneas resultantes, reemplazando
las líneas que ya estaban allí.

| Canalice todas las líneas a un comando de shell y muéstrelas sin cambiarlas.

En cualquier momento también se pueden utilizar estos comandos de un solo carácter:


Pasar al siguiente campo de entrada.

^n Pasar al siguiente campo de entrada.

^p Ir al campo de entrada anterior.

^y Busque con el último texto escrito.

^b Ir al campo de entrada anterior y al patrón de búsqueda.

^f Pasar al siguiente campo de entrada y patrón de búsqueda.

^c Alternar ignorar / usar mayúsculas y minúsculas al buscar. (Al ignorar mayúsculas y minúsculas, busque
para `` ARCHIVO '' coincidirá con `` Archivo '' y `` archivo ''.)

^r Reconstruya la referencia cruzada.

! Inicie un shell interactivo (escriba ^ d para volver a cscope).

^l Vuelva a dibujar la pantalla.

? Proporcione información de ayuda sobre los comandos de cscope.

^d Salga de cscope.

NOTA: If el first personaje of el texto a be buscado para cerillas uno of el above
comandos, escapar it by escribiendo a (barra invertida) de antemano.

Sustituyendo new texto para los ancianos texto

Después de que se haya escrito el texto que se va a cambiar, cscope solicitará el nuevo texto y luego
mostrará las líneas que contienen el texto antiguo. Seleccione las líneas a cambiar con
estos comandos de un solo carácter:

0-9a-zA-Z
Marque o desmarque la línea que desee cambiar.

* Marque o desmarque todas las líneas mostradas para cambiarlas.


Muestra el siguiente conjunto de líneas.

+ Muestra el siguiente conjunto de líneas.

- Muestra el conjunto de líneas anterior.

a Marque o desmarque todas las líneas que desee cambiar.

^d Cambie las líneas marcadas y salga.

Salir sin cambiar las líneas marcadas.

! Inicie un shell interactivo (escriba ^ d para volver a cscope).

^l Vuelva a dibujar la pantalla.

? Proporcione información de ayuda sobre los comandos de cscope.

Especial claves
Si su terminal tiene teclas de flecha que funcionan en vi, puede usarlas para moverse
los campos de entrada. La tecla de flecha hacia arriba es útil para moverse al campo de entrada anterior.
en lugar de usar el tecla repetidamente. Si usted tiene , , o
teclas actuarán como los comandos ^ l, + y -, respectivamente.

Orientado a líneas interfaz.
La opción -l le permite usar cscope donde una interfaz orientada a pantalla no sería útil,
por ejemplo, de otro programa orientado a la pantalla.

cscope mostrará >> cuando esté listo para una línea de entrada que comience con el campo
número (contando desde 0) seguido inmediatamente por el patrón de búsqueda, por ejemplo,
`` lmain '' busca la definición de la función principal.

Si solo desea una búsqueda única, en lugar de la opción -l use el patrón -L y -num
opciones, y no obtendrá el indicador >>.

Para -l, cscope genera el número de líneas de referencia cscope: 2 líneas

Para cada referencia encontrada, cscope genera una línea que consta del nombre del archivo, función
nombre, número de línea y texto de línea, separados por espacios, por ejemplo, main.c main 161
principal (argc, argv)

Tenga en cuenta que no se llama al editor para mostrar una sola referencia, a diferencia de la pantalla-
interfaz orientada.

Puede usar el comando c para alternar entre ignorar / usar mayúsculas y minúsculas durante la búsqueda. (Al ignorar
mayúsculas y minúsculas, la búsqueda de `` ARCHIVO '' coincidirá con `` Archivo '' y `` archivo ''.)

Puede utilizar el comando r para reconstruir la base de datos.

cscope se cerrará cuando detecte el final del archivo, o cuando el primer carácter de una línea de entrada
es `` ^ d '' o `` q ''.

MEDIO AMBIENTE VARIABLES

CSCOPE_EDITOR
Anula las variables EDITOR y VISOR. Utilice esto si desea utilizar un
editor con cscope que el especificado por sus variables EDITOR / VISOR.

CSCOPE_LINEFLAG
Formato del indicador de número de línea para su editor. De forma predeterminada, cscope invoca su
editor a través del equivalente de `` editor + archivo N '', donde `` N '' es el número de línea
al que debería saltar el editor. Este formato es utilizado tanto por emacs como por vi. Si tu
editor necesita algo diferente, especifíquelo en esta variable, con ``% s '' como
marcador de posición para el número de línea. Ej: si su editor necesita ser invocado como
`` editor - archivo # 103 '' para ir a la línea 103, establezca esta variable en `` - #% s ''.

CSCOPE_LINEFLAG_AFTER_FILE
Establezca esta variable en `` sí '' si su editor necesita ser invocado con la línea
opción de número después del nombre de archivo que se va a editar. Para continuar con el ejemplo de
CSCOPE_LINEFLAG, arriba: si su editor necesita ver `` archivo de editor - # número '', establezca
esta variable de entorno. Los usuarios de la mayoría de los editores estándar (vi, emacs) no necesitan
para establecer esta variable.

EDITOR Editor preferido, cuyo valor predeterminado es vi.

INICIO Directorio de inicio, que se configura automáticamente al iniciar sesión.

INCLUYE
Lista de directorios separados por dos puntos para buscar archivos #include.

SHELL Shell preferido, que por defecto es sh.

FUENTES
Lista de directorios separados por dos puntos para buscar archivos de origen adicionales.

PLAZO Tipo de terminal, que debe ser un terminal de pantalla.

TÉRMINO
Nombre de ruta completo del directorio de información del terminal. Si su terminal no está en el
directorio estándar de terminfo, consulte curses y terminfo para saber cómo hacer el suyo
descripción del terminal.

TMPDIR Directorio de archivos temporal, cuyo valor predeterminado es / var / tmp.

ESPECTADOR Programa de visualización de archivos preferido (como less), que anula a EDITOR (ver más arriba).

VPATH Una lista de directorios separados por dos puntos, cada uno de los cuales tiene el mismo directorio
estructura debajo de él. Si se establece VPATH, cscope busca archivos de origen en el
directorios especificados; si no está configurado, cscope busca solo en el actual
directorio.

Utilice cscope en línea utilizando los servicios de onworks.net