wiki:ApiHidra

Version 25 (modified by trac, 7 years ago) (diff)

--

Índice

  1. Descripción
  2. Funciones internas C
  3. Funciones BASH
    1. Funciones básicas
    2. Funciones de particiones
    3. Funciones de caché local y repositorio remoto
    4. Funciones de clonación
    5. Funciones de edición o modificación
    6. Funciones de inventario
    7. Funciones de ficheros
  4. Tabla de códigos de error
  5. Tabla de mnemónicos de tipos de particiones
  6. Tabla de mnemónicos de tipos de dispositivos

API de funciones de Hidra

Descripción

El interfaz web Hidra utilizará 2 tipos principales de funciones:

  • Funciones C incluidas en el código del cliente y del servidor.
  • Funciones y scripts BASH ejecutables por el cliente.

El desarrollo de las funciones debe cumplir el siguiente estilo:

  • Todos los nombres de funciones y variables deben ser descriptivos y fáciles de recordar.
  • Nombres de funciones al estilo Rembo-C, sólo con las iniciales en mayúsculas.
  • Para evitar inconsistencias y para mantener la compatibilidad con EAC, los nombres del as funciones Hidra tendrán el prefijo hidra.
  • Las constantes y variables globales deben ir escritas en mayúsculas.
  • Debe incluirse toda la información necesaria en las cabeceras de las funciones (descripción, formato, salidas, notas, etc.).
  • Deben incluirse comentarios descriptivos en los bloques de código.
  • La función Hidra llamará a la función correspondiente EAC, siempre que exista esta última y que cumpla los requisitos de funcionamiento.
  • En el caso de que una función EAC no devuelva el formato adecuado para el gestor Hidra, deberá desarrollarse una nueva función equivalente.

Funciones internas C

...

Funciones BASH

Funciones básicas

Funciones de particiones

Funciones de caché local y repositorio remoto

Funciones de clonación

Funciones de edición o modificación

Funciones de inventario

Funciones de ficheros

(por definir)

Tabla de códigos de error

ValorMnemónico Descripción
0 Ejecución correcta sin error
1 ERRFORMAT Llamada incorrecta a la función o parámetros incorrectos
2 ERRNOTFOUND Fichero, directorio o dispositivo no encontrado o inaccesible
3 ERRPARTITIONTipo o tamaño de partición erróneo o no reconocido
4 ERRNOTEXEC Programa o función desconocido o no ejecutable
5 ERRNOTOS Partición sin sistema operativo
6 ERRLOCKED Partición bloqueada por una operación de uso exclusivo

Tabla de mnemónicos de tipos de particiones

IdentificadorMnemónicoTipo de partición
00 EMPTY Partición vacía no definida
05 EXTENDED Partición extendida que puede contener varias particiones lógicas
06, 0e BIGDOS FAT16
07 NTFS NTFS
0b, 0c FAT32 FAT32
16, 1e HBIGDOS FAT16 oculta
17 HNTFS NTFS oculta
1b, 1c HFAT32 FAT32 oculta
82 LINUX-SWAPPaginación para Linux (swap)
83 EXT2, EXT3, EXT4, REISERFS, REISER4Partición Linux tipo Extension o Reiser
8e LINUX-LVMPartición de volumen lógico para Linux
a7 CACHE Caché local para EAC (se formateará como Ext3).
fd RAID-EXT2, RAID-EXT3, RAID-EXT4Partición RAID para Linux tipo Ext2, Ext3 o Ext4
- UNKNOWN Tipo de partición desconocido.
- EXCED Indica cuando una partición tiene espacio libre o se solapa con la siguiente (no es un mnemónico real).

Tabla de mnemónicos de tipos de dispositivos

MnemónicoTipo de hardware
mod Marca y modelo del equipo
boa Placa base
bio Modelo y versión de la BIOS
cpu Modelo y velocidad del procesador
mem Tamaño de la memoria
vga Tarjeta gráfica
net Tarjeta de red
mul Tarjeta de sonido o muldimedia
ide Controladora de discos IDE ATA/SATA
dis Modelo y capacidad del disco duro
cdr Modelo de lectora o grabadora de CD/DVD
usb Dispositivo USB
fir Dispositivo FireWire
bus Bus interno de gestión