Man » Manual de tar en línea: documentación detallada en línea para la página man de tar

🌍 ☰

tar: una utilidad de archivo

SINTAXIS

Uso tradicional

tar {A|c|d|r|t|u|x}[GnSkUWOmpsMBiajJzZhPlRvwo] [ARG...]

Uso de estilo UNIX

tar -A [OPCIONES] -f ARCHIVO ARCHIVO...

tar -c [-f ARCHIVO] [OPCIONES] [ARCHIVO...]

tar -d [-f ARCHIVO] [OPCIONES] [ARCHIVO...]

tar -r [-f ARCHIVO] [OPCIONES] [ARCHIVO...]

tar -t [-f ARCHIVO] [OPCIONES] [MIEMBRO...]

tar -u [-f ARCHIVO] [OPCIONES] [ARCHIVO...]

tar -x [-f ARCHIVO] [OPCIONES] [MIEMBRO...]

Uso de estilo GNU

tar {--catenate|--concatenate} [OPCIONES] --file ARCHIVO ARCHIVO...

tar --create [--file ARCHIVO] [OPCIONES] [ARCHIVO...]

tar {--diff|--compare} [--file ARCHIVO] [OPCIONES] [ARCHIVO...]

tar --delete [--file ARCHIVO] [OPCIONES] [MIEMBRO...]

tar --append [--file ARCHIVO] [OPCIONES] [ARCHIVO...]

tar --list [--file ARCHIVO] [OPCIONES] [MIEMBRO...]

tar --test-label [--file ARCHIVO] [OPCIONES] [ETIQUETA...]

tar --update [--file ARCHIVO] [OPCIONES] [ARCHIVO...]

tar {--extract|--get} [--file ARCHIVO] [OPCIONES] [MIEMBRO...]

NOTA

Esta página man es una breve descripción de GNU tar. Para obtener una discusión detallada, incluidos los ejemplos y las recomendaciones de uso, consulte el Manual de GNU Tar disponible en formato texinfo. Si el lector de info y la documentación de tar están instalados correctamente en su sistema, el comando

info tar

debería darle acceso al manual completo.

También puede ver el manual utilizando el modo info en emacs(1), o encontrarlo en varios formatos en línea en

https://www.gnu.org/software/tar/manual

Si se producen discrepancias entre esta página man y el Manual de GNU Tar, este último se considerará la fuente autorizada.

DESCRIPCIÓN

GNU tar es un programa de archivo diseñado para almacenar varios archivos en un solo archivo (un archivo) y para manipular dichos archivos. El archivo puede ser un archivo normal o un dispositivo (por ejemplo, una unidad de cinta, de ahí el nombre del programa, que significa archivador de cintas), que puede estar ubicado tanto en la máquina local como en una máquina remota.

Estilos de opción

Las opciones para GNU tar se pueden especificar en tres estilos diferentes. En el estilo tradicional, el primer argumento es un grupo de letras de opción y todos los argumentos posteriores proporcionan argumentos a esas opciones que los requieren. Los argumentos se leen en el mismo orden que las letras de opción. Cualquier palabra de línea de comandos que permanezca después de que se hayan procesado todas las opciones se trata como argumentos que no son opciones: nombres de archivo o miembros de archivo.

Por ejemplo, la opción c requiere la creación del archivo, la opción v solicita la operación detallada y la opción f toma un argumento que establece el nombre del archivo con el que se va a operar. El siguiente comando, escrito en el estilo tradicional, instruye a tar para que almacene todos los archivos del directorio /etc en el archivo etc.tar, mostrando detalladamente los archivos que se están archivando:

tar cfv etc.tar /etc

En UNIX o en el estilo de opciones cortas, cada letra de opción va precedida por un solo guion, como en otras utilidades de línea de comandos. Si una opción requiere un argumento, el argumento le sigue, ya sea como una palabra separada en la línea de comandos o inmediatamente después de la opción. Sin embargo, si la opción requiere un argumento opcional, el argumento debe seguir a la letra de la opción sin ningún espacio en blanco intermedio, como en -g/tmp/snar.db.

Cualquier número de opciones que no requieran argumentos se pueden agrupar juntas después de un solo guion, por ejemplo, -vkp. Una opción que requiere un argumento (ya sea obligatorio u opcional) puede aparecer al final de dicho grupo, por ejemplo, -vkpf a.tar.

El ejemplo de comando anterior escrito en el estilo de opción corta podría verse así:

tar -cvf etc.tar /etc
o
tar -c -v -f etc.tar /etc

En el estilo de opción GNU o de opción larga, cada opción comienza con dos guiones y tiene un nombre significativo, que consiste en letras minúsculas y guiones. Cuando se utiliza, la opción larga se puede abreviar a sus letras iniciales, siempre y cuando esto no cree ambigüedad. Los argumentos para las opciones largas se proporcionan ya sea como una palabra separada en la línea de comandos, inmediatamente después de la opción, o separados de la opción por un signo igual sin ningún espacio en blanco intermedio. Los argumentos opcionales siempre deben usar este último método.

Aquí hay varias formas de escribir el ejemplo de comando en este estilo:

tar --create --file etc.tar --verbose /etc
o (abrevando algunas opciones):
tar --cre --file=etc.tar --verb /etc

Las opciones en los tres estilos se pueden combinar, aunque no se recomienda hacerlo con opciones antiguas.

