RNUSERS

Section: RPC Services Library (3R)
Updated: 10 August 1985
Index Return to Main Contents

NAME

rnusers, rusers - return information about users on remote machines

SYNOPSIS

#include <rpcsvc/rusers.h>

rnusers(host)
        char *host

rusers(host, up)
        char *host
        struct utmpidlearr *up;

DESCRIPTION

Rnusers returns the number of users logged on to host (-1 if it cannot determine that number). Rusers fills the utmpidlearr structure with data about host, and returns 0 if successful. The relevant structures are:

struct utmparr {                        /* RUSERSVERS_ORIG */
        struct utmp **uta_arr;
        int uta_cnt
};

struct utmpidle {
        struct utmp ui_utmp;
        unsigned ui_idle;
};

struct utmpidlearr {            /* RUSERSVERS_IDLE */
        struct utmpidle **uia_arr;
        int uia_cnt
};

RPC INFO

program number:
        RUSERSPROG

xdr routines:
        int xdr_utmp(xdrs, up)
                XDR *xdrs;
                struct utmp *up;
        int xdr_utmpidle(xdrs, ui);
                XDR *xdrs;
                struct utmpidle *ui;
        int xdr_utmpptr(xdrs, up);
                XDR *xdrs;
                struct utmp **up;
        int xdr_utmpidleptr(xdrs, up);
                XDR *xdrs;
                struct utmpidle **up;
        int xdr_utmparr(xdrs, up);
                XDR *xdrs;
                struct utmparr *up;
        int xdr_utmpidlearr(xdrs, up);
                XDR *xdrs;
                struct utmpidlearr *up;

procs:
        RUSERSPROC_NUM
                No arguments, returns number of users as an unsigned long.
        RUSERSPROC_NAMES
                No arguments, returns utmparr or utmpidlearr, depending on version number.
        RUSERSPROC_ALLNAMES
                No arguments, returns utmparr or utmpidlearr, depending on version number.
                Returns listing even for utmp entries satisfying nonuser() in utmp.h.
versions:
        RUSERSVERS_ORIG
        RUSERSVERS_IDLE

structures: