source: client/engine/FileSystem.lib @ 8e29877

#!/bin/bash
#/**
#@file    FileSystem.lib
#@brief   Librería o clase FileSystem
#@class   FileSystem
#@brief   Funciones para gestión de sistemas de archivos.
#@version 1.0.5
#@warning License: GNU GPLv3+
#*/


#/**
#         ogCheckFs int_ndisk int_nfilesys
#@brief   Comprueba el estado de un sistema de archivos.
#@param   int_ndisk      nº de orden del disco
#@param   int_nfilesys   nº de orden del sistema de archivos
#@return  (nada)
#@exception OG_ERR_FORMAT    Formato incorrecto.
#@exception OG_ERR_NOTFOUND  Disco o particion no corresponden con un dispositivo.
#@exception OG_ERR_PARTITION Partición desconocida o no accesible.
#@note    Requisitos: *fsck*
#@warning No se comprueban sistemas de archivos montados o bloqueados.
#@todo    Definir salidas.
#@version 0.9 - Primera adaptación para OpenGnSys.
#@author  Ramon Gomez, ETSII Universidad de Sevilla
#@date    2009-10-07
#@version 1.0.2 - Ignorar códigos de salida de comprobación (no erróneos).
#@author  Ramon Gomez, ETSII Universidad de Sevilla
#@date    2011-09-23
#@version 1.0.4 - Soportar HFS/HFS+.
#@author  Ramon Gomez, ETSII Universidad de Sevilla
#@date    2012-05-21
#@version 1.0.5 - Desmontar antes de comprobar.
#@author  Ramon Gomez, ETSII Universidad de Sevilla
#@date    2012-09-05
#*/ ##
function ogCheckFs ()
{
# Variables locales.
local PART TYPE PROG PARAMS CODES ERRCODE
# Si se solicita, mostrar ayuda.
if [ "$*" == "help" ]; then
    ogHelp "$FUNCNAME" "$FUNCNAME int_ndisk int_nfilesys" \
           "$FUNCNAME 1 1"
    return
fi

# Error si no se reciben 2 parámetros.
[ $# == 2 ] || ogRaiseError $OG_ERR_FORMAT || return $?
# Obtener partición.
PART="$(ogDiskToDev $1 $2)" || return $?

TYPE=$(ogGetFsType $1 $2)
case "$TYPE" in
    EXT[234])     PROG="e2fsck"; PARAMS="-y"; CODES=(1 2) ;;
    REISERFS)     PROG="fsck.reiserfs"; PARAMS="<<<\"Yes\""; CODES=(1 2) ;;
    REISER4)      PROG="fsck.reiser4"; PARAMS="-ay" ;;
    JFS)          PROG="fsck.jfs"; CODES=(1 2) ;;
    XFS)          PROG="fsck.xfs" ;;
    NTFS)         PROG="ntfsfix" ;;
    FAT32)        PROG="dosfsck"; PARAMS="-a"; CODES=1 ;;
    FAT16)        PROG="dosfsck"; PARAMS="-a"; CODES=1 ;;
    FAT12)        PROG="dosfsck"; PARAMS="-a"; CODES=1 ;;
    HFS)          PROG="fsck.hfs" ;;
    HFSPLUS)      PROG="fsck.hfsplus" ;;
    *)            ogRaiseError $OG_ERR_PARTITION "$1, $2, $TYPE"
                  return $? ;;
esac
# Error si el sistema de archivos esta montado o bloqueado.
ogUnmount $1 $2
if ogIsMounted $1 $2; then
    ogRaiseError $OG_ERR_PARTITION "$1 $2"       # Indicar nuevo error
    return $?
fi
if ogIsLocked $1 $2; then
    ogRaiseError $OG_ERR_LOCKED "$1 $2"
    return $?
fi
# Comprobar en modo uso exclusivo.
ogLock $1 $2
trap "ogUnlock $1 $2" 1 2 3 6 9
eval $PROG $PARAMS $PART
ERRCODE=$?
case $ERRCODE in
    0|${CODES[*]})
            ERRCODE=0 ;;
    127)    ogRaiseError $OG_ERR_NOTEXEC "$PROG"
            ERRCODE=$OG_ERR_NOTEXEC ;;
    *)      ogRaiseError $OG_ERR_PARTITION "$1 $2"
            ERRCODE=$OG_ERR_PARTITION ;;
esac
ogUnlock $1 $2
return $ERRCODE
}


#/**
#         ogExtendFs int_ndisk int_nfilesys
#@brief   Extiende un sistema de archivos al tamaño de su partición.
#@param   int_ndisk      nº de orden del disco
#@param   int_nfilesys   nº de orden del sistema de archivos
#@return  (nada)
#@exception OG_ERR_FORMAT   Formato incorrecto.
#@exception OG_ERR_NOTFOUND Disco o particion no corresponden con un dispositivo.
#@exception OG_ERR_PARTITION Partición desconocida o no accesible.
#@note    Requisitos: *resize*
#@version 0.1 -  Integracion para Opengnsys  -  EAC:   EnlargeFileSystem() en ATA.lib
#@author  Antonio J. Doblas Viso. Universidad de Malaga
#@date    2008-10-27
#@version 0.9 - Primera adaptacion para OpenGnSys.
#@author  Ramon Gomez, ETSII Universidad de Sevilla
#@date    2009-09-23
#@version 1.0.5 - Soporte para BTRFS.
#@author  Ramon Gomez, ETSII Universidad de Sevilla
#@date    2012-06-28
#*/ ##
function ogExtendFs ()
{
# Variables locales.
local PART TYPE PROG PARAMS ERRCODE

# Si se solicita, mostrar ayuda.
if [ "$*" == "help" ]; then
    ogHelp "$FUNCNAME" "$FUNCNAME int_ndisk int_nfilesys" \
           "$FUNCNAME 1 1"
    return
fi
# Error si no se reciben 2 parámetros.
[ $# == 2 ] || ogRaiseError $OG_ERR_FORMAT || return $?

# Obtener partición.
PART="$(ogDiskToDev $1 $2)" || return $?

# Redimensionar al tamano máximo según el tipo de partición.
TYPE=$(ogGetFsType $1 $2)
case "$TYPE" in
    EXT[234])   PROG="resize2fs"; PARAMS="-f" ;;
    REISERFS)   PROG="resize_reiserfs"; PARAMS="-f" ;;
    BTRFS)      PROG="btrfs"; PARAMS="filesystem resize max" ;;
    NTFS)       PROG="ntfsresize"; PARAMS="<<<\"y\" -f" ;;
