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

NOMBRE

       find - busca ficheros en un arbol de directorios

SINOPSIS

       find [camino...] [expresion]

DESCRIPCI'ON

       Esta  pagina  del  Manual  documenta  la  version de GNU de find.  find
       recorre el arbol de directorio cuya  raiz  reside  en  cada  nombre  de
       fichero   dado,   evaluando   de   izquierda  a  derecha  la  expresion
       especificada, segun las  reglas  de  precedencia  (vea  la  seccion  de
       OPERADORES),  hasta  que  se conoce el resultado (la parte izquierda es
       falsa para operaciones and, verdadera para or), en cuyo punto  find  se
       mueve al siguiente nombre de fichero.

       El  primer argumento que comience con `-', `(', `)', `,', o `!' se toma
       como el principio de la expresion; cualesquier argumentos antes  de  el
       son  caminos  a  recorrer,  y  cualesquier argumentos tras el forman el
       resto de la expresion. Si no se da ningun camino, se toma el directorio
       de  trabajo.  Si  no  se  da  ninguna  expresion,  se  sobreentiende la
       expresion `-print'.

       find acaba con codigo de estado 0 si todos  los  ficheros  se  procesan
       satisfactoriamente, mayor que 0 si ocurre un error.

EXPRESIONES

       La   expresion  esta  hecha  de  opciones  (que  afectan  a  todas  las
       operaciones en vez de al procesamiento  de  un  fichero  especifico,  y
       siempre  devuelven  verdad),  comparaciones  (que  devuelven  un  valor
       verdadero o falso),  y  acciones  (que  tienen  efectos  colaterales  y
       devuelven  un valor verdadero o falso), todos separados por operadores.
       Donde se omita el operador, se sobreentiende -and. Si la  expresion  no
       contiene  ninguna  accion, aparte de -prune, se ejecuta -print en todos
       los ficheros para los que la expresion de verdadera.

   OPCIONES
       Todas las opciones siempre devuelven verdadero. Siempre tienen  efecto,
       en  lugar  de ser procesadas solamente cuando se alcance su sitio en la
       expresion. Por lo tanto, por claridad, lo mejor es ponerlas siempre  al
       principio de la expresion.

       -daystart
              Mide  los  tiempos  (para -amin, -atime, -cmin, -ctime, -mmin, y
              -mtime) desde el principio del dia de hoy en lugar de desde hace
              24 horas.

       -depth Procesa   cada   contenido   del  directorio  antes  del  propio
              directorio.

       -follow
              Desreferencia enlaces simbolicos. Implica -noleaf.

       -help, --help
              Muestra un sumario del modo de empleo de find y acaba.

       -maxdepth niveles
              Desciende como mucho niveles (un entero no negativo) niveles  de
              directorios por debajo de los argumentos de la linea de ordenes.
              `-maxdepth 0' significa que solo se aplicaran las  comparaciones
              y acciones a los argumentos de la linea de ordenes.

       -mindepth niveles
              No aplica comparaciones ni acciones a niveles menores de niveles
              (un entero no negativo). `-mindepth 1' significa procesar  todos
              los ficheros excepto los argumentos de la linea de ordenes.

       -mount No  descender  a  directorios  en otros sistemas de ficheros. Un
              nombre alternativo para -xdev, por  compatibilidad  con  algunas
              otras versiones de find.

       -noleaf
              No   optimiza  suponiendo  que  los  directorios  contienen  dos
              subdirectorios menos que lo que dice su numero de enlaces duros.
              Esta opcion es necesaria cuando se recorren sistemas de ficheros
              que  no  siguen  el  convenio  de  Unix  sobre  los  enlaces  de
              directorios, como sistemas de ficheros ISO-9660 (de un CD-ROM) o
              FAT (de MS-DOS o Windows), o puntos de montaje de volumenes  AFS
              (Andrew  File System). Cada directorio de un sistema de ficheros
              normal de Unix (UFS,  ext2fs,  etc.)  tiene  por  lo  menos  dos
              enlaces  duros:  su nombre y su entrada `.' (punto). Ademas, sus
              subdirectorios (si los hay) tienen cada  uno  una  entrada  `..'
              enlazada  a  este  directorio.  Cuando  find  esta examinando un
              directorio, despues de que ha hecho stat() en dos subdirectorios
              menos  de  lo que dice el numero de enlaces del directorio, sabe
              que el resto de las entradas del directorio  son  no-directorios
              (ficheros `hoja' [`leaf' en ingles] en el arbol del directorio).
              Si solo hay  que  examinar  los  nombres  de  ficheros,  no  hay
              necesidad de llamar a stat() sobre ellos, lo cual proporciona un
              incremento significativo en la velocidad del recorrido.

       -version, --version
              Muestra el numero de version de find y acaba.

       -xdev  No desciende a directorios en otros sistemas  de  ficheros.  Vea
              -mount mas arriba.

   COMPARACIONES
       Los argumentos numericos pueden especificarse como

       +n     para mayor que n,

       -n     para menor que n,

       n      para exactamente n.

       -amin n
              Se ha accedido al fichero por ultima vez hace n minutos.

       -anewer fichero
              Se  ha  accedido al fichero por ultima vez mas recientemente que
              cuando  fichero  fue  modificado.   -anewer  esta  afectado  por
              -follow  solamente si -follow va antes de -anewer en la linea de
              ordenes.

       -atime n
              Se ha accedido al fichero por ultima vez hace nx24 horas.

       -cmin n
              El status del fichero se cambio por ultima vez hace n minutos.

       -cnewer fichero
              El status del fichero se cambio por ultima vez mas recientemente
              que  cuando  se  modifico  fichero.   -cnewer  esta afectado por
              -follow solamente si -follow va antes de -cnewer en la linea  de
              ordenes.

       -ctime n
              EL status del fichero se cambio por ultima vez hace nx24 horas.

       -empty El fichero esta vacio y es o un fichero regular o un directorio.

       -false Siempre da falso.

       -fstype tipo
              El  fichero  esta  en  un  sistema de ficheros de tipo tipo. Los
              tipos validos de sistemas de ficheros varian segun la version de
              Unix;  una lista incompleta de tipos de sistemas de ficheros que
              se aceptan en algunas versiones de Unix es: ufs, 4.2, 4.3,  nfs,
              tmp, mfs, S51K, S52K.  Se puede usar -printf con la directiva %F
              para ver los tipos de sus sistemas de ficheros. (En  Linux,  cat
              /proc/filesystems  dara  una  lista  de los tipos de sistemas de
              ficheros reconocidos.)

       -gid n El GID numerico del fichero es n.

       -group grupo
              El  fichero  pertenece  al  grupo  grupo  (se  permite  un   GID
              numerico).

       -ilname patr'on
              Como  -lname, pero la concordancia no hace caso de mayusculas ni
              minusculas.

       -iname patr'on
              Como -name, pero la concordancia no hace caso de  mayusculas  ni
              minusculas.  Por  ejemplo, los patrones `fo*' y `F??' concuerdan
              con los nombres de ficheros `Foo', `FOO', `foo', `fOo', etc.

       -inum n
              El fichero tiene de numero-i n.

       -ipath patr'on
              Como -path, pero la concordancia no hace caso de  mayusculas  ni
              minusculas.

       -iregex patr'on
              Como  -regex, pero la concordancia no hace caso de mayusculas ni
              minusculas.

       -links n
              El fichero tiene n enlaces.

       -lname patr'on
              El fichero es un enlace simbolico  cuyos  contenidos  concuerdan
              con  el  patron  del  shell patr'on. Los metacaracteres no tratan
              especialmente a `/' ni a `.'.

       -mmin n
              Los datos del fichero fueron modificados por ultima vez  hace  n
              minutos.

       -mtime n
              Los  datos  del  fichero  fueron modificados por ultima vez hace
              nx24 horas.

       -name patr'on
              La base del nombre del fichero (el camino sin  los  directorios)
              concuerda  con  el  patron  del shell patr'on. Los metacaracteres
              (`*', `?' y `[]') no concuerdan con  un  `.'  al  principio  del
              nombre  base.  Para omitir un directorio y los ficheros bajo el,
              emplee -prune; vea un ejemplo en la descripcion de -path.

       -newer fichero
              El fichero fue modificado mas recientemente que fichero.  -newer
              es  afectado por -follow solamente si -follow va antes de -newer
              en la linea de ordenes.

       -nouser
              Ningun usuario se corresponde con el UID numerico del fichero.

       -nogroup
              Ningun grupo se corresponde con el GID numerico del fichero.

       -path patr'on
              El nombre del fichero concuerda con el patron del shell  patr'on.
              Los  metacaracteres  no  tratan de forma especial a `/' o a `.';
              asi, por ejemplo,
                        find . -path './sr*sc'
              mostrara una entrada para un directorio llamado './src/misc' (si
              es  que  existe).  Para  omitir  un  arbol entero de directorio,
              emplee -prune en vez de comprobar cada fichero en el arbol.  Por
              ejemplo,  para  pasar  el  directorio  `src/emacs'  y  todos los
              ficheros y directorios bajo el, y mostrar  los  nombres  de  los
              otros ficheros encontrados, haga algo como esto:
                        find . -path './src/emacs' -prune -o -print

       -perm modo
              Los  bits  de  permiso del fichero son exactamente modo (octal o
              simbolico). Los modos simbolicos  utilizaran  0  como  punto  de
              partida.

       -perm -modo
              Todos los bits de permiso modo estan activos para el fichero.

       -perm +modo
              Cualquiera  de  los  bits de permiso de modo esta activo para el
              fichero.

       -regex patr'on
              El nombre del fichero concuerda con la expresion regular patr'on.
              Esta  concordancia  es  en el camino entero, no es una busqueda.
              Por ejemplo, para  un  fichero  llamado  `./fubar3',  Ud.  puede
              emplear  la  expresion  regular  `.*bar.'  or  `.*b.*3',  mas no
              `b.*r3'.

       -size n[bckw]
              El fichero emplea n  unidades  de  espacio.   Las  unidades  son
              bloques  de  512 bytes si no se dice otra cosa o si la letra `b'
              sigue a n, bloques de bytes si se pone la letra  `c',  kilobytes
              con  la  `k',  o  palabras  de  2 bytes con la `w'. El tamano no
              cuenta bloques indirectos, pero si cuenta  bloques  en  ficheros
              esparcidos que no estan realmente asignados.

       -true  Siempre da verdadero.

       -type c
              El fichero es de tipo c:

              b      especial de bloques (tamponado)

              c      especial de caracteres (sin tamponar)

              d      directorio

              p      tuberia con nombre (FIFO)

              f      fichero regular

              l      enlace simbolico

              s      zocalo (socket)

       -uid n El UID numerico del propietario del fichero es n.

       -used n
              Se  accedio  por  ultima vez al fichero n dias despues de que se
              cambio por ultima vez su estado.

       -user usuario
              El propietario del fichero es el usuario usuario (se permite  un
              UID numerico).

       -xtype c
              Lo  mismo  que  -type  a  menos  que  el  fichero  sea un enlace
              simbolico. Para enlaces simbolicos: si no se  ha  dado  -follow,
              verdad si el fichero es un enlace a un fichero de tipo c; si no,
              verdad si c es `l'. En otras palabras, para enlaces  simbolicos,
              -xtype comprueba el tipo del fichero que -type no comprueba.

   ACCIONES
       -exec orden ;
              Ejecuta  orden;  verdad  si  se  devuelve el status 0. Todos los
              argumentos que siguen a find se toman como de la orden hasta que
              se encuentre uno consistente en `;'. La cadena `{}' se reemplaza
              por el nombre del fichero que se esta procesando;  en  cualquier
              sitio de los argumentos de la orden, no solo en argumentos donde
              este sola, como en  algunas  otras  versiones  de  find.   Ambas
              construcciones  pueden  necesitar  `escaparse'  (con  una `\') o
              entrecomillarse, para protegerlas de la expansion que efectuaria
              el shell. La orden se ejecuta en el directorio de comienzo.

       -fls fichero
              Verdad; como -ls pero escribe en fichero como -fprint.

       -fprint fichero
              Verdad;  escribe  el  nombre completo del fichero en fichero. Si
              fichero no existe cuando se ejecuta find, se crea; si existe, se
              trunca.    Los    nombres    de   ficheros   ``/dev/stdout''   y
              ``/dev/stderr'' se manejan de manera especial; se refieren a  la
              salida    estandar    y   la   salida   estandar   de   errores,
              respectivamente.

       -fprint0 fichero
              Verdad; como -print0 pero escribe en fichero como -fprint.

       -fprintf fichero formato
              Verdad; como -printf pero escribe en fichero como -fprint.

       -ok orden ;
              Como -exec pero pregunta  primero  al  usuario  (en  la  entrada
              estandar);  si  la respuesta no comienza con `y' o `Y' (o quizas
              el equivalente local, en espanol `s' o `S'), no  se  ejecuta  la
              orden, y devuelve falso.

       -print Verdad;  imprime  el  nombre  completo  del fichero en la salida
              estandar, seguido por un salto de linea.

       -print0
              Verdad; imprime el nombre completo  del  fichero  en  la  salida
              estandar, seguido por un caracter nulo. Esto permite que nombres
              de ficheros que contengan saltos  de  linea  sean  correctamente
              interpretados por programas que procesen la salida de find.

       -printf formato
              Verdad;  imprime  formato  en  la salida estandar, interpretando
              secuencias de escape `\' y directivas `%'. Las anchuras de campo
              y  precisiones  pueden  especificarse  como  en  la funcion de C
              `printf'. De forma contraria a lo que hace  -print,  -printf  no
              anade un salto de linea al final de la cadena. Las secuencias de
              escape y directivas son:

              \a     La campana de alarma.

              \b     Espacio atras.

              \c     Para la impresion de este formato inmediatamente y vuelca
                     el bufer de salida.

              \f     Salto de pagina.

              \n     Salto de linea.

              \r     Retorno de carro.

              \t     Tabulador horizontal.

              \v     Tabulador vertical.

              \\     Una barra inclinada inversa literal (`\').

              Un  caracter  `\'  seguido  por  otro cualquiera distinto de los
              anteriores se trata como un caracter ordinario, por  lo  que  se
              imprimiran ambos.

              %%     Un signo de porcentaje literal `%'.

              %a     El  tiempo  de  ultimo  acceso  al  fichero en el formato
                     devuelto por la funcion de C `ctime()'.

              %Ak    El tiempo de ultimo  acceso  al  fichero  en  el  formato
                     especificado  por  k,  que  es  o  bien  `@'  o  bien una
                     directiva valida para la funcion de C  `strftime()'.  Los
                     valores posibles para k se listan abajo; algunos de ellos
                     pueden no estar disponibles en todos los sistemas, debido
                     a diferencias en la funcion `strftime()' entre sistemas.

                     @      segundos desde el 1 de Enero de 1970 a las 00:00 h
                            GMT.

                     Campos de tiempo:

                     H      hora (00..23)

                     I      hora (01..12)

                     k      hora ( 0..23)

                     l      hora ( 1..12)

                     M      minuto (00..59)

                     p      AM o PM, en su representacion local

                     r      hora, formato de 12 horas (hh:mm:ss [AP]M)

                     S      segundo (00..61)

                     T      tiempo, formato de 24 horas (hh:mm:ss)

                     X      representacion local de la hora (H:M:S)

                     Z      zona horaria  (e.g.,  CET),  o  nada  si  el  huso
                            horario no es determinable

                     Campos de fecha:

                     a      nombre  local  abreviado  del  dia  de  la  semana
                            (Dom..Sab)

                     A      nombre  local  completo  del  dia  de  la  semana,
                            longitud variable (Domingo..Sabado)

                     b      nombre local abreviado del mes (Ene..Dic)

                     B      nombre  local  completo del mes, longitud variable
                            (Enero..Diciembre)

                     c      fecha y hora en representacion local  (Sab  4  Nov
                            12:02:33 CET 1989)

                     d      dia del mes (01..31)

                     D      fecha (mm/dd/aa)

                     h      lo mismo que b

                     j      dia del ano (juliano) (001..366)

                     m      mes numerico (01..12)

                     U      numero  de  la  semana del ano con el Domingo como
                            primer dia de la semana (00..53)

                     w      dia de la semana, numerico (0..6)

                     W      numero de la semana del ano como el Lunes como  el
                            primer dia de la semana (00..53)

                     x      representacion local de la fecha (dd/mm/aa)

                     y      los ultimos dos digitos del ano (00..99)

                     Y      ano (1970...)

              %b     El   tamano   del   fichero   en  bloques  de  512  bytes
                     (redondeado)

              %c     El tiempo del ultimo cambio del estado del fichero en  el
                     formato devuelto por la funcion de C `ctime()'.

              %Ck    El  tiempo del ultimo cambio del estado del fichero en el
                     formato especificado por k, que es el mismo que para %A.

              %d     La profundidad en el arbol del  directorio;  0  significa
                     que el fichero es un argumento de la linea de ordenes.

              %f     El nombre del fichero sin los directorios (solo el ultimo
                     elemento del camino).

              %F     Tipo del sistema de ficheros donde esta el fichero;  este
                     valor puede emplearse para -fstype.

              %g     El  nombre de grupo al que pertenece el fichero, o el GID
                     numerico si el grupo no tiene nombre.

              %G     El GID numerico del grupo al que pertenece el fichero.

              %h     Los  directorios  del  camino  del  fichero  (todos   los
                     componentes del camino menos el ultimo elemento).

              %H     Argumento  de  la  linea  de  ordenes  bajo  el que se ha
                     encontrado el fichero.

              %i     El numero-i del fichero (en base 10).

              %k     El tamano del fichero en bloques de un kB (redondeado).

              %l     El objeto de un enlace simbolico (la cadena vacia  si  el
                     fichero no es un enlace simbolico).

              %m     Los bits de permiso del fichero (en octal).

              %n     El numero de enlaces duros del fichero.

              %p     El nombre del fichero.

              %P     El  nombre  del fichero con el nombre del argumento de la
                     linea de ordenes bajo el que se ha encontrado, quitado.

              %s     El tamano del fichero en bytes.

              %t     El tiempo  de  ultima  modificacion  del  fichero  en  el
                     formato devuelto por la funcion de C `ctime()'.

              %Tk    El  tiempo  de  ultima  modificacion  del  fichero  en el
                     formato especificado por k, que es el mismo que para %A.

              %u     El nombre del usuario propietario del fichero, o  el  UID
                     si el usuario no tiene nombre.

              %U     El UID numerico del propietario del fichero.

              Un  caracter  `%'  seguido  por  cualquier  otro distinto de los
              recien mencionados no es tenido en cuenta (pero el otro caracter
              se imprime).

       -prune Si  -depth  no  se  da,  devuelve  verdad;  no  desciende por el
              directorio en curso.
              Si -depth se da, devuelve falso; no tiene otro efecto.

       -ls    Verdad; lista el fichero actual en el formato de `ls  -dils'  en
              la  salida  estandar. Los numeros de bloques son en bloques de 1
              kB, a menos que la variable  de  ambiente  POSIXLY_CORRECT  este
              definida, en cuyo caso los bloques son de 512 B.

   OPERADORES
       Listados en orden de precedencia decreciente:

       ( expr )
              Fuerza la precedencia.

       ! expr Verdad si expr es falsa.

       -not expr
              Lo mismo que ! expr.

       expr1 expr2
              Y (implicito); expr2 no se evalua si expr1 es falsa.

       expr1 -a expr2
              Lo mismo que expr1 expr2.

       expr1 -and expr2
              Lo mismo que expr1 expr2.

       expr1 -o expr2
              O; expr2 no se evalua si expr1 es verdad.

       expr1 -or expr2
              Lo mismo que expr1 -o expr2.

       expr1 , expr2
              Lista; expr1 y expr2 son, ambos, evaluados siempre.  El valor de
              expr1 se descarta; el valor de la lista es el de expr2.

V'EASE TAMBI'EN

       locate(1L),  locatedb(5L),  updatedb(1L),   xargs(1L)   Finding   Files
       (``Buscando Ficheros''; en interactivo con Info, o impreso en papel).

                                                                      FIND(1L)