util-linux/sys-utils/hwclock.h
Rasmus Villemoes 76cf1753f4 hwclock: add support for RTC_VL_READ/RTC_VL_CLR ioctls
Implement a way for userspace to query the status of the backup
battery, if supported by the hardware and driver.

The RTC_VL_* bits are a somewhat recent addition (3431ca4837bf, but
really only from b0efe0281234) to the uapi header,
so provide our own definition if the build host's header doesn't.

Signed-off-by: Rasmus Villemoes <rasmus.villemoes@prevas.dk>
2023-06-22 10:27:36 +02:00

101 lines
2.6 KiB
C

#ifndef HWCLOCK_CLOCK_H
#define HWCLOCK_CLOCK_H
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <sys/time.h>
#include <time.h>
#include "c.h"
#include "debug.h"
#include "nls.h"
#define HWCLOCK_DEBUG_INIT (1 << 0)
#define HWCLOCK_DEBUG_RANDOM_SLEEP (1 << 1)
#define HWCLOCK_DEBUG_DELTA_VS_TARGET (1 << 2)
#define HWCLOCK_DEBUG_ALL 0xFFFF
UL_DEBUG_DECLARE_MASK(hwclock);
#define DBG(m, x) __UL_DBG(hwclock, HWCLOCK_DEBUG_, m, x)
#define ON_DBG(m, x) __UL_DBG_CALL(hwclock, HWCLOCK_DEBUG_, m, x)
struct hwclock_control {
char *date_opt;
char *adj_file_name;
double rtc_delay; /* --delay <seconds> */
#if defined(__linux__) && defined(__alpha__)
char *epoch_option;
#endif
#ifdef __linux__
char *rtc_dev_name;
#endif
char *param_get_option;
char *param_set_option;
unsigned int
hwaudit_on:1,
adjust:1,
show:1,
hctosys:1,
utc:1,
systohc:1,
#if defined(__linux__) && defined(__alpha__)
getepoch:1,
setepoch:1,
#endif
noadjfile:1,
local_opt:1,
directisa:1,
testing:1,
systz:1,
predict:1,
get:1,
set:1,
update:1,
universal:1, /* will store hw_clock_is_utc() return value */
vl_read:1,
vl_clear:1,
verbose:1;
};
struct clock_ops {
char *interface_name;
int (*get_permissions) (void);
int (*read_hardware_clock) (const struct hwclock_control *ctl, struct tm * tm);
int (*set_hardware_clock) (const struct hwclock_control *ctl, const struct tm * tm);
int (*synchronize_to_clock_tick) (const struct hwclock_control *ctl);
const char *(*get_device_path) (void);
};
extern const struct clock_ops *probe_for_cmos_clock(void);
extern const struct clock_ops *probe_for_rtc_clock(const struct hwclock_control *ctl);
/* hwclock.c */
extern double time_diff(struct timeval subtrahend, struct timeval subtractor);
/* rtc.c */
#if defined(__linux__) && defined(__alpha__)
extern int get_epoch_rtc(const struct hwclock_control *ctl, unsigned long *epoch);
extern int set_epoch_rtc(const struct hwclock_control *ctl);
#endif
struct hwclock_param {
int id;
const char *name;
const char *help;
};
extern const struct hwclock_param *get_hwclock_params(void);
extern int get_param_rtc(const struct hwclock_control *ctl,
const char *name, uint64_t *id, uint64_t *value);
extern int set_param_rtc(const struct hwclock_control *ctl, const char *name);
extern int rtc_vl_read(const struct hwclock_control *ctl);
extern int rtc_vl_clear(const struct hwclock_control *ctl);
extern void __attribute__((__noreturn__))
hwclock_exit(const struct hwclock_control *ctl, int status);
extern int parse_date(struct timespec *, char const *, struct timespec const *);
#endif /* HWCLOCK_CLOCK_H */