#    FAT32|FAT16)       # Usar "fatresize"
    *)          ogRaiseError $OG_ERR_PARTITION "$1 $2 $TYPE"
                return $? ;;
esac
# Error si el sistema de archivos está montado o bloqueado.
ogUnmount $1 $2 2>/dev/null
if ogIsMounted $1 $2; then
    ogRaiseError $OG_ERR_PARTITION "$1 $2"       # Indicar nuevo error
    return $?
fi
if ogIsLocked $1 $2; then
    ogRaiseError $OG_ERR_LOCKED "$1 $2"
    return $?
fi
# Redimensionar en modo uso exclusivo.
ogLock $1 $2
trap "ogUnlock $1 $2" 1 2 3 6 9
eval $PROG $PARAMS $PART &>/dev/null
ERRCODE=$?
case $ERRCODE in
    0)    ;;
    127)  ogRaiseError $OG_ERR_NOTEXEC "$PROG"
          ERRCODE=$OG_ERR_NOTEXEC ;;
    *)    ogRaiseError $OG_ERR_PARTITION "$1 $2"
          ERRCODE=$OG_ERR_PARTITION ;;
esac
ogUnlock $1 $2
return $ERRCODE
}


#/**
#         ogFormat int_ndisk int_nfilesys | CACHE
#@see     ogFormatFs ogFormatCache
#*/ ##
function ogFormat ()
{
case "$*" in
    CACHE|cache)  ogFormatCache ;;
    *)            ogFormatFs "$@" ;;
esac
}


#/**
#         ogFormatFs int_ndisk int_nfilesys [type_fstype] [str_label]
#@brief   Formatea un sistema de ficheros según el tipo de su partición.
#@param   int_ndisk      nº de orden del disco
#@param   int_nfilesys   nº de orden del sistema de archivos
#@param   type_fstype    mnemónico de sistema de ficheros a formatear
#@param   str_label      etiqueta de volumen (opcional)
#@return  (por determinar)
#@exception OG_ERR_FORMAT    Formato incorrecto.
#@exception OG_ERR_NOTFOUND  Disco o particion no corresponden con un dispositivo.
#@exception OG_ERR_PARTITION Partición no accesible o desconocida.
#@note    Requisitos:   mkfs*
#@warning No formatea particiones montadas ni bloqueadas.
#@todo    Definir salidas.
#@version 0.9 - Primera versión para OpenGnSys.
#@author  Ramon Gomez, ETSII Universidad de Sevilla
#@date    2009-10-08
#@version 1.0.4 - Solucionado error cuando no se detecta tipo de sistema de ficheros pero si se indica
#@author  Universidad de Huelva
#@date    2012-04-11
#*/ ##
function ogFormatFs ()
{
# Variables locales
local PART ID TYPE LABEL PROG PARAMS ERRCODE

# Si se solicita, mostrar ayuda.
if [ "$*" == "help" ]; then
    ogHelp "$FUNCNAME" "$FUNCNAME int_ndisk int_nfilesys [str_label]" \
           "$FUNCNAME 1 1" \
           "$FUNCNAME 1 1 EXT4" \
           "$FUNCNAME 1 1 \"DATA\"" \
           "$FUNCNAME 1 1 EXT4 \"DATA\""
    return
fi
# Error si no se reciben entre 2 y 4 parámetros.
[ $# -ge 2 -a $# -le 4 ] || ogRaiseError $OG_ERR_FORMAT || return $?
# Obtener fichero de dispositivo.
PART="$(ogDiskToDev $1 $2)" || return $?
# Error si la partición está montada o bloqueada.
if ogIsMounted $1 $2; then
    ogRaiseError $OG_ERR_PARTITION "$1 $2"       # Indicar nuevo error
    return $?
fi
if ogIsLocked $1 $2; then
    ogRaiseError $OG_ERR_LOCKED "$1 $2"
    return $?
fi
# Obtener tipo de sisitema de archivos.
TYPE="$(ogGetFsType $1 $2)"
if [ -z "$TYPE" ]; then
    # Si no se indico ningun tipo de sistema de ficheros se retorna
    if [ -z "$3" ]; then
        return $?
    else
    # Si no se detecto, se asigna el indicado
        TYPE="$3"
    fi
fi

# Elegir tipo de formato segun el tipo de particion.
case "$3" in
    EXT2)      ID=83; PROG="mkfs.ext2" ;;
    EXT3)      ID=83; PROG="mkfs.ext3" ;;
    EXT4)      ID=83; PROG="mkfs.ext4" ;;
    BTRFS)     ID=83; PROG="mkfs.btrfs" ;;
    REISERFS)  ID=83; PROG="mkfs.reiserfs"; PARAMS="-f" ;;
    REISER4)   ID=83; PROG="mkfs.reiser4" ;;
    XFS)       ID=83; PROG="mkfs.xfs"; PARAMS="-f" ;;
    JFS)       ID=83; PROG="mkfs.jfs"; PARAMS="<<<\"y\"";;
    NTFS)      ID=7;  PROG="mkntfs"; PARAMS="-f" ;;
    HNTFS)     ID=17; PROG="mkntfs"; PARAMS="-f" ;;
    FAT32)     ID=b;  PROG="mkdosfs"; PARAMS="-F 32" ;;
    HFAT32)    ID=1b; PROG="mkdosfs"; PARAMS="-F 32" ;;
    FAT16)     ID=6;  PROG="mkdosfs"; PARAMS="-F 16" ;;
    HFAT16)    ID=16; PROG="mkdosfs"; PARAMS="-F 16" ;;
    FAT12)     ID=1;  PROG="mkdosfs"; PARAMS="-F 12" ;;
    HFAT12)    ID=11; PROG="mkdosfs"; PARAMS="-F 12" ;;
    HFS)       ID=af; PROG="mkfs.hfs" ;;
    HFSPLUS)   ID=af; PROG="mkfs.hfsplus" ;;
    UFS)       ID=bf; PROG="mkfs.ufs"; PARAMS="-O 2" ;;
    *)         LABEL="$3" ;;