Modo de operación

Las opciones enumeradas en la tabla a continuación le indican a GNU tar qué operación realizar. Exactamente una de ellas debe proporcionarse. El significado de los argumentos que no son opciones depende del modo de operación solicitado.

-A, --catenate, --concatenate

Adjuntar archivos al final de otro archivo. Los argumentos se tratan como los nombres de los archivos que se van a adjuntar. Todos los archivos deben tener el mismo formato que el archivo al que se adjuntan; de lo contrario, el archivo resultante podría no ser utilizable con implementaciones de tar que no sean GNU. Tenga en cuenta también que cuando se proporciona más de un archivo, los miembros de los archivos distintos del primero solo serán accesibles en el archivo resultante cuando se utilice la opción -i (--ignore-zeros).

Los archivos comprimidos no se pueden concatenar.

-c, --create

Crear un nuevo archivo. Los argumentos proporcionan los nombres de los archivos que se van a archivar. Los directorios se archivan de forma recursiva, a menos que se proporcione la opción --no-recursion.

-d, --diff, --compare

Encontrar diferencias entre un archivo y el sistema de archivos. Los argumentos son opcionales y especifican los miembros del archivo que se van a comparar. Si no se proporciona, se asume el directorio de trabajo actual.

--delete

Elimina del archivo. Los argumentos especifican los nombres de los miembros del archivo que se van a eliminar. Debe proporcionarse al menos un argumento.

Esta opción no funciona en archivos comprimidos. No existe una opción abreviada equivalente.

-r, --append

Agrega archivos al final de un archivo. Los argumentos tienen el mismo significado que para -c (--create).

-t, --list

Lista el contenido de un archivo. Los argumentos son opcionales. Cuando se proporcionan, especifican los nombres de los miembros del archivo que se van a listar.

--test-label

Prueba la etiqueta del volumen del archivo y sale. Cuando se usa sin argumentos, imprime la etiqueta del volumen (si existe) y sale con el estado 0. Cuando se proporcionan uno o más argumentos de línea de comandos, tar compara la etiqueta del volumen con cada argumento. Sale con el código 0 si se encuentra una coincidencia y con el código 1 en caso contrario. No se muestra ninguna salida, a menos que se use junto con la opción -v (--verbose).

No existe una opción abreviada equivalente para esta opción.

-u, --update

Agrega archivos que son más recientes que la copia correspondiente en el archivo. Los argumentos tienen el mismo significado que con las opciones -c y -r. Tenga en cuenta que los archivos más recientes no reemplazan sus copias antiguas en el archivo, sino que se agregan al final del archivo. Por lo tanto, el archivo resultante puede contener varios miembros con el mismo nombre, que corresponden a varias versiones del mismo archivo.

-x, --extract, --get

Extrae archivos de un archivo. Los argumentos son opcionales. Cuando se proporcionan, especifican los nombres de los miembros del archivo que se van a extraer.

--show-defaults

Muestra los valores predeterminados integrados para varias opciones de tar y sale.

-?, --help

Muestra un resumen de las opciones y sale.

--usage

Muestra una lista de opciones disponibles y sale.

--version

Imprime la versión del programa y la información de los derechos de autor y sale.

OPCIONES

Modificadores de operación

--check-device

Verifica los números de dispositivo al crear archivos incrementales (predeterminado).

-g, --listed-incremental=ARCHIVO

Maneja los nuevos archivos de copia de seguridad incremental de formato GNU. ARCHIVO es el nombre de un archivo de instantánea, donde tar almacena información adicional que se utiliza para decidir qué archivos han cambiado desde la copia de seguridad incremental anterior y, por lo tanto, deben volverse a incluir en la copia de seguridad. Si ARCHIVO no existe cuando se crea un archivo, se creará y todos los archivos se agregarán al archivo resultante (la copia de seguridad de nivel 0). Para crear archivos incrementales de nivel N distinto de cero, necesita una copia del archivo de instantánea creado para el nivel N-1 y usarlo como ARCHIVO.

Cuando se enumera o extrae, el contenido real de ARCHIVO no se inspecciona, solo se necesita debido a los requisitos sintácticos. Por lo tanto, es una práctica común usar /dev/null en su lugar.

--hole-detection=METODO

Utilice METODO para detectar huecos en archivos dispersos. Esta opción implica --sparse. Los valores válidos para METODO son seek y raw. El valor predeterminado es seek con retroceso a raw cuando no es aplicable.

-G, --incremental

Maneja los archivos de copia de seguridad incremental de formato GNU antiguos.

--ignore-failed-read

No salir con un código de error distinto de cero en caso de archivos ilegibles.

--level=NUMBER

Establecer el nivel de volcado para un archivo incremental listado creado. Actualmente, solo --level=0 es significativo: indica a tar que trunque el archivo de instantánea antes de realizar el volcado, obligando así a un volcado de nivel 0.

-n, --seek

Asumir que el archivo está preparado para búsquedas. Normalmente, tar determina automáticamente si el archivo se puede buscar o no. Esta opción está pensada para usarse en casos en los que dicho reconocimiento falle. Solo tiene efecto si el archivo se abre para lectura (por ejemplo, con las opciones --list o --extract).

--no-check-device

No comprobar los números de dispositivo al crear archivos incrementales.

--no-seek

Asumir que el archivo no está preparado para búsquedas.

--occurrence[=N]

Procesar solo la N-ésima aparición de cada archivo en el archivo. Esta opción solo es válida cuando se utiliza con uno de los siguientes subcomandos: --delete, --diff, --extract o --list, y cuando se proporciona una lista de archivos en la línea de comandos o mediante la opción -T. El valor predeterminado de N es 1.

--restrict

Deshabilitar el uso de algunas opciones potencialmente peligrosas.

--sparse-version=MAJOR[.MINOR]

Establecer qué versión del formato disperso se utilizará. Esta opción implica --sparse. Los valores de argumento válidos son 0.0, 0.1 y 1.0. Para obtener una discusión detallada de los formatos dispersos, consulte el Manual de GNU Tar, Apéndice D, "Formatos dispersos". Utilizando el lector de información, se puede acceder ejecutando el siguiente comando: info tar 'Formatos dispersos'.

-S, --sparse

Manejar los archivos dispersos de manera eficiente. Algunos archivos en el sistema de archivos pueden tener segmentos que en realidad nunca se escribieron (a menudo, estos son archivos de base de datos creados por sistemas como DBM). Cuando se proporciona esta opción, tar intenta determinar si el archivo es disperso antes de archivarlo, y si lo es, reduce el tamaño del archivo resultante al no volcar las partes vacías del archivo.

Control de sobrescritura

Estas opciones controlan las acciones de tar cuando se extrae un archivo sobre una copia existente en el disco.

-k, --keep-old-files

No reemplazar los archivos existentes al extraer.

--keep-newer-files

No reemplazar los archivos existentes que son más recientes que sus copias en el archivo.

--keep-directory-symlink

No reemplazar los enlaces simbólicos a los directorios existentes al extraer.

--no-overwrite-dir

Preservar los metadatos de los directorios existentes.

--one-top-level[=DIR]

Extraer todos los archivos en DIR, o, si se utiliza sin argumento, en un subdirectorio con el nombre de la base del archivo (menos los sufijos de compresión estándar reconocidos por --auto-compress).

--overwrite

Reemplazar los archivos existentes al extraer.

--overwrite-dir

Reemplazar los metadatos de los directorios existentes al extraer (predeterminado).

--recursive-unlink

Eliminar recursivamente todos los archivos del directorio antes de extraerlo.

--remove-files

Eliminar los archivos del disco después de agregarlos al archivo.

--skip-old-files

No reemplazar los archivos existentes al extraer, omitirlos en silencio.

-U, --unlink-first

Eliminar cada archivo antes de extraerlo.

-W, --verify

Verifica el archivo después de escribirlo.

Selección del flujo de salida

--ignore-command-error

Ignora los códigos de salida de los subprocesos.

--no-ignore-command-error

Considera los códigos de salida distintos de cero de los procesos secundarios como errores (por defecto).

-O, --to-stdout

Extrae los archivos a la salida estándar.

--to-command=COMANDO

Canaliza los archivos extraídos a COMANDO. El argumento es el nombre de ruta de un programa externo, opcionalmente con argumentos de línea de comandos. El programa se invocará y el contenido del archivo que se está extrayendo se suministrará a su entrada estándar. Los datos adicionales se suministrarán a través 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 simbólico
h Enlace físico
b Dispositivo de bloque
c Dispositivo de caracteres

Actualmente, solo se admiten archivos regulares.

TAR_MODE

Modo del archivo, un número octal.

TAR_FILENAME

El nombre del archivo.

TAR_REALNAME

Nombre del archivo tal como se almacena en el archivo.

TAR_UNAME

Nombre del propietario del archivo.

TAR_GNAME

Nombre del grupo propietario del archivo.

TAR_ATIME

Hora del último acceso. Es un número decimal que representa los segundos desde la Época. Si el archivo proporciona horas con precisión de nanosegundos, los nanosegundos se agregan a la marca de tiempo después de un punto decimal.

TAR_MTIME

Hora de la última modificación.

TAR_CTIME

Hora del último cambio de estado.

TAR_SIZE

Tamaño del archivo.

TAR_UID

UID del propietario del archivo.

TAR_GID

GID del propietario del archivo.

Además, las siguientes variables contienen información sobre el modo de operación de tar y el archivo que se está procesando:

TAR_VERSION

Número de versión de GNU tar.

TAR_ARCHIVE

El nombre del archivo que tar está procesando.

TAR_BLOCKING_FACTOR

Factor de bloqueo actual, es decir, el número de bloques de 512 bytes en un registro.

TAR_VOLUME

Número ordinal del volumen que tar está procesando (se establece si se está leyendo un archivo de varios volúmenes).

TAR_FORMAT

Formato del archivo que se está procesando. Uno de: gnu, oldgnu, posix, ustar, v7.

TAR_SUBCOMMAND

Una opción corta (con un guión inicial) que describe la operación que tar está ejecutando.

Manejo de atributos de archivo

--atime-preserve[=METHOD]

Preserva los tiempos de acceso en los archivos volcados, ya sea restaurando los tiempos después de la lectura (METHOD=replace, este es el valor predeterminado) o no estableciendo los tiempos en absoluto (METHOD=system).

--delay-directory-restore

Retrasa la configuración de los tiempos de modificación y los permisos de los directorios extraídos hasta el final de la extracción. Utilice esta opción cuando extraiga de un archivo que tiene un orden de miembros inusual.

--group=NAME[:GID]

Fuerza que NAME sea el grupo para los archivos agregados. Si no se proporciona GID, NAME puede ser un nombre de usuario o un GID numérico. En este caso, la parte que falta (GID o nombre) se inferirá de la base de datos de grupos del host actual.

Cuando se utiliza con --group-map=FILE, afecta solo a los archivos cuyo grupo propietario no está incluido en FILE.

--group-map=FILE

Lee el mapa de traducción de grupos desde FILE. Las líneas vacías se ignoran. Los comentarios se introducen con el signo # y se extienden hasta el final de la línea. Cada línea no vacía en FILE define la traducción para un solo grupo. Debe constar de dos campos, delimitados por cualquier cantidad de espacios en blanco:

OLDGRP NEWGRP[:NEWGID]

OLDGRP es un nombre de grupo válido o un GID prefijado con +. A menos que se proporcione NEWGID,
NEWGRP también debe ser un nombre de grupo válido o un +GID. De lo contrario, ni NEWGRP ni
NEWGID tienen que estar listados en la base de datos de grupos del sistema.

Como resultado, cada archivo de entrada con el grupo propietario OLDGRP se almacenará en el archivo con el grupo propietario NEWGRP y el GID NEWGID.

--mode=CHANGES
Fuerza el modo simbólico CHANGES para los archivos añadidos.

--mtime=DATE-OR-FILE
Establece la fecha de modificación para los archivos añadidos. DATE-OR-FILE es una fecha y hora en un formato casi arbitrario,
o el nombre de un archivo existente. En este último caso, se utilizará la fecha de modificación de ese archivo.

-m, --touch
No extrae la fecha de modificación del archivo.

--no-delay-directory-restore
Cancela el efecto de la opción anterior --delay-directory-restore.

--no-same-owner
Extrae los archivos como tú mismo (valor predeterminado para usuarios normales).

--no-same-permissions
Aplica la umask del usuario al extraer los permisos del archivo (valor predeterminado para usuarios normales).

--numeric-owner
Utiliza siempre números para los nombres de usuario/grupo.

--owner=NAME[:UID]
Fuerza que NAME sea el propietario de los archivos añadidos. Si no se proporciona UID, NAME puede ser un nombre de usuario o un UID numérico. En este caso, la parte que falta (UID o nombre) se deducirá
de la base de datos de usuarios del host actual.

Cuando se utiliza con --owner-map=FILE, afecta solo a los archivos cuyo propietario no está listado en FILE.

--owner-map=FILE
Lee el mapa de traducción de propietarios desde FILE. Las líneas vacías se ignoran. Los comentarios se introducen con el signo # y se extienden hasta el final de la línea. Cada línea no vacía en FILE define la traducción para un único UID. Debe constar de dos campos, delimitados por cualquier cantidad de espacio en blanco:

OLDUSR NEWUSR[:NEWUID]

OLDUSR es un nombre de usuario válido o un UID prefijado con +. A menos que se proporcione NEWUID,
NEWUSR también debe ser un nombre de usuario válido o un +UID. De lo contrario, ni NEWUSR ni NEWUID tienen que estar listados en la base de datos de usuarios del sistema.

Como resultado, cada archivo de entrada cuyo propietario es OLDUSR se almacenará en el archivo con el nombre de propietario NEWUSR y el UID NEWUID.

-p, --preserve-permissions, --same-permissions
Establece los permisos de los archivos extraídos a los que están registrados en el archivo (valor predeterminado para superusuarios).

--same-owner
Intenta extraer los archivos con la misma propiedad que existe en el archivo (valor predeterminado para superusuarios).

-s, --preserve-order, --same-order
Indica a tar que la lista de nombres de archivo a procesar está ordenada de la misma manera que los archivos en el archivo.

--sort=ORDER
Al crear un archivo, ordena las entradas del directorio según ORDER, que es uno de none, name o inode.

El valor predeterminado es --sort=none, que almacena los miembros del archivo en el mismo orden que devuelve el sistema operativo.

El uso de --sort=name asegura que el orden de los miembros en el archivo creado sea uniforme y reproducible.

El uso de --sort=inode reduce el número de búsquedas en disco realizadas al crear el archivo y, por lo tanto, puede acelerar considerablemente la creación del archivo. Este orden de clasificación solo se admite si el sistema subyacente proporciona la información necesaria.

Atributos de archivo extendidos

--acls Habilita el soporte de ACL de POSIX.

--no-acls
Deshabilita el soporte de ACL de POSIX.

--selinux
Habilita el soporte del contexto de SELinux.

--no-selinux
Deshabilita el soporte del contexto de SELinux.

--xattrs
Habilita el soporte de atributos extendidos.

--no-xattrs
Deshabilita el soporte de atributos extendidos.

--xattrs-exclude=PATTERN
Especifica el patrón de exclusión para las claves de xattr. PATTERN es un patrón de globbing, por ejemplo, `--xattrs-exclude='user.\*'` para incluir solo atributos del espacio de nombres de usuario.

--xattrs-include=PATTERN
Especifica el patrón de inclusión para las claves de xattr. PATTERN es un patrón de globbing.

Selección y cambio de dispositivo

