#!/bin/bash #/** #@file System.lib #@brief Librería o clase System #@class System #@brief Funciones básicas del sistema. #@version 0.9 #@warning License: GNU GPLv3+ #*/ #/** # ogEcho [str_loglevel] "str_message..." #@brief Muestra mensajes en consola y lo registra en fichero de incidencias. #@param str_loglevel nivel de registro de incidencias. #@param str_message mensaje (puede recibir más de 1 parámetro. #@return Mensaje mostrado. #@note El nivel de ayuda \c (help) no se registra en el fichero de incidencias. #@version 0.9 - Primera versión para OpenGnSys #@author Ramon Gomez, ETSII Universidad de Sevilla #@date 2009-07-23 #*/ function ogEcho () { # Variables locales local LOGLEVEL LOGFILE DATETIME # Selección del nivel de registro (opcional). case "$1" in help) shift ;; info) LOGLEVEL=$1; shift ;; warning) LOGLEVEL=$1; shift ;; error) LOGLEVEL=$1; shift ;; *) ;; esac # Pendiente en cliente Initrd. #DATETIME=$(date +"%F %T") if [ -n "$LOGLEVEL" ]; then logger -s -t "OpenGnSys $LOGLEVEL" $LOGFILE "$DATETIME $*" else echo "$*" fi } #/** # ogRaiseError int_errcode ["str_errmessage" ...] #@brief Devuelve el mensaje y el código de error correspondiente. #@param int_errcode código de error. #@param str_errmessage mensajes complementarios de error. #@return str_message - Mensaje de error. #@warning No definidas #@note Mensajes internacionales del fichero de idiomas. #@version 0.9 - Primera versión para OpenGnSys. #@author Ramon Gomez, ETSII Universidad de Sevilla #@date 2009-07-21 #*/ function ogRaiseError () { # Variables locales local MSG CODE # Obtener código y mensaje de error. CODE=$1 case "$CODE" in $OG_ERR_FORMAT) MSG="$MSG_ERR_FORMAT \"$2\"" ;; $OG_ERR_NOTFOUND) MSG="$MSG_ERR_NOTFOUND \"$2\"" ;; $OG_ERR_OUTOFLIMIT) MSG="$MSG_ERR_OUTOFLIMIT \"$2\"" ;; $OG_ERR_PARTITION) MSG="$MSG_ERR_PARTITION \"$2\"" ;; $OG_ERR_LOCKED) MSG="$MSG_ERR_LOCKED \"$2\"" ;; $OG_ERR_CACHE) MSG="$MSG_ERR_CACHE \"$2\"" ;; $OG_ERR_FILESYS) MSG="$MSG_ERR_FILESYS \"$2\"" ;; $OG_ERR_IMAGE) MSG="$MSG_ERR_IMAGE \"$2\"" ;; $OG_ERR_NOTOS) MSG="$MSG_ERR_NOTOS \"$2\"" ;; $OG_ERR_NOTEXEC) MSG="$MSG_ERR_NOTEXEC \"$2\"" ;; $OG_ERR_NOTWRITE) MSG="$MSG_ERR_NOTWRITE \"$2\"" ;; $OG_ERR_NOTCACHE) MSG="$MSG_ERR_NOTCACHE \"$2\"" ;; $OG_ERR_CACHESIZE) MSG="$MSG_ERR_CACHESIZE \"$2\"" ;; $OG_ERR_REDUCEFS) MSG="$MSG_ERR_REDUCEFS \"$2\"" ;; $OG_ERR_EXTENDFS) MSG="$MSG_ERR_EXTENDFS \"$2\"" ;; $OG_ERR_IMGSIZEPARTITION) MSG="$MSG_ERR_IMGSIZEPARTITION \"$2\"" ;; $OG_ERR_UCASTSYNTAXT) MSG="$MSG_ERR_UCASTSYNTAXT \"$2\"" ;; $OG_ERR_UCASTSENDPARTITION) MSG="$MSG_ERR_UCASTSENDPARTITION \"$2\"" ;; $OG_ERR_UCASTSENDFILE) MSG="$MSG_ERR_UCASTSENDFILE \"$2\"" ;; $OG_ERR_UCASTRECEIVERPARTITION) MSG="$MSG_ERR_UCASTRECEIVERPARTITION \"$2\"" ;; $OG_ERR_UCASTRECEIVERFILE) MSG="$MSG_ERR_UCASTRECEIVERFILE \"$2\"" ;; $OG_ERR_MCASTSYNTAXT) MSG="$MSG_ERR_MCASTSYNTAXT \"$2\"" ;; $OG_ERR_MCASTSENDFILE) MSG="$MSG_ERR_MCASTSENDFILE \"$2\"" ;; $OG_ERR_MCASTRECEIVERFILE) MSG="$MSG_ERR_MCASTRECEIVERFILE \"$2\"" ;; $OG_ERR_MCASTSENDPARTITION) MSG="$MSG_ERR_MCASTSENDPARTITION \"$2\"" ;; $OG_ERR_MCASTRECEIVERPARTITION) MSG="$MSG_ERR_MCASTRECEIVERPARTITION \"$2\"" ;; $OG_ERR_PROTOCOLJOINMASTER) MSG="$MSG_ERR_PROTOCOLJOINMASTER \"$2\"" ;; *) MSG="$MSG_ERR_GENERIC"; CODE=$OG_ERR_GENERIC ;; esac # Mostrar mensaje de error y salir con el código indicado. ogEcho error "${FUNCNAME[1]}: $MSG" >&2 return $CODE } #/** # ogGetCaller #@brief Devuelve nombre del programa o script ejecutor (padre). #@param No. #@return str_name - Nombre del programa ejecutor. #@version 0.10 - Primera versión para OpenGnSys. #@author Ramon Gomez, ETSII Universidad de Sevilla #@date 2011-01-17 #*/ function ogGetCaller () { # Obtener el nombre del programa o del script que ha llamado al proceso actual. basename $(ps hlp $PPID | awk '{if ($13~/bash/ && $14!="") print $14; else print $13;}') } #/** # ogIsRepoLocked #@brief Comprueba si el repositorio está siendo usado (tiene ficheros abiertos). #@param No. #@return Código de salida: 0 - bloqueado, 1 - sin bloquear o error. #@version 0.10 - Primera versión para OpenGnSys. #@author Ramon Gomez, ETSII Universidad de Sevilla #@date 2011-01-17 #@version 1.0.1 - Devolver falso en caso de error. #@author Ramon Gomez, ETSII Universidad de Sevilla #@date 2011-05-18 #*/ function ogIsRepoLocked () { # Variables locales. local f FILES # No hacer nada, si no está definido el punto de montaje del repositorio. [ -z "$OGIMG" ] && return 1 # Comprobar si alguno de los ficheros abiertos por los procesos activos está en el # punto de montaje del repositorio de imágenes. FILES=$(for f in /proc/[0-9]*/fd/*; do readlink -f "$f"; done | grep "^$OGIMG") # */ (comentario Doxygen) test -n "$FILES" } #/** # ogHelp ["str_function" ["str_format" ["str_example" ... ]]] #@brief Muestra mensaje de ayuda para una función determinda. #@param str_function Nombre de la función. #@param str_format Formato de ejecución de la función. #@param str_example Ejemplo de ejecución de la función. #@return str_help - Salida de ayuda. #@note Si no se indican parámetros, la función se toma de la variable \c $FUNCNAME #@note La descripción de la función se toma de la variable compuesta por \c MSG_FUNC_$función incluida en el fichero de idiomas. #@note Pueden especificarse varios mensajes con ejemplos. #@version 0.9 - Primera versión para OpenGnSys. #@author Ramon Gomez, ETSII Universidad de Sevilla #@date 2009-07-27 #*/ function ogHelp () { # Variables locales. local FUNC MSG # Mostrar función, descripción y formato. FUNC="${1:-${FUNCNAME[${#FUNCNAME[*]}-1]}}" MSG="MSG_HELP_$FUNC" ogEcho help "$MSG_FUNCTION $FUNC: ${!MSG}" [ -n "$2" ] && ogEcho help " $MSG_FORMAT: $2" # Mostrar ejemplos (si existen). shift 2 while [ $# -gt 0 ]; do ogEcho help " $MSG_EXAMPLE: $1" shift done } ogCheckProgram () { # Si se solicita, mostrar ayuda. if [ "$*" == "help" ]; then ogHelp "$FUNCNAME \"str_program1 program2 programN\" " \ "$FUNCNAME \"partimage partclone mbuffer\" " return fi # Error si no se recibe 1 parámetro. [ $# == 1 ] || ogRaiseError $OG_ERR_FORMAT || return $? local PERROR PLOG PERROR=0 PLOG=" " for i in `echo $1` do if [ ! `which $i` ] then PERROR=1 PLOG="$PLOG $i" fi done if [ "$PERROR" == "1" ] then ogRaiseError $OG_ERR_NOTEXEC "$PLOG" || return $? else return 0 fi }