Provided by: manpages-es-extra_0.8a-19_all bug

NOMBRE

       grep, egrep, fgrep - muestran líneas que concuerdan con un patrón

SINOPSIS

       grep  [-AB]  núm]  [-CEFGVbchiLlnqsvwxyUu] [[-e ] patrón | -f fichero] [--extended-regexp]
       [--fixed-strings]  [--basic-regexp]  [--regexp=PATRÓN]  [--file=FICHERO]   [--ignore-case]
       [--word-regexp]    [--line-regexp]    [--line-regexp]   [--no-messages]   [--invert-match]
       [--version] [--help]  [--byte-offset]  [--line-number]  [--with-filename]  [--no-filename]
       [--quiet]  [--silent]  [--files-without-match] [--files-with-matcces] [--count] [--before-
       context=NUM]   [--after-context=NUM]    [--context]    [--binary]    [--unix-byte-offsets]
       ficheros...

DESCRIPCIÓN

       Grep  busca  en la entrada, bien en la que se le especifica con nombres de ficheros o bien
       en la entrada estándar si no se le dan dichos nombres o si uno de  éstos  consiste  en  -,
       líneas  que  concuerden  o  coincidan  con  el patrón dado.  Si no se dice otra cosa, grep
       muestra las líneas que concuerden.

       Hay tres grandes variantes de grep, controladas por las siguientes opciones:
       -G, --basic-regexp
              Interpreta patrón como una expresión regular básica (vea más  abajo).  Éste  es  el
              comportamiento predeterminado.
       -E, --extended-regexp
              Interpreta patrón coma una expresión regular extendida (vea más adelante).
       -F, --fixed-strings
              Interpreta  patrón  como  una  lista  de cadenas de caracteres fijas, separadas por
              saltos de línea; se busca la concordancia de una cualquiera de ellas.
       Además, están disponibles dos programas que son variantes de éste: egrep y  fgrep.   egrep
       es  similar  (pero no idéntico) a grep -E, y es compatible con el egrep histórico de Unix.
       fgrep es lo mismo que grep -F.

       Todas las variantes de grep entienden las siguientes opciones:
       -núm   Las líneas concordantes  se  mostrarán  acompañadas  de  núm  líneas  anteriores  y
              posteriores. Sin embargo, grep nunca mostrará cualquier línea dada más de una vez.
       -A  núm , --after-context=NÚM
              Muestra núm líneas de contexto después de las que concuerden con el patrón.
       -B  núm , --before-context=NÚM
              Muestra núm líneas de contexto antes de las que concuerden con el patrón.
       -C, --context
              Equivalente a -2.
       -V, --version
              Muestra  el número de versión de grep en la salida estándar de errores. Este número
              de versión debería incluirse en todos los informes de fallos (vea más abajo).
       -b, --byte-offset
              Muestra el desplazamiento en bytes desde el principio del fichero de entrada  antes
              de cada línea de salida.
       -c, --count
              Suprime  la  salida  normal; en su lugar muestra el número de líneas que concuerdan
              con el patrón para cada fichero de entrada.  Con la opción -v, --invert-match  (vea
              más abajo), muestra el número de líneas que no concuerden.
       -e patrón,--regexp=PATRÓN
              Emplea patrón como el patrón; útil para proteger patrones que comiencen con -.
       -f fichero,--file=FICHERO
              Obtiene el patrón de fichero.
       -h, --no-filename
              Suprime la impresión de los nombres de ficheros antes de las líneas concordantes en
              la salida, cuando se busca en varios ficheros.
       -i, --ignore-case
              No hace caso de si las letras son mayúsculas o minúsculas ni en el patrón ni en los
              ficheros de entrada.
       -L, --files-without-match
              Suprime  la salida normal; en su lugar muestra el nombre de cada fichero de entrada
              donde no se encuentre ninguna concordancia y por lo tanto de cada  fichero  que  no
              produciría  ninguna  salida.  La  búsqueda  se  detendrá  al  llegar  a  la primera
              concordancia.
       -l, --files-with-matches
              Suprime la salida normal; en su lugar muestra el nombre de cada fichero de  entrada
              que produciría alguna salida. La búsqueda se detendrá en la primera concordancia.
       -n, --line-number
              Prefija  cada  línea  de  salida  con  el  número de línea de su fichero de entrada
              correspondiente.
       -q, --quiet
              Silencioso;  suprime  la  salida  normal.  La  búsqueda  finaliza  en  la   primera
              concordancia.
       -s, --silent
              Suprime los mensajes de error sobre ficheros que no existen o no se pueden leer.
       -v, --invert-match
              Invierte  el  sentido  de la concordancia, para seleccionar las líneas donde no las
              hay.
       -w, --word-regexp
              Selecciona  solamente  aquellas  líneas  que  contienen  concordancias  que  forman
              palabras  completas.  La  comprobación  consiste  en  que  la  cadena de caracteres
              concordante debe estar al principio de la línea o precedida por un carácter que  no
              forme  parte  de una palabra. De forma similar, debe estar o al final de la línea o
              ser seguida por un carácter no constituyente de  palabra.  Los  caracteres  que  se
              consideran como parte de palabras son letras, dígitos y el subrayado.
       -x, --line-regexp
              Selecciona solamente aquellas concordancias que constan de toda la línea.
       -y     Sinónimo obsoleto de -i.
       -U, --binary
              Trata  el(los)  fichero(s)  como binario(s). De forma predeterminada, bajo MS-DOS y
              MS-Windows, grep intenta adivinar el tipo del fichero mirando los contenidos de los
              primeros  32  kB leídos de él. Si grep decide que el fichero es de texto, quita los
              caracteres CR (retorno de carro) de los contenidos originales del fichero (para que
              las  expresiones  regulares  con  ^ y $ funcionen correctamente). Al especificar -U
              deshabilitamos este intento de adivinación del tipo del fichero, haciendo que todos
              se  lean  y  pasen  al mecanismo de concordancia tal cuales; si el fichero lo es de
              texto y tiene al final de cada línea el par de  caracteres  CR/LF,  esto  hará  que
              algunas  expresiones  regulares  fallen. Esta opción sólo tiene sentido en MS-DOS y
              MS-Windows.
       -u, --unix-byte-offsets
              Informa de desplazamientos de bytes al estilo de Unix. Esta opción  hace  que  grep
              muestre los desplazamientos de bytes como si el fichero fuera de texto al estilo de
              Unix; o sea, sin  los  caracteres  CR  al  final  de  cada  línea.  Esto  producirá
              resultados  idénticos  a  ejecutar  grep  en  un sistema Unix. Esta opción no tiene
              efecto a menos que se dé también la opción -b; sólo tiene sentido en MS-DOS  y  MS-
              Windows.