-f, --file=ARCHIVO
Utiliza el archivo o dispositivo de archivo ARCHIVO. Si no se proporciona esta opción, tar primero examinará la variable de entorno `TAPE`. Si está configurada, su valor se utilizará como nombre de archivo. De lo contrario, tar asumirá el valor predeterminado compilado. El valor predeterminado se puede inspeccionar utilizando la opción `--show-defaults` o al final de la salida de `tar --help`.

Un nombre de archivo que tiene dos puntos en él especifica un archivo o dispositivo en una máquina remota.
La parte anterior de los dos puntos se toma como el nombre de la máquina o la dirección IP, y la parte posterior de los dos puntos como la ruta del archivo o dispositivo, por ejemplo:

`--file=remotehost:/dev/sr0`

Se puede prefijar un nombre de usuario opcional al nombre de host, colocando un signo @ entre ellos.

Por defecto, la máquina remota se accede mediante el comando `rsh(1)`. Hoy en día, es común utilizar [ssh]({filename}../../ssh)(1) en su lugar. Puede hacerlo proporcionando la siguiente opción de línea de comandos:

`--rsh-command=/usr/bin/ssh`

La máquina remota debe tener instalado el comando `rmt(8)`. Si su ruta no coincide con la ruta predeterminada de tar, puede informar a tar sobre la ruta correcta utilizando la opción `--rmt-command`.

--force-local
El archivo de archivo es local incluso si tiene dos puntos.

-F, --info-script=COMMAND, --new-volume-script=COMMAND
Ejecuta COMMAND al final de cada cinta (implica -M). El comando puede incluir argumentos.
Cuando se inicia, heredará el entorno de tar más las siguientes variables:

TAR_VERSION
Número de versión de GNU tar.

TAR_ARCHIVE
El nombre del archivo que tar está procesando.

TAR_BLOCKING_FACTOR
Factor de bloqueo actual, es decir, el número de bloques de 512 bytes en un registro.

TAR_VOLUME
Número ordinal del volumen que tar está procesando (se establece si se está leyendo un archivo de varios volúmenes).

TAR_FORMAT
Formato del archivo que se está procesando. Uno de: gnu, oldgnu, posix, ustar, v7.

TAR_SUBCOMMAND
Una opción corta (con un guion inicial) que describe la operación que tar está ejecutando.

TAR_FD
Descriptor de archivo que se puede utilizar para comunicar el nombre del nuevo volumen a tar.

Si falla el script de información, tar sale; de lo contrario, comienza a escribir el siguiente volumen.

-L, --tape-length=N
Cambia la cinta después de escribir Nx1024 bytes. Si N va seguido de un sufijo de tamaño (véase la subsección Sufijos de tamaño a continuación), el sufijo especifica el factor multiplicativo que se utilizará en lugar de 1024.

Esta opción implica -M.

-M, --multi-volume
Crea/lista/extrae un archivo de múltiples volúmenes.

--rmt-command=COMMAND
Utiliza COMMAND en lugar de rmt al acceder a archivos remotos. Véase la descripción de la opción -f, arriba.

--rsh-command=COMMAND
Utiliza COMMAND en lugar de rsh al acceder a archivos remotos. Véase la descripción de la opción -f, arriba.

--volno-file=FILE
Cuando esta opción se utiliza en conjunto con --multi-volume, tar realizará un seguimiento de qué volumen del archivo de múltiples volúmenes está utilizando en FILE.

Bloqueo de dispositivos

-b, --blocking-factor=BLOCKS
Establece el tamaño del registro en BLOCKSx512 bytes.

-B, --read-full-records
Al listar o extraer, acepta registros de entrada incompletos después del marcador de fin de archivo.

-i, --ignore-zeros
Ignora los bloques de ceros en el archivo. Normalmente, dos bloques de 512 bytes consecutivos llenos de ceros significan el final del archivo, y tar deja de leer después de encontrarlos. Esta opción le indica que siga leyendo y es útil cuando se leen archivos creados con la opción -A.

--record-size=NUMBER
Establece el tamaño del registro. NUMBER es el número de bytes por registro. Debe ser un múltiplo de 512. Puede tener un sufijo de tamaño, por ejemplo, --record-size=10K, para 10 Kilobytes. Véase la subsección Sufijos de tamaño, para obtener una lista de sufijos válidos.

Selección del formato de archivo

-H, --format=FORMAT
Crea un archivo con el formato especificado. Los formatos válidos son:

gnu    Formato GNU tar 1.13.x

oldgnu Formato GNU según tar <= 1.12.

pax, posix
Formato POSIX 1003.1-2001 (pax).

ustar  Formato POSIX 1003.1-1988 (ustar).

v7     Formato V7 tar antiguo.

--old-archive, --portability
Lo mismo que --format=v7.

--pax-option=keyword[[:]=value][,keyword[[:]=value]]...
Controla las palabras clave pax al crear archivos PAX (-H pax). Esta opción es equivalente a la opción -o del utilidad pax(1).

--posix
Lo mismo que --format=posix.

-V, --label=TEXT
Crea un archivo con el nombre de volumen TEXT. Si se está listando o extrayendo, utiliza TEXT como patrón de búsqueda para el nombre del volumen.

Opciones de compresión

-a, --auto-compress
Utiliza el sufijo del archivo para determinar el programa de compresión.

