source: client/engine/File.lib @ b5523ac

918-git-images-111dconfigfileconfigure-oglivegit-imageslgromero-new-oglivemainmaint-cronmount-efivarfsmultivmmultivm-ogboot-installerogClonningEngineogboot-installer-jenkinsoglive-ipv6test-python-scriptsticket-301ticket-50ticket-50-oldticket-577ticket-585ticket-611ticket-612ticket-693ticket-700ubu24tplunification2use-local-agent-oglivevarios-instalacionwebconsole3
Last change on this file since b5523ac was df1ffe5, checked in by ramon <ramongomez@…>, 12 years ago

Versión 1.0.5: Corregir errata en función ogGetPath para evitar que un fichero se use como si fuese un directorio.

git-svn-id: https://opengnsys.es/svn/branches/version1.0@3451 a21b9725-9963-47de-94b9-378ad31fedc9

  • Property mode set to 100755
File size: 14.9 KB
Line 
1#!/bin/bash
2#/**
3#@file    File.lib
4#@brief   Librería o clase File
5#@class   File
6#@brief   Funciones para gestión de archivos y directorios.
7#@version 1.0.4
8#@warning License: GNU GPLv3+
9#*/
10
11
12#/**
13#         ogCalculateChecksum [ str_repo | int_ndisk int_npart ] path_filepath
14#@brief   Devuelve la suma de comprobación (checksum) de un fichero.
15#@param   path_filepath     camino del fichero (independiente de mayúsculas)
16#@param   str_repo          repositorio de ficheros
17#@param   int_ndisk         nº de orden del disco
18#@param   int_npartition    nº de orden de la partición
19#@return  hex_checksum      Checksum del fichero
20#@version 0.9.2 - Primera versión para OpenGnSys.
21#@author  Ramon Gomez, ETSII Universidad de Sevilla
22#@date    2010-07-24
23#@version 1.0.4 - Calcula solo el checksum del último MB del fichero.
24#@author  Ramon Gomez, ETSII Universidad de Sevilla
25#@date    2012-03-16
26#*/ ##
27function ogCalculateChecksum ()
28{
29# Variables locales.
30local FILE
31if [ "$*" == "help" ]; then
32    ogHelp "$FUNCNAME" "$FUNCNAME [ str_repo | int_ndisk int_npartition ] path_filepath" \
33           "$FUNCNAME REPO ubuntu.img  ==>  ef899299caf8b517ce36f1157a93d8bf"
34    return
35fi
36
37# Comprobar que existe el fichero y devolver sus datos.
38FILE=$(ogGetPath "$@")
39[ -n "$FILE" ] || ogRaiseError $OG_ERR_NOTFOUND "$*" || return $?
40tail -c1M "$FILE" | md5sum -b 2>&1 | cut -f1 -d" "
41}
42
43
44#/**
45#         ogCompareChecksumFiles [ str_repo | int_ndisk int_npart ] path_source [ str_repo | int_ndisk int_npart ] path_target
46#@brief   Metafunción que compara las sumas de comprobación almacenadas de 2 ficheros.
47#@return  bool_compare   Valor de comparación.
48#@warning No es necesario especificar la extensión ".sum".
49#@version 0.9.2 - Primera versión para OpenGnSys.
50#@author  Ramon Gomez, ETSII Universidad de Sevilla
51#@date    2010-07-24
52#*/ ##
53function ogCompareChecksumFiles ()
54{
55# Variables locales.
56local ARGS SOURCE TARGET
57if [ "$*" == "help" ]; then
58    ogHelp "$FUNCNAME" "$FUNCNAME [ str_repo | int_ndisk int_npartition ] path_filepath" \
59           "if $FUNCNAME REPO ubuntu.img CACHE ubuntu.img; then ...;  fi"
60    return
61fi
62
63ARGS="$@"
64case "$1" in
65    /*)     # Camino completo.          */ (Comentrio Doxygen)
66        SOURCE=$(ogGetPath "$1")
67        shift ;;
68    [1-9]*) # ndisco npartición.
69        SOURCE=$(ogGetPath "$1" "$2" "$3")
70        shift 3 ;;
71    *)      # Otros: repo, cache, cdrom (no se permiten caminos relativos).
72        SOURCE=$(ogGetPath "$1" "$2")
73        shift 2 ;;
74esac
75TARGET=$(ogGetPath "$@")
76
77# Comparar los ficheros de checksum.
78test "$(cat "$SOURCE.sum" 2>/dev/null)" == "$(cat "$TARGET.sum" 2>/dev/null)"
79}
80
81
82#/**
83#         ogCopyFile [ str_repo | int_ndisk int_npart ] path_source [ str_repo | int_ndisk int_npart ] path_target
84#@brief   Metafunción para copiar un fichero de sistema OpenGnSys a un directorio.
85#@see     ogGetPath
86#@return  Progreso de la copia.
87#@warning Deben existir tanto el fichero origen como el directorio destino.
88#@version 0.9 - Pruebas con OpenGnSys.
89#@author  Ramon Gomez, ETSII Universidad de Sevilla
90#@date    2009-10-20
91#@version 1.0.4 - Copiar usando rsync.
92#@author  Universidad de Huelva
93#@date    2012-07-06
94#*/ ##
95function ogCopyFile ()
96{
97# Variables locales.
98local ARGS SOURCE TARGET
99if [ "$*" == "help" ]; then
100    ogHelp "$FUNCNAME" "$FUNCNAME [ str_repo | int_ndisk int_npartition ] path_source [ str_repo | int_ndisk int_npartition ] path_target" \
101           "$FUNCNAME REPO newfile.txt 1 2 /tmp/newfile.txt"
102    return
103fi
104
105ARGS="$@"
106case "$1" in
107    /*)     # Camino completo.          */ (Comentrio Doxygen)
108        SOURCE="$(ogGetPath "$1")"
109        shift ;;
110    [1-9]*) # ndisco npartición.
111        SOURCE="$(ogGetPath "$1" "$2" "$3")"
112        shift 3 ;;
113    *)      # Otros: repo, cache, cdrom (no se permiten caminos relativos).
114        SOURCE="$(ogGetPath "$1" "$2")"
115        shift 2 ;;
116esac
117# Comprobar fichero origen y directorio destino.
118[ -n "$SOURCE" ] || ogRaiseError $OG_ERR_NOTFOUND "${ARGS% $*}" || return $?
119TARGET="$(ogGetPath "$@")"
120[ -n "$TARGET" ] || ogRaiseError $OG_ERR_NOTFOUND "$*" || return $?
121# Copiar fichero (para evitar problemas de comunicaciones las copias se hacen con rsync en vez de cp).
122rsync --progress -avh "$SOURCE" "$TARGET"
123}
124
125
126#/**
127#         ogDeleteFile [ str_repo | int_ndisk int_npartition ] path_filepath
128#@brief   Metafunción que borra un fichero de un dispositivo.
129#@see     ogGetPath
130#@version 0.9 - Pruebas con OpenGnSys.
131#@author  Ramon Gomez, ETSII Universidad de Sevilla
132#@date    2009-09-29
133#*/ ##
134function ogDeleteFile ()
135{
136# Variables locales.
137local FILE
138if [ "$*" == "help" ]; then
139    ogHelp "$FUNCNAME" "$FUNCNAME [ str_repo | int_ndisk int_npartition ] path_file" \
140           "$FUNCNAME 1 2 /tmp/newfile.txt"
141    return
142fi
143
144# Comprobar que existe el fichero y borrarlo.
145FILE="$(ogGetPath "$@")"
146[ -n "$FILE" ] || ogRaiseError $OG_ERR_NOTFOUND "$*" || return $?
147rm -f "$FILE" || ogRaiseError $OG_ERR_NOTFOUND "$*" || return $?
148}
149
150
151#/**
152#         ogDeleteTree [ str_repo | int_ndisk int_npartition ] path_dirpath
153#@brief   Metafunción que borra todo un subárbol de directorios de un dispositivo.
154#@see     ogGetPath
155#@version 0.9 - Pruebas con OpenGnSys.
156#@author  Ramon Gomez, ETSII Universidad de Sevilla
157#@date    2009-09-29
158#*/ ##
159function ogDeleteTree ()
160{
161# Variables locales.
162local DIR
163if [ "$*" == "help" ]; then
164    ogHelp "$FUNCNAME" "$FUNCNAME [ str_repo | int_ndisk int_npartition ] path_dir" \
165           "$FUNCNAME 1 2 /tmp/newdir"
166    return
167fi
168
169# Comprobar que existe el directorio y borrarlo con su contenido.
170DIR="$(ogGetPath "$@")"
171[ -n "$DIR" ] || ogRaiseError $OG_ERR_NOTFOUND "$*" || return $?
172rm -fr "$DIR" || ogRaiseError $OG_ERR_NOTFOUND "$*" || return $?
173}
174
175
176#/**
177#         ogGetPath [ str_repo | int_ndisk int_npartition ] path_filepath
178#@brief   Inicia el proceso de arranque de un sistema de archivos.
179#@param   path_filepath   camino del fichero (independiente de mayúsculas)
180#@param   str_repo        repositorio de ficheros
181#@param   int_ndisk       nº de orden del disco
182#@param   int_npartition  nº de orden de la partición
183#@return  path_file - camino completo real del fichero.
184#@note    repo = { REPO, CACHE, CDROM }
185#@note    Requisitos: \c grep \c sed
186#@exception OG_ERR_FORMAT    Formato incorrecto.
187#@exception OG_ERR_NOTFOUND  Fichero o dispositivo no encontrado.
188#@exception OG_ERR_PARTITION Tipo de partición desconocido o no se puede montar.
189#@warning En caso de error, sólo devuelve el código y no da mensajes.
190#@todo    Terminar de definir parámetros para acceso a repositorios.
191#@version 0.1 -  Integracion para Opengnsys  -  HIDRA: CaminoWindows.sh; EAC: GetPath(), FormatSintaxSpacePath(), FormatSintaxBackSlashPath (),  en FileSystem.lib
192#@author Ramon Gomez, ETSII Universidad de Sevilla
193#@Date    2008/10/10
194#@author  Antonio J. Doblas Viso. Universidad de Malaga
195#@date    2008/10/27
196#@version 0.9 - Pruebas con OpenGnSys.
197#@author  Ramon Gomez, ETSII Universidad de Sevilla
198#@date    2009-09-15
199#*/ ##
200function ogGetPath ()
201{
202# Variables locales.
203local MNTDIR FILE PREVFILE FILEPATH CURRENTDIR
204
205# Si se solicita, mostrar ayuda.
206if [ "$*" == "help" ]; then
207    ogHelp "$FUNCNAME" "$FUNCNAME [ str_repo | int_ndisk int_npartition ] path_filepath" \
208           "$FUNCNAME \"/mnt/sda1/windows/system32\"  ==>  /mnt/sda1/WINDOWS/System32" \
209           "$FUNCNAME REPO /etc/fstab  ==>  /opt/opengnsys/images/etc/fstab" \
210           "$FUNCNAME 1 1 \"/windows/system32\"  ==>  /mnt/sda1/WINDOWS/System32"
211    return
212fi
213
214# Procesar camino según el número de parámetros.
215case $# in
216    1)  FILE="$1" ;;
217    2)  case "$1" in
218            REPO|repo)
219                FILE="$OGIMG/$2" ;;
220            CACHE|cache)
221                FILE="$(ogMountCache)/$OGIMG/$2" ;;
222            CDROM|cdrom)
223                FILE="$(ogMountCdrom)/$2" ;;
224            *)  ogRaiseError $OG_ERR_FORMAT
225                return $? ;;
226        esac ;;
227    3)  FILE="$(ogMount $1 $2)/$3" ;;
228    *)  ogRaiseError $OG_ERR_FORMAT
229        return $? ;;
230esac
231
232# Eliminar caracteres \c / iniciales, finales y duplicados.
233CURRENTDIR="$PWD"
234        # /* (comentario Doxygen)
235FILE="$(echo $FILE|sed -e 's/\(\/\)*\1/\//g' -e 's/^\///' -e 's/\/$//')"
236PREVFILE=""
237FILEPATH="/"
238while [ "$FILE" != "$PREVFILE" ]; do
239    # Busca el nombre correcto en el directorio actual.
240    cd "$FILEPATH" 2>/dev/null || FILE=""
241    FILEPATH="${FILEPATH}/$(ls -A 2>/dev/null | grep -i -m1 "^${FILE%%/*}$")" || return $?
242    PREVFILE="$FILE"
243    FILE="${FILE#*/}"
244done
245        # (comentario Doxygen) */
246# Muestra el camino Linux, quitando el / inicial duplicado.
247[ "$FILEPATH" != "/" ] && echo ${FILEPATH#/}
248cd $CURRENTDIR
249}
250
251
252#/**
253#         ogGetParentPath [ str_repo | int_ndisk int_npartition ] path_filepath
254#@brief   Metafunción que devuelve el camino del directorio padre.
255#@see     ogGetPath
256#@version 0.9 - Pruebas con OpenGnSys.
257#@author  Ramon Gomez, ETSII Universidad de Sevilla
258#@date    2009-09-29
259#*/ ##
260function ogGetParentPath ()
261{
262local PARENT
263if [ "$*" == "help" ]; then
264    ogHelp "$FUNCNAME" "$FUNCNAME [ str_repo | int_ndisk int_npartition ] path_filepath" \
265           "$FUNCNAME \"/mnt/sda1/windows/system32\"  ==>  /mnt/sda1/WINDOWS" \
266           "$FUNCNAME REPO /etc/fstab  ==>  /opt/opengnsys/images/etc" \
267           "$FUNCNAME 1 1 \"/windows/system32\"  ==>  /mnt/sda1/WINDOWS"
268    return
269fi
270
271case $# in
272    1)  PARENT="$(dirname "$1")" ;;
273    2)  PARENT="$1 $(dirname "/$2")" ;;
274    3)  PARENT="$1 $2 $(dirname "/$3")" ;;
275    *)  ogRaiseError $OG_ERR_FORMAT
276        return $? ;;
277esac
278ogGetPath $PARENT
279}
280
281
282#/**
283#         ogIsNewerFile [ str_repo | int_ndisk int_npart ] path_source [ str_repo | int_ndisk int_npart ] path_target
284#@brief   Metafunción que indica se un fichero es más nuevo que otro.
285#@see     ogGetPath
286#@return  Código de salida: 0 - nuevo, 1 - antiguo o error
287#@warning Deben existir tanto el fichero origen como el destino.
288#@version 0.9.2 - Primera versión para OpenGnSys.
289#@author  Ramon Gomez, ETSII Universidad de Sevilla
290#@date    2010-07-24
291#@version 1.0.1 - Devolver falso en caso de error.
292#@author  Ramon Gomez, ETSII Universidad de Sevilla
293#@date    2011-05-18
294#*/ ##
295function ogIsNewerFile ()
296{
297# Variables locales.
298local ARGS SOURCE TARGET
299# Si se solicita, mostrar ayuda.
300if [ "$*" == "help" ]; then
301    ogHelp "$FUNCNAME" "$FUNCNAME [ str_repo | int_ndisk int_npartition ] path_source [ str_repo | int_ndisk int_npartition ] path_target" \
302           "if $FUNCNAME REPO ubuntu.img CACHE ubuntu.img; then ...  fi"
303    return
304fi
305
306ARGS="$@"
307case "$1" in
308    /*)     # Camino completo.          */ (Comentrio Doxygen)
309        SOURCE="$(ogGetPath "$1")"
310        shift ;;
311    [1-9]*) # ndisco npartición.
312        SOURCE="$(ogGetPath "$1" "$2" "$3")"
313        shift 3 ;;
314    *)      # Otros: repo, cache, cdrom (no se permiten caminos relativos).
315        SOURCE="$(ogGetPath "$1" "$2")"
316        shift 2 ;;
317esac
318# Comprobar que existen los ficheros origen y destino.
319[ -n "$SOURCE" ] || ogRaiseError $OG_ERR_NOTFOUND "${ARGS% $*}" || return 1
320TARGET=$(ogGetPath "$@")
321[ -n "$TARGET" ] || ogRaiseError $OG_ERR_NOTFOUND "$*" || return 1
322# Devolver si el primer fichero se ha modificado después que el segundo.
323test "$SOURCE" -nt "$TARGET"
324}
325
326
327#/**
328#         ogMakeChecksumFile [ str_repo | int_ndisk int_npart ] path_filepath
329#@brief   Metafunción que guarda el valor de comprobación de un fichero.
330#@see     ogCalculateChecksum
331#@warning Genera un fichero con extensión ".sum".
332#@version 0.9.2 - Primera versión para OpenGnSys.
333#@author  Ramon Gomez, ETSII Universidad de Sevilla
334#@date    2010-07-24
335#*/ ##
336function ogMakeChecksumFile ()
337{
338# Variables locales.
339local FILE
340if [ "$*" == "help" ]; then
341    ogHelp "$FUNCNAME" "$FUNCNAME [ str_repo | int_ndisk int_npartition ] path_filepath" \
342           "$FUNCNAME REPO ubuntu.img"
343    return
344fi
345
346# Comprobar que existe el fichero y guardar su checksum.
347FILE="$(ogGetPath "$@")"
348[ -n "$FILE" ] || ogRaiseError $OG_ERR_NOTFOUND "$*" || return $?
349ogCalculateChecksum "$FILE" > "$FILE.sum"
350}
351
352
353#/**
354#         ogMakeDir [ str_repo | int_ndisk int_npartition ] path_dirpath
355#@brief   Metafunción que crea un subdirectorio vacío en un dispositivo.
356#@see     ogGetParentPath
357#@version 0.1 -  Integracion para Opengnsys  -   HIDRA: CrearDirectorio.sh, EAC: MkdirPath() en FileSystem.lib
358#@author Ramon Gomez, ETSII Universidad de Sevilla
359#@Date    2008/10/10
360#@author  Antonio J. Doblas Viso. Universidad de Malaga
361#@date    2008/10/27
362#@version 0.9 - Pruebas con OpenGnSys.
363#@author  Ramon Gomez, ETSII Universidad de Sevilla
364#@date    2009-09-29
365#*/ ##
366function ogMakeDir ()
367{
368local PARENT DIR
369if [ "$*" == "help" ]; then
370    ogHelp "$FUNCNAME" "$FUNCNAME [ str_repo | int_ndisk int_npartition ] path_dir" \
371           "$FUNCNAME 1 2 /tmp/newdir"
372    return
373fi
374
375PARENT="$(ogGetParentPath "$@")" || return $?
376DIR="$(basename "${!#}")"
377mkdir -p "$PARENT/$DIR" || ogRaiseError $OG_ERR_NOTFOUND "$*" || return $?
378}
379 
380
381#/**
382#         ogNewPath [ str_repo | int_ndisk int_npartition ] path_filepath
383#@brief   Crea el directorio especificado
384#@param   path_filepath   camino del fichero (independiente de mayúsculas)
385#@param   str_repo        repositorio de ficheros
386#@param   int_ndisk       nº de orden del disco
387#@param   int_npartition  nº de orden de la partición
388#@return  file - camino completo real del directorio creado
389#@note    repo = { REPO, CACHE }
390#@note    Requisitos: \c grep \c sed
391#@exception OG_ERR_FORMAT    Formato incorrecto.
392#@exception OG_ERR_NOTFOUND  Disco o particion no corresponden con un dispositivo.
393#@exception OG_ERR_PARTITION Tipo de partición desconocido o no se puede montar.
394#@warning Primeras pruebas.
395#@todo    Terminar de definir parámetros para acceso a repositorios.
396#@version 0.1 - Primera adaptaci³n para OpenGNSys.
397#@author  obtenido de ogGetPath de Ramon Gomez, ETSII Universidad de Sevilla
398#@date    2009-09-15
399#*/
400function ogNewPath ()
401{
402# Variables locales.
403local MNTDIR FILE PREVFILE FILEPATH CURRENTDIR
404
405#/// Si se solicita, mostrar ayuda.
406if [ "$*" == "help" ]; then
407    ogHelp "$FUNCNAME" "$FUNCNAME int_ndisk int_npartition" \
408           "$FUNCNAME \"/mnt/sda1/windows/system32\"  ==>  /mnt/sda1/WINDOWS/System32" \
409           "$FUNCNAME REPO /etc/fstab  ==>  /opt/opengnsys/images/etc/fstab" \
410           "$FUNCNAME 1 1 \"/windows/system32\"  ==>  /mnt/sda1/WINDOWS/System32"
411    return
412fi
413
414#/// Procesar camino según el número de parámetros.
415case $# in
416     # si 1 parametro directorio-fichero completo.
417    1)  FILE="$1" ;;
418    # Si 2 parametros es REPOSITORIO  DIRECTORIO-FICHERO
419    2)  case "$1" in
420            # consultando servidor repositorio base
421            REPO | $IPREPOMAN )  FILE="$OGIMG/$2" || return $OG_ERR_NOTFOUND ;;
422            # consultando particion auxiliar cache local
423            CACHE | $IP )
424                ogMountCache >> /dev/null &&    FILE="$OGCAC/$OGIMG/$2" || return $OG_ERR_NOTFOUND ;;
425            # conectando con Servidor Axuliar.
426            *)     ogRaiseError $OG_ERR_FORMAT
427                   return $? ;;
428        esac ;;
429    # Si 3 parametros DISK PARTITION DIRECTORIO-FICHERO
430    3)  FILE="$(ogMount $1 $2)/$3" || return $OG_ERR_NOTFOUND ;;
431    *)  return $OG_ERR_FORMAT ;;
432esac
433
434mkdir -p ${FILE}
435echo $FILE
436}
437
Note: See TracBrowser for help on using the repository browser.