esac
# Si no se indica explícitamente, detectar el tipo de sistema de archivos.
if [ -z "$PROG" ]; then
    case "$TYPE" in
        EXT2)         PROG="mkfs.ext2" ;;
        EXT3)         PROG="mkfs.ext3" ;;
        EXT4)         PROG="mkfs.ext4" ;;
        BTRFS)        PROG="mkfs.btrfs" ;;
        REISERFS)     PROG="mkfs.reiserfs"; PARAMS="-f" ;;
        REISER4)      PROG="mkfs.reiser4" ;;
        XFS)          PROG="mkfs.xfs"; PARAMS="-f" ;;
        JFS)          PROG="mkfs.jfs"; PARAMS="<<<\"y\"" ;;
        LINUX-SWAP)   PROG="mkswap" ;;
        NTFS)         PROG="mkntfs"; PARAMS="-f" ;;
        FAT32)        PROG="mkdosfs"; PARAMS="-F 32" ;;
        FAT16)        PROG="mkdosfs"; PARAMS="-F 16" ;;
        FAT12)        PROG="mkdosfs"; PARAMS="-F 12" ;;
        HFS)          PROG="mkfs.hfs" ;;
        HFSPLUS)      PROG="mkfs.hfsplus" ;;
        UFS)          PROG="mkfs.ufs"; PARAMS="-O 2" ;;
        *)            ogRaiseError $OG_ERR_PARTITION "$1 $2 $TYPE"
                      return $? ;;
    esac
else
    [ $TYPE == "$3" -o $ID == "$(ogGetPartitionId $1 $2)" ] || ogRaiseError $OG_ERR_PARTITION "$3 != $TYPE" || return $?
fi
# Comprobar consistencia entre id. de partición y tipo de sistema de archivos.
[ -n "$PROG" ] || ogRaiseError $OG_ERR_PARTITION "$3 != $TYPE" || return $?

# Etiquetas de particion.
if [ -z "$LABEL" ]; then
    [ "$4" != "CACHE" ] || ogRaiseError $OG_ERR_FORMAT "$MSG_RESERVEDVALUE: CACHE" || return $?
    [ -n "$4" ] && PARAMS="$PARAMS -L $4"
else
    PARAMS="$PARAMS -L $LABEL"
fi

# Formatear en modo uso exclusivo (desmontar siempre).
ogLock $1 $2
trap "ogUnlock $1 $2" 1 2 3 6 9
ogUnmount $1 $2
eval $PROG $PARAMS $PART 2>/dev/null
ERRCODE=$?
case $ERRCODE in
    0)    ;;
    127)  ogRaiseError $OG_ERR_NOTEXEC "$PROG" ;;
    *)    ogRaiseError $OG_ERR_PARTITION "$1 $2" ;;
esac
ogUnlock $1 $2
return $ERRCODE
}


#/**
#         ogGetFsSize int_ndisk int_npartition [str_unit]
#@brief Muestra el tamanio del sistema de archivos indicado, permite definir la unidad de medida, por defecto GB
#@param   int_ndisk      nº de orden del disco
#@param   int_npartition nº de orden de la partición
#@param   str_unit       unidad (opcional, por defecto: KB)
#@return  float_size - Tamaño del sistema de archivos
#@note    str_unit = { KB, MB, GB, TB }
#@exception OG_ERR_FORMAT   Formato incorrecto.
#@exception OG_ERR_NOTFOUND Disco o partición no corresponden con un dispositivo.
#@version 0.1 -  Integracion para Opengnsys  -  EAC:  SizeFileSystem() en FileSystem.lib
#@author  Antonio J. Doblas Viso. Universidad de Malaga
#@date    2008-10-27
#@version 1.0.4 - Adaptación de las salidas.
#@author  Ramon Gomez, ETSII Universidad de Sevilla
#@date    2012-06-18
#*/ ##
function ogGetFsSize ()
{
# Variables locales.
local MNTDIR UNIT VALUE FACTOR SIZE
# Si se solicita, mostrar ayuda.
if [ "$*" == "help" ]; then
    ogHelp "$FUNCNAME" "$FUNCNAME int_ndisk int_npartition [str_unit]" \
           "$FUNCNAME 1 1  =>  15624188" \
           "$FUNCNAME 1 1 KB  =>  15624188"
    return
fi
# Error si no se reciben 2 o 3 parámetros.
[ $# == 2 ] || [ $# == 3 ] || ogRaiseError $OG_ERR_FORMAT || return $?
# Obtener unidad y factor de medida.
UNIT="$3"
UNIT=${UNIT:-"KB"}
case "$UNIT" in
    [kK]B)
        FACTOR=1 ;;
    MB) FACTOR=1024 ;;
    GB) FACTOR=$[1024*1024] ;;
    TB) FACTOR=$[1024*1024*1024] ;;
    *)  ogRaiseError $OG_ERR_FORMAT "$3 != { KB, MB, GB, TB }"
        return $? ;;