-I, --use-compress-program=COMMAND
Filtra los datos a través de COMMAND. Debe aceptar la opción -d, para la descompresión. El argumento puede contener opciones de línea de comandos.

-j, --bzip2
Filtra el archivo a través de [bzip2]({filename}bzip2.md)(1).

-J, --xz
Filtra el archivo a través de [xz]({filename}../../xz)(1).

--lzip Filtra el archivo a través de lzip(1).

--lzma Filtra el archivo a través de lzma(1).

--lzop Filtra el archivo a través de lzop(1).

--no-auto-compress
No utilice el sufijo del archivo para determinar el programa de compresión.

-z, --gzip, --gunzip, --ungzip
Filtra el archivo a través de [gzip]({filename}../../gzip)(1).

-Z, --compress, --uncompress
Filtra el archivo a través de compress(1).

--zstd Filtra el archivo a través de zstd(1).

Selección de archivos locales

--add-file=ARCHIVO

Agrega ARCHIVO al archivo (útil si su nombre comienza con un guión).

--backup[=CONTROL]

Realiza una copia de seguridad antes de la eliminación. El argumento CONTROL, si se proporciona, controla la política de copia de seguridad. Sus valores válidos son:

none, off

Nunca realiza copias de seguridad.

t, numbered

Realiza copias de seguridad numeradas.

nil, existing

Realiza copias de seguridad numeradas si existen copias de seguridad numeradas, copias de seguridad simples en caso contrario.

never, simple

Siempre realiza copias de seguridad simples.

Si no se proporciona CONTROL, el valor se toma de la variable de entorno VERSION_CONTROL. Si no está configurada, se asume existing.

-C, --directory=DIR

Cambia al directorio DIR antes de realizar cualquier operación. Esta opción es sensible al orden, es decir, afecta a todas las opciones que la siguen.

--exclude=PATRÓN

Excluye archivos que coincidan con el PATRÓN, un patrón de comodín de estilo glob(3).

--exclude-backups

Excluye archivos de copia de seguridad y archivos de bloqueo.

--exclude-caches

Excluye el contenido de los directorios que contienen el archivo CACHEDIR.TAG, excepto el archivo de etiqueta en sí.

--exclude-caches-all

Excluye los directorios que contienen el archivo CACHEDIR.TAG y el archivo en sí.

--exclude-caches-under

Excluye todo lo que haya debajo de los directorios que contienen CACHEDIR.TAG

--exclude-ignore=ARCHIVO

Antes de volcar un directorio, verifica si contiene ARCHIVO. Si es así, lee los patrones de exclusión de este archivo. Los patrones solo afectan al directorio en sí.

--exclude-ignore-recursive=ARCHIVO

Igual que --exclude-ignore, excepto que los patrones de ARCHIVO afectan tanto al directorio como a todos sus subdirectorios.

--exclude-tag=ARCHIVO

Excluye el contenido de los directorios que contienen ARCHIVO, excepto ARCHIVO en sí.

--exclude-tag-all=ARCHIVO

Excluye los directorios que contienen ARCHIVO.

--exclude-tag-under=ARCHIVO

Excluye todo lo que haya debajo de los directorios que contienen ARCHIVO.

--exclude-vcs

Excluye los directorios del sistema de control de versiones.

--exclude-vcs-ignores

Excluye los archivos que coincidan con los patrones leídos de los archivos de omisión específicos del VCS. Los archivos compatibles son: .cvsignore, .gitignore, .bzrignore y .hgignore.

-h, --dereference

Sigue los enlaces simbólicos; archiva y volca los archivos a los que apuntan.

--hard-dereference

Sigue los enlaces duros; archiva y volca los archivos a los que se refieren.

-K, --starting-file=MIEMBRO

Comienza en el miembro dado en el archivo.

--newer-mtime=FECHA

Trabaja en los archivos cuyos datos han cambiado después de la FECHA. Si FECHA comienza con / o ., se considera que es un nombre de archivo; la fecha de modificación de ese archivo se utiliza como fecha.

--no-null

Desactiva el efecto de la opción --null anterior.

--no-recursion

Evita descender automáticamente en los directorios.

--no-unquote

No elimina las comillas de los nombres de archivo o miembros de entrada.

--no-verbatim-files-from

Trata cada línea leída de un archivo de lista como si se hubiera proporcionado en la línea de comandos. Es decir, se elimina el espacio en blanco inicial y final, y si la cadena resultante comienza con un guión, se trata como una opción de la línea de comandos de tar.

Este es el comportamiento predeterminado. La opción --no-verbatim-files-from se proporciona como una forma de restablecerlo después de la opción --verbatim-files-from.

Esta opción es posicional: afecta a todas las opciones --files-from que aparezcan después en la línea de comandos, hasta la opción --verbatim-files-from o el final de la línea, lo que ocurra primero.

Está implícita por la opción --no-null.

--null Indica a las opciones -T posteriores que lean los nombres terminados en null de forma literal (desactiva el manejo especial de los nombres que comienzan con un guion).

Consulte también --verbatim-files-from.

-N, --newer=FECHA, --after-date=FECHA
Solo almacena los archivos más recientes que FECHA. Si FECHA comienza con / o ., se toma como un nombre de archivo; se utiliza la hora de modificación de ese archivo como fecha.

--one-file-system
Permanece en el sistema de archivos local al crear el archivo.

