[[PageOutline(2-5,Índice)]]

= Definición de la API de funciones 1.0 =

Este artítulo incluye los cambios previstos para ser incluidos en la definición de la versión 1.0 de la API de funciones del motor de clonación de !OpenGnSys. ''Nota: Estos cambios se incluirán en la página de la API cuando se termine su implementación''.

Modificaciones importantes:
 * Detección de discos físicos y lógicos.
 * Separación de objetos de tipo partición y sistema de archivos.
 * Redefinición y ampliación de códigos de error.
 * Nuevas librerías de funciones.
 * Gestión de la caché local.
 * Protocolos de comunicaciones.
 * ...


== Tipos de datos ==

Nuevos tipos de datos definidos o modificados en la API 1.0:
 * Tipo de disco:
 * Partición:
 * Tipo de partición:
 * Identificador de partición:
 * Sistema de archivos:
 * Tipo de sistema de archivos:
 * ...

== Tipos de discos ==

Tabla de mnemónicos de tipos de sistemas de almacenamiento:

||'''Tipo dispositivo'''||'''Mnemónico'''|| '''Tipo de disco'''               ||
|| 1                    ||{{{RAMDISK}}}  ||Disco en memoria                   ||
|| 3, 8, 65-69, 104-107 ||{{{DISK}}}     ||Disco local USB o RAID por hardware||
|| 7                    ||{{{LOOP}}}     ||Disco en fichero                   ||
|| 9                    ||{{{RAID}}}     ||RAID software                      ||
|| 31                   ||{{{ROMFLASH}}} ||ROM Flash                          ||
|| 43                   ||{{{NBD}}}      ||Network Block Device               ||
|| 79                   ||{{{CARD}}}     ||Tarjeta SD/MMC                     ||
|| 240-254              ||               ||Reservado (comprobar LVM)          ||


== Particiones ==

Cambios en la tabla de mnemónicos de tipos de partición:

||'''Identificador'''|| '''Mnemónico''' ||'''Tipo de partición'''                 ||
|| 07                ||{{{NTFS}}}       ||NTFS o FAT64 (exFAT)                    ||
|| 12                ||{{{COMPAQDIAG}}} || -                                      ||
|| 42                ||{{{WIN-DYNAMIC}}}|| -                                      ||
|| 83                ||{{{LINUX}}}      ||Partición para sistemas operativos Linux||
|| af                ||{{{HFS}}}        ||Partición para sistemas operativos MacOS||


== Sistemas de archivos ==

Tabla de mnemónicos de tipos de sistemas de archivos y de particiones compatibles:

{{{
#!rst
+-----------+----------------------------+
| Mnemónico |Tipo de partición compatible|
+-----------+----------------------------+
| EXT2      |                            |
+-----------+                            |
| EXT3      |                            |
+-----------+                            |
| EXT4      |                            |
+-----------+                            |
| REISERFS  | LINUX                      |
+-----------+                            |
| REISER4   |                            |
+-----------+                            |
| JFS       |                            |
+-----------+                            |
| XFS       |                            |
+-----------+----------------------------+
| NTFS      |                            |
+-----------+ NTFS, HNTFS                |
| EXFAT     |                            |
+-----------+----------------------------+
| FAT32     | FAT32, HFAT32              |
+-----------+----------------------------+
| FAT16     | FAT16, HFAT16              |
+-----------+----------------------------+
| FAT12     | FAT12, HFAT12              |
+-----------+----------------------------+
| HFS       |                            |
+-----------+ HFS                        |
| HFS+      |                            |
+-----------+----------------------------+
| SOLARIS   | SOLARIS                    |
+-----------+----------------------------+
}}}

== Errores ==


codigos de ejecución. propuesta 1.0.1
||'''Código'''|| '''Mnemónico'''       || '''Descripción'''                          ||
||      0     ||      TRUE             ||          TRUE                              || 
||      1     ||      FALSE            ||          FALSE                             ||

Tabla de códigos de error propuesta 1.0.1 :

