Man page - sg_get_user_stats(3)
Packages contains this manual
- sg_get_error_details(3)
- sg_vector_create(3)
- statgrab(3)
- sg_free_load_stats(3)
- sg_get_page_stats_r(3)
- sg_comp_destroy(3)
- sg_get_swap_stats_r(3)
- sg_get_cpu_stats_r(3)
- sg_init(3)
- sg_get_disk_io_stats_r(3)
- sg_get_network_io_stats(3)
- sg_free_network_io_stats(3)
- sg_set_valid_filesystems(3)
- sg_free_swap_stats(3)
- sg_get_swap_stats(3)
- sg_get_network_iface_stats(3)
- sg_get_error_arg(3)
- sg_get_disk_io_stats(3)
- sg_get_valid_filesystems(3)
- sg_internal-intro(3)
- sg_get_cpu_stats_diff(3)
- sg_strperror(3)
- sg_str_error(3)
- sg_get_cpu_stats_diff_between(3)
- sg_free_network_iface_stats(3)
- sg_vector_clear(3)
- sg_get_host_info(3)
- sg_comp_init(3)
- sg_get_page_stats_diff(3)
- sg_process_compare_size(3)
- sg_process_compare_cpu(3)
- sg_unlock_mutex(3)
- sg_fs_compare_device_name(3)
- sg_fs_compare_mnt_point(3)
- sg_free_user_stats(3)
- sg_free_host_info(3)
- sg_get_user_stats(3)
- sg_get_fs_stats_diff_between(3)
- sg_set_error(3)
- sg_get_fs_stats_diff(3)
- sg_free_mem_stats(3)
- sg_vector_compute_diff(3)
- sg_get_page_stats_diff_between(3)
- sg_vector_clone_into(3)
- sg_get_network_io_stats_diff(3)
- sg_get_network_io_stats_diff_between(3)
- sg_free_cpu_stats(3)
- sg_get_cpu_percents_r(3)
- sg_get_process_count_r(3)
- sg_get_network_iface_stats_r(3)
- sg_get_error(3)
- sg_get_fs_stats(3)
- sg_intro(3)
- sg_get_network_io_stats_r(3)
- sg_snapshot(3)
- sg_vector_clone(3)
- sg_get_mem_stats(3)
- sg_get_cpu_percents_of(3)
- sg_process_compare_pid(3)
- sg_free_page_stats(3)
- sg_get_error_errno(3)
- sg_get_process_stats_r(3)
- sg_get_process_count(3)
- sg_free_process_count(3)
- sg_process_compare_name(3)
- sg_get_mem_stats_r(3)
- sg_lock_mutex(3)
- sg_set_error_with_errno_code(3)
- libstatgrab(3)
- sg_free_stats_buf(3)
- sg_get_load_stats_r(3)
- sg_shutdown(3)
- sg_vector_resize(3)
- sg_get_page_stats(3)
- sg_get_process_count_of(3)
- sg_vector_free(3)
- sg_get_process_stats(3)
- sg_network_io_compare_name(3)
- sg_prove_vector(3)
- sg_network_iface_compare_name(3)
- sg_process_compare_gid(3)
- sg_disk_io_compare_traffic(3)
- sg_comp_get_tls(3)
- sg_disk_io_compare_name(3)
- sg_get_cpu_stats(3)
- sg_get_nelements(3)
- sg_process_compare_res(3)
- sg_drop_privileges(3)
- sg_get_load_stats(3)
- sg_get_fs_stats_r(3)
- sg_process_compare_uid(3)
- sg_global_lock(3)
- sg_free_disk_io_stats(3)
- sg_get_disk_io_stats_diff(3)
- sg_process_compare_time(3)
- sg_clear_error(3)
- sg_set_error_with_errno(3)
- sg_free_fs_stats(3)
- sg_get_cpu_percents(3)
- sg_get_user_stats_r(3)
- sg_get_host_info_r(3)
- sg_get_disk_io_stats_diff_between(3)
- sg_global_unlock(3)
apt-get install libstatgrab-dev
Manual
sg_get_user_stats
NAMESYNOPSIS
DESCRIPTION
RETURN VALUES
SEE ALSO
WEBSITE
NAME
sg_get_user_stats, sg_get_user_stats_r, sg_free_user_stats - get the current logged in users
SYNOPSIS
#include <statgrab.h>
sg_user_stats * sg_get_user_stats (size_t * entries );
sg_user_stats * sg_get_user_stats_r (size_t * entries );
sg_error sg_free_user_stats (sg_user_stats * data );
DESCRIPTION
The user statistics module delivers some information about logged on users. Each logon is treated separately. Both statistic get functions, sg_get_user_stats () and sg_get_user_stats_r (), return a vector of sg_user_stats with entries elements.
|
API Shortcut |
The sg_user_stats vector received from sg_get_user_stats_r () must be freed using sg_free_user_stats () when not needed any more. The caller is responsible for doing it.
RETURN VALUES
The structure returned is of type sg_user_stats.
typedef struct {
char *login_name;
char *record_id;
size_t record_id_size;
char *device;
char *hostname;
pid_t pid;
time_t login_time;
time_t systime;
} sg_user_stats;
login_name
The username which was used to log in
record_id
Record identifier of host database containing login information (not necessarily 0-terminated)
record_id_size
Size of the record identifier
|
device |
Device name (eg. "pts/0") of the tty assigned to the login session |
hostname
(remote) Hostname from where the user is logged on, eg. "infoterm7.some.kind.of.domain.local", "localhost", "10.42.17.4" or ":0.0" (in case it’s a local logon via new xterm)
|
pid |
Process identifier of the process which made the entry to the logged on users database |
login_time
Timestamp (time in seconds since epoch) when the user logged on
systime
The timestamp when the above stats where collected in seconds since epoch
SEE ALSO
statgrab (3)
WEBSITE
⟨ https://libstatgrab.org/⟩