-P, --absolute-names
No elimina las barras iniciales de los nombres de archivo al crear archivos.

--recursion
Recorre los directorios (por defecto).

--suffix=CADENA
Realiza una copia de seguridad antes de la eliminación, reemplaza el sufijo habitual. El sufijo predeterminado es ~, a menos que se reemplace mediante la variable de entorno SIMPLE_BACKUP_SUFFIX.

-T, --files-from=ARCHIVO
Obtiene los nombres para extraer o crear desde ARCHIVO.

A menos que se especifique lo contrario, ARCHIVO debe contener una lista de nombres separados por LF ASCII (es decir, un nombre por línea). Los nombres leídos se manejan de la misma manera que los argumentos de la línea de comandos. Se realiza la eliminación de comillas y la división de palabras, y cualquier cadena que comience con - se trata como una opción de la línea de comandos de tar.

Si este comportamiento no es deseable, se puede desactivar mediante la opción --verbatim-files-from.

La opción --null indica a tar que los nombres en ARCHIVO están separados por el carácter ASCII NUL, en lugar de LF. Es útil si la lista se genera mediante el predicado [find]({filename}../../find)(1) -print0.

--unquote
Elimina las comillas de los nombres de archivo o miembros (por defecto).

--verbatim-files-from
Trata cada línea obtenida de una lista de archivos como un nombre de archivo, incluso si comienza con un guion.
Las listas de archivos se proporcionan con la opción --files-from (-T). El comportamiento predeterminado es tratar los nombres suministrados en las listas de archivos como si se hubieran escrito en la línea de comandos, es decir, cualquier nombre que comience con un guion se trata como una opción de tar. La opción --verbatim-files-from desactiva este comportamiento.

Esta opción afecta a todas las opciones --files-from que aparezcan después en la línea de comandos. Su efecto se revierte mediante la opción --no-verbatim-files-from.

Esta opción está implícita por la opción --null.

Consulte también --add-file.

-X, --exclude-from=ARCHIVO
Excluye los archivos que coincidan con los patrones enumerados en ARCHIVO.

Transformaciones de nombres de archivo

--strip-components=NÚMERO
Elimina los NÚMERO componentes iniciales de los nombres de archivo al extraerlos.

--transform=EXPRESIÓN, --xform=EXPRESIÓN
Utiliza la expresión de sustitución de sed EXPRESIÓN para transformar los nombres de archivo.

Opciones de coincidencia de nombres de archivo

Estas opciones afectan tanto a los patrones de exclusión como de inclusión.

--anchored
Los patrones coinciden con el inicio del nombre del archivo.

--ignore-case
Ignora mayúsculas y minúsculas.

--no-anchored
Los patrones coinciden después de cualquier / (predeterminado para la exclusión).

--no-ignore-case
Coincidencia con distinción de mayúsculas y minúsculas (predeterminado).

--no-wildcards
Coincidencia de cadenas literal.

--no-wildcards-match-slash
Los comodines no coinciden con /.

--wildcards
Utiliza comodines (predeterminado para la exclusión).

--wildcards-match-slash

Los comodines coinciden con / (predeterminado para la exclusión).

Salida informativa

--checkpoint[=N]

Muestra mensajes de progreso cada N registros (predeterminado 10).

--checkpoint-action=ACTION

Ejecuta ACTION en cada punto de control.

--clamp-mtime

Establece la hora solo cuando el archivo es más reciente que la especificada con --mtime.

--full-time

Imprime la hora del archivo con su resolución completa.

--index-file=FILE

Envía una salida detallada a FILE.

-l, --check-links

Imprime un mensaje si no se vacían todos los enlaces.

--no-quote-chars=STRING

Desactiva el escape de los caracteres de STRING.

--quote-chars=STRING

Escapa adicionalmente los caracteres de STRING.

--quoting-style=STYLE

Establece el estilo de escape para los nombres de archivo y miembro. Los valores válidos para STYLE son literal, shell, shell-always, c, c-maybe, escape, locale, clocale.

-R, --block-number

Muestra el número de bloque dentro del archivo con cada mensaje.

--show-omitted-dirs

Al listar o extraer, muestra cada directorio que no coincide con los criterios de búsqueda.

--show-transformed-names, --show-stored-names

Muestra los nombres de archivo o archivo después de la transformación mediante las opciones --strip y --transform.

--totals[=SIGNAL]

Imprime el total de bytes después de procesar el archivo. Si se proporciona SIGNAL, imprime el total de bytes cuando se envía esta señal. Las señales permitidas son: SIGHUP, SIGQUIT, SIGINT, SIGUSR1 y SIGUSR2. Se puede omitir el prefijo SIG.

--utc

Imprime las horas de modificación del archivo en UTC.

-v, --verbose

Lista detalladamente los archivos procesados. Cada instancia de esta opción en la línea de comandos aumenta el nivel de detalle en uno. El nivel de detalle máximo es 3. Para obtener una discusión detallada sobre cómo los diferentes niveles de detalle afectan la salida de tar, consulte el Manual de GNU Tar, la sección 2.5.2 "La opción '--verbose'".

--warning=KEYWORD

Habilita o deshabilita los mensajes de advertencia identificados por KEYWORD. Los mensajes se suprimen si KEYWORD tiene el prefijo no- y se habilitan en caso contrario.