esac

# Obtener el tamaño del sistema de archivo (si no está formateado; tamaño = 0).
MNTDIR="$(ogMount $1 $2 2>/dev/null)"
if [ -n "$MNTDIR" ]; then
    VALUE=$(df -BK "$MNTDIR" | awk '{getline; print $2}')
    SIZE=$(echo "$VALUE $FACTOR" | awk '{printf "%f\n", $1/$2}')
else
    SIZE=0
fi
# Devolver el tamaño (quitar decimales si son 0).
echo ${SIZE%.0*}
}


#/**
#         ogGetFsType int_ndisk int_nfilesys
#@brief   Devuelve el mnemonico con el tipo de sistema de archivos.
#@param   int_ndisk      nº de orden del disco
#@param   int_nfilesys   nº de orden del sistema de archivos
#@return  Mnemonico
#@note    Mnemonico: { EXT2, EXT3, EXT4, REISERFS, XFS, JFS, FAT16, FAT32, NTFS, CACHE }
#@exception OG_ERR_FORMAT   Formato incorrecto.
#@exception OG_ERR_NOTFOUND Disco o particion no corresponden con un dispositivo.
#@version 0.1 -  Integracion para Opengnsys  -  EAC:   TypeFS() en ATA.lib
#@author  Antonio J. Doblas Viso. Universidad de Malaga
#@date    2008-10-27
#@version 0.9 - Primera adaptacion para OpenGnSys.
#@author  Ramon Gomez, ETSII Universidad de Sevilla
#@date    2009-07-21
#@version 1.0.2 - Obtención de datos reales de sistemas de ficheros.
#@author  Ramon Gomez, ETSII Universidad de Sevilla
#@date    2011-12-02
#@version 1.0.5 - Usar "mount" en vez de "parted".
#@author  Ramon Gomez, ETSII Universidad de Sevilla
#@date    2012-09-04
#*/ ##
function ogGetFsType ()
{
# Variables locales.
local PART ID TYPE
# Si se solicita, mostrar ayuda.
if [ "$*" == "help" ]; then
    ogHelp "$FUNCNAME" "$FUNCNAME int_ndisk int_nfilesys" \
           "$FUNCNAME 1 1  =>  NTFS"
    return
fi
# Error si no se reciben 2 parámetros.
[ $# == 2 ] || ogRaiseError $OG_ERR_FORMAT || return $?

# Detectar id. de tipo de partición.
PART=$(ogDiskToDev "$1" "$2") || return $?
ID=$(ogGetPartitionId "$1" "$2")
[ "$ID" == "a7" ] && ID="ca"    # Traducir antiguo id. de partición de caché.
TYPE=""
case "$ID" in
     ca|CA00)  # Detectar caché local (revisar detección en tablas GPT).
               ogIsFormated $1 $2 2>/dev/null && TYPE="CACHE"
               ;;
     *)        # Detectar sistema de ficheros.
               ogMount $1 $2 &>/dev/null
               TYPE=$(mount | awk -v p=$PART '{ if ($1==p) { print toupper($5); } }')
               # Detectar otros sistemas de archivos (FUSE, VFAT).
               case "$TYPE" in
                    FUSEBLK) TYPE="NTFS" ;;    # usar "file -Ls" para detectar
                    VFAT)    TYPE="FAT32" ;;   # usar "file -Ls" para detectar
               esac
               ;;
esac

[ -n "$TYPE" ] && echo "$TYPE"
}


