TAR(1) Manual de GNU TAR TAR(1) NOMBRE tar: una utilidad de archivado SINOPSIS Uso tipico tar {A|c|d|r|t|u|x}[GnSkUWOmpsMBiajJzZhPlRvwo] [ARG...] Uso al estilo UNIX tar -A [OPCIONES] -f ARCHIVO ARCHIVO... tar -c [-f ARCHIVO] [OPCIONES] [FICHERO...] tar -d [-f ARCHIVO] [OPCIONES] [FICHERO...] tar -r [-f ARCHIVO] [OPCIONES] [FICHERO...] tar -t [-f ARCHIVO] [OPCIONES] [MIEMBRO...] tar -u [-f ARCHIVO] [OPCIONES] [FICHERO...] tar -x [-f ARCHIVO] [OPCIONES] [MIEMBRO...] Uso al estilo GNU tar {--catenate|--concatenate} [OPCIONES] --file ARCHIVO ARCHIVO... tar --create [--file ARCHIVO] [OPCIONES] [FICHERO...] tar {--diff|--compare} [--file ARCHIVO] [OPCIONES] [FICHERO...] tar --delete [--file ARCHIVO] [OPCIONES] [MIEMBRO...] tar --append [--file ARCHIVO] [OPCIONES] [ARCHIVO...] tar --lista [--archivo ARCHIVO] [OPCIONES] [MIEMBRO...] tar --test-label [--file ARCHIVO] [OPCIONES] [ETIQUETA...] tar --update [--file ARCHIVO] [OPCIONES] [FICHERO...] tar {--extract|--get} [--file ARCHIVO] [OPCIONES] [MIEMBRO...] NOTA Esta pagina de manual es una breve descripcion de GNU tar. Si desea informacion mas detallada, incluidos ejemplos y recomendaciones de uso, consulte el GNU Tar Manual disponible en formato texinfo. Si el lector info y la documentacion tar estan instalados correctamente en su sistema, la orden info tar deberia mostrarle el manual completo. Tambien puede ver el manual usando el modo de informacion en emacs(1), o encontrarlo en varios formatos en internet en https://www.gnu.org/software/tar/manual Si existiesen discrepancias entre esta pagina de manual y el GNU Tar Manual, este ultimo se considerara la fuente autorizada. DESCRIPCION GNU tar es un programa de archivado disenado para almacenamiento de multiples archivos en un solo archivo (un archive) asi como su manipulacion. El archivo puede ser un archivo normal o un dispositivo (por ejemplo, una unidad de cinta, de ahi el nombre del programa, que viene de 'tape archiver', que puede ubicarse en el propio equipo o en un equipo remoto. Estilos de opciones Las opciones para GNU tar se pueden ofrecer en tres estilos diferentes. En estilo tradicional, el primer argumento es un grupo de letras de opciones, todos los argumentos posteriores proporcionan argumentos a aquellas opciones que los requieren. Los argumentos se leen en el mismo orden que las letras de las opciones. Cualquier palabra de la linea de ordenes que quede despues de que se hayan procesado todas las opciones se trata como archivos o nombres de miembros del archivo. Por ejemplo, la opcion c requiere la creacion del archivo, la opcion v mostrara la salida mas detallada y la opcion f establece el nombre del archivo sobre el que operar. La siguiente orden en el estilo tradicional, le indica a tar que almacene todos los archivos del directorio /etc en el archivo etc.tar, enumerando detalladamente los archivos que se estan archivando: tar cfv etc.tar /etc En UNIX o estilo de opcion corta, cada letra de opcion tiene como prefijo un solo guion, como en otras utilidades de linea de ordenes. Si una opcion toma un argumento, el argumento le sigue, ya sea como una palabra de linea de ordenes separada o inmediatamente despues de la opcion. Sin embargo, si la opcion toma un argumento opcional, el argumento debe seguir a la letra de la opcion sin ningun espacio en blanco intermedio, como en -g/tmp/snar.db. Cualquier cantidad de opciones que no tomen argumentos se pueden agrupar despues de un solo guion, p. -vkp. Una opcion que toma un argumento (ya sea obligatorio u opcional) puede aparecer al final de dicho grupo como por ejemplo -vkpf a.tar. La orden de ejemplo anterior escrito en estilo de opcion corta podria verse asi: tar -cvf etc.tar /etc o tar -c -v -f etc.tar /etc En GNU o estilo de opcion larga, cada opcion comienza con dos guiones y tiene un nombre significativo, que consta de letras minusculas y guiones. Cuando se utiliza, la opcion larga se puede abreviar a sus letras iniciales, siempre que no resulte ambiguo. Los argumentos para las opciones largas se proporcionan como una palabra separada, inmediatamente despues de la opcion, o separados de la opcion por un signo igual sin espacios en blanco intermedios. Los argumentos opcionales siempre deben utilizar este el ultimo metodo. A continuacion se muestran varias formas de escribir la orden de ejemplo en este estilo: tar --create --file etc.tar --verbose /etc o (abreviando algunas opciones): tar --cre --file=etc.tar --verb /etc Las opciones de los tres estilos se pueden mezclar, aunque no se recomienda hacerlo con opciones antiguas. Modo de operacion Las opciones enumeradas en la siguiente tabla le indican a GNU tar que operacion debe realizar. Se debe dar exactamente una de ellas. El significado de los argumentos que no son opciones depende del modo de operacion solicitado. -A, --catenate, --concatenate Agrega archivos al final de otro archivo. Los argumentos se consideran los nombres de los archivos que se van a adjuntar. Todos los archivos deben tener el mismo formato que el archivo al que estan adjuntos; de lo contrario, el archivo resultante podria no poder utilizarse con implementaciones de tar distintas de GNU. Observe que si se proporciona mas de un archivo, los miembros de archivos distintos del primero seran accesibles en el archivo resultante solo cuando se use la opcion -i (--ignore-zeros). Los archivos comprimidos no se pueden concatenar. -c, --create Crea un nuevo archivo. Los argumentos proporcionan los nombres de los archivos que se van a archivar. Los directorios se archivan de forma recursiva, salvo que se proporcione la opcion --no-recursion. -d, --diff, --compare Encuentra diferencias entre archivo y sistema de archivos. Los argumentos son opcionales y definen los miembros del archivo para comparar. Si no se indica, se asume el directorio de trabajo actual. --delete Elimina del archivo. Los argumentos proporcionan los nombres de los miembros del archivo que se eliminaran. Se debe dar al menos un argumento. Esta opcion no funciona con archivos comprimidos. No existe un equivalente de opcion corta. -r, --append Agrega archivos al final de un archivo. Los argumentos tienen el mismo significado que para -c (--create). -t, --list Enumera el contenido de un archivo. Los argumentos son opcionales, si se proporcionan, definiran los nombres de los miembros a enumerar. --test-label Prueba la etiqueta del volumen de archivo y finaliza. Cuando se usa sin argumentos, muestra la etiqueta del volumen (si la hay) y sale con el estado 0. Si se indican uno o mas argumentos, tar compara la etiqueta del volumen con cada argumento. Sale con el codigo 0 si se encuentra una coincidencia y con el codigo 1 en caso contrario. No se muestra ninguna salida, a menos que se use junto con la opcion -v (--verbose). No existe una opcion corta equivalente para esta opcion. -u, --update Adjunta archivos que sean mas recientes que la copia presente en el archivo. Los argumentos tienen el mismo significado que las opciones -c y -r. Tenga en cuenta que los archivos mas recientes no reemplazan sus copias antiguas, sino que se agregan al final del archivo. Por tanto, el archivo resultante puede contener varios miembros con el mismo nombre, correspondientes a varias versiones del mismo archivo. -x, --extract, --get Extrae archivos de un archivo. Los argumentos son opcionales, definiran los nombres de los miembros del archivo que se extraeran. --show-defaults Muestra los valores predeterminados para varias opciones de tar y finaliza. -?, --help Muestra un breve resumen de opciones y finaliza. --usage Muestra una lista de opciones disponibles y finaliza. --version Muestra la version del programa, la informacion de derechos de autor y finaliza. OPCIONES Modificadores de operacion --check-device Comprueba los numeros de dispositivo cuando se crean archivos incrementales (por omision). -g, --listed-incremental=ARCHIVO Gestiona nuevas copias de seguridad incrementales en formato GNU. ARCHIVO es el nombre de un volcado instantaneo, tar gurardara informacion adicional para poder conocer que archivos cambiaron desde el volcado incremental anterior y que deberan volcarse nuevamente. Si no existiese ARCHIVO un archivo, se creara y todos los archivos se agregaran al archivo resultante (lo que seria un volcado de nivel 0). Para crear archivos incrementales de nivel N (distinto de cero), necesita una copia del archivo de volcado instantaneo creado para el nivel N-1 y designarlo como ARCHIVO. Al enumerar o extraer no se inspeccciona el contenido real de ARCHIVO. Solo es necesario por motivos tecnicos, por lo que suele emplearse /dev/null en su lugar. --hole-detection=METODO Utiliza METODO para detectar agujeros en archivos dispersos. Esta opcion implica --sparse. Los valores validos para METODO son seek y raw. Por defecto se considera seek y, si no es aplicable, se pasa a raw automaticamente. -G, --incremental Gestiona copias de seguridad incrementales antiguas en formato GNU. --ignore-failed-read No sale con estado distinto de cero (error) en el caso de encontrar ficheros que no pueda leer. --level=NUMERO Establece el nivel de volcado para un archivo incremental ya creado. Ahora mismo, solo tendria sentido --level=0: hace que corte la copia instantanea antes de volcarla, forzando un volcado de nivel 0. -n, --seek Asume que el archivo se puede buscar. Normalmente tar determina automaticamente si el archivo se puede buscar o no. Esta opcion esta pensada para su uso en casos en los que dicho reconocimiento falla. Tiene efecto solo si el archivo esta abierto para lectura (por ejemplo, con las opciones --list o --extract). --no-check-device No comprueba los numeros de dispositivo cuando se crean archivos incrementales. --no-seek Asume que el archivo no se puede buscar. --occurrence[=N] Procesa unicamente la N-esima aparicion de cada fichero en el archivo; esta opcion solamente es valida junto con una de las subordenes --delete, --diff, --extract o --list y cuando se da una lista de ficheros en la linea de ordenes o con la opcion -T; el valor predeterminado de N es 1. --restrict Desactiva el uso de algunas opciones de riesgo. --sparse-version=PRINCIPAL[.SECUNDARIO]] Establece que version del formato disperso usar. Esta opcion implica --sparse. Los valores de argumento validos son 0.0, 0.1 y 1.0. Para obtener informacion detallada sobre los formatos dispersos, consulte el GNU Tar Manual, apendice D, 'Sparse Formats'. Mediante la orden info, se puede acceder ejecutando: info tar 'Sparse Formats'. -S, --sparse Gestiona de manera eficiente archivos dispersos. Algunos archivos en el sistema de archivos pueden tener segmentos que en realidad nunca se escribieron (suele tratrse de archivos de bases de datos creados por sistemas como DBM). Cuando se le da esta opcion, tar intenta determinar si el archivo es disperso antes de archivarlo y, de ser asi, reducir el tamano del archivo resultante al no volcar partes vacias del archivo. Control de sobreescritura Estas opciones controlan las acciones de tar al extraer un archivo sobre una copia existente en el disco. -k, --keep-old-files No reemplaza ficheros que existan al extraer. --keep-newer-files No reemplaza los ficheros que existan que sean mas recientes que sus copias en el archivo. --keep-directory-symlink No reemplaza los enlaces simbolicos existentes a directorios al realizar la extraccion. --no-overwrite-dir Conserva los metadatos de los directorios que existan. --one-top-level[=DIR] Extrae todos los archivos en DIR o, si se usan sin argumentos, en un subdirectorio nombrado segun el nombre base del archivo (quitando los sufijos de compresion estandar reconocibles mediante --auto-compress). --overwrite Sobreescribe los ficheros que existan al extraer. --overwrite-dir Sobreescribe los metadatos de los directorios que existan al extraer (predeterminado). --recursive-unlink Elimina recursivamente todos los archivos del directorio antes de extraerlo. --remove-files Elimina archivos del disco despues de agregarlos al archivo. --skip-old-files No reemplaza ficheros que existan al extraer, se los salta silenciosamente. -U, --unlink-first Borra cada fichero antes de extraer sobre el. -W, --verify Verifica el archivo despues de escribirlo. Seleccion del flujo de salida --ignore-command-error Descarta los codigos de salida de los subprocesos. --no-ignore-command-error Trata los estados de salida distintos de cero de los subprocesos como errores (predeterminado). -O, --to-stdout Extrae los archivos a la salida estandar. --to-command=ORDEN Canaliza los archivos extraidos a ORDEN. El argumento es la ruta de acceso de un programa externo, opcionalmente con argumentos de linea de ordenes. Se invocara el programa y se le enviara el contenido del archivo que se esta extrayendo por su entrada estandar. Se proporcionaran datos adicionales a traves de las siguientes variables de entorno: TAR_FILETYPE Tipo de archivo. Es una sola letra con el siguiente significado: f Archivo regular d Directorio l Enlace simbolicos h Enlace duros b Dispositivo de bloque c Dispositivo de caracteres Actualmente solo se admiten archivos normales. TAR_MODE Modo de archivo, un numero octal. TAR_FILENAME El nombre del archivo. TAR_REALNAME Nombre del archivo almacenado en el archivo. TAR_UNAME Nombre del propietario del archivo. TAR_GNAME Nombre del grupo propietario del archivo. TAR_ATIME Hora del ultimo acceso. Es un numero decimal que representa los segundos desde el Inicio de Unix. Si el archivo proporciona horas con precision de nanosegundos, los nanosegundos se agregan a la marca de tiempo despues de un punto decimal. TAR_MTIME Hora de la ultima modificacion. TAR_CTIME Hora del ultimo cambio de estado. TAR_SIZE Tamano del archivo. TAR_UID UID del propietario del archivo. TAR_GID GID del propietario del archivo. Ademas, las siguientes variables contienen informacion sobre el modo de operacion de tar y el archivo que se esta procesando: TAR_VERSION El numero de version del programa GNU tar. TAR_ARCHIVE El nombre del archivo que tar esta procesando. TAR_BLOCKING_FACTOR Factor de bloqueo actual, es decir, numero de bloques de 512 bytes en un registro. TAR_VOLUME Numero del volumen que tar esta procesando (define si se lee un archivo de varios volumenes). TAR_FORMAT Formato del archivo que se esta procesando. Sera uno de entre de los siguientes: gnu, oldgnu, posix, ustar, v7. TAR_SUBCOMMAND Una opcion corta precedida por un guion, que describe la operacion que tar esta ejecutando. Manejo de los atributos del fichero --atime-preserve[=METODO] Conserva la hora de acceso en los archivos volcados, ya sea restaurando los tiempos despues de la lectura (METODO=replace, este es el valor predeterminado) o no configurando los tiempos en primer lugar (METODO=system). --delay-directory-restore Pospone la configuracion de la hora de modificacion y de los permisos de los directorios extraidos hasta el final de la extraccion. Utilice esta opcion al trabajar con un archivo que tiene un orden de miembros inusual. --group=NOMBRE[:GID] Fuerza NOMBRE como grupo para los archivos agregados. Si no se proporciona GID, NOMBRE puede ser un nombre de usuario o un GID numerico. En este caso, la parte que falta (GID o nombre) se inferira de la base de datos de grupos del equipo actual. Cuando se utiliza con --group-map=ARCHIVO, afectara solo a aquellos archivos cuyo grupo propietario no esta incluido en ARCHIVO. --group-map=FICHERO Toma el mapa de traduccion de grupos desde ARCHIVO. Las lineas vacias se ignoran. Los comentarios se introducen con el signo # y abarcan hasta el final de la linea. Cada linea no vacia en ARCHIVO define la traduccion para un solo grupo. Debe constar de dos campos, delimitados por un numero indeterminado de espacios en blanco: ANTIGUOGRP NUEVOGRP[:NUEVOGID] ANTIGUOGRP es un nombre de grupo valido o un GID con el prefijo +. Salvo que se proporcione NUEVOGID, NUEVOGRP tambien debe ser un nombre de grupo valido o un +GID. De lo contrario, no es necesario que NUEVOGRP ni NUEVOGID esten incluidos en la base de datos del grupo del sistema. Como resultado, cada archivo de entrada con el grupo propietario ANTIGUOGRP se almacenara en un archivo con el grupo propietario NUEVOGRP y el GID NUEVOGID. --mode=CAMBIOS Fuerza CAMBIOS (simbolicos) de modo para los ficheros que se anaden. --mtime=FECHA-O-ARCHIVO Establece mtime para los archivos agregados. FECHA-O-ARCHIVO puede ser una fecha/hora en un formato casi arbitrario o bien el nombre de un archivo existente. En este el ultimo caso, se utilizara el mtime de ese archivo. -m, --touch No extrae la fecha de modificacion del fichero. --no-delay-directory-restore Cancela el efecto de la opcion anterior --delay-directory-restore. --no-same-owner Extrae los ficheros como usted mismo (predeterminado para usuarios normales). --no-same-permissions Aplica el umask del usuario cuando se extraen permisos del archivo (predeterminado para usuarios normales). --numeric-owner Utiliza siempre numeros para los nombres de usuarios/grupos. --owner=NOMBRE[:UID] Fuerza la asignacion de NOMBRE como propietario de los archivos agregados. Si no se proporciona UID, NOMBRE puede ser un nombre de usuario o un UID numerico. En este caso, la parte que falta (UID o nombre) se inferira de la base de datos de usuarios del equipo actual. Cuando se utiliza con --owner-map=ARCHIVO, afecta solo a aquellos archivos cuyo propietario no esta incluido en ARCHIVO. --owner-map=ARCHIVO Lee el mapa de traduccion del propietario desde ARCHIVO. Las lineas vacias se ignoran. Los comentarios se introducen con el signo # y se extienden hasta el final de la linea. Cada linea no vacia en ARCHIVO definira la traduccion para un unico UID. Debe constar de dos campos, delimitados por una cantidad indeterminada de espacios en blanco: ANTIGUOUSR NUEVOUSR[:NUEVOUID] ANTIGUOUSR es un nombre de usuario valido o un UID con el prefijo +. Salvo que se indique NUEVOUID, NUEVOUSR tambien debe ser un nombre de usuario valido o un +UID. De lo contrario, no es necesario que ni NUEVOUSR ni NUEVOUID esten incluidos en la base de datos de usuarios del sistema. Finalmente, cada archivo de entrada propiedad de ANTIGUOUSR se almacenara en un archivo con el nombre de propietario NUEVOUSR y el UID NUEVOUID. -p, --preserve-permissions, --same-permissions Establece los permisos de los archivos extraidos en los registrados en el archivo (predeterminado para el administrador). --same-owner Intenta extraer los ficheros con el mismo propietario que existe en el archivo (predeterminado para el superusuario). -s, --preserve-order, --same-order Indica a tar que la lista de nombres de archivos a procesar se ordena en el mismo orden que los archivos en el archivo. --sort=ORDENACION Al crear un archivo, ordena las entradas del directorio segun ORDENACION, que sera uno de los siguientes: none, name o inode. El valor por defecto es --sort=none, almacenara los miembros del archivo en el mismo orden en que los devuelve el sistema operativo. El uso de --sort=name garantiza que el orden de los miembros en el archivo creado sea uniforme y reproducible. El uso de --sort=inode reduce la cantidad de busquedas en el disco que se realizan al crear el archivo y, por lo tanto, puede acelerar considerablemente el archivado. Este orden de clasificacion solo se admite si el sistema proporciona la informacion necesaria. Atributos extendidos del fichero --acls Activa el soporte de ACLs de POSIX. --no-acls Desactiva el soporte de ACLs de POSIX. --selinux Activa el soporte de contextos SELinux. --no-selinux Desactiva el soporte de contextos SELinux. --xattrs Activa el soporte de los atributos extendidos. --no-xattrs Desactiva el soporte de atributos extendidos. --xattrs-exclude=PATRON Define el patron de exclusion para las claves xattr. PATRON es un patron global, por ejemplo, --xattrs-exclude='user.*' para incluir solo atributos del espacio de nombres de usuario. --xattrs-include=PATRON Especifica el patron de inclusion para las claves xattr. PATRON es un patron global. Seleccion de dispositivo y opciones -f, --file=ARCHIVO Utiliza el archivo o dispositivo ARCHIVO. Si no se proporciona esta opcion, tar examinara primero la variable de entorno `TAPE', si esta establecida, su valor se utilizara como nombre del archivo. De lo contrario, tar asumira el valor predeterminado con el que fue compilado. Puede conocer dicho valor predeterminado mediante la opcion --show-defaults o al final de la salida tar --help. Un nombre de archivo con dos puntos definira un archivo o dispositivo en un equipo remoto. La parte antes de los dos puntos se toma como el nombre del equipo o la direccion IP, y la parte despues de ellos como la ruta del archivo o dispositivo, por ejemplo: --file=remotehost:/dev/sr0 Se puede anteponer un nombre de usuario opcional al nombre de host, colocando un signo @ entre ellos. De forma predeterminada, se accedera al equipo remoto mediante la orden rsh(1), aunque actualmente suele emplearse ssh(1) en su lugar. Puede hacerlo mediante la siguiente opcion: --rsh-command=/usr/bin/ssh El equipo remoto debe tener instalada la orden rmt(8). Si su nombre de ruta no coincide con el predeterminado en tar, puede definirlo mediante la opcion --rmt-command. --force-local El archivo es local incluso si tiene dos puntos. -F, --info-script=ORDEN, --new-volume-script=ORDEN Ejecute ORDEN al final de cada cinta (implica -M). La orden puede incluir argumentos. Cuando se inicie, heredara el entorno de tar mas las siguientes variables: TAR_VERSION El numero de version del programa GNU tar. TAR_ARCHIVE El nombre del archivo que tar esta procesando. TAR_BLOCKING_FACTOR Factor de bloqueo actual, es decir, numero de bloques de 512 bytes en un registro. TAR_VOLUME Numero del volumen que tar esta procesando (define si se lee un archivo de varios volumenes). TAR_FORMAT Formato del archivo que se esta procesando. Sera uno de entre de los siguientes: gnu, oldgnu, posix, ustar, v7. TAR_SUBCOMMAND Una opcion corta precedida por un guion, que describe la operacion que tar esta ejecutando. TAR_FD Descriptor de archivo que se puede emplearse para comunicar el nuevo nombre del volumen a tar. Si falla el script de informacion, tar finaliza; sino comienza a escribir el siguiente volumen. -L, --tape-length=N Cambia la cinta despues de escribir Nx1024 bytes. Si N va seguido de un sufijo de tamano (consulte la subseccion Sufijos de tamano a continuacion), este definira el factor multiplicativo que se utilizara en lugar de 1024. Esta opcion implica -M. -M, --multi-volume Crea/lista/extrae un archivo multi-volumen. --rmt-command=ORDEN Utiliza ORDEN en lugar de rmt cuando acceda a archivos remotos. Consulte la descripcion de la opcion -f dada anteriormente. --rsh-command=ORDEN Utiliza ORDEN en lugar de rsh cuando acceda a archivos remotos. Consulte la descripcion de la opcion -f dada anteriormente. --volno-file=ARCHIVO Cuando esta opcion se utiliza junto con --multi-volume, tar realizara seguimiento de en que volumen de un archivo de varios volumenes esta trabajando ARCHIVO. Bloques en los dispositivos -b, --blocking-factor=BLOQUES Establece el tamano del registro en BLOCKSx512 bytes. -B, --read-full-records Al enumerar o extraer, acepta registros de entrada incompletos despues del marcador de fin de archivo. -i, --ignore-zeros Ignora los bloques puestos a cero en el archivo. Normalmente, dos bloques 512 consecutivos llenos de ceros se consideran un (fin de archivo) EOF, por lo que tar dejaria de leer despues de encontrarlos. Esto es util al leer archivos creados con la opcion -A. --record-size=NUMERO Establece el tamano de registro. NUMERO es el numero de bytes por registro. Debe ser multiplo de 512. Puede tener el sufijo sufijo de tamano, p. --record-size=10K para 10 Kilobytes. Consulte la subseccion Sufijos de tamano para obtener una lista de sufijos validos. Seleccion del formato de archivo -H, --format=FORMATO Crea el archivo en el formato dado. Los formatos validos son: gnu formato GNU tar 1.13.x oldgnu Formato GNU de tar <= 1.12. pax, posix Formato POSIX 1003.1-2001 (pax). ustar Formato POSIX 1003.1-1988 (ustar). v7 Formato tar V7 antiguo. --old-archive, --portability Igual que --format=v7. --pax-option=palabraclave[[:]=valor][,palabraclave[[:]=valor]]... Controla las palabras clave de pax al crear archivos PAX (-H pax). Esta opcion es equivalente a la opcion -o de la aplicacion pax(1). --posix Igual que --format=posix. -V, --label=TEXTO Crea un archivo con nombre de volumen TEXTO; en el momento de listar/extraer, utiliza TEXTO como patron expandible para el nombre del volumen. Opciones de compresion -a, --auto-compress Utiliza el sufijo del archivo para determinar el programa de compresion. -I, --use-compress-program=ORDEN Filtra datos mediante ORDEN. Debe aceptar la opcion -d, para descompresion. El argumento puede contener opciones de linea de ordenes. -j, --bzip2 Filtra el archivo a traves de bzip2(1). -J, --xz Filtra el archivo a traves de xz(1). --lzip Filtra el archivo a traves de lzip(1). --lzma Filtra el archivo a traves de lzma(1). --lzop Filtra el archivo a traves de lzop(1). --no-auto-compress No utiliza el sufijo del archivo para determinar el programa de compresion. -z, --gzip, --gunzip, --ungzip Filtra el archivo a traves de gzip(1). -Z, --compress, --uncompress Filtra el archivo a traves de compress(1). --zstd Filtra el archivo a traves de zstd(1). Seleccion del fichero local --add-file=FICHERO Anade el FICHERO dado al archivo (util si su nombre comienza con un guion). --backup[=CONTROL] Copia de seguridad antes de la eliminacion. El argumento CONTROL, si se indica, controla el modo en que se realiza la copia de seguridad. Sus valores validos son: none, off Nunca realiza copias de seguridad. t, numbered Crea copias de seguridad numeradas. nil, existing Numeradas si existen copias de seguridad numeradas, simples en caso contrario. never, simple Siempre crea copias de seguridad simples Si no se proporciona CONTROL, el valor se toma de la variable de entorno VERSION_CONTROL. Si no se establece, se supondra existing. -C, --directory=DIR Se situa en DIR antes de realizar cualquier operacion. Esta opcion afecta al orden, es decir, afecta a todas las opciones siguientes. --exclude=PATRON Excluye archivos que coincidan con PATRON, un patron comodin de estilo glob(3). --exclude-backups Excluye los ficheros de respaldo y de bloqueo. --exclude-caches Excluye el contenido de los directorios que contienen CACHEDIR.TAG, excepto por el propio fichero CACHEDIR.TAG. --exclude-caches-all Excluye los directorios que contienen el archivo CACHEDIR.TAG y el propio archivo. --exclude-caches-under Excluye todo bajo los directorios que contienen CACHEDIR.TAG --exclude-ignore=FICHERO Antes de volcar un directorio, comprueba si contiene ARCHIVO. Si es asi, tomara los patrones de exclusion de dicho archivo. Los patrones afectan solo al directorio en si. --exclude-ignore-recursive=FICHERO Igual que --exclude-ignore, excepto que los patrones de ARCHIVO afectan tanto al directorio como a todos sus subdirectorios. --exclude-tag=FICHERO Excluye el contenido de los directorios que contengan FICHERO, excepto el propio FICHERO. --exclude-tag-all=FICHERO Excluye los directorios que contienen FICHERO. --exclude-tag-under=FICHERO Excluye todo bajo los directorios que contienen FICHERO. --exclude-vcs Excluye los directorios de sistemas de control de versiones. --exclude-vcs-ignores Excluye archivos que coincidan con patrones leidos de archivos ignore especificos de algun VCS. Los archivos admitidos son: .cvsignore, .gitignore, .bzrignore y .hgignore. -h, --dereference Sigue los enlaces simbolicos; archiva y vuelca los ficheros a los que apuntan. --hard-dereference Sigue los enlaces duros; archiva y vuelca los ficheros a los que se refieren. -K, --starting-file=MIEMBRO Comienza en el miembro indicado en el archivo. --newer-mtime=FECHA Trabaja en archivos cuyos datos cambiaron despues de la FECHA. Si DATE comienza con / o . se considera un nombre de archivo y se usara el mtime de ese archivo como fecha. --no-null Desactiva el efecto de la opcion --null anterior. --no-recursion Evita descender automaticamente en los directorios. --no-unquote No quita las comillas de los nombres de ficheros de entrada o de miembros. --no-verbatim-files-from Trata cada linea leida de una lista de archivos como si se hubiera proporcionado en la linea de ordenes. Es decir, eliminara los espacios en blanco iniciales y finales y, si la cadena resultante comienza con un guion, se tratara como una opcion de tar. Este es el comportamiento predeterminado. La opcion --no-verbatim-files-from se proporciona como una forma de restaurarlo despues de la opcion --verbatim-files-from. Esta opcion es posicional: afecta a todas las opciones --files-from que se indiquen despues de ella y hasta la opcion --verbatim-files-from o el final de la linea, lo que ocurra primero. Esta implicito en la opcion --no-null. --null Indica a las opciones -T posteriores que lean palabra por palabra los nombres terminados en null (deshabilita el manejo especial de nombres que comienzan con un guion). Vease tambien --verbatim-files-from. -N, --newer=FECHA, --after-date=FECHA Almacena solo archivos posteriores a la FECHA. Si FECHA comienza con / o . se considera un nombre de archivo y se usa su mtime como fecha. --one-file-system Se queda en un sistema de ficheros local cuando crea un archivo. -P, --absolute-names No elimina las barras iniciales de los nombres de los archivos al crear archivos. --recursion Opera recursivamente sobre los directorios (por omision). --suffix=CADENA Se hace un respaldo antes de borrar, cambiando el sufijo usual (~ a menos que se cambie con la variable de entorno SIMPLE_BACKUP_SUFFIX). -T, --files-from=FICHERO Obtiene los nombres a extraer o crear del FICHERO. Salvo que se indique lo contrario, ARCHIVO debe contener una lista de nombres separados por ASCII LF (es decir, un nombre por cada linea). Los nombres leidos se manejan de la misma manera que los argumentos de la linea de ordenes. Se someten a eliminacion de comillas y division de palabras, y cualquier cadena que comience con - se maneja como opcion de linea de ordenes para tar. Si este comportamiento no es el deseado, se puede desactivar mediante la opcion --verbatim-files-from. La opcion --null indica a tar que los nombres en ARCHIVO esten separados por el caracter ASCII NUL, en lugar de LF. Es util si la lista se ha generado mediante la orden find(1) -print0. --unquote Quita las comillas de los nombres de ficheros de entrada o de miembros (predeterminado). --verbatim-files-from Trata cada linea obtenida de una lista de archivos como un nombre de archivo, incluso si comienza con un guion. Las listas de archivos se indican mediante la opcion --files-from (-T). Por defecto, se gestionan los nombres proporcionados en las listas de archivos como si se hubieran escrito directamente en la linea de ordenes, es decir, cualquier nombre que comience con un guion se trata como opciones para tar. La opcion --verbatim-files-from desactiva este comportamiento. Esta opcion afecta a todas las opciones --files-from que aparecen con posterioridad en la linea de ordenes. Su efecto se revierte con la opcion --no-verbatim-files-from. Esta opcion esta implicita en la opcion --null. Vease tambien --add-file. -X, --exclude-from=ARCHIVO Excluye archivos que coincidan con los patrones indicados en ARCHIVO. Transformaciones de los nombres de ficheros --strip-components=NUMERO Elimina NUMERO componentes iniciales de los nombres de ficheros al extraer. --transform=EXPRESION, --xform=EXPRESION Utiliza la EXPRESION de reemplazo sed para transformar los nombres de ficheros. Opciones de coincidencia para nombres de fichero Estas opciones afectan a los patrones de exclusion y de inclusion. --anchored Los patrones encajan con el comienzo del nombre del fichero. --ignore-case No distingue mayusculas de minusculas. --no-anchored Los patrones encajan despues de cualquier / (por omision para exclusion). --no-ignore-case Distingue mayusculas de minusculas (por omision). --no-wildcards Coincidencia de cadenas verbatim. --no-wildcards-match-slash Los comodines no encajan con /. --wildcards Utiliza comodines (predeterminado para exclusion). --wildcards-match-slash Los comodines encajan con / (por omision para exclusion). Salida informativa --checkpoint[=N] Muestra mensajes de progreso cada N-esimo registro (por omision 10). --checkpoint-action=ACCION Ejecuta ACCION en cada punto de comprobacion. --clamp-mtime Solo establece la hora cuando el archivo es mas reciente que el que se indico mediante la opcion --mtime. --full-time Muestra la fecha del fichero con la maxima resolucion. --index-file=FICHERO Envia la salida detallada a FICHERO. -l, --check-links Muestra un mensaje si no se vuelcan todos los enlaces. --no-quote-chars=CADENA No entrecomilla los caracteres de CADENA. --quote-chars=CADENA Tambien entrecomilla los caracteres de CADENA. --quoting-style=ESTILO Establece el estilo de comillas para los nombres de archivos y miembros. Los valores validos para ESTILO son literal, shell, shell-always, c, c-maybe, escape, locale y clocale. -R, --block-number Muestra el numero de bloque dentro del archivo con cada mensaje. --show-omitted-dirs Cuando se lista o extrae, lista cada directorio que no coincida con el criterio de busqueda. --show-transformed-names, --show-stored-names Muestra los nombres de archivos o archivos comprimidos despues de la transformacion sufrida mediante las opciones --strip y --transform. --totals[=SENAL] Muestra el total de bytes despues de procesar el archivo. Si se indica SENAL, mostrara el total de bytes cuando se entregue dicha senal. Las senales permitidas son: SIGHUP, SIGQUIT, SIGINT, SIGUSR1 y SIGUSR2. Se puede omitir el prefijo SIG. --utc Muestra las fechas/horas de modificacion de los ficheros en UTC. -v, --verbose Enumera con detalle los archivos procesados. Cuantas mas veces se indique esta opcion, mas aumenta el nivel de detalle, hasta un nivel maximo de 3. Si desea informacion mas detallada de como los distintos niveles de detalle afectan la salida de tar, consulte GNU Tar Manual, subseccion 2.5.2 'The '--verbose' Option'. --warning=PALABRACLAVE Habilita o deshabilita los mensajes de advertencia identificados mediante PALABRACLAVE. Los mensajes se suprimen si PALABRACLAVE tiene el prefijo no- y se habilita en caso contrario. Se acumulan varias opciones --warning. Palabras clave que controlan la operacion general de tar: all Habilita todos los mensajes de advertencia. Este es el valor predeterminado. none Desactiva todos los mensajes de advertencia. filename-with-nuls "%s: el nombre de fichero leido contiene el caracter nul" alone-zero-block "Un bloque de ceros aislado en %s" Palabras clave aplicables para tar --create: cachedir "%s: contiene una marca de directorio cache %s; %s" file-shrank "%s: El tamano del fichero ha disminuido en %s byte, se rellena con ceros" xdev "%s: el fichero esta en un sistema de ficheros distinto; no se vuelca" file-ignored "%s: Tipo de fichero desconocido; no se tendra en cuenta" "%s: el `socket' no se tendra en cuenta" "%s: no se tendra en cuenta la puerta" file-unchanged "%s: el fichero no ha cambiado; no se vuelca" ignore-archive "%s: el archivo no puede contenerse a si mismo; no volcado" file-removed "%s: El fichero fue borrado antes de leerlo" file-changed "%s: el fichero cambio mientras se estaba leyendo" failed-read Elimina las advertencias sobre archivos o directorios ilegibles. Esta palabra clave se aplica solo si se usa junto con la opcion --ignore-failed-read. Palabras clave aplicables para tar --extract: existing-file "%s: se salta un fichero que existe" timestamp "%s: marca de fecha sospechosamente antigua %s" "%s: la marca de tiempo %s esta %s s en el futuro" contiguous-cast "Extrayendo ficheros contiguos como ficheros regulares" symlink-cast "Intentando la extraccion de enlaces simbolicos como enlaces duros" unknown-cast "%s: Tipo de fichero '%c' desconocido, se extrae como fichero normal" ignore-newer "El %s actual es mas reciente o de la misma fecha" unknown-keyword "Se desestima la palabra clave de la cabecera extendida desconocida '%s'" decompress-program Controla la descripcion detallada de los fallos que se producen al intentar ejecutar otros programas descompresores. Esta advertencia esta deshabilitada de forma predeterminada (a menos que se use --verbose). Un ejemplo tipico de lo que puede verse al utilizar esta advertencia seria: $ tar --warning=decompress-program -x -f archive.Z tar (child): cannot run compress: No such file or directory tar (child): trying gzip Esto indica que tar primero intento descomprimir archive.Z usando compress y, al fallar este, se uso gzip. record-size "Tamano de registro = %lu bloques" Palabras clave que controlan la extraccion incremental: rename-directory "%s: El directorio ha sido renombrado desde %s" "%s: El directorio ha sido renombrado" new-directory "%s: El directorio es nuevo" xdev "%s: el directorio esta en un dispositivo distinto: no se purga" bad-dumpdir "Dumpdir erroneo: no se ha utilizado nunca 'X'" -w, --interactive, --confirmation Pide confirmacion para cada accion. Opciones de compatibilidad -o Al crear, lo mismo que --old-archive; al extraer, lo mismo que --no-same-owner. Sufijos de tamano Sufijo Unidades Equivalencia en Bytes b Blocks TAMANO x 512 B Kilobytes TAMANO x 1024 c Bytes TAMANO G Gigabytes TAMANO x 1024^3 K Kilobytes TAMANO x 1024 k Kilobytes TAMANO x 1024 M Megabytes TAMANO x 1024^2 P Petabytes TAMANO x 1024^5 T Terabytes TAMANO x 1024^4 w Palabras TAMANO x 2 VALOR DEVUELTO El codigo de salida de Tar indicara si se ha realizado con exito la operacion solicitada o bien, de no ser asi, que tipo de error ocurrio. 0 Finalizado con exito. 1 Algunos archivos difieren. Si tar fue invocado con la opcion --compare (--diff, -d), esto significa que algunos archivos en el archivo difieren de sus homologos en el disco. Si se indicaron alguna de las siguientes opciones: --create, --append o --update, este codigo de salida indica que algunos archivos se cambiaron mientras se archivaban y que, por lo tanto el archivo resultante no es una copia exacta del conjunto de archivos. 2 Error fatal. Durante la ejecucion ha ocurrido un error irrecuperable. Si un subproceso invocado por tar finaliza con un codigo de salida distinto de cero, tar tambien finalizara con ese codigo. Esto puede suceder, por ejemplo, al utilizar una opcion de compresion (por ejemplo, -z) si falla la aplicacion externa invocada. Otro ejemplo es el error rmt durante la copia de seguridad en un dispositivo remoto. VEASE TAMBIEN bzip2(1), compress(1), gzip(1), lzma(1), lzop(1), rmt(8), symlink(7), xz(1), zstd(1). Puede acceder al manual completo de tar ejecutando info tar o mediante el modo de informacion emacs(1) para leerlo. Puede consultar la documentacion de GNU tar en internet en varios formatos desde: https://www.gnu.org/software/tar/manual INFORMES DE FALLOS Comunicar errores a . COPYRIGHT Copyright (C) 2023 Free Software Foundation, Inc. Licencia GPLv3+: GNU GPL version 3 o posterior . Esto es software libre: usted es libre de cambiarlo y redistribuirlo. NO HAY GARANTIA, en la medida permitida por la legislacion. TRADUCCION La traduccion al espanol de esta pagina del manual fue creada por Gerardo Aburruzaga Garcia y Marcos Fouces Esta traduccion es documentacion libre; lea la GNU General Public License Version 3 o posterior con respecto a las condiciones de copyright. No existe NINGUNA RESPONSABILIDAD. Si encuentra algun error en la traduccion de esta pagina del manual, envie un correo electronico a . TAR 11 de julio de 2022 TAR(1)