Las múltiples opciones --warning se acumulan.

Palabras clave que controlan la operación general de tar:

all

Habilita todos los mensajes de advertencia. Este es el valor predeterminado.

none

Deshabilita todos los mensajes de advertencia.

filename-with-nuls

"%s: el nombre del archivo contiene un carácter nulo"

alone-zero-block

"Un bloque cero solitario en %s"

Palabras clave aplicables para tar --create:

cachedir

"%s: contiene una etiqueta de directorio de caché %s; %s"

file-shrank

"%s: el archivo se redujo en %s bytes; se está rellenando con ceros"

xdev

"%s: el archivo está en un sistema de archivos diferente; no se está incluyendo"

file-ignored

"%s: tipo de archivo desconocido; archivo ignorado" "%s: socket ignorado" "%s: puerta ignorada"

file-unchanged

"%s: el archivo no ha cambiado; no se está incluyendo"

ignore-archive

"%s: el archivo no puede contenerse a sí mismo; no se está incluyendo"

file-removed

"%s: archivo eliminado antes de que lo leyéramos"

file-changed

"%s: archivo cambiado mientras lo leíamos"

failed-read

Suprime las advertencias sobre archivos o directorios ilegibles. Esta palabra clave solo se aplica si se utiliza junto con la opción --ignore-failed-read.

Palabras clave aplicables para tar --extract:

existing-file

"%s: omitiendo archivo existente"

timestamp
"%s: marca de tiempo implausíblemente antigua %s"
"%s: la marca de tiempo %s está %s segundos en el futuro"

contiguous-cast
"Extrayendo archivos contiguos como archivos regulares"

symlink-cast
"Intentando extraer enlaces simbólicos como enlaces físicos"

unknown-cast
"%s: tipo de archivo desconocido '%c', extraído como archivo normal"

ignore-newer
"El archivo %s actual es más reciente o tiene la misma antigüedad"

unknown-keyword
"Ignorando palabra clave de encabezado extendido desconocida '%s'"

decompress-program
Controla la descripción detallada de los errores que ocurren al intentar ejecutar programas de descompresión alternativos. Esta advertencia está desactivada de forma predeterminada (a menos que se use --verbose). Un ejemplo común de lo que puede obtener al usar esta advertencia es:

$ tar --warning=decompress-program -x -f archive.Z
tar (hijo): no puede ejecutar compress: No existe dicho archivo o directorio
tar (hijo): intentando gzip

Esto significa que tar primero intentó descomprimir archive.Z usando compress y, cuando eso falló, cambió a gzip.

record-size
"Tamaño del registro = %lu bloques"

Palabras clave que controlan la extracción 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 está en un dispositivo diferente: no se elimina"

bad-dumpdir
"dumpdir malformado: 'X' nunca se usó"

-w, --interactive, --confirmation
Solicita confirmación para cada acción.

Opciones de compatibilidad

-o     Cuando se crea, es lo mismo que --old-archive. Cuando se extrae, es lo mismo que --no-same-owner.

Sufijos de tamaño

Sufijo Unidades Equivalente en bytes

b         Bloques                  SIZE x 512
B         Kilobytes                SIZE x 1024
c         Bytes                    SIZE
G         Gigabytes                SIZE x 1024^3
K         Kilobytes                SIZE x 1024
k         Kilobytes                SIZE x 1024
M         Megabytes                SIZE x 1024^2
P         Petabytes                SIZE x 1024^5
T         Terabytes                SIZE x 1024^4
w         Palabras                 SIZE x 2

VALOR DE RETORNO

El código de salida de Tar indica si pudo realizar correctamente la operación solicitada y, si no, qué tipo de error ocurrió.

0     Terminación exitosa.

1     Algunos archivos difieren. Si se invocó a tar con la opción de línea de comandos --compare (--diff, -d), esto significa que algunos archivos en el archivo difieren de sus contrapartes en el disco. Si a tar se le dio una de las opciones --create, --append o --update, este código de salida significa que algunos archivos cambiaron mientras se archivaban y, por lo tanto, el archivo resultante no contiene la copia exacta del conjunto de archivos.

2     Error fatal. Esto significa que ocurrió algún error fatal e irrecuperable.

Si un subproceso que había sido invocado por tar salió con un código de salida distinto de cero, el propio tar sale con ese código también. Esto puede ocurrir, por ejemplo, si se usó una opción de compresión (por ejemplo, -z) y el programa de compresión externo falló. Otro ejemplo es el fallo de rmt durante la copia de seguridad en un dispositivo remoto.

VÉASE TAMBIÉN

bzip2(1), compress(1), gzip(1), lzma(1), lzop(1), rmt(8), symlink(7), xz(1), zstd(1).

Manual completo de tar: ejecute info tar o utilice emacs(1) en modo info para leerlo.

Las copias en línea de la documentación de GNU tar en varios formatos se pueden encontrar en:

https://www.gnu.org/software/tar/manual

INFORMES DE ERRORES

Informe los errores a <_>.

DERECHOS DE AUTOR

Copyright © 2023 Free Software Foundation, Inc. Licencia GPLv3+: GNU GPL versión 3 o posterior [http://gnu.org/licenses/gpl.html] Este es un software libre: usted es libre de cambiarlo y redistribuirlo. NO HAY GARANTÍA, en la medida permitida por la ley.