#/**
#         ogGetMountPoint int_ndisk int_nfilesys
#@brief   Devuelve el punto de montaje de un sistema de archivos.
#@param   int_ndisk      nº de orden del disco
#@param   int_nfilesys   nº de orden del sistema de archivos
#@return  Punto de montaje
#@exception OG_ERR_FORMAT    Formato incorrecto.
#@exception OG_ERR_NOTFOUND  Disco o particion no corresponden con un dispositivo.
#@note    Requisitos: \c mount* \c awk
#@version 0.9 - Primera versión para OpenGnSys.
#@author  Ramon Gomez, ETSII Universidad de Sevilla
#@date    2009-10-15
#*/ ##
function ogGetMountPoint ()
{
# Variables locales
local PART
# Si se solicita, mostrar ayuda.
if [ "$*" == "help" ]; then
    ogHelp "$FUNCNAME" "$FUNCNAME int_ndisk int_nfilesys" \
           "$FUNCNAME 1 1  =>  /mnt/sda1"
    return
fi
# Error si no se reciben 2 parámetros.
[ $# == 2 ] || ogRaiseError $OG_ERR_FORMAT || return $?
# Obtener partición.
PART="$(ogDiskToDev $1 $2)" || return $?

mount | awk -v P=$PART '{if ($1==P) {print $3}}'
}


#/**
#         ogIsFormated int_ndisk int_nfilesys
#@brief   Comprueba si un sistema de archivos está formateado.
#@param   int_ndisk      nº de orden del disco o volumen.
#@param   int_nfilesys   nº de orden del sistema de archivos
#@return  Código de salida: 0 - formateado, 1 - sin formato o error.
#@version 0.91 - Adaptación inicial para comprobar que existe caché.
#@author  Ramon Gomez, ETSII Universidad de Sevilla
#@date    2010-03-18
#@version 1.0.1 - Devolver falso en caso de error.
#@author  Ramon Gomez, ETSII Universidad de Sevilla
#@date    2011-05-18
#@version 1.0.5 - Dejar de usar "parted".
#@author  Ramon Gomez, ETSII Universidad de Sevilla
#@date    2012-09-04
#*/ ##
function ogIsFormated ()
{
# Variables locales
local DISK
if [ "$*" == "help" ]; then
    ogHelp "$FUNCNAME" "$FUNCNAME int_ndisk int_nfilesys" \
           "if $FUNCNAME 1 1; then ... ; fi"
    return
fi
# Falso, en caso de error.
[ $# == 2 ] || return 1

test -n "$(ogMount "$1" "$2")"
}


#/**
#         ogIsMounted int_ndisk int_nfilesys
#@brief   Comprueba si un sistema de archivos está montado.
#@param   int_ndisk      nº de orden del disco
#@param   int_nfilesys   nº de orden del sistema de archivos
#@return  Código de salida: 0 - montado, 1 - sin montar o error.
#@version 0.9 - Primera versión para OpenGnSys.
#@author  Ramon Gomez, ETSII Universidad de Sevilla
#@date    2009-10-15
#@version 1.0.1 - Devolver falso en caso de error.
#@author  Ramon Gomez, ETSII Universidad de Sevilla
#@date    2011-05-18
#*/ ##
function ogIsMounted ()
{
# Si se solicita, mostrar ayuda.
if [ "$*" == "help" ]; then
    ogHelp "$FUNCNAME" "$FUNCNAME int_ndisk int_nfilesys" \
           "if $FUNCNAME 1 1; then ... ; fi"
    return
fi
# Falso, en caso de error.
[ $# == 2 ] || return 1

test -n "$(ogGetMountPoint $1 $2)"
}


#/**
#         ogIsLocked int_ndisk int_npartition
#@brief   Comprueba si una partición está bloqueada por una operación de uso exclusivo.
#@param   int_ndisk      nº de orden del disco
#@param   int_npartition nº de orden de la partición
#@return  Código de salida: 0 - bloqueado, 1 - sin bloquear o error.
#@note    El fichero de bloqueo se localiza en \c /var/lock/part, siendo \c part el dispositivo de la partición, sustituyendo el carácter "/" por "-".
#@version 0.9 - Primera versión para OpenGnSys.
#@author  Ramon Gomez, ETSII Universidad de Sevilla
#@date    2009-09-03
#@version 1.0.1 - Devolver falso en caso de error.
#@author  Ramon Gomez, ETSII Universidad de Sevilla
#@date    2011-05-18
#*/ ##
function ogIsLocked ()
{
# Variables locales
local PART LOCKFILE

# Si se solicita, mostrar ayuda.
if [ "$*" == "help" ]; then
    ogHelp "$FUNCNAME" "$FUNCNAME int_ndisk int_npartition" \
           "if $FUNCNAME 1 1; then ... ; fi"
    return
fi
# Falso, en caso de error.
[ $# == 2 ] || return 1

# Obtener partición.
PART="$(ogDiskToDev $1 $2)" || return 1

# Comprobar existencia del fichero de bloqueo.
LOCKFILE="/var/lock/lock${PART//\//-}"
test -f $LOCKFILE
}


#/**
#         ogLock int_ndisk int_npartition
#@see     ogLockPartition
#*/
function ogLock ()
{
ogLockPartition "$@"
}

#/**
#         ogLockPartition int_ndisk int_npartition
#@brief   Genera un fichero de bloqueo para una partición en uso exlusivo.
#@param   int_ndisk      nº de orden del disco
#@param   int_npartition nº de orden de la partición
#@return  (nada)
#@exception OG_ERR_FORMAT    Formato incorrecto.
#@exception OG_ERR_NOTFOUND  Disco o particion no corresponden con un dispositivo.
#@note    El fichero de bloqueo se localiza en \c /var/lock/part, siendo \c part el dispositivo de la partición, sustituyendo el carácter "/" por "-".
#@version 0.9 - Primera versión para OpenGnSys.
#@author  Ramon Gomez, ETSII Universidad de Sevilla
#@date    2009-09-03
#*/ ##
function ogLockPartition ()
{
# Variables locales
local PART LOCKFILE

# Si se solicita, mostrar ayuda.
if [ "$*" == "help" ]; then
    ogHelp "$FUNCNAME" "$FUNCNAME int_ndisk int_npartition" \
           "$FUNCNAME 1 1"
    return
fi
# Error si no se reciben 2 parámetros.
[ $# == 2 ] || ogRaiseError $OG_ERR_FORMAT || return $?

# Obtener partición.
PART="$(ogDiskToDev $1 $2)" || return $?

# Crear archivo de bloqueo exclusivo.
LOCKFILE="/var/lock/lock${PART//\//-}"
touch $LOCKFILE
}


#/**
#         ogMount int_ndisk int_nfilesys
#@see     ogMountFs ogMountCache ogMountCdrom
#*/ ##
function ogMount ()
{
case "$*" in
    CACHE|cache)
        ogMountCache ;;
    CDROM|cdrom)
        ogMountCdrom ;;
    *)  ogMountFs "$@" ;;
esac
}


#/**
#         ogMountFs int_ndisk int_nfilesys
#@brief   Monta un sistema de archivos.
#@param   int_ndisk      nº de orden del disco
#@param   int_nfilesys   nº de orden del sistema de archivos
#@return  Punto de montaje
#@exception OG_ERR_FORMAT    Formato incorrecto.
#@exception OG_ERR_NOTFOUND  Disco o particion no corresponden con un dispositivo.
#@exception OG_ERR_PARTITION Tipo de particion desconocido o no se puede montar.
#@version 0.1 -  Integracion para Opengnsys  -  EAC:   MountPartition() en FileSystem.lib
#@author  Antonio J. Doblas Viso. Universidad de Malaga
#@date    2008-10-27
#@version 0.9 - Primera version para OpenGnSys.
#@author  Ramon Gomez, ETSII Universidad de Sevilla
#@date    2009-09-28
#@version 1.0.5 - Independiente del tipo de sistema de ficheros.
#@author  Ramon Gomez, ETSII Universidad de Sevilla
#@date    2012-09-04
#*/ ##
function ogMountFs ()
{
# Variables locales
local PART MNTDIR

# Si se solicita, mostrar ayuda.
if [ "$*" == "help" ]; then
    ogHelp "$FUNCNAME" "$FUNCNAME int_ndisk int_nfilesys" \
           "$FUNCNAME 1 1  =>  /mnt/sda1"
    return
fi
# Error si no se reciben 2 parámetros.
[ $# == 2 ] || ogRaiseError $OG_ERR_FORMAT || return $?

# Obtener partición.
PART="$(ogDiskToDev "$1" "$2")" || return $?

# Comprobar si el sistema de archivos ya está montada.
MNTDIR="$(ogGetMountPoint $1 $2)"
# Si no, montarlo en un directorio de sistema.
if [ -z "$MNTDIR" ]; then
    # Error si la particion esta bloqueada.
    if ogIsLocked $1 $2; then
        ogRaiseError $OG_ERR_LOCKED "$MSG_PARTITION, $1 $2"
        return $?
    fi
    # Crear punto de montaje o enlace simbólico para caché local.
    MNTDIR=${PART/dev/mnt}
    if [ "$(ogFindCache)" == "$1 $2" -a -n "$OGCAC" ]; then
        mkdir -p $OGCAC
        ln -fs $OGCAC $MNTDIR
    else
        mkdir -p $MNTDIR
    fi
    # Montar sistema de archivos.
    mount $PART $MNTDIR &>/dev/null || \
               mount $PART $MNTDIR -o force,remove_hiberfile &>/dev/null || \
               ogRaiseError $OG_ERR_PARTITION "$1, $2" || return $?
fi
echo "$MNTDIR"
}


#####  PRUEBAS
# Montar CDROM
function ogMountCdrom ()
{
local DEV MNTDIR
DEV="/dev/cdrom"            # Por defecto
MNTDIR=$(mount | awk -v D=$DEV '{if ($1==D) {print $3}}')
if [ -z "$MNTDIR" ]; then
    MNTDIR=${DEV/dev/mnt}
    mkdir -p $MNTDIR
    mount -t iso9660 $DEV $MNTDIR || ogRaiseError $OG_ERR_PARTITION "cdrom" || return $?
fi
echo $MNTDIR
}


#/**
#         ogReduceFs int_ndisk int_nfilesys
#@brief   Reduce el tamaño del sistema de archivos, sin tener en cuenta el espacio libre.
#@param   int_ndisk      nº de orden del disco
#@param   int_nfilesys   nº de orden del sistema de archivos
#@return  int_tamañoKB - tamaño en KB
#@exception OG_ERR_FORMAT    Formato incorrecto.
#@exception OG_ERR_NOTFOUND  Disco o particion no corresponden con un dispositivo.
#@exception OG_ERR_PARTITION Partición desconocida o no accesible.
#@warning En Windows, se borran los ficheros pagefile.sys e hiberfile.sys
#@warning El sistema de archivos se amplía al mínimo + 10%.
#@note    Requisitos:   *resize*
#@version 0.1 -  Integracion para Opengnsys  -  EAC:   ReduceFileSystem() en ATA.lib
#@author  Antonio J. Doblas Viso. Universidad de Malaga
#@date    2008-10-27
#@version 0.9 - Primera version para OpenGnSys.
#@author  Ramon Gomez, ETSII Universidad de Sevilla
#@date    2009-09-23
#@version 0.9.2 - Añadir un 10% al tamaño mínimo requerido.
#@author  Ramon Gomez, ETSII Universidad de Sevilla
#@date    2010-09-27
#@version 1.0 -  Deteccion automatica del tamaño minimo adecuado
#@author  Antonio J. Doblas Viso. Universidad de Malaga
#@date    2011-02-24
#*/ ##
function ogReduceFs ()
{
# Variables locales
local PART BLKS SIZE

# Si se solicita, mostrar ayuda.
if [ "$*" == "help" ]; then
    ogHelp "$FUNCNAME" "$FUNCNAME int_ndisk int_nfilesys" \
           "$FUNCNAME 1 1"
    return
fi
# Error si no se reciben 2 parámetros.
[ $# == 2 ] || ogRaiseError $OG_ERR_FORMAT || return $?

# Obtener partición.
PART="$(ogDiskToDev $1 $2)" || return $?

# Redimensionar según el tipo de particion.
case "$(ogGetFsType $1 $2)" in
    EXT[234])
        ogUnmount $1 $2 2>/dev/null
        # Ext2/3/4: Tamaño de los bloques del sistema de archivos
        BLKS=$(tune2fs -l $PART | awk '/Block size/ {print int($3/512)}')
        # Traduce el num. en sectores de 512B a tamano en MB.
        #SIZE=$(resize2fs -P $PART 2>/dev/null | \
                #       awk -v B=$BLKS '/minimum size/ {print int($7*1.1*B/2048)}')
        #resize2fs -fp $PART "${SIZE}M" &>/dev/null || ogRaiseError $OG_ERR_PARTITION "$1,$2" || return $?
        resize2fs -fpM $PART  &>/dev/null || ogRaiseError $OG_ERR_PARTITION "$1,$2" || return $?
        ;;
#    BTRFS)             # Usar "btrfs"
#       ;;
#    REISERFS)          # Usar "resize_reiserfs"
#       ;;
    NTFS)
        ogDeleteFile $1 $2 pagefile.sys
        ogDeleteFile $1 $2 hiberfil.sys
        ogUnmount $1 $2 2>/dev/null
        ## NTFS: Obtiene tamaño mínimo en MB.
        #SIZE=$(ntfsresize -fi $PART | awk '/resize at/ {print int($8*1.1)}')
        #ntfsresize -fns "${SIZE}M" $PART >/dev/null || ogRaiseError $OG_ERR_PARTITION "$1,$2" || return $?
        #ntfsresize -fs "${SIZE}M" $PART <<<"y" >/dev/null || ogRaiseError $OG_ERR_PARTITION "$1,$2" || return $?
        SIZE=$(ogReduceFsCheck $1 $2)
        [ "$SIZE" == 0 ] && return 1    
        ntfsresize -fs "${SIZE}M" $PART <<<"y"  || ogRaiseError $OG_ERR_PARTITION "error reduciendo $1,$2" || return $?
        ;;
#    FAT32|FAT16)       # Usar "fatresize"
#        ;;
    *)  ogRaiseError $OG_ERR_PARTITION "$1,$2"
        return $? ;;
esac
ogGetFsSize $1 $2
}


function ogReduceFsCheck ()
{
#IMPORTANTE: retorna el valor en MB que podrá reducir el FS de una particion ntfs
#valor devuelto 0, y codigo error 1. No se puede reducir, probar a reiniciar windows y chkdsk


local  PART RC MODE SIZE SIZEDATA 
[ $# == 2 ] && MODE=STAGE1
[ $# == 3 ] && MODE=STAGE2
[ -z $MODE ] && return

PART="$(ogDiskToDev $1 $2)" || return $?
ogUnmount $1 $2 &>/dev/null


case $MODE in
        STAGE1)
        #       echo "primera etapa $*"
                ntfsresize -fi $PART &>/dev/null
                RC=`echo $?`
        #       echo "RC es" $RC
                if [ "$RC" -eq "1" ]
                then 
                        echo "0" 
                        return 1        
                fi  
                SIZEDATA=$(ntfsresize -fi $PART | awk '/resize at/ {print $8+1000}')
        #       echo "salida" $?
        #       echo $SIZEDATA
                ogReduceFsCheck $1 $2 $SIZEDATA 
                return 0
       ;;
        STAGE2)
        #       echo "segunda etapa $*"
                SIZEDATA=$3
                ntfsresize -fns "${SIZEDATA}M" $PART &>/tmp/ntfsresize.txt
                RC=$?
                if [ "$RC" == "0" ]
                then  
                        SIZE=$SIZEDATA  
                        echo $SIZE      
                else
                        SIZEEXTRA=$(cat /tmp/ntfsresize.txt | awk '/Needed relocations :/ {print $0}' | awk -F"(" '{print $2}' | awk '{print $1+500}')
                        SIZE=$(expr $SIZEDATA + $SIZEEXTRA)
                        ogReduceFsCheck $1 $2 $SIZE 
                        return 0 
                fi
        ;;
        *)
        return
        ;;
esac
}



