GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  SG_GET_USER_STATS_R (3)

NAME

sg_get_user_stats, sg_get_user_stats_r, sg_free_user_stats - get the current logged in users

CONTENTS

Synopsis
Description
Website

SYNOPSIS

#include <statgrab.h>

sg_user_stats *sg_get_user_stats \kx (size_t *entries);

sg_user_stats *sg_get_user_stats_r \kx (size_t *entries);

sg_error sg_free_user_stats \kx (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

function returns data owner
sg_get_user_stats sg_user_stats * libstatgrab (thread local)
sg_get_user_stats_r sg_user_stats * caller

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

\(lahttp://www.i-scream.org/libstatgrab/\(ra
Search for    or go to Top of page |  Section 3 |  Main Index


i-scream SG_GET_USER_STATS (3) 2013-06-07

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.