Provided by:
manpages-es-extra_0.8a-16_all 
NOMBRE
magic - fichero de números mágicos para la orden file
DESCRIPCIÓN
Esta página del Manual documenta el formato del fichero mágico que
emplea la orden file(1), versión 3.26. La orden file identifica el tipo
de un fichero utilizando, entre otras pruebas, una que mira si el
fichero empieza con un cierto número mágico. El fichero
/usr/share/misc/magic especifica qué números mágicos hay que buscar,
qué mensaje mostrar si se encuentra un número mágico en particular, e
información adicional que haya que extraer del fichero.
Cada lÃnea del fichero especifica una prueba a realizar. Una prueba
compara los datos que comiencen en una posición particular en el
fichero con un valor numérico de 1, 2 ó 4 bytes o una cadena de
caracteres. Si la prueba tiene éxito, se muestra un mensaje. La lÃnea
consiste en los campos siguientes:
desplazamiento
Un número que especifica el desplazamiento, en bytes, desde el
principio del fichero de datos que se esté comprobando.
tipo El tipo de los datos a comprobar. Los valores posibles son:
byte Un valor de un byte.
short Un valor de dos bytes (en la mayorÃa de los sistemas)
en el orden de bytes nativo de la máquina.
long Un valor de cuatro bytes (en la mayorÃa de los
sistemas) en el orden de bytes nativo de la máquina.
string Una cadena de bytes.
date Un valor de cuatro bytes interpretado como una fecha
de Unix.
beshort Un valor de dos bytes (en la mayorÃa de los sistemas)
en orden de bytes ascendiente hacia la derecha.
belong Un valor de cuatro bytes (en la mayorÃa de los
sistemas) en orden de bytes ascendente hacia la
derecha.
bedate Un valor de cuatro bytes (en la mayorÃa de los
sistemas) en orden de bytes ascendente hacia la
derecha, interpretado como una fecha de Unix.
leshort Un valor de dos bytes (en la mayorÃa de los sistemas)
en orden de bytes ascendente hacia la izquierda.
lelong Un valor de cuatro bytes (en la mayorÃa de los
sistemas) en orden de bytes ascendente hacia la
izquierda.
ledate Un valor de cuatro bytes (en la mayorÃa de los
sistemas) en orden de bytes ascendente hacia la
izquierda, interpretado como una fecha de Unix.
Los tipos numéricos pueden opcionalmente ir seguidos por & y un valor
numérico, para especificar la operación de bits Y con dicho valor antes
de que se realice la comparación. Preceder el tipo de una u indica que
las comparaciones ordenadas deben hacerse sobre valores sin signo.
test El valor a ser comparado con el valor del fichero. Si el tipo es
numérico, este valor se especifica como en el lenguaje C; si es
una cadena, como una cadena de caracteres de C, permitiéndose
las secuencias de escape habituales (como \n para la nueva
lÃnea).
Los valores numéricos pueden hacerse preceder por un carácter
que indique la operación a realizarse. Puede ser =, para
especificar que el valor del fichero debe igualar al
especificado, <, para especificar que el valor del fichero debe
ser menor que el valor especificado, >, para especificar que el
valor del fichero debe ser mayor que el valor especificado, &,
para especificar que el valor del fichero debe tener a 1 todos
los bits que estén a 1 en el valor especificado, ^, para
especificar que el valor del fichero debe tener a 0 cualquiera
de los bits que estén a 1 en el valor especificado, o x, para
especificar que cualquier valor concordará. Si el carácter se
omite, se asume que es =.
Los valores numéricos se especifican como en C; por ejemplo, 13
es en base diez, 013 es octal, y 0x13 es hexadecimal.
Para valores de cadena, la cadena de bytes del fichero debe
concordar con la cadena de bytes especificada. Los operadores
=, < y > (pero no &) pueden aplicarse a cadenas. La longitud
empleada para la concordancia es la del argumento cadena en el
fichero mágico. Esto significa que una lÃnea puede concordar con
cualquier cadena, y por tanto presumiblemente mostrarla,
haciendo >\0 (porque todas las cadenas son mayores que la cadena
nula).
mensaje
EL mensaje a mostrarse si la comparación tiene éxito. Si la
cadena contiene una especificación de formato como las de
printf(3S), el valor del fichero (con cualquier enmascaramiento
especificado ya realizado) se muestra empleando el mensaje como
la cadena de formato.
Algunos formatos de fichero contienen información adicional que se
mostrará junto con el tipo del fichero. Una lÃnea que comience con el
carácter > indica pruebas y mensajes a mostrarse adicionales. El número
de > en la lÃnea indica el nivel de la prueba; una lÃnea sin ningún >
al principio se considera que está en el nivel 0. Cada lÃnea en el
nivel n+1 está bajo el control de la lÃnea en el nivel n más cercano
que la preceda en el fichero mágico. Si la prueba en una lÃnea en el
nivel n tiene éxito, se realizan las pruebas especificadas en todas las
lÃneas subsiguientes en el nivel n+1 y se muestran los mensajes si las
pruebas tienen éxito. La lÃnea siguiente en el nivel n termina con
esto. Si el primer carácter que siga al último > es un ( entonces la
cadena tras el paréntesis se interpreta como un desplazamiento
indirecto. Eso significa que el número tras el paréntesis se emplea
como un desplazamiento en el fichero. Se lee el valor en tal
desplazamiento, y se emplea de nuevo como un desplazamiento en el
fichero. Los desplazamientos indirectos son de la forma:
((x[.[bslBSL]][+-][y]). El valor de x se emplea como un desplazamiento
en el fichero. Se lee en tal sitio un byte, un entero corto o uno
largo, dependiendo del especificador de tipo [bslBSL]. Los tipos en
mayúsculas interpretan el número como un valor ascendente hacia la
derecha, mientras que las versiones en minúsculas lo interpretan como
ascendente hacia la izquierda. A ese número se le suma el valor de y y
el resultado se emplea como un desplazamiento en el fichero. El tipo
predeterminado si no se especifica uno es long, un entero largo.
A veces uno no sabe la posición exacta puesto que ésta depende de la
longitud de los campos anteriores. Entonces se puede especificar un
desplazamiento o posición relativa al final del último campo del nivel
superior (por supuesto esto sólo puede hacerse para pruebas en
subniveles, como en las que empiezan con >). Tal desplazamiento
relativo se especifica empleando & como prefijo del desplazamiento.
FALLOS
Los formatos long, belong, lelong, short, beshort, leshort, date,
bedate, y ledate son dependientes del sistema; quizás deberÃan
especificarse como un número de bytes (2B, 4B, etc.), puesto que los
ficheros que se están reconociendo vienen normalmente de un sistema en
el que las longitudes son invariantes.
No hay (actualmente) soporte para que se empleen datos con sexo
(endianess) especificado en desplazamientos indirectos.
VÉASE TAMBIÉN
file(1) - la orden que lee este fichero.
Dominio Público MAGIC(4)