Provided by: manpages-es-extra_0.8a-19_all 
NOMBRE
hwclock - interroga y pone en hora el Reloj del Hardware (RTC)
SINOPSIS
hwclock --show
hwclock --set --date=nuevafecha
hwclock --systohc
hwclock --hctosys
hwclock --getepoch
hwclock --setepoch --epoch=año
hwclock --adjust
hwclock --version
otras opciones:
--utc --directisa --test --debug
Las abreviaciones mínimas de todas las opciones son aceptables, si no hay ambigüedad.
También se aceptan las opciones equivalentes -r, -w, -s, -a, -v, -u y -D, por compatibilidad con el
programa "clock".
DESCRIPCIÓN
hwclock es una herramienta para acceder al Reloj del Hardware. Ud. puede mostrar la hora actual, poner el
Reloj del Hardware a una hora especificada, poner el Reloj del Hardware a la Hora del Sistema, y poner el
Tiempo del Sistema desde el Reloj del Hardware.
Ud. también puede ejecutar hwclock periódicamente para insertar o quitar tiempo del Reloj del Hardware
para compensar desviaciones sistemáticas (en las que el reloj gana o pierde tiempo consistentemente a una
cierta velocidad si se deja solo).
OPCIONES
Ud. necesita exactamente una de las siguientes opciones para decirle a hwclock qué función realizar:
--show Lee el Reloj del Hardware y muestra la hora en la salida estándar.
--set Pone el Reloj del Hardware a la hora dada por la opción --date.
--hctosys
Pone el Tiempo del Sistema a partir del Reloj del Hardware. Ésta es una buena opción para poner en
uno de los guiones de arranque del sistema.
--systohc
Pone el Reloj del Hardware a la hora del sistema actual.
--adjust
Añade o sustrae tiempo del Reloj del Hardware para tener en cuenta el desvío sistemático desde la
última vez que el reloj se puso o se ajustó. Vea la discusión al respecto más adelante.
--getepoch
Muestra en la salida estándar el valor de la época del Reloj del Hardware del núcleo. Esto es el
número de años en la Era al que se refiere el año cero del Reloj del Hardware. Por ejemplo, si Ud.
emplea el convenio de que el contador de años en su Reloj del Hardware contiene el número de años
completos desde 1952, entonces el valor de la época del contador de años del Reloj del Hardware
debe ser 1952.
Este valor de la época se emplea cada vez que hwclock lee o pone el Reloj del Hardware.
--setepoch
Pone el valor de la época del Reloj del Hardware del núcleo al valor especificado por la opción
--epoch. Vea la opción --getepoch para más detalles.
--version
Muestra la versión de hwclock en la salida estándar.
Si Ud. especifica la opción --set, necesita la opción siguiente. Si no, no es tenida en
consideración.
--date=nuevafecha
Especifica la hora a la cual poner el Reloj del Hardware. El valor de esta opción es un argumento
válido para el programa date(1). Por ejemplo,
hwclock --set --date="9/22/96 16:45:05"
--epoch=año
Especifica el año que es el principio de la época del Reloj del Hardware. Esto es el número de
años en la Era a la cual se refiere un valor cero en el contador de años del Reloj del Hardware.
Por ejemplo,
hwclock --setepoch --epoch=1952
Las opciones siguientes se aplican a la mayoría de las funciones.
--utc Indica que el Reloj del Hardware se mantiene en el Tiempo Universal Coordinado (UTC). Es cosa suya
si mantiene su reloj en hora local o UTC, pero nada en el reloj le dice qué es lo que ha escogido.
Así que con esta opción es como le da esa información a hwclock.
Si no especifica --utc cuando debiera, o viceversa, el poner y preguntar la hora del reloj del hardware
acabarán funcionando mal.
--directisa
tiene sentido solamente en una máquina ISA. Para todas las otras máquinas no tiene efecto. Esta
opción le dice a hwclock que use instrucciones de E/S explícitas para acceder al reloj del
hardware. Sin esta opción, hwclock intentará emplear el dispositivo /dev/rtc (que supone que está
controlado por el controlador del dispositivo rtc). Si es incapaz de abrir el dispositivo (para
lectura), empleará las instrucciones explícitas de E/S, de todas formas.
El controlador de dispositivo rtc fue introducido en Linux versión 2.
--test Hace todo excepto actualizar realmente el Reloj del Hardware o cualquier otra cosa. Esto es útil,
especialmente en conjunción con --debug, para aprender sobre cómo funciona hwclock.
--debug
Muestra un montón de información sobre lo que hwclock está haciendo internamente. Algo de su
función es compleja y esta salida puede ayudarle a comprender cómo funciona el programa.
NOTAS
Relojes en un sistema Linux
Hay dos relojes principales en un sistema Linux:
El Reloj del Hardware: Esto es un reloj que corre independientemente de cualquier programa de control
ejecutándose en la CPU e incluso cuando la máquina está apagada.
En un sistema ISA, este reloj está especificado como parte del estándar ISA. El programa de control puede
leer o poner este reloj a un segundo entero, pero el programa de control también puede detectar los
límites de los pulsos del reloj de 1 segundo, así que el reloj realmente tiene una precisión virtualmente
infinita.
Este reloj se llama comúnmente el Reloj del Hardware, el reloj de tiempo real, el RTC, el reloj de la
BIOS, y el reloj CMOS. El Reloj del Hardware, en esta forma con las iniciales en mayúsculas, se acuñó
para el uso en hwclock porque todos los otros nombres son inapropiados hasta el punto de llevar a
confusión.
El Tiempo del Sistema: Esto es el tiempo mantenido por un reloj de dentro del núcleo Linux y controlado
por un interruptor de temporización. (En una máquina ISA, el interruptor de temporización es parte del
estándar ISA.) Sólo tiene sentido mientras Linux está ejecutándose en la máquina. El Tiempo del Sistema
es el número de segundos desde las 00:00:00 horas del 1 de Enero de 1970, UTC (o más sucintamente, el
número de segundos desde 1969). El Tiempo del Sistema no es un entero, sin embargo. Tiene precisión
virtualmente infinita.
El Tiempo del Sistema es el que tiene importancia. El propósito básico del Reloj del Hardware en un
sistema Linux es mantener la hora mientras que Linux no está ejecutándose. Ud. inicia el Tiempo del
Sistema al tiempo del Reloj del Hardware cuando Linux arranca, y ya no utiliza nunca más el Reloj del
Hardware. Observe que en DOS, para quien se diseñó ISA, el Reloj del Hardware es el único reloj de tiempo
real.
Es importante que el Tiempo del Sistema no tenga discontinuidades como las que podrían ocurrir si Ud.
empleara el programa date(1) para ponerlo en hora mientras el sistema esté en ejecución. Sin embargo, Ud.
puede hacer lo que quiera con el Reloj del Hardware mientras el sistema esté ejecutándose, y la siguiente
vez que Linux arrancara, lo haría con la nueva hora ajustada del Reloj del Hardware. También puede
emplear el programa adjtimex(8) para ajustar suavemente el Tiempo del Sistema mientras que el sistema
está ejecutándose.
Cómo hwclock accede al Reloj del Hardware
hwclock utiliza muchas formas diferentes de obtener y poner valores en el Reloj del Hardware. La forma
más normal es hacer E/S en el fichero especial de dispositivo /dev/rtc, que se supone controlado por el
controlador del dispositivo rtc. Sin embargo, este método no está siempre disponible. Por una cosa: el
controlador rtc es una adición relativamente reciente a Linux. Sistemas más antiguos no lo tienen.
En sistemas más viejos, el método de acceder al Reloj del Hardware depende del hardware del sistema.
En un sistema ISA, hwclock puede acceder directamente a los registros de la "memoria CMOS" que constituye
el reloj, haciendo E/S a los puertos 0x70 y 0x71. Esto sólo lo puede hacer si se ejecuta con el UID
efectivo 0 (esto es, con privilegios de súper-usuario).
Esto es realmente un pobre método de acceder al reloj, por la razón de que los programas en el espacio de
usuario se supone generalmente que no deben hacer E/S directa y deshabilitar interrupciones. Hwclock lo
proporciona porque es el único método disponible con núcleos Linux más antiguos para máquinas ISA.
En un sistema m68k (68000 de Motorola), hwclock puede acceder al reloj a través del controlador de
consola, mediante el fichero especial de dispositivo /dev/tty1.
En un Alpha, de DEC, /dev/rtc es la única posibilidad.
Hay o había algunos sistemas Linux en Alpha que no tienen /dev/rtc y hay o había programas que accedían
al reloj a través de E/S casi directa usando /dev/port. Sin embargo, esto no es un método tan bueno como
el de /dev/rtc y tales programas no fueron tan ampliamente empleados como para que hwclock tuviera
ninguna necesidad de ser compatible hacia atrás con ellos. Así que hwclock no proporciona el método de
/dev/port y consecuentemente no funcionará en un Alpha que no tenga /dev/rtc.
hwclock intenta emplear /dev/rtc. Si se ha compilado para un núcleo que no tiene esa función o es incapaz
de abrir /dev/rtc, hwclock intentará otro método, si hay alguno disponible. En una máquina ISA, Ud. puede
forzar a hwclock a usar la manipulación directa de los registros de la CMOS sin ni siquiera intentar
/dev/rtc especificando la opción --directisa.
La Función de Ajuste
El Reloj del Hardware no es usualmente muy preciso. Sin embargo, mucha de su imprecisión es completamente
predecible; gana o pierde la misma cantidad de tiempo cada día. Esto se llama desviación sistemática. La
función de "ajuste" de hwclock le permite hacer correcciones sistemáticas para corregir la desviación
sistemática.
Funciona así: Hwclock mantiene un fichero, /etc/adjtime, que mantiene alguna información histórica. Este
fichero se llama el fichero adjtime.
Suponga que Ud. empieza sin fichero adjtime. Ud. da una orden hwclock --set para poner el Reloj del
Hardware a la hora verdadera actual. Hwclock crea el fichero adjtime y graba en él la hora actual como
la última vez que el reloj se calibró. 5 días más tarde, el reloj ha ganado 10 segundos, así que Ud. da
otra orden hwclock --set para ponerlo con 10 segundos menos. Hwclock ajusta el fichero adjtime para
mostrar la hora actual como la última vez que el reloj se calibró, y graba dos segundos por día como la
velocidad de desviación sistemática. Pasan 24 horas, y entonces Ud. da una orden hwclock --adjust.
Hwclock consulta el fichero adjtime y ve que el reloj gana 2 segundos por día cuando se le deja solo, y
que se le ha dejado solo exactamente un día. Así que sustrae 2 segundos del Reloj del Hardware. Entonces
graba la hora actual como la última vez que se ajustó el reloj. Otras 24 horas pasan y Ud. da otra orden
hwclock --adjust. Hwclock hace lo mismo: sustrae 2 segundos y actualiza el fichero adjtime con la hora
actual como la última vez que el reloj se ajustó.
Cada vez que Ud. calibra (pone en hora) el reloj, hwclock recalcula la velocidad de desviación
sistemática basado en cuánto tiempo ha pasado desde la última calibración, cuánto tiempo ha pasado desde
el último ajuste, qué velocidad de desviación se suponía en cualesquiera ajustes intervinientes, y la
cantidad que el reloj está desviado actualmente de la hora verdadera.
Se arrastra una pequeña cantidad de error en cualquier momento en que hwclock pone el reloj en hora, de
forma que rehúsa hacer un ajuste que vaya a ser de menos de 1 segundo. Más tarde, cuando Ud. pida un
ajuste de nuevo, la desviación acumulada será de más de un segundo y hwclock hará el ajuste entonces.
Es bueno hacer un hwclock --adjust justo antes del hwclock --hctosys en la hora del arranque del sistema,
y quizás periódicamente mientras que el sistema está ejecutándose, mediante cron.
El formato del fichero adjtime es:
Línea 1: 3 números: 1) velocidad de desviación sistemática en segundos por día, número en base diez en
coma flotante; 2) número resultante de segundos desde 1969 UTC del más reciente ajuste o calibración,
entero en base diez; 3) cero (por compatibilidad con clock ).
Línea 2: 1 número: El número resultante de segundos desde 1969 UTC de la calibración más reciente.
Ud. puede emplear con hwclock un fichero adjtime que fuera usado previamente con el programa clock.
FICHEROS
/etc/adjtime
VÉASE TAMBIÉN
adjtimex(8), date(1), gettimeofday(2), settimeofday(2), crontab(1)
AUTORES
Escrito por Bryan Henderson, en Septiembre de 1996 (bryanh@giraffe-data.com), basándose en el trabajo
hecho en el programa clock de Charles Hedrick, Rob Hooft y Harald König. Mire el código fuente para la
historia completa y los créditos.
2 Marzo 1998 HWCLOCK(8)