Documentación técnica de reloj.c

Programa: reloj.c
Versión: 1.07.24
Autor: Eugenio Martínez - Argentina
Correo-e: torrentelinux@gmail.com
Hospedado en: github://torrentelinux/torrentarium/base/fuente/C/reloj
Propósito: muestra, modifica o ajusta la hora y la fecha del sistema local. Está pensado para utilizarlo en MS-DOS/Windows consola 16/32/64 bits y GNU Linux.
Fecha de creación: Noviembre de 2001
Fecha de última modificación: Julio de 2024
Licencia: Software libre, GNU/GPL v3.

Distribución inicial de ficheros:

Instalación:

Copie todos los ficheros en el directorio /base/fuente/reloj/

Compilar:

16 bits: bcc -I. reloj.c

32 bits: bcc32 -I. -6 -y- -v- -O2 -w reloj.c

32/64 bits, linux: gcc -s -I . -o reloj reloj.c

Ejecutar para probar:

1º forma: reloj                  -> muestra la hora y fecha del sistema
2º forma: reloj /?              -> muestra una ayuda
3º forma: reloj --ayuda   -> muestra una ayuda

Dependencias:
Es importante tener instalado en Windows y en Linux el comando 'curl'.
Otros comandos que se necesitan en Linux son 'rdate' y 'ntpdate'. Estos son proporcionados por el mismo sistema operativo.
Estas dependencias son necesarias para leer y actualizar el tiempo del reloj interno. Los datos son consultados desde internet.

Herramientas de programación:
El código fuente de la aplicación es compatible con CPUs de 16/32/64 bits, arquitectura Intel.
Básicamente se puede compilar a reloj.c sin un entorno de desarrollo (IDE). Puede compilar desde la consola de textos que ofrece el S.O.
Para MSDOS se utilizó Borland C++ v3.1, 16 bits.
Para Windows 32/64 bits se utilizó Embarcadero RAD Studio XE4.
Para Linux 64 bits se utilizó Oracle Developer Studio IDE ver. 12.6 y el compilador GNU/GCC.

Imágenes de la aplicación:

Imágen 1: El programa reloj.exe en la consola de Windows.

Imágen 2: Visualización de la ayuda del programa reloj.exe en la consola de Windows.

Imágen 3: Ajuste del reloj de tiempo mediante una llamada a un servidor remoto de tiempo.

Imágen 4: Vista del IDE Borland C++ 3.1 con el código fuente reloj.c

Imágen 5: Vista del IDE Embarcadero RAD Studio 10.2 con el código fuente reloj.c

Imágen 6: vista del IDE Oracle Developer Studio 12.6 con el código fuente reloj.c

Imágen 7: Uso de sudo para ajustar el tiempo por parte de usuario operador con privilegios regulares.

Para ajustar el tiempo en Linux es necesario que el usuario tenga permisos administrativos para lograrlo porque de lo contrario tendrá que utilizar el comando sudo e invocar a reloj. Ver Imágen 7 para entender esta situación.
Para comprobar que el reloj de la PC tiene la hora exacta puede visitar el sitio https://time.is/ para leer el tiempo actual.

Referencias:
Let's make a NTP Client in C
Time API
Time is
Set time zone from command line (CMD)
Horario NTP - Instituto Geográfico Argentino
Servidores de tiempo NTP para Argentina
Oracle Developer Studio IDE
Embarcadero RAD Studio
Borland C++ 3.1 para MS-DOS, 16 bits