/ 
perlrpcgen-0.71a
River stage zero No dependents
/ RPC::ONC

NAME

RPC::ONC - Perl interface to ONC RPC

SYNOPSIS

    use RPC::ONC;

    # Create a client of the NFS service.

    $clnt = &RPC::ONC::Client::clnt_create('foo.bar.com',
				      NFS_PROGRAM, NFS_VERSION,
				      'netpath');

    # Set the timeout to 3 seconds.
    $clnt->clnt_control(CLSET_TIMEOUT, pack('LL', 3, 0));

DESCRIPTION

The RPC::ONC module provides access to some of the ONC RPC routines for making and receiving remote procedure calls, as well as functions to access members of RPC-related structures. It's intended to be used with 'perlrpcgen', which generates Perl XS stubs for RPC clients and servers.

Most of these routines work the same as their C equivalents and are thus not described in detail.

CAVEAT

Not all of the ONC RPC calls are provided in this alpha version--I've been filling them in more or less as needed. Let me know if there's one you really need.

GLOBALS

RPC::ONC::errno

Number of the error that just occurred.

RPC::ONC::errstr

Message corresponding to error that just occurred.

CLASSES

RPC::ONC::Client

RPC::ONC::Client wraps CLIENT *.

clnt_create(host, prognum, versnum, nettype)

If the call fails, clnt_create will set RPC::ONC::errno and RPC::ONC::errstr and croak.

clnt_control(clnt, req, info)

The info argument should be packed as an appropriate structure for the operation.

clnt_destroy(clnt)
set_cl_auth(clnt, auth)

Takes an RPC::ONC::Client object and an RPC::ONC::Auth object and assigns the cl_auth field of the first to the second.

RPC::ONC::Auth

RPC::ONC::Auth wraps AUTH *.

authnone_create
authsys_create_default
auth_destroy(auth)

RPC::ONC::svc_req

RPC::ONC::svc_req wraps struct svc_req *.

rq_prog(svc_req)

Returns the rq_prog field.

rq_vers(svc_req)

Returns the rq_vers field.

rq_proc(svc_req)

Returns the rq_proc field.

rq_cred(svc_req)

Returns the rq_cred field as an RPC::ONC::opaque_auth object.

authsys_parms(svc_req)

Returns the rq_clntcred field as an RPC::ONC::authsys_parms object. Will croak if the credentials are not the right flavor.

authdes_cred(svc_req)

Returns the rq_clntcred field as an RPC::ONC::authdes_cred object. Will croak if the credentials are not the right flavor.

RPC::ONC::opaque_auth

oa_flavor(opaque_auth)

Returns the oa_flavor field.

RPC::ONC::authsys_parms

aup_time(authsys_parms)

Returns the aup_time field.

aup_machname(authsys_parms)

Returns the aup_machname field.

aup_uid(authsys_parms)

Returns the aup_uid field.

aup_gid(authsys_parms)

Returns the aup_gid field.

aup_gids(authsys_parms)

Returns the aup_gids field as an array.

RPC::ONC::Svcxprt

RPC::ONC::Svcxprt wraps struct svcxprt *.

svc_getcaller(transp)

Returns a sockaddr_in * which you can unpack to get the IP address of the caller.

SEE ALSO

perlrpcgen(1)

AUTHOR

Jake Donham <jake@organic.com>

THANKS

Thanks to Organic Online <http://www.organic.com/> for letting me hack at work.