||'''Código'''|| '''Mnemónico'''       || '''Descripción'''                          ||
||      2     ||{{{OG_ERR_FORMAT}}}    ||Formato de ejecución incorrecto             ||
||      3     ||{{{OG_ERR_NOTFOUND}}}  ||Fichero o dispositivo no encontrado         ||
||      4     ||{{{OG_ERR_OUTOFLIMIT}}}||Valor fuera de rango o no válido            ||
||      5     ||{{{OG_ERR_PARTITION}}} ||Partición no reconocida o no se puede montar||
||      6     ||{{{OG_ERR_LOCKED}}}    ||Partición o fichero bloqueado               ||
||      7     ||{{{OG_ERR_IMAGE}}}     ||Error al crear o restaurar una imagen       ||
||    8-13    || RESERVASO             || RESERVADO para ogADMClient local           ||
||            ||{{{OG_ERR_FILESYS}}}   ||Error de sistema de archivos                ||
||            ||{{{OG_ERR_NOTOS}}}     ||Sin sistema operativo                       ||
||            ||{{{OG_ERR_NOTEXEC}}}   ||Programa o función no ejecutable            ||
||            ||{{{OG_ERR_NOTWRITE}}}  ||      No hay acceso de escritura            ||
||            ||{{{OG_ERR_NOTCACHE}}}  ||      No hay particion cache en cliente     ||
||            ||{{{OG_ERR_CACHESIZE}}}  ||     No hay espacio suficiente en CACHE      ||
||            ||{{{OG_ERR_REDUCEFS}}}  ||      Error al reducir sistema archivos    ||
||            ||{{{OG_ERR_EXTENDFS}}}  ||      Error al expandir el sistema de archivos     ||
||            ||{{{OG_ERR_EXTENDFS}}}  ||      Error al expandir el sistema de archivos     ||
||            ||{{{OG_ERR_IMGSIZEPARTITION}}}  ||   Error al restaurar: Particion mas pequeña que la imagen       ||


 OG_ERR_UCASTSYNTAXT=50  # Error en la generación de sintaxis de transferenica unicast
 OG_ERR_UCASTSENDPARTITION=51  # Error en envio UNICAST de una particion
 OG_ERR_UCASTSENDFILE=52  # Error en envio UNICAST de un fichero
 OG_ERR_UCASTRECEIVERPARTITION=53  #Error en la recepcion UNICAST de una particion
 OG_ERR_UCASTRECEIVERFILE=54  #Error en la recepcion UNICAST de un fichero
 OG_ERR_MCASTSYNTAXT=55 # Error en la generacion de sintaxis de transferenica Multicast.
 OG_ERR_MCASTSENDFILE=56  # Error en envio MULTICAST de un fichero
 OG_ERR_MCASTRECEIVERFILE=57  #Error en la recepcion MULTICAST de un fichero
 OG_ERR_MCASTSENDPARTITION=58  # Error en envio MULTICAST de una particion
 OG_ERR_MCASTRECEIVERPARTITION=59  # Error en la recepcion MULTICAST de una particion
 OG_ERR_PROTOCOLJOINMASTER=60 # Error en la conexion de una sesion UNICAST|MULTICAST con el MASTER




Tabla de códigos de error 1.0:

||'''Código'''|| '''Mnemónico'''       || '''Descripción'''                          ||
||      1     ||{{{OG_ERR_FORMAT}}}    ||Formato de ejecución incorrecto             ||
||      2     ||{{{OG_ERR_NOTFOUND}}}  ||Fichero o dispositivo no encontrado         ||
||      3     ||{{{OG_ERR_OUTOFLIMIT}}}||Valor fuera de rango o no válido            ||
||      4     ||{{{OG_ERR_PARTITION}}} ||Partición no reconocida o no se puede montar||
||      5     ||{{{OG_ERR_LOCKED}}}    ||Partición o fichero bloqueado               ||
||      6     ||{{{OG_ERR_IMAGE}}}     ||Error al crear o restaurar una imagen       ||
||      7     ||{{{OG_ERR_CACHE}}}     ||Error en partición de caché local           ||
||      8     ||{{{OG_ERR_FILESYS}}}   ||Error de sistema de archivos                ||
||      9     ||{{{OG_ERR_NOTOS}}}     ||Sin sistema operativo                       ||
||     10     ||{{{OG_ERR_NOTEXEC}}}   ||Programa o función no ejecutable            ||