| 1 | #!/bin/bash |
|---|
| 2 | #/** |
|---|
| 3 | #@file Disk.lib |
|---|
| 4 | #@brief Librería o clase Disk |
|---|
| 5 | #@class Disk |
|---|
| 6 | #@brief Funciones para gestión de discos y particiones. |
|---|
| 7 | #@version 0.9 |
|---|
| 8 | #@warning License: GNU GPLv3+ |
|---|
| 9 | #*/ |
|---|
| 10 | |
|---|
| 11 | |
|---|
| 12 | #/** |
|---|
| 13 | # ogCreatePartitions int_ndisk str_parttype:int_partsize ... |
|---|
| 14 | #@brief Define el conjunto de particiones de un disco. |
|---|
| 15 | #@param int_ndisk nº de orden del disco |
|---|
| 16 | #@param str_parttype mnemónico del tipo de partición |
|---|
| 17 | #@param int_partsize tamaño de la partición (en KB) |
|---|
| 18 | #@return (nada, por determinar) |
|---|
| 19 | #@exception OG_ERR_FORMAT formato incorrecto. |
|---|
| 20 | #@exception OG_ERR_NOTFOUND disco o particion no detectado (no es un dispositivo). |
|---|
| 21 | #@attention El nº de partición se indica por el orden de los párametros \c parttype:partsize |
|---|
| 22 | #@attention Pueden definirse particiones vacías de tipo \c EMPTY |
|---|
| 23 | #@attention No puede definirse partición de cache y no se modifica si existe. |
|---|
| 24 | #@note Requisitos: sfdisk, parted, partprobe, awk |
|---|
| 25 | #@todo Definir atributos (arranque, oculta) y tamaños en MB, GB, etc. |
|---|
| 26 | #@version 0.9 - Primera versión para OpenGNSys |
|---|
| 27 | #@author Ramon Gomez, ETSII Universidad de Sevilla |
|---|
| 28 | #@date 2009/09/09 |
|---|
| 29 | #@version 0.9.1 - Corrección del redondeo del tamaño del disco. |
|---|
| 30 | #@author Ramon Gomez, ETSII Universidad de Sevilla |
|---|
| 31 | #@date 2010/03/09 |
|---|
| 32 | #*/ ## |
|---|
| 33 | function ogCreatePartitions () |
|---|
| 34 | { |
|---|
| 35 | # Variables locales. |
|---|
| 36 | local DISK PART SECTORS CYLS START SIZE TYPE CACHESIZE EXTSTART EXTSIZE tmpsfdisk |
|---|
| 37 | # Si se solicita, mostrar ayuda. |
|---|
| 38 | if [ "$*" == "help" ]; then |
|---|
| 39 | ogHelp "$FUNCNAME" "$FUNCNAME int_ndisk str_parttype:int_partsize ..." \ |
|---|
| 40 | "$FUNCNAME 1 NTFS:10000000 EXT3:5000000 LINUX-SWAP:1000000" |
|---|
| 41 | return |
|---|
| 42 | fi |
|---|
| 43 | # Error si no se reciben menos de 2 parámetros. |
|---|
| 44 | [ $# -ge 2 ] || ogRaiseError $OG_ERR_FORMAT || return $? |
|---|
| 45 | |
|---|
| 46 | # Desmontar todos los sistemas de archivos del disco. |
|---|
| 47 | DISK=$(ogDiskToDev "$1") || return $? |
|---|
| 48 | ogUnmountAll $1 |
|---|
| 49 | # Nº total de sectores, para evitar desbordamiento (evitar redondeo). |
|---|
| 50 | SECTORS=$(awk -v D=${DISK#/dev/} '{if ($4==D) {print $3*2}}' /proc/partitions) |
|---|
| 51 | CYLS=$(sfdisk -g $DISK | cut -f2 -d" ") |
|---|
| 52 | SECTORS=$[SECTORS/CYLS*CYLS-1] |
|---|
| 53 | # Se recalcula el nº de sectores del disco 1, si existe partición de caché. |
|---|
| 54 | CACHESIZE=$(ogGetCacheSize 2>/dev/null | awk '{print $0*2}') |
|---|
| 55 | [ $1 == 1 -a -n "$CACHESIZE" ] && SECTORS=$[SECTORS-CACHESIZE] |
|---|
| 56 | ENDPART3=$(sfdisk -uS -l $DISK | awk -v P="${DISK}3" '{if ($1==P) print $3}') |
|---|
| 57 | # Sector de inicio (la partición 1 empieza en el sector 63). |
|---|
| 58 | START=63 |
|---|
| 59 | PART=1 |
|---|
| 60 | |
|---|
| 61 | # Fichero temporal de entrada para "sfdisk" |
|---|
| 62 | tmpsfdisk=/tmp/sfdisk$$ |
|---|
| 63 | trap "rm -f $tmpsfdisk" 1 2 3 9 15 |
|---|
| 64 | |
|---|
| 65 | echo "unit: sectors" >$tmpsfdisk |
|---|
| 66 | echo >>$tmpsfdisk |
|---|
| 67 | |
|---|
| 68 | # Generar fichero de entrada para "sfdisk" con las particiones. |
|---|
| 69 | shift |
|---|
| 70 | while [ $# -gt 0 ]; do |
|---|
| 71 | # Conservar los datos de la partición de caché. |
|---|
| 72 | if [ -n "$CACHESIZE" -a $PART == 4 ]; then |
|---|
| 73 | echo "$DISK$PART : start=$[SECTORS+1], size=$CACHESIZE, Id=ca" >>$tmpsfdisk |
|---|
| 74 | PART=$[PART+1] |
|---|
| 75 | fi |
|---|
| 76 | # Leer formato de cada parámetro - Tipo:Tamaño |
|---|
| 77 | TYPE="${1%%:*}" |
|---|
| 78 | [ "$TYPE" != "CACHE" ] || ogRaiseError $OG_ERR_FORMAT "$TYPE" || return $? |
|---|
| 79 | SIZE="${1#*:}" |
|---|
| 80 | # Convertir en sectores de 512 B. |
|---|
| 81 | SIZE=$(echo $SIZE|awk '{print $0*2}') # (solución error de sintaxis) |
|---|
| 82 | [ $SIZE -ne 0 ] || ogRaiseError $OG_ERR_FORMAT "$SIZE" || return $? |
|---|
| 83 | # Obtener identificador de tipo de partición. |
|---|
| 84 | ID=$(ogFsToId "$TYPE") |
|---|
| 85 | [ -n "$ID" ] || ogRaiseError $OG_ERR_PARTITION "$TYPE" || return $? |
|---|
| 86 | # Comprobar si la partición es extendida. |
|---|
| 87 | if [ $ID = 5 ]; then |
|---|
| 88 | [ $PART -gt 4 ] && ogRaiseError $OG_ERR_FORMAT && return $? |
|---|
| 89 | EXTSTART=$START |
|---|
| 90 | EXTSIZE=$SIZE |
|---|
| 91 | fi |
|---|
| 92 | # Incluir particiones lógicas dentro de la partición extendida. |
|---|
| 93 | if [ $PART = 5 ]; then |
|---|
| 94 | [ -z "$EXTSTART" ] && ogRaiseError $OG_ERR_FORMAT && return $? |
|---|
| 95 | START=$EXTSTART |
|---|
| 96 | SECTORS=$[EXTSTART+EXTSIZE] |
|---|
| 97 | fi |
|---|
| 98 | # Generar datos para la partición. |
|---|
| 99 | echo "$DISK$PART : start=$START, size=$SIZE, Id=$ID" >>$tmpsfdisk |
|---|
| 100 | # Error si se supera el nº total de sectores. |
|---|
| 101 | START=$[START+SIZE] |
|---|
| 102 | [ $START -le $SECTORS ] || ogRaiseError $OG_ERR_FORMAT "$[START/2] > $[SECTORS/2]" || return $? |
|---|
| 103 | PART=$[PART+1] |
|---|
| 104 | shift |
|---|
| 105 | done |
|---|
| 106 | # Si no se indican las 4 particiones primarias, definirlas como vacías, conservando la partición de caché. |
|---|
| 107 | while [ $PART -le 4 ]; do |
|---|
| 108 | if [ -n "$CACHESIZE" -a $PART == 4 ]; then |
|---|
| 109 | echo "$DISK$PART : start=$[SECTORS+1], size=$CACHESIZE, Id=ca" >>$tmpsfdisk |
|---|
| 110 | else |
|---|
| 111 | echo "$DISK$PART : start=0, size=0, Id=0" >>$tmpsfdisk |
|---|
| 112 | fi |
|---|
| 113 | PART=$[PART+1] |
|---|
| 114 | done |
|---|
| 115 | # Si se define partición extendida sin lógicas, crear particion 5 vacía. |
|---|
| 116 | if [ $PART = 5 -a -n "$EXTSTART" ]; then |
|---|
| 117 | echo "${DISK}5 : start=$EXTSTART, size=$EXTSIZE, Id=0" >>$tmpsfdisk |
|---|
| 118 | fi |
|---|
| 119 | |
|---|
| 120 | # Si la tabla de particiones no es valida, volver a generarla. |
|---|
| 121 | [ $(parted -s $DISK print >/dev/null) ] || fdisk $DISK <<< "w" |
|---|
| 122 | # Definir particiones y notificar al kernel. |
|---|
| 123 | sfdisk -f $DISK < $tmpsfdisk 2>/dev/null && partprobe |
|---|
| 124 | rm -f $tmpsfdisk |
|---|
| 125 | } |
|---|
| 126 | |
|---|
| 127 | |
|---|
| 128 | #/** |
|---|
| 129 | # ogDevToDisk path_device |
|---|
| 130 | #@brief Devuelve el nº de orden de dicso (y partición) correspondiente al nombre de fichero de dispositivo. |
|---|
| 131 | #@param path_device Camino del fichero de dispositivo. |
|---|
| 132 | #@return int_ndisk (para dispositivo de disco) |
|---|
| 133 | #@return int_ndisk int_npartition (para dispositivo de partición). |
|---|
| 134 | #@exception OG_ERR_FORMAT Formato incorrecto. |
|---|
| 135 | #@exception OG_ERR_NOTFOUND Dispositivo no detectado. |
|---|
| 136 | #@note Requisitos: awk |
|---|
| 137 | #@version 0.1 - Integracion para Opengnsys - EAC: DiskEAC() en ATA.lib |
|---|
| 138 | #@author Antonio J. Doblas Viso, Universidad de Malaga |
|---|
| 139 | #@date 2008/10/27 |
|---|
| 140 | #@version 0.9 - Primera version para OpenGNSys |
|---|
| 141 | #@author Ramon Gomez, ETSII Universidad Sevilla |
|---|
| 142 | #@date 2009/07/20 |
|---|
| 143 | #*/ ## |
|---|
| 144 | function ogDevToDisk () |
|---|
| 145 | { |
|---|
| 146 | # Variables locales. |
|---|
| 147 | local d n |
|---|
| 148 | # Si se solicita, mostrar ayuda. |
|---|
| 149 | if [ "$*" == "help" ]; then |
|---|
| 150 | ogHelp "$FUNCNAME" "$FUNCNAME path_device" \ |
|---|
| 151 | "$FUNCNAME /dev/sda => 1 1" |
|---|
| 152 | return |
|---|
| 153 | fi |
|---|
| 154 | |
|---|
| 155 | # Error si no se recibe 1 parámetro. |
|---|
| 156 | [ $# == 1 ] || ogRaiseError $OG_ERR_FORMAT || return $? |
|---|
| 157 | # Error si no es fichero de bloques. |
|---|
| 158 | [ -b "$1" ] || ogRaiseError $OG_ERR_NOTFOUND "$1" || return $? |
|---|
| 159 | |
|---|
| 160 | # Procesa todos los discos para devolver su nº de orden y de partición. |
|---|
| 161 | n=1 |
|---|
| 162 | for d in $(ogDiskToDev); do |
|---|
| 163 | [ -n "$(echo $1 | grep $d)" ] && echo "$n ${1#$d}" && return |
|---|
| 164 | n=$[n+1] |
|---|
| 165 | done |
|---|
| 166 | ogRaiseError $OG_ERR_NOTFOUND "$1" |
|---|
| 167 | return $OG_ERR_NOTFOUND |
|---|
| 168 | } |
|---|
| 169 | |
|---|
| 170 | |
|---|
| 171 | #/** |
|---|
| 172 | # ogDiskToDev [int_ndisk [int_npartition]] |
|---|
| 173 | #@brief Devuelve la equivalencia entre el nº de orden del dispositivo (dicso o partición) y el nombre de fichero de dispositivo correspondiente. |
|---|
| 174 | #@param int_ndisk nº de orden del disco |
|---|
| 175 | #@param int_npartition nº de orden de la partición |
|---|
| 176 | #@return Para 0 parametros: Devuelve los nombres de ficheros de los dispositivos sata/ata/usb linux encontrados. |
|---|
| 177 | #@return Para 1 parametros: Devuelve la ruta del disco duro indicado. |
|---|
| 178 | #@return Para 2 parametros: Devuelve la ruta de la particion indicada. |
|---|
| 179 | #@exception OG_ERR_FORMAT Formato incorrecto. |
|---|
| 180 | #@exception OG_ERR_NOTFOUND Dispositivo no detectado. |
|---|
| 181 | #@note Requisitos: awk, lvm |
|---|
| 182 | #@version 0.1 - Integracion para Opengnsys - EAC: Disk() en ATA.lib; HIDRA: DetectarDiscos.sh |
|---|
| 183 | #@author Ramon Gomez, ETSII Universidad de Sevilla |
|---|
| 184 | #@Date 2008/06/19 |
|---|
| 185 | #@author Antonio J. Doblas Viso, Universidad de Malaga |
|---|
| 186 | #@date 2008/10/27 |
|---|
| 187 | #@version 0.9 - Primera version para OpenGNSys |
|---|
| 188 | #@author Ramon Gomez, ETSII Universidad Sevilla |
|---|
| 189 | #@date 2009-07-20 |
|---|
| 190 | #*/ ## |
|---|
| 191 | function ogDiskToDev () |
|---|
| 192 | { |
|---|
| 193 | # Variables locales |
|---|
| 194 | local ALLDISKS VOLGROUPS DISK PART |
|---|
| 195 | |
|---|
| 196 | # Si se solicita, mostrar ayuda. |
|---|
| 197 | if [ "$*" == "help" ]; then |
|---|
| 198 | ogHelp "$FUNCNAME" "$FUNCNAME int_ndisk [int_npartition]" \ |
|---|
| 199 | "$FUNCNAME => /dev/sda /dev/sdb" \ |
|---|
| 200 | "$FUNCNAME 1 => /dev/sda" \ |
|---|
| 201 | "$FUNCNAME 1 1 => /dev/sda1" |
|---|
| 202 | return |
|---|
| 203 | fi |
|---|
| 204 | |
|---|
| 205 | # Listar dispositivo para los discos duros (tipos: 3=hd, 8=sd). |
|---|
| 206 | ALLDISKS=$(awk '($1==3 || $1==8) && $4!~/[0-9]/ {printf "/dev/%s ",$4}' /proc/partitions) |
|---|
| 207 | VOLGROUPS=$(vgs -a --noheadings 2>/dev/null | awk '{printf "/dev/%s ",$1}') |
|---|
| 208 | ALLDISKS="$ALLDISKS $VOLGROUPS" |
|---|
| 209 | |
|---|
| 210 | # Mostrar salidas segun el número de parametros. |
|---|
| 211 | case $# in |
|---|
| 212 | 0) # Muestra todos los discos, separados por espacios. |
|---|
| 213 | echo $ALLDISKS |
|---|
| 214 | ;; |
|---|
| 215 | 1) # Error si el parámetro no es un digito. |
|---|
| 216 | [ -z "${1/[1-9]/}" ] || ogRaiseError $OG_ERR_FORMAT || return $? |
|---|
| 217 | DISK=$(echo "$ALLDISKS" | awk -v n=$1 '{print $n}') |
|---|
| 218 | # Error si el fichero no existe. |
|---|
| 219 | [ -e "$DISK" ] || ogRaiseError $OG_ERR_NOTFOUND "$1" || return $? |
|---|
| 220 | echo "$DISK" |
|---|
| 221 | ;; |
|---|
| 222 | 2) # Error si los 2 parámetros no son digitos. |
|---|
| 223 | [ -z "${1/[1-9]/}" -a -z "${2/[1-9]/}" ] || ogRaiseError $OG_ERR_FORMAT|| return $? |
|---|
| 224 | DISK=$(echo "$ALLDISKS" | awk -v n=$1 '{print $n}') |
|---|
| 225 | [ -e "$DISK" ] || ogRaiseError $OG_ERR_NOTFOUND "$1" || return $? |
|---|
| 226 | PART="$DISK$2" |
|---|
| 227 | # Comprobar si es partición. |
|---|
| 228 | if [ -b "$PART" ]; then |
|---|
| 229 | echo "$PART" |
|---|
| 230 | elif [ -n "$VOLGROUPS" ]; then |
|---|
| 231 | # Comprobar si volumen lógico. /* (comentario Doxygen) |
|---|
| 232 | PART=$(lvscan -a 2>/dev/null | grep "'$DISK/" | awk -v n=$2 -F\' '{if (NR==n) print $2}') |
|---|
| 233 | [ -e "$PART" ] || ogRaiseError $OG_ERR_NOTFOUND "$1 $2" || return $? |
|---|
| 234 | # (comentario Doxygen) */ |
|---|
| 235 | echo "$PART" |
|---|
| 236 | else |
|---|
| 237 | ogRaiseError $OG_ERR_NOTFOUND "$1 $2" || return $? |
|---|
| 238 | fi |
|---|
| 239 | ;; |
|---|
| 240 | *) # Formato erroneo. |
|---|
| 241 | ogRaiseError $OG_ERR_FORMAT |
|---|
| 242 | return $OG_ERR_FORMAT |
|---|
| 243 | ;; |
|---|
| 244 | esac |
|---|
| 245 | } |
|---|
| 246 | |
|---|
| 247 | |
|---|
| 248 | #/** |
|---|
| 249 | # ogFsToId str_fstype |
|---|
| 250 | #@brief Devuelve el identificador de partición correspondiente a un tipo de sistema de archivos. |
|---|
| 251 | #@param str_fstype mnemónico de tipo de sistema de archivos |
|---|
| 252 | #@return int_idpart nº identificador de tipo de partición. |
|---|
| 253 | #@exception OG_ERR_FORMAT Formato incorrecto. |
|---|
| 254 | #@version 0.1 - Integracion para Opengnsys - EAC: TypeFS () en ATA.lib |
|---|
| 255 | #@author Antonio J. Doblas Viso, Universidad de Malaga |
|---|
| 256 | #@date 2008/10/27 |
|---|
| 257 | #@version 0.9 - Primera version para OpenGNSys |
|---|
| 258 | #@author Ramon Gomez, ETSII Universidad Sevilla |
|---|
| 259 | #@date 2009-12-14 |
|---|
| 260 | #*/ ## |
|---|
| 261 | function ogFsToId () |
|---|
| 262 | { |
|---|
| 263 | # Variables locales |
|---|
| 264 | local ID |
|---|
| 265 | |
|---|
| 266 | # Si se solicita, mostrar ayuda. |
|---|
| 267 | if [ "$*" == "help" ]; then |
|---|
| 268 | ogHelp "$FUNCNAME" "$FUNCNAME str_fstype" "$FUNCNAME EXT3 => 83" |
|---|
| 269 | return |
|---|
| 270 | fi |
|---|
| 271 | # Error si no se recibe 1 parámetro. |
|---|
| 272 | [ $# == 1 ] || ogRaiseError $OG_ERR_FORMAT || return $? |
|---|
| 273 | |
|---|
| 274 | # Asociar id. de partición para su mnemónico de sistema de archivos. |
|---|
| 275 | case "$1" in |
|---|
| 276 | EMPTY) ID=0 ;; |
|---|
| 277 | FAT12) ID=1 ;; |
|---|
| 278 | EXTENDED) ID=5 ;; |
|---|
| 279 | FAT16) ID=6 ;; |
|---|
| 280 | NTFS|EXFAT) ID=7 ;; |
|---|
| 281 | FAT32) ID=b ;; |
|---|
| 282 | HFAT12) ID=11 ;; |
|---|
| 283 | HFAT16) ID=16 ;; |
|---|
| 284 | HNTFS) ID=17 ;; |
|---|
| 285 | HFAT32) ID=1b ;; |
|---|
| 286 | LINUX-SWAP) ID=82 ;; |
|---|
| 287 | EXT[234]|REISERFS|REISER4|XFS|JFS) |
|---|
| 288 | ID=83 ;; |
|---|
| 289 | LINUX-LVM) ID=8e ;; |
|---|
| 290 | SOLARIS) ID=bf ;; |
|---|
| 291 | CACHE) ID=ca ;; |
|---|
| 292 | LINUX-RAID) ID=fd ;; |
|---|
| 293 | *) ID="" ;; |
|---|
| 294 | esac |
|---|
| 295 | echo $ID |
|---|
| 296 | } |
|---|
| 297 | |
|---|
| 298 | |
|---|
| 299 | #/** |
|---|
| 300 | # ogGetDiskSize int_ndisk |
|---|
| 301 | #@brief Muestra el tamaño en KB de un disco. |
|---|
| 302 | #@param int_ndisk nº de orden del disco |
|---|
| 303 | #@return int_size - Tamaño en KB del disco. |
|---|
| 304 | #@exception OG_ERR_FORMAT formato incorrecto. |
|---|
| 305 | #@exception OG_ERR_NOTFOUND disco o particion no detectado (no es un |
|---|
| 306 | dispositivo). |
|---|
| 307 | #@note Requisitos: sfdisk, awk |
|---|
| 308 | #@version 0.9.2 - Primera version para OpenGnSys |
|---|
| 309 | #@author Ramon Gomez, ETSII Universidad de Sevilla |
|---|
| 310 | #@date 2010/09/15 |
|---|
| 311 | #*/ ## |
|---|
| 312 | function ogGetDiskSize () |
|---|
| 313 | { |
|---|
| 314 | # Variables locales. |
|---|
| 315 | local DISK |
|---|
| 316 | |
|---|
| 317 | # Si se solicita, mostrar ayuda. |
|---|
| 318 | if [ "$*" == "help" ]; then |
|---|
| 319 | ogHelp "$FUNCNAME" "$FUNCNAME int_ndisk" \ "$FUNCNAME 1 => |
|---|
| 320 | 244198584" |
|---|
| 321 | return |
|---|
| 322 | fi |
|---|
| 323 | # Error si no se recibe 1 parámetro. |
|---|
| 324 | [ $# == 1 ] || ogRaiseError $OG_ERR_FORMAT || return $? |
|---|
| 325 | |
|---|
| 326 | # Obtener el tamaño de la partición. |
|---|
| 327 | DISK="$(ogDiskToDev $1)" || return $? |
|---|
| 328 | sfdisk -s $DISK |
|---|
| 329 | } |
|---|
| 330 | |
|---|
| 331 | |
|---|
| 332 | # ogGetPartitionActive int_ndisk |
|---|
| 333 | #@brief Muestra que particion de un disco esta marcada como de activa. |
|---|
| 334 | #@param int_ndisk nº de orden del disco |
|---|
| 335 | #@return int_npart Nº de partición activa |
|---|
| 336 | #@exception OG_ERR_FORMAT Formato incorrecto. |
|---|
| 337 | #@exception OG_ERR_NOTFOUND Disco o particion no corresponden con un dispositivo. |
|---|
| 338 | #@note Requisitos: parted |
|---|
| 339 | #@todo Queda definir formato para atributos (arranque, oculta, ...). |
|---|
| 340 | #@version 0.9 - Primera version compatible con OpenGNSys. |
|---|
| 341 | #@author Ramon Gomez, ETSII Universidad de Sevilla |
|---|
| 342 | #@date 2009/09/17 |
|---|
| 343 | #*/ ## |
|---|
| 344 | function ogGetPartitionActive () |
|---|
| 345 | { |
|---|
| 346 | # Variables locales |
|---|
| 347 | local DISK |
|---|
| 348 | |
|---|
| 349 | # Si se solicita, mostrar ayuda. |
|---|
| 350 | if [ "$*" == "help" ]; then |
|---|
| 351 | ogHelp "$FUNCNAME" "$FUNCNAME int_ndisk" "$FUNCNAME 1 => 1" |
|---|
| 352 | return |
|---|
| 353 | fi |
|---|
| 354 | # Error si no se recibe 1 parámetro. |
|---|
| 355 | [ $# == 1 ] || ogRaiseError $OG_ERR_FORMAT || return $? |
|---|
| 356 | |
|---|
| 357 | # Comprobar que el disco existe y listar su partición activa. |
|---|
| 358 | DISK="$(ogDiskToDev $1)" || return $? |
|---|
| 359 | parted $DISK print 2>/dev/null | awk '/boot/ {print $1}' |
|---|
| 360 | } |
|---|
| 361 | |
|---|
| 362 | |
|---|
| 363 | #/** |
|---|
| 364 | # ogGetPartitionId int_ndisk int_npartition |
|---|
| 365 | #@brief Devuelve el mnemonico con el tipo de sistema de archivos. |
|---|
| 366 | #@param int_ndisk nº de orden del disco |
|---|
| 367 | #@param int_npartition nº de orden de la partición |
|---|
| 368 | #@return Identificador de tipo de partición. |
|---|
| 369 | #@exception OG_ERR_FORMAT Formato incorrecto. |
|---|
| 370 | #@exception OG_ERR_NOTFOUND Disco o particion no corresponden con un dispositivo. |
|---|
| 371 | #@note Requisitos: sfdisk |
|---|
| 372 | #@version 0.9 - Primera versión compatible con OpenGNSys. |
|---|
| 373 | #@author Ramon Gomez, ETSII Universidad de Sevilla |
|---|
| 374 | #@date 25/03/2009 |
|---|
| 375 | #*/ ## |
|---|
| 376 | function ogGetPartitionId () |
|---|
| 377 | { |
|---|
| 378 | # Variables locales. |
|---|
| 379 | local DISK PART |
|---|
| 380 | |
|---|
| 381 | # Si se solicita, mostrar ayuda. |
|---|
| 382 | if [ "$*" == "help" ]; then |
|---|
| 383 | ogHelp "$FUNCNAME" "$FUNCNAME int_ndisk int_npartition" \ |
|---|
| 384 | "$FUNCNAME 1 1 => 7" |
|---|
| 385 | return |
|---|
| 386 | fi |
|---|
| 387 | # Error si no se reciben 2 parámetros. |
|---|
| 388 | [ $# == 2 ] || ogRaiseError $OG_ERR_FORMAT || return $? |
|---|
| 389 | |
|---|
| 390 | # Detectar id. de tipo de particion y codificar al mnemonico. |
|---|
| 391 | DISK=$(ogDiskToDev $1) || return $? |
|---|
| 392 | PART=$(ogDiskToDev $1 $2) || return $? |
|---|
| 393 | echo $(sfdisk --id $DISK $2 2>/dev/null) |
|---|
| 394 | } |
|---|
| 395 | |
|---|
| 396 | |
|---|
| 397 | #/** |
|---|
| 398 | # ogGetPartitionSize int_ndisk int_npartition |
|---|
| 399 | #@brief Muestra el tamano en KB de una particion determinada. |
|---|
| 400 | #@param int_ndisk nº de orden del disco |
|---|
| 401 | #@param int_npartition nº de orden de la partición |
|---|
| 402 | #@return int_partsize - Tamaño en KB de la partición. |
|---|
| 403 | #@exception OG_ERR_FORMAT formato incorrecto. |
|---|
| 404 | #@exception OG_ERR_NOTFOUND disco o particion no detectado (no es un dispositivo). |
|---|
| 405 | #@note Requisitos: sfdisk, awk |
|---|
| 406 | #@version 0.1 - Integracion para Opengnsys - EAC: SizePartition () en ATA.lib |
|---|
| 407 | #@author Antonio J. Doblas Viso, Universidad de Malaga |
|---|
| 408 | #@date 2008/10/27 |
|---|
| 409 | #@version 0.9 - Primera version para OpenGNSys |
|---|
| 410 | #@author Ramon Gomez, ETSII Universidad de Sevilla |
|---|
| 411 | #@date 2009/07/24 |
|---|
| 412 | #*/ ## |
|---|
| 413 | function ogGetPartitionSize () |
|---|
| 414 | { |
|---|
| 415 | # Variables locales. |
|---|
| 416 | local DISK PART |
|---|
| 417 | |
|---|
| 418 | # Si se solicita, mostrar ayuda. |
|---|
| 419 | if [ "$*" == "help" ]; then |
|---|
| 420 | ogHelp "$FUNCNAME" "$FUNCNAME int_ndisk int_npartition" \ |
|---|
| 421 | "$FUNCNAME 1 1 => 10000000" |
|---|
| 422 | return |
|---|
| 423 | fi |
|---|
| 424 | # Error si no se reciben 2 parámetros. |
|---|
| 425 | [ $# == 2 ] || ogRaiseError $OG_ERR_FORMAT || return $? |
|---|
| 426 | |
|---|
| 427 | # Obtener el tamaño de la partición. |
|---|
| 428 | DISK="$(ogDiskToDev $1)" || return $? |
|---|
| 429 | PART="$(ogDiskToDev $1 $2)" || return $? |
|---|
| 430 | case "$(ogGetPartitionId $1 $2)" in |
|---|
| 431 | 5|f) # Procesar detección de tamaño de partición Extendida. |
|---|
| 432 | sfdisk -l $DISK 2>/dev/null | \ |
|---|
| 433 | awk -v p=$PART '{if ($1==p) {sub (/\*/,""); print $5} }' |
|---|
| 434 | ;; |
|---|
| 435 | *) sfdisk -s $PART |
|---|
| 436 | ;; |
|---|
| 437 | esac |
|---|
| 438 | } |
|---|
| 439 | |
|---|
| 440 | |
|---|
| 441 | #/** |
|---|
| 442 | # ogListPartitions int_ndisk |
|---|
| 443 | #@brief Lista las particiones definidas en un disco. |
|---|
| 444 | #@param int_ndisk nº de orden del disco |
|---|
| 445 | #@return str_parttype:int_partsize ... |
|---|
| 446 | #@exception OG_ERR_FORMAT formato incorrecto. |
|---|
| 447 | #@exception OG_ERR_NOTFOUND disco o particion no detectado (no es un dispositivo). |
|---|
| 448 | #@note Requisitos: \c parted \c awk |
|---|
| 449 | #@attention El nº de partición se indica por el orden de los párametros \c parttype:partsize |
|---|
| 450 | #@attention Las tuplas de valores están separadas por espacios. |
|---|
| 451 | #@version 0.9 - Primera versión para OpenGNSys |
|---|
| 452 | #@author Ramon Gomez, ETSII Universidad de Sevilla |
|---|
| 453 | #@date 2009/07/24 |
|---|
| 454 | #*/ ## |
|---|
| 455 | function ogListPartitions () |
|---|
| 456 | { |
|---|
| 457 | # Variables locales. |
|---|
| 458 | local DISK PART NPARTS TYPE SIZE |
|---|
| 459 | |
|---|
| 460 | # Si se solicita, mostrar ayuda. |
|---|
| 461 | if [ "$*" == "help" ]; then |
|---|
| 462 | ogHelp "$FUNCNAME" "$FUNCNAME int_ndisk" \ |
|---|
| 463 | "$FUNCNAME 1 => NTFS:10000000 EXT3:5000000 LINUX-SWAP:1000000" |
|---|
| 464 | return |
|---|
| 465 | fi |
|---|
| 466 | # Error si no se recibe 1 parámetro. |
|---|
| 467 | [ $# == 1 ] || ogRaiseError $OG_ERR_FORMAT "$FORMAT" || return $? |
|---|
| 468 | |
|---|
| 469 | # Procesar la salida de \c parted . |
|---|
| 470 | DISK="$(ogDiskToDev $1)" || return $? |
|---|
| 471 | NPARTS=$(ogGetPartitionsNumber $1) |
|---|
| 472 | for (( PART = 1; PART <= NPARTS; PART++ )); do |
|---|
| 473 | TYPE=$(ogGetFsType $1 $PART 2>/dev/null) |
|---|
| 474 | if [ $? -eq 0 ]; then |
|---|
| 475 | SIZE=$(ogGetPartitionSize $1 $PART 2>/dev/null) |
|---|
| 476 | echo -n "$TYPE:$SIZE " |
|---|
| 477 | else |
|---|
| 478 | echo -n "EMPTY:0 " |
|---|
| 479 | fi |
|---|
| 480 | done |
|---|
| 481 | echo |
|---|
| 482 | } |
|---|
| 483 | |
|---|
| 484 | |
|---|
| 485 | #/** |
|---|
| 486 | # ogListPrimaryPartitions int_ndisk |
|---|
| 487 | #@brief Metafunción que lista las particiones primarias no vacías definidas en un disco. |
|---|
| 488 | #@param int_ndisk nº de orden del disco |
|---|
| 489 | #@see ogListPartitions |
|---|
| 490 | #*/ ## |
|---|
| 491 | function ogListPrimaryPartitions () |
|---|
| 492 | { |
|---|
| 493 | # Variables locales. |
|---|
| 494 | local PARTS |
|---|
| 495 | |
|---|
| 496 | PARTS=$(ogListPartitions "$@") || return $? |
|---|
| 497 | echo $PARTS | cut -sf1-4 -d" " | sed 's/\( EMPTY:0\)*$//' |
|---|
| 498 | } |
|---|
| 499 | |
|---|
| 500 | |
|---|
| 501 | #/** |
|---|
| 502 | # ogListLogicalPartitions int_ndisk |
|---|
| 503 | #@brief Metafunción que lista las particiones lógicas definidas en un disco. |
|---|
| 504 | #@param int_ndisk nº de orden del disco |
|---|
| 505 | #@see ogListPartitions |
|---|
| 506 | #*/ ## |
|---|
| 507 | function ogListLogicalPartitions () |
|---|
| 508 | { |
|---|
| 509 | # Variables locales. |
|---|
| 510 | local PARTS |
|---|
| 511 | |
|---|
| 512 | PARTS=$(ogListPartitions "$@") || return $? |
|---|
| 513 | echo $PARTS | cut -sf5- -d" " |
|---|
| 514 | } |
|---|
| 515 | |
|---|
| 516 | |
|---|
| 517 | #/** |
|---|
| 518 | # ogSetPartitionActive int_ndisk int_npartition |
|---|
| 519 | #@brief Establece cual es la partición activa de un disco. |
|---|
| 520 | #@param int_ndisk nº de orden del disco |
|---|
| 521 | #@param int_npartition nº de orden de la partición |
|---|
| 522 | #@return (nada). |
|---|
| 523 | #@exception OG_ERR_FORMAT Formato incorrecto. |
|---|
| 524 | #@exception OG_ERR_NOTFOUND Disco o partición no corresponden con un dispositivo. |
|---|
| 525 | #@note Requisitos: parted |
|---|
| 526 | #@version 0.1 - Integracion para Opengnsys - EAC: SetPartitionActive() en ATA.lib |
|---|
| 527 | #@author Antonio J. Doblas Viso, Universidad de Malaga |
|---|
| 528 | #@date 2008/10/27 |
|---|
| 529 | #@version 0.9 - Primera version compatible con OpenGNSys. |
|---|
| 530 | #@author Ramon Gomez, ETSII Universidad de Sevilla |
|---|
| 531 | #@date 2009/09/17 |
|---|
| 532 | #*/ ## |
|---|
| 533 | function ogSetPartitionActive () |
|---|
| 534 | { |
|---|
| 535 | # Variables locales |
|---|
| 536 | local DISK PART |
|---|
| 537 | |
|---|
| 538 | # Si se solicita, mostrar ayuda. |
|---|
| 539 | if [ "$*" == "help" ]; then |
|---|
| 540 | ogHelp "$FUNCNAME" "$FUNCNAME int_ndisk int_npartition" \ |
|---|
| 541 | "$FUNCNAME 1 1" |
|---|
| 542 | return |
|---|
| 543 | fi |
|---|
| 544 | # Error si no se reciben 2 parámetros. |
|---|
| 545 | [ $# == 2 ] || ogRaiseError $OG_ERR_FORMAT || return $? |
|---|
| 546 | |
|---|
| 547 | # Comprobar que el disco existe y activar la partición indicada. |
|---|
| 548 | DISK="$(ogDiskToDev $1)" || return $? |
|---|
| 549 | PART="$(ogDiskToDev $1 $2)" || return $? |
|---|
| 550 | parted -s $DISK set $2 boot on 2>/dev/null |
|---|
| 551 | } |
|---|
| 552 | |
|---|
| 553 | |
|---|
| 554 | #/** |
|---|
| 555 | # ogSetPartitionSize int_ndisk int_npartition int_size |
|---|
| 556 | #@brief Muestra el tamano en KB de una particion determinada. |
|---|
| 557 | #@param int_ndisk nº de orden del disco |
|---|
| 558 | #@param int_npartition nº de orden de la partición |
|---|
| 559 | #@param int_size tamaño de la partición (en KB) |
|---|
| 560 | #@return (nada) |
|---|
| 561 | #@exception OG_ERR_FORMAT formato incorrecto. |
|---|
| 562 | #@exception OG_ERR_NOTFOUND disco o particion no detectado (no es un dispositivo). |
|---|
| 563 | #@note Requisitos: sfdisk, awk |
|---|
| 564 | #@todo Compruebar que el tamaño sea numérico positivo y evitar que pueda solaparse con la siguiente partición. |
|---|
| 565 | #@version 0.9 - Primera versión para OpenGNSys |
|---|
| 566 | #@author Ramon Gomez, ETSII Universidad de Sevilla |
|---|
| 567 | #@date 2009/07/24 |
|---|
| 568 | #*/ ## |
|---|
| 569 | function ogSetPartitionSize () |
|---|
| 570 | { |
|---|
| 571 | # Variables locales. |
|---|
| 572 | local DISK PART SIZE |
|---|
| 573 | |
|---|
| 574 | # Si se solicita, mostrar ayuda. |
|---|
| 575 | if [ "$*" == "help" ]; then |
|---|
| 576 | ogHelp "$FUNCNAME" "$FUNCNAME int_ndisk int_npartition int_size" \ |
|---|
| 577 | "$FUNCNAME 1 1 10000000" |
|---|
| 578 | return |
|---|
| 579 | fi |
|---|
| 580 | # Error si no se reciben 3 parámetros. |
|---|
| 581 | [ $# == 3 ] || ogRaiseError $OG_ERR_FORMAT || return $? |
|---|
| 582 | |
|---|
| 583 | # Obtener el tamaño de la partición. |
|---|
| 584 | DISK="$(ogDiskToDev $1)" || return $? |
|---|
| 585 | PART="$(ogDiskToDev $1 $2)" || return $? |
|---|
| 586 | # Convertir tamaño en KB a sectores de 512 B. |
|---|
| 587 | SIZE=$[$3*2] || ogRaiseError $OG_ERR_FORMAT || return $? |
|---|
| 588 | # Usar \c sfdisk para redefinir el tamaño. |
|---|
| 589 | sfdisk -f -uS -N$2 $DISK <<< ",$SIZE" &>/dev/null || ogRaiseError $OG_ERR_PARTITION "$1,$2" || return $? |
|---|
| 590 | partprobe 2>/dev/null |
|---|
| 591 | } |
|---|
| 592 | |
|---|
| 593 | |
|---|
| 594 | #/** |
|---|
| 595 | # ogUpdatePartitionTable |
|---|
| 596 | #@brief Fuerza al kernel releer la tabla de particiones de los discos duros |
|---|
| 597 | #@param no requiere |
|---|
| 598 | #@return informacion propia de la herramienta |
|---|
| 599 | #@note Requisitos: \c partprobe |
|---|
| 600 | #@warning pendiente estructurar la funcion a opengnsys |
|---|
| 601 | #@version 0.1 - Integracion para Opengnsys - EAC: UpdatePartitionTable() en ATA.lib |
|---|
| 602 | #@author Antonio J. Doblas Viso. Universidad de Malaga |
|---|
| 603 | #@date 27/10/2008 |
|---|
| 604 | #*/ |
|---|
| 605 | |
|---|
| 606 | function ogUpdatePartitionTable () |
|---|
| 607 | { |
|---|
| 608 | echo "Forzando al kernel la lectura de la tabla de particiones" |
|---|
| 609 | list=`partprobe -s | cut -f1 -d: ` 2>/dev/null |
|---|
| 610 | echo $list > /tmp/disk |
|---|
| 611 | } |
|---|
| 612 | |
|---|
| 613 | |
|---|
| 614 | |
|---|
| 615 | #/** @function ogGetPartitionsNumber: @brief detecta el numero de particiones del disco duro indicado. |
|---|
| 616 | #@param int_numdisk (indentificado EAC del disco) |
|---|
| 617 | #@return devuelve el numero paritiones del disco duro indicado |
|---|
| 618 | #@warning Salidas de errores no determinada |
|---|
| 619 | #@attention Requisitos: parted |
|---|
| 620 | #@note Notas sin especificar |
|---|
| 621 | #@version 0.1 - Integracion para Opengnsys - EAC: DetectNumberPartition () en ATA.lib |
|---|
| 622 | #@author Antonio J. Doblas Viso. Universidad de Malaga |
|---|
| 623 | #@date Date: 27/10/2008 |
|---|
| 624 | #@version 1.0 - Uso de sfdisk Primera version para OpenGnSys |
|---|
| 625 | #@author Ramon Gomez, ETSII Universidad de Sevilla |
|---|
| 626 | #@date 2009/07/24 |
|---|
| 627 | #*/ |
|---|
| 628 | function ogGetPartitionsNumber () { |
|---|
| 629 | #local disco totalpart |
|---|
| 630 | #disco=`ogDiskToDev $1` |
|---|
| 631 | #totalpart=`parted $disco print | egrep ^" [0123456789] " -c` |
|---|
| 632 | #echo $totalpart |
|---|
| 633 | local DISK |
|---|
| 634 | #/// Contar el nº de veces que aparece el disco en su lista de particiones. |
|---|
| 635 | DISK=$(ogDiskToDev $1) 2>/dev/null |
|---|
| 636 | sfdisk -l $DISK 2>/dev/null | grep -c "^$DISK" |
|---|
| 637 | } |
|---|
| 638 | |
|---|
| 639 | |
|---|
| 640 | #/** @function ogDiskToRelativeDev: @brief Traduce los ID de discos o particiones EAC a ID Linux relativos, es decir 1 1 => sda1 |
|---|
| 641 | #@param Admite 1 parametro: $1 int_numdisk |
|---|
| 642 | #@param Admite 2 parametro: $1 int_numdisk $2 int_partition |
|---|
| 643 | #@return Para 1 parametros traduce Discos Duros: Devuelve la ruta relativa linux del disco duro indicado con nomenclatura EAC.........ejemplo: IdPartition 1 => sda |
|---|
| 644 | #@return Para 2 parametros traduce Particiones: Devuelve la ruta relativa linux de la particion indicado con nomenclatura EAC........... ejemplo: IdPartition 2 1 => sdb1 |
|---|
| 645 | #@warning No definidas |
|---|
| 646 | #@attention |
|---|
| 647 | #@note Notas sin especificar |
|---|
| 648 | #@version 0.1 - Integracion para Opengnsys - EAC: IdPartition en ATA.lib |
|---|
| 649 | #@author Antonio J. Doblas Viso. Universidad de Malaga |
|---|
| 650 | #@date 27/10/2008 |
|---|
| 651 | #*/ |
|---|
| 652 | function ogDiskToRelativeDev () { |
|---|
| 653 | if [ $# = 0 ] |
|---|
| 654 | then |
|---|
| 655 | Msg "Info: Traduce el identificador del dispositivo EAC a dispositivo linux \n" info |
|---|
| 656 | Msg "Sintaxis1: IdPartition int_disk -----------------Ejemplo1: IdPartition 1 -> sda " example |
|---|
| 657 | Msg "Sintaxis2: IdPartition int_disk int_partition --Ejemplo2: IdPartition 1 2 -> sda2 " example |
|---|
| 658 | |
|---|
| 659 | return |
|---|
| 660 | fi |
|---|
| 661 | #PART="$(Disk|cut -f$1 -d' ')$2" # se comenta esta linea porque doxygen no reconoce la funcion disk y no crea los enlaces y referencias correctas. |
|---|
| 662 | PART=$(ogDiskToDev|cut -f$1 -d' ')$2 |
|---|
| 663 | echo $PART | cut -f3 -d \/ |
|---|
| 664 | } |
|---|
| 665 | |
|---|
| 666 | #/** @function ogDeletePartitionTable: @brief Borra la tabla de particiones del disco. |
|---|
| 667 | #@param $1 opcion A (identificador LINUX) str_ID_linux (/dev/sda) |
|---|
| 668 | #@param $1 opcion B (Identifiador EAC) int_numdiskEAC(1) |
|---|
| 669 | #@return la informacion propia del fdisk |
|---|
| 670 | #@warning no definidos |
|---|
| 671 | #@attention |
|---|
| 672 | #@note |
|---|
| 673 | #@version 0.1 - Integracion para Opengnsys - EAC: DeletePartitionTable () en ATA.lib |
|---|
| 674 | #@author Antonio J. Doblas Viso. Universidad de Malaga |
|---|
| 675 | #@date 27/10/2008 |
|---|
| 676 | #*/ |
|---|
| 677 | function ogDeletePartitionTable () { |
|---|
| 678 | if [ $# = 0 ] |
|---|
| 679 | then |
|---|
| 680 | Msg "sintaxis1: ogDeletePartitionTable int_disk" red |
|---|
| 681 | Msg "sintaxis2: ogDeletePartitionTable str_/dev/sdX" red |
|---|
| 682 | return |
|---|
| 683 | fi |
|---|
| 684 | if [ -n "${1%/dev/*}" ] |
|---|
| 685 | then |
|---|
| 686 | dev=`DiskToDev $1` |
|---|
| 687 | else |
|---|
| 688 | dev=$1 |
|---|
| 689 | fi |
|---|
| 690 | echo -ne "o\nw" | fdisk $dev |
|---|
| 691 | } |
|---|
| 692 | |
|---|
| 693 | |
|---|
| 694 | #/** @function ogSetPartitionId: @brief Cambia el identificador de la particion, pero no su sistema de archivos. |
|---|
| 695 | #@param $1 int_numdiskEAC |
|---|
| 696 | #@param $2 int_numpartitionEAC |
|---|
| 697 | #@param $3 str_tipoPartition admite EXT2 EXT3 NTFS FAT32 SWAP CACHE |
|---|
| 698 | #@return la propia del fdisk |
|---|
| 699 | #@warning no controla los parametros, si se introducen mal o simplemente no se introducen no muestra mensaje |
|---|
| 700 | #@warning Identifica por nombre del sistema de archivos no por número |
|---|
| 701 | #@attention Requisitos: fdisk |
|---|
| 702 | #@note |
|---|
| 703 | #@version 0.1 - Integracion para Opengnsys - SetPartitionType() en ATA.lib |
|---|
| 704 | #@author Antonio J. Doblas Viso. Universidad de Malaga |
|---|
| 705 | #@date 27/10/2008 |
|---|
| 706 | #*/ |
|---|
| 707 | function ogSetPartitionId() { |
|---|
| 708 | # Variables locales |
|---|
| 709 | local DISK PART ID |
|---|
| 710 | |
|---|
| 711 | # Si se solicita, mostrar ayuda. |
|---|
| 712 | if [ "$*" == "help" ]; then |
|---|
| 713 | ogHelp "$FUNCNAME" "$FUNCNAME int_ndisk int_npartition str_type" \ |
|---|
| 714 | "$FUNCNAME 1 1 NTFS" |
|---|
| 715 | return |
|---|
| 716 | fi |
|---|
| 717 | # Error si no se reciben 3 parámetros. |
|---|
| 718 | [ $# == 3 ] || ogRaiseError $OG_ERR_FORMAT || return $? |
|---|
| 719 | |
|---|
| 720 | # Sustituye nº de disco por su dispositivo. |
|---|
| 721 | DISK=`ogDiskToDev $1` || return $? |
|---|
| 722 | PART=`ogDiskToDev $1 $2` || return $? |
|---|
| 723 | |
|---|
| 724 | # Elección del tipo de partición. |
|---|
| 725 | ID=$(ogFsToId "$3") |
|---|
| 726 | [ -n "$ID" ] || ogRaiseError $OG_ERR_PARTITION "$TYPE" || return $? |
|---|
| 727 | |
|---|
| 728 | echo -ne "t\n$2\n${ID}\nw\n" | fdisk $DISK 1>/dev/null 2>&1 |
|---|
| 729 | } |
|---|
| 730 | |
|---|
| 731 | |
|---|
| 732 | #/** @function ogDeletePartitionsLabels: @brief Elimina la informacion que tiene el kernel del cliente og sobre los labels de los sistemas de archivos |
|---|
| 733 | #@param No requiere |
|---|
| 734 | #@return Nada |
|---|
| 735 | #@warning |
|---|
| 736 | #@attention Requisitos: comando interno linux rm |
|---|
| 737 | #@note |
|---|
| 738 | #@version 0.1 - Integracion para Opengnsys - EAC: DeletePartitionTable() en ATA.lib |
|---|
| 739 | #@author Antonio J. Doblas Viso. Universidad de Malaga |
|---|
| 740 | #@date 27/10/2008 |
|---|
| 741 | #*/ |
|---|
| 742 | function ogDeletePartitionsLabels () { |
|---|
| 743 | rm /dev/disk/by-label/* # */ COMENTARIO OBLIGATORIO PARA DOXYGEN |
|---|
| 744 | } |
|---|
| 745 | |
|---|