#/**
#         ogUnlock int_ndisk int_npartition
#@see     ogUnlockPartition
#*/ ##
function ogUnlock ()
{
ogUnlockPartition "$@"
}

#/**
#         ogUnlockPartition int_ndisk int_npartition
#@brief   Elimina el fichero de bloqueo para una particion.
#@param   int_ndisk      nº de orden del disco
#@param   int_npartition nº de orden de la partición
#@return  (nada)
#@exception OG_ERR_FORMAT    Formato incorrecto.
#@exception OG_ERR_NOTFOUND  Disco o particion no corresponden con un dispositivo.
#@note    El fichero de bloqueo se localiza en \c /var/lock/part, siendo \c part el dispositivo de la partición, sustituyendo el carácter "/" por "-".
#@version 0.9 - Primera versión para OpenGnSys.
#@author  Ramon Gomez, ETSII Universidad de Sevilla
#@date    2009-09-03
#*/ ##
function ogUnlockPartition ()
{
# Variables locales
local PART LOCKFILE

# Si se solicita, mostrar ayuda.
if [ "$*" == "help" ]; then
    ogHelp "$FUNCNAME" "$FUNCNAME int_ndisk int_npartition" \
           "$FUNCNAME 1 1"
    return
fi
# Error si no se reciben 2 parámetros.
[ $# == 2 ] || ogRaiseError $OG_ERR_FORMAT || return $?

# Obtener partición.
PART="$(ogDiskToDev $1 $2)" || return $?

# Borrar archivo de bloqueo exclusivo.
LOCKFILE="/var/lock/lock${PART//\//-}"
rm -f $LOCKFILE
}


#/**
#         ogUnmount int_ndisk int_npartition
#@see     ogUnmountFs
#*/ ##
function ogUnmount ()
{
ogUnmountFs "$@"
}

#/**
#         ogUnmountFs int_ndisk int_nfilesys
#@brief   Desmonta un sistema de archivos.
#@param   int_ndisk      nº de orden del disco
#@param   int_nfilesys   nº de orden del sistema de archivos
#@return  Nada
#@exception OG_ERR_FORMAT    Formato incorrecto.
#@exception OG_ERR_NOTFOUND  Disco o particion no corresponden con un dispositivo.
#@warning La partición no está previamente montada o no se puede desmontar.
#@version 0.1 -  Integracion para Opengnsys  -  EAC:  UmountPartition() en FileSystem.lib
#@author  Antonio J. Doblas Viso. Universidad de Malaga
#@date    2008-10-27
#@version 0.9 - Primera version para OpenGnSys.
#@author  Ramon Gomez, ETSII Universidad de Sevilla
#@date    2009-09-28
#*/ ##
function ogUnmountFs ()
{
# Variables locales
local PART MNTDIR

# Si se solicita, mostrar ayuda.
if [ "$*" == "help" ]; then
    ogHelp "$FUNCNAME" "$FUNCNAME int_ndisk int_npartition" "$FUNCNAME 1 1"
    return
fi
# Error si no se reciben 2 parámetros.
[ $# == 2 ] || ogRaiseError $OG_ERR_FORMAT || return $?

# Obtener partición y punto de montaje.
PART="$(ogDiskToDev $1 $2)" || return $?
MNTDIR="$(ogGetMountPoint $1 $2)"

# Si está montada, desmontarla.
if [ -n "$MNTDIR" ]; then
    # Error si la particion está bloqueada.
    if ogIsLocked $1 $2; then
        ogRaiseError $OG_ERR_LOCKED "$MSG_PARTITION $1, $2"
        return $?
    fi
    # Desmontar y borrar punto de montaje.
    umount $PART 2>/dev/null || ogEcho warning "$FUNCNAME: $MSG_DONTUNMOUNT: \"$1, $2\""
    rmdir $MNTDIR 2>/dev/null || rm -f $MNTDIR 2>/dev/null
else
    ogEcho warning "$MSG_DONTMOUNT: \"$1,$2\""
fi
}


#/**
#         ogUnmountAll int_ndisk
#@brief   Desmonta todos los sistema de archivos de un disco, excepto el caché local.
#@param   int_ndisk      nº de orden del disco
#@return  Nada
#@exception OG_ERR_FORMAT    Formato incorrecto.
#@exception OG_ERR_NOTFOUND  Disco o particion no corresponden con un dispositivo.
#@warning No se desmonta la partición marcada como caché local.
#@version 0.9 - Versión para OpenGnSys.
#@author  Ramon Gomez, ETSII Universidad de Sevilla
#@date    2009/10/07
#*/ ##
function ogUnmountAll ()
{
# Variables locales
local DISK PART
# Si se solicita, mostrar ayuda.
if [ "$*" == "help" ]; then
    ogHelp "$FUNCNAME" "$FUNCNAME int_ndisk" "FUNCNAME 1"
    return
fi
# Error si no se recibe 1 parámetro.
[ $# == 1 ] || ogRaiseError $OG_ERR_FORMAT || return $?

# Obtener partición y punto de montaje.
DISK="$(ogDiskToDev $1)" || return $?
for ((PART=1; PART<=$(ogGetPartitionsNumber $1); PART++)); do
    case "$(ogGetFsType $1 $PART)" in
        CACHE) ;;
        *)     ogUnmount $1 $PART 2>/dev/null ;;
    esac
done
}


function ogGetFreeSize () {
if [ $# = 0 ]
then
        echo "sintaxis: ogGetFreeSize int_disco int_partition str_SizeOutput [ kB MB GB -default GB]-]" red
        echo "devuelve int_size : int_data : int_free" red
return
fi
if [ $# -ge 2 ]
then
        particion=`ogMount $1 $2 ` #1>/dev/null 2>&1
        if [ -z $3 ]
                then
                        unit=kB  # s B kB MB GB TB %
                else
                        unit=$3
        fi
        case $unit in
                kB)
                        factor="1.024";
                        #valor=`df | grep  $particion | awk -F" " '{size=$2*1.024; used=$3*1.024; free=$4*1.024; printf "%d:%d:%d", size,used,free}'`
                        valor=`df | grep  $particion | awk -F" " '{size=$2*1.024; used=$3*1.024; free=$4*1.024; printf "%d", free}'`
                        ;;
                MB)
                        factor="1.024/1000";
                        valor=`df | grep  $particion | awk -F" " '{size=$2*1.024/1000; used=$3*1.024/1000; free=$4*1.024/1000; printf "%d:%d:%d", size,used,free}'`
                ;;
                GB)
                        factor="1.024/1000000";
                        valor=`df | grep $particion | awk -F" " '{size=$2*1.024/1000000; used=$3*1.024/1000000; free=$4*1.024/1000000; printf "%f:%f:%f", size,used,free}'`
                ;;
        esac
        #echo $valor
        #NumberRound $valor
        #valor=`NumberRound $valor`;
        ogUnmount $1 $2 1>/dev/null 2>&1
        echo $valor

fi
}