KVM_TTYS(3) BSD Programmer's Manual KVM_TTYS(3)NAME
kvm_ttys, kvm_ttytotals - kernel ttys and statistics
SYNOPSIS
#include <sys/param.h>
#include <sys/sysctl.h>
#include <sys/tty.h>
#include <sys/ttystats.h>
#include <kvm.h>
#include <kvm_stat.h>
int
kvm_ttys(kvm_t *kd, struct ttydevice_tmp **tdpp, int *ntdp,
struct ttystat **ttpp, int *ntpp);
int
kvm_ttytotals(kvm_t *kd, struct ttytotals *tp);
DESCRIPTION
The kvm_ttys() function sets the pointer referenced by tdpp to a table of
struct ttydevice_tmp structures, sets the integer referenced by ntdp to
the number of elements in this table, sets the pointer referenced by ttp
to a table of struct ttystat structures and sets the integer referenced
by ntpp to the number of elements in this table. Memory for these tables
is obtained via malloc(3) and should be released via free(3) if desired.
The struct ttydevice_tmp table describes all tty devices or multiplexors
recognized by the kernel indicated by kd, including pseudo-devices such
as those described in pty(4). The struct ttystat table describes the
state and statistics of all tty devices in the kernel indicated by kd.
There is a correspondence between the elements of the struct
ttydevice_tmp table and the struct ttystat table. But note that a multi-
plexor entry listed in the struct ttydevice_tmp table may define more
than one element in the struct tty table, as specified by the tty_count
field. The struct ttystat structure is defined in /usr/include/sys/tty.h
and the struct ttydevice_tmp structure is defined in
/usr/include/sys/ttystats.h.
The kvm_ttytotals() function fills in the struct ttytotals structure ref-
erenced by tp. This structure contains global statistics on characters
sent and received on tty devices. The struct ttytotals structure is de-
fined in /usr/include/sys/ttystats.h.
RETURN VALUES
These routines return zero on success and -1 on failure. Upon failure
kvm_geterr(3) can be used to obtain a string describing the error.
SEE ALSOkvm(3), kvm_open(3), kvm_openfiles(3), kvm_close(3), kvm_read(3),
kvm_write(3), kvm_nlist(3), kvm_geterr(3)BSDI BSD/OS May 7, 1997 1