Manual Pages for UNIX Operating System command usage for man rnusers

RPC Library Functions                                rusers(3RPC)



NAME
     rusers, rnusers - return information about users  on  remote
     machines

SYNOPSIS
     cc [ flag ... ] file ... -lrpcsvc [ library ... ]
     #include 
     #include 

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


     int rnusers(char *host);


PROTOCOL
     /usr/include/rpcsvc/rusers.x

DESCRIPTION
     These routines require that the  rpc.rusersd(1M)  daemon  be
     configured  and  available on the remote system indicated by
     host. The rusers() protocol is used to retrieve  information
     about users logged in on the remote system.


     rusers() fills the utmpidlearr  structure  with  data  about
     host, and returns 0 if successful. up must point to an allo-
     cated utmpidlearr structure. If rusers() returns  successful
     it  will have allocated data structures within the up struc-
     ture, which should be freed with xdr_free(3NSL) when you  no
     longer need them:

       xdr_free(xdr_utimpidlearr, up);




     On error, the returned value can be interpreted as an   enum
     clnt_stat  and  can  be  displayed with clnt_perror(3NSL) or
     clnt_sperrno(3NSL).


     See the header   for a definition of struct
     utmpidlearr.


     rnusers() returns the number of users logged on to host  (-1
     if it cannot determine that number).


     The following  XDR routines are available in librpcsvc:




SunOS 5.11          Last change: 30 Dec 1996                    1






RPC Library Functions                                rusers(3RPC)



       xdr_utmpidlearr



ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|


SEE ALSO
     rusers(1),      rpc.rusersd(1M),       rpc_clnt_calls(3NSL),
     xdr_free(3NSL), attributes(5)



































SunOS 5.11          Last change: 30 Dec 1996                    2