EXPRESIONES REGULARES

       Una  expresión regular es un patrón que describe un conjunto de cadenas de caracteres. Las
       expresiones regulares se construyen  de  forma  análoga  a  las  expresiones  aritméticas,
       combinando  expresiones  más  pequeñas mediante ciertos operadores para formar expresiones
       complejas.

       El programa grep entiende dos  versiones  diferentes  de  sintaxis  para  las  expresiones
       regulares:  la  ``básica''  y  la  ``extendida''.  En  la  versión  de grep de GNU, no hay
       diferencia en usar  una  u  otra  en  cuanto  a  la  funcionalidad  disponible.  En  otras
       implementaciones,  las  expresiones  regulares  básicas  son  menos potentes. La siguiente
       descripción se aplica a expresiones regulares extendidas; las diferencias con las  básicas
       se resumen a continuación.

       Los bloques de construcción fundamentales son las expresiones regulares que concuerdan con
       un solo carácter. La mayoría de los caracteres, incluyendo todas las letras y dígitos, son
       expresiones  regulares  que  concuerdan  consigo  mismos.  Cualquier  meta-carácter con un
       significado especial debe ser protegido precediéndolo con una barra inclinada inversa.

       Una lista de caracteres rodeados por [ y ] concuerda con cualquier carácter de esa  lista;
       si  el  primer  carácter  de  la  lista  es el acento circunflejo ^ entonces concuerda con
       cualquier carácter de fuera de la lista.  Por ejemplo, la expresión  regular  [0123456789]
       concuerda con cualquier carácter dígito. Se puede especificar un rango de caracteres ASCII
       dando el primero y el último, separados por  un  guión.   Finalmente,  están  predefinidas
       ciertas  clases  de  caracteres,  con  un  nombre  para  cada una. Estos nombres son auto-
       explicativos, y son [:alnum:],  [:alpha:],  [:cntrl:],  [:digit:],  [:graph:],  [:lower:],
       [:print:],  [:punct:],  [:space:],  [:upper:],  y  [:xdigit:].   Por  ejemplo, [[:alnum:]]
       significa  (en  inglés)  [0-9A-Za-z],  salvo  que  la  última  forma  depende  de  que  la
       codificación  de  caracteres  siga el estándar ISO-646 o ASCII, mientras que la primera es
       transportable.  (Observe que los corchetes en estos nombres de clases  son  parte  de  los
       nombres simbólicos, y deben incluirse además de los corchetes que delimitan la lista entre
       corchetes.) La mayor parte de los meta-caracteres pierden su significado  especial  dentro
       de  estas  listas.  Para  incluir  un  ] literal, póngalo el primero de la lista. De forma
       similar, para incluir  un  ^  literal,  póngalo  en  cualquier  sitio  menos  el  primero.
       Finalmente, para incluir un - literal, póngalo el último.

       El  punto  .   concuerda  con  cualquier  carácter  solo.  El símbolo \w es un sinónimo de
       [[:alnum:]] y \W lo es de [^[:alnum]].

       El acento circunflejo ^ y el signo  del  dólar  (y  del  escudo  portugués)  $  son  meta-
       caracteres  que  respectivamente  concuerdan con la cadena vacía al comienzo y al final de
       una línea.  Los símbolos \< y  \>  respectivamente  concuerdan  con  la  cadena  vacía  al
       principio y al final de una palabra.  El símbolo \b concuerda con la cadena vacía al borde
       de una palabra, y \B concuerda con la cadena vacía supuesto que no esté en el  extremo  de
       una palabra.

       Una  expresión  regular  que  concuerde  con un solo carácter puede ser seguida por uno de
       estos varios operadores de repetición:
       ?      El elemento precedente es opcional y concuerda como mucho una vez.
       *      El elemento precedente concordará cero o más veces.
       +      El elemento precedente concordará una o más veces.
       {n}    El elemento precedente concuerda exactamente n veces.
       {n,}   El elemento precedente concuerda n o más veces.
       {,m}   El elemento precedente es opcional y concuerda como mucho m veces.
       {n,m}  El elemento precedente concuerda como poco n veces, pero no más de m veces.

       Dos expresiones regulares pueden concatenarse; la expresión regular  resultante  concuerda
       con  cualquier  cadena  formada mediante la concatenación de dos subcadenas que concuerdan
       respectivamente con las subexpresiones concatenadas.

       Dos expresiones regulares pueden juntarse mediante el  operador  infijo  |;  la  expresión
       regular  resultante  concuerda  con  cualquier  cadena que concuerde con cualquiera de las
       subexpresiones.

       La repetición tiene precedencia sobre la concatenación, la cual a su vez tiene precedencia
       sobre  la  alternancia.  Una subexpresión entera puede ser encerrada entre paréntesis para
       subvertir estas reglas de precedencia.

       La retrorreferencia \n, donde n es un  dígito  simple,  concuerda  con  la  subcadena  que
       previamente concordó con la n-sima subexpresión entre paréntesis de la expresión regular.

       En  las  expresiones  regulares básicas, los meta-caracteres ?, +, {, |, (, y ) pierden su
       significado especial; en su lugar  emplee  las  versiones  protegidas  mediante  la  barra
       inversa \?, \+, \{, \|, \(, y \).

       En egrep, el meta-carácter { pierde su significado especial; en su lugar emplee \{.

DIAGNÓSTICOS

       Normalmente,  el  status  de  salida  es  0  si  se encuentran concordancias, y 1 si no se
       encuentran. (La opción -v invierte el sentido del status de salida.)  El status de  salida
       es  2  si  había  errores  de  sintaxis  en  el  patrón,  si  los ficheros de entrada eran
       inaccesibles, o en caso de otros errores del sistema.

FALLOS

       Envíe  informes  sobre  fallos  por   correo   electrónico   a   la   dirección   bug-gnu-
       utils@prep.ai.mit.edu.   Asegúrese de incluir la palabra ``grep'' en algún sitio del campo
       ``Asunto:'' (``Subject:'').

       Números de repetición grandes en la  construcción  {m,n}  pueden  hacer  que  grep  emplee
       grandes  cantidades  de  memoria.   En  adición a esto, ciertas otras obscuras expresiones
       regulares requieren tiempo y espacio exponenciales, y pueden hacer que grep se  quede  sin
       memoria.

       Las retrorreferencias son muy lentas, y pueden requerir un tiempo exponencial.