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.