LDP
/
man-pages
mirror of https://github.com/mkerrisk/man-pages
0
1
Fork 0
Code Releases Activity

Remove font size markup

This commit is contained in:
Michael Kerrisk 2007-12-16 15:39:37 +00:00
parent e40c76c011
commit 066cb3d698
3 changed files with 127 additions and 127 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

156
man3/rpc.3
View File

@ -36,7 +36,7 @@ Finally, the procedure call returns to the client.
.sp .5 .sp .5
void void
auth_destroy(auth) auth_destroy(auth)
\s-1AUTH\s0 *auth; AUTH *auth;
.fi .fi
.ft R .ft R
.IP .IP
@ -54,7 +54,7 @@ is undefined after calling
.ft B .ft B
.nf .nf
.sp .5 .sp .5
\s-1AUTH\s0 * AUTH *
authnone_create() authnone_create()
.fi .fi
.ft R .ft R
@ -71,7 +71,7 @@ default authentication used by
.ft B .ft B
.nf .nf
.sp .5 .sp .5
\s-1AUTH\s0 * AUTH *
authunix_create(host, uid, gid, len, aup_gids) authunix_create(host, uid, gid, len, aup_gids)
char *host; char *host;
int uid, gid, len, *aup_gids; int uid, gid, len, *aup_gids;
@ -103,7 +103,7 @@ It is easy to impersonate a user.
.ft B .ft B
.nf .nf
.sp .5 .sp .5
\s-1AUTH\s0 * AUTH *
authunix_create_default() authunix_create_default()
.fi .fi
.ft R .ft R
@ -219,7 +219,7 @@ this value is 1500 bytes.
.sp .5 .sp .5
enum clnt_stat enum clnt_stat
clnt_call(clnt, procnum, inproc, in, outproc, out, tout) clnt_call(clnt, procnum, inproc, in, outproc, out, tout)
\s-1CLIENT\s0 *clnt; CLIENT *clnt;
u_long procnum; u_long procnum;
xdrproc_t inproc, outproc; xdrproc_t inproc, outproc;
char *in, *out; char *in, *out;
@ -253,7 +253,7 @@ is the time allowed for results to come back.
.nf .nf
.sp .5 .sp .5
clnt_destroy(clnt) clnt_destroy(clnt)
\s-1CLIENT\s0 *clnt; CLIENT *clnt;
.fi .fi
.ft R .ft R
.IP .IP
@ -278,7 +278,7 @@ Otherwise, the socket remains open.
.ft B .ft B
.nf .nf
.sp .5 .sp .5
\s-1CLIENT\s0 * CLIENT *
clnt_create(host, prog, vers, proto) clnt_create(host, prog, vers, proto)
char *host; char *host;
u_long prog, vers; u_long prog, vers;
@ -301,7 +301,7 @@ Warning: Using
.SM UDP .SM UDP
has its shortcomings. has its shortcomings.
Since Since
.SM UDP\s0-based .SM UDP-based
.SM RPC .SM RPC
messages can only hold up to 8 Kbytes of encoded data, messages can only hold up to 8 Kbytes of encoded data,
this transport cannot be used for procedures that take this transport cannot be used for procedures that take
@ -314,7 +314,7 @@ large arguments or return huge results.
.sp .5 .sp .5
bool_t bool_t
clnt_control(cl, req, info) clnt_control(cl, req, info)
\s-1CLIENT\s0 *cl; CLIENT *cl;
int req; int req;
char *info; char *info;
.fi .fi
@ -329,15 +329,15 @@ is a pointer to the information.
For both For both
.SM UDP .SM UDP
and and
.SM TCP\s0, .SM TCP,
the supported values of the supported values of
.I req .I req
and their argument types and what they do are: and their argument types and what they do are:
.IP .IP
.nf .nf
.ta +2.0i +2.0i +2.0i .ta +2.0i +2.0i +2.0i
.SM CLSET_TIMEOUT\s0 struct timeval set total timeout .SM CLSET_TIMEOUT struct timeval set total timeout
.SM CLGET_TIMEOUT\s0 struct timeval get total timeout .SM CLGET_TIMEOUT struct timeval get total timeout
.fi .fi
.IP .IP
Note: if you set the timeout using Note: if you set the timeout using
@ -347,7 +347,7 @@ the timeout parameter passed to
will be ignored in all future calls. will be ignored in all future calls.
.IP .IP
.nf .nf
.SM CLGET_SERVER_ADDR\s0 struct sockaddr_in get server's address .SM CLGET_SERVER_ADDR struct sockaddr_in get server's address
.fi .fi
.br .br
.IP .IP
@ -357,8 +357,8 @@ only:
.IP .IP
.nf .nf
.ta +2.0i +2.0i +2.0i .ta +2.0i +2.0i +2.0i
.SM CLSET_RETRY_TIMEOUT\s0 struct timeval set the retry timeout .SM CLSET_RETRY_TIMEOUT struct timeval set the retry timeout
.SM CLGET_RETRY_TIMEOUT\s0 struct timeval get the retry timeout .SM CLGET_RETRY_TIMEOUT struct timeval get the retry timeout
.fi .fi
.br .br
.IP .IP
@ -373,7 +373,7 @@ retransmitting the request.
.nf .nf
.sp .5 .sp .5
clnt_freeres(clnt, outproc, out) clnt_freeres(clnt, outproc, out)
\s-1CLIENT\s0 *clnt; CLIENT *clnt;
xdrproc_t outproc; xdrproc_t outproc;
char *out; char *out;
.fi .fi
@ -402,7 +402,7 @@ and zero otherwise.
.sp .5 .sp .5
void void
clnt_geterr(clnt, errp) clnt_geterr(clnt, errp)
\s-1CLIENT\s0 *clnt; CLIENT *clnt;
struct rpc_err *errp; struct rpc_err *errp;
.fi .fi
.ft R .ft R
@ -461,7 +461,7 @@ Used after
.nf .nf
.sp .5 .sp .5
clnt_perror(clnt, s) clnt_perror(clnt, s)
\s-1CLIENT\s0 *clnt; CLIENT *clnt;
char *s; char *s;
.fi .fi
.ft R .ft R
@ -515,7 +515,7 @@ indicating why an
call failed, return a pointer to a string which contains call failed, return a pointer to a string which contains
the message. the message.
The string ends with a The string ends with a
.SM NEWLINE\s0. .SM NEWLINE.
.IP .IP
.BR clnt_sperrno () .BR clnt_sperrno ()
is used instead of is used instead of
@ -543,7 +543,7 @@ result will not get overwritten on each call.
.sp .5 .sp .5
char * char *
clnt_sperror(rpch, s) clnt_sperror(rpch, s)
\s-1CLIENT\s0 *rpch; CLIENT *rpch;
char *s; char *s;
.fi .fi
.ft R .ft R
@ -562,7 +562,7 @@ on each call.
.ft B .ft B
.nf .nf
.sp .5 .sp .5
\s-1CLIENT\s0 * CLIENT *
clntraw_create(prognum, versnum) clntraw_create(prognum, versnum)
u_long prognum, versnum; u_long prognum, versnum;
.fi .fi
@ -595,7 +595,7 @@ if it fails.
.ft B .ft B
.nf .nf
.sp .5 .sp .5
\s-1CLIENT\s0 * CLIENT *
clnttcp_create(addr, prognum, versnum, sockp, sendsz, recvsz) clnttcp_create(addr, prognum, versnum, sockp, sendsz, recvsz)
struct sockaddr_in *addr; struct sockaddr_in *addr;
u_long prognum, versnum; u_long prognum, versnum;
@ -626,11 +626,11 @@ service is consulted for this information).
The parameter The parameter
.I sockp .I sockp
is a socket; if it is is a socket; if it is
.BR \s-1RPC_ANYSOCK\s0 , .BR RPC_ANYSOCK ,
then this routine opens a new one and sets then this routine opens a new one and sets
.IR sockp . .IR sockp .
Since Since
.SM TCP\s0-based .SM TCP-based
.SM RPC .SM RPC
uses buffered uses buffered
.SM I/O , .SM I/O ,
@ -649,7 +649,7 @@ if it fails.
.ft B .ft B
.nf .nf
.sp .5 .sp .5
\s-1CLIENT\s0 * CLIENT *
clntudp_create(addr, prognum, versnum, wait, sockp) clntudp_create(addr, prognum, versnum, wait, sockp)
struct sockaddr_in *addr; struct sockaddr_in *addr;
u_long prognum, versnum; u_long prognum, versnum;
@ -679,7 +679,7 @@ service is consulted for this information).
The parameter The parameter
.I sockp .I sockp
is a socket; if it is is a socket; if it is
.BR \s-1RPC_ANYSOCK\s0 , .BR RPC_ANYSOCK ,
then this routine opens a new one and sets then this routine opens a new one and sets
.IR sockp . .IR sockp .
The The
@ -692,7 +692,7 @@ The total time for the call to time out is specified by
.BR clnt_call (). .BR clnt_call ().
.IP .IP
Warning: since Warning: since
.SM UDP\s0-based .SM UDP-based
.SM RPC .SM RPC
messages can only hold up to 8 Kbytes messages can only hold up to 8 Kbytes
of encoded data, this transport cannot be used for procedures of encoded data, this transport cannot be used for procedures
@ -703,7 +703,7 @@ that take large arguments or return huge results.
.ft B .ft B
.nf .nf
.sp .5 .sp .5
\s-1CLIENT\s0 * CLIENT *
clntudp_bufcreate(addr, prognum, versnum, wait, sockp, sendsize, clntudp_bufcreate(addr, prognum, versnum, wait, sockp, sendsize,
recosize) recosize)
struct sockaddr_in *addr; struct sockaddr_in *addr;
@ -736,7 +736,7 @@ service is consulted for this information).
The parameter The parameter
.I sockp .I sockp
is a socket; if it is is a socket; if it is
.BR \s-1RPC_ANYSOCK\s0 , .BR RPC_ANYSOCK ,
then this routine opens a new one and sets then this routine opens a new one and sets
.BR sockp . .BR sockp .
The The
@ -749,7 +749,7 @@ The total time for the call to time out is specified by
.BR clnt_call (). .BR clnt_call ().
.IP .IP
This allows the user to specify the maximum packet size for sending and receiving This allows the user to specify the maximum packet size for sending and receiving
.SM UDP\s0-based .SM UDP-based
.SM RPC .SM RPC
messages. messages.
.br .br
@ -771,7 +771,7 @@ address into
without consulting the library routines that deal with without consulting the library routines that deal with
.IR /etc/hosts . .IR /etc/hosts .
The port number is always set to The port number is always set to
.BR htons(\s-1PMAPPORT\s0) . .BR htons(PMAPPORT) .
.br .br
.if t .ne 10 .if t .ne 10
.LP .LP
@ -827,7 +827,7 @@ is most likely
.B .B
.SM IPPROTO_UDP .SM IPPROTO_UDP
or or
.BR \s-1IPPROTO_TCP\s0 . .BR IPPROTO_TCP .
A return value of zero means that the mapping does not exist A return value of zero means that the mapping does not exist
or that or that
the the
@ -911,7 +911,7 @@ is most likely
.B .B
.SM IPPROTO_UDP .SM IPPROTO_UDP
or or
.BR \s-1IPPROTO_TCP\s0 . .BR IPPROTO_TCP .
This routine returns one if it succeeds, zero otherwise. This routine returns one if it succeeds, zero otherwise.
Automatically done by Automatically done by
.BR svc_register (). .BR svc_register ().
@ -1001,7 +1001,7 @@ to print the reason why.
.nf .nf
.sp .5 .sp .5
void svc_destroy(xprt) void svc_destroy(xprt)
\s-1SVCXPRT\s0 * SVCXPRT *
xprt; xprt;
.fi .fi
.ft R .ft R
@ -1065,7 +1065,7 @@ This interface is obsoleted by
.nf .nf
.sp .5 .sp .5
svc_freeargs(xprt, inproc, in) svc_freeargs(xprt, inproc, in)
\s-1SVCXPRT\s0 *xprt; SVCXPRT *xprt;
xdrproc_t inproc; xdrproc_t inproc;
char *in; char *in;
.fi .fi
@ -1086,7 +1086,7 @@ and zero otherwise.
.nf .nf
.sp .5 .sp .5
svc_getargs(xprt, inproc, in) svc_getargs(xprt, inproc, in)
\s-1SVCXPRT\s0 *xprt; SVCXPRT *xprt;
xdrproc_t inproc; xdrproc_t inproc;
char *in; char *in;
.fi .fi
@ -1116,7 +1116,7 @@ otherwise.
.sp .5 .sp .5
struct sockaddr_in * struct sockaddr_in *
svc_getcaller(xprt) svc_getcaller(xprt)
\s-1SVCXPRT\s0 *xprt; SVCXPRT *xprt;
.fi .fi
.ft R .ft R
.IP .IP
@ -1176,7 +1176,7 @@ This interface is obsoleted by
.nf .nf
.sp .5 .sp .5
svc_register(xprt, prognum, versnum, dispatch, protocol) svc_register(xprt, prognum, versnum, dispatch, protocol)
\s-1SVCXPRT\s0 *xprt; SVCXPRT *xprt;
u_long prognum, versnum; u_long prognum, versnum;
void (*dispatch) (); void (*dispatch) ();
u_long protocol; u_long protocol;
@ -1219,7 +1219,7 @@ has the following form:
.nf .nf
dispatch(request, xprt) dispatch(request, xprt)
struct svc_req *request; struct svc_req *request;
\s-1SVCXPRT\s0 *xprt; SVCXPRT *xprt;
.ft R .ft R
.fi .fi
.RE .RE
@ -1254,7 +1254,7 @@ system call to return.
.nf .nf
.sp .5 .sp .5
svc_sendreply(xprt, outproc, out) svc_sendreply(xprt, outproc, out)
\s-1SVCXPRT\s0 *xprt; SVCXPRT *xprt;
xdrproc_t outproc; xdrproc_t outproc;
char *out; char *out;
.fi .fi
@ -1299,7 +1299,7 @@ to port number.
.sp .5 .sp .5
void void
svcerr_auth(xprt, why) svcerr_auth(xprt, why)
\s-1SVCXPRT\s0 *xprt; SVCXPRT *xprt;
enum auth_stat why; enum auth_stat why;
.fi .fi
.ft R .ft R
@ -1314,7 +1314,7 @@ a remote procedure call due to an authentication error.
.sp .5 .sp .5
void void
svcerr_decode(xprt) svcerr_decode(xprt)
\s-1SVCXPRT\s0 *xprt; SVCXPRT *xprt;
.fi .fi
.ft R .ft R
.IP .IP
@ -1330,7 +1330,7 @@ See also
.sp .5 .sp .5
void void
svcerr_noproc(xprt) svcerr_noproc(xprt)
\s-1SVCXPRT\s0 *xprt; SVCXPRT *xprt;
.fi .fi
.ft R .ft R
.IP .IP
@ -1344,7 +1344,7 @@ the procedure number that the caller requests.
.sp .5 .sp .5
void void
svcerr_noprog(xprt) svcerr_noprog(xprt)
\s-1SVCXPRT\s0 *xprt; SVCXPRT *xprt;
.fi .fi
.ft R .ft R
.IP .IP
@ -1360,7 +1360,7 @@ Service implementors usually do not need this routine.
.sp .5 .sp .5
void void
svcerr_progvers(xprt) svcerr_progvers(xprt)
\s-1SVCXPRT\s0 *xprt; SVCXPRT *xprt;
.fi .fi
.ft R .ft R
.IP .IP
@ -1377,7 +1377,7 @@ Service implementors usually do not need this routine.
.sp .5 .sp .5
void void
svcerr_systemerr(xprt) svcerr_systemerr(xprt)
\s-1SVCXPRT\s0 *xprt; SVCXPRT *xprt;
.fi .fi
.ft R .ft R
.IP .IP
@ -1394,7 +1394,7 @@ it may call this routine.
.sp .5 .sp .5
void void
svcerr_weakauth(xprt) svcerr_weakauth(xprt)
\s-1SVCXPRT\s0 *xprt; SVCXPRT *xprt;
.fi .fi
.ft R .ft R
.IP .IP
@ -1402,14 +1402,14 @@ Called by a service dispatch routine that refuses to perform
a remote procedure call due to insufficient a remote procedure call due to insufficient
authentication parameters. authentication parameters.
The routine calls The routine calls
.BR "svcerr_auth(xprt, \s-1AUTH_TOOWEAK\s0)" . .BR "svcerr_auth(xprt, AUTH_TOOWEAK)" .
.br .br
.if t .ne 11 .if t .ne 11
.LP .LP
.ft B .ft B
.nf .nf
.sp .5 .sp .5
\s-1SVCXPRT\s0 * SVCXPRT *
svcfd_create(fd, sendsize, recvsize) svcfd_create(fd, sendsize, recvsize)
int fd; int fd;
u_int sendsize; u_int sendsize;
@ -1420,7 +1420,7 @@ u_int recvsize;
Create a service on top of any open descriptor. Create a service on top of any open descriptor.
Typically, this descriptor is a connected socket for a stream protocol such Typically, this descriptor is a connected socket for a stream protocol such
as as
.SM TCP\s0. .SM TCP.
.I sendsize .I sendsize
and and
.I recvsize .I recvsize
@ -1433,7 +1433,7 @@ zero, a reasonable default is chosen.
.ft B .ft B
.nf .nf
.sp .5 .sp .5
\s-1SVCXPRT\s0 * SVCXPRT *
svcraw_create() svcraw_create()
.fi .fi
.ft R .ft R
@ -1463,7 +1463,7 @@ if it fails.
.ft B .ft B
.nf .nf
.sp .5 .sp .5
\s-1SVCXPRT\s0 * SVCXPRT *
svctcp_create(sock, send_buf_size, recv_buf_size) svctcp_create(sock, send_buf_size, recv_buf_size)
int sock; int sock;
u_int send_buf_size, recv_buf_size; u_int send_buf_size, recv_buf_size;
@ -1471,13 +1471,13 @@ u_int send_buf_size, recv_buf_size;
.ft R .ft R
.IP .IP
This routine creates a This routine creates a
.SM TCP/IP\s0-based .SM TCP/IP-based
.SM RPC .SM RPC
service transport, to which it returns a pointer. service transport, to which it returns a pointer.
The transport is associated with the socket The transport is associated with the socket
.IR sock , .IR sock ,
which may be which may be
.BR \s-1RPC_ANYSOCK\s0 , .BR RPC_ANYSOCK ,
in which case a new socket is created. in which case a new socket is created.
If the socket is not bound to a local If the socket is not bound to a local
.SM TCP .SM TCP
@ -1491,7 +1491,7 @@ This routine returns
.SM NULL .SM NULL
if it fails. if it fails.
Since Since
.SM TCP\s0-based .SM TCP-based
.SM RPC .SM RPC
uses buffered uses buffered
.SM I/O , .SM I/O ,
@ -1503,7 +1503,7 @@ choose suitable defaults.
.ft B .ft B
.nf .nf
.sp .5 .sp .5
\s-1SVCXPRT\s0 * SVCXPRT *
svcudp_bufcreate(sock, sendsize, recosize) svcudp_bufcreate(sock, sendsize, recosize)
int sock; int sock;
u_int sendsize, recosize; u_int sendsize, recosize;
@ -1511,13 +1511,13 @@ u_int sendsize, recosize;
.ft R .ft R
.IP .IP
This routine creates a This routine creates a
.SM UDP/IP\s0-based .SM UDP/IP-based
.SM RPC .SM RPC
service transport, to which it returns a pointer. service transport, to which it returns a pointer.
The transport is associated with the socket The transport is associated with the socket
.IR sock , .IR sock ,
which may be which may be
.BR \s-1RPC_ANYSOCK\s0 , .BR RPC_ANYSOCK ,
in which case a new socket is created. in which case a new socket is created.
If the socket is not bound to a local If the socket is not bound to a local
.SM UDP .SM UDP
@ -1533,7 +1533,7 @@ if it fails.
.IP .IP
This allows the user to specify the maximum packet size for sending and This allows the user to specify the maximum packet size for sending and
receiving receiving
.SM UDP\s0-based .SM UDP-based
.SM RPC messages. .SM RPC messages.
.br .br
.if t .ne 5 .if t .ne 5
@ -1541,7 +1541,7 @@ receiving
.ft B .ft B
.nf .nf
.sp .5 .sp .5
\s-1SVCXPRT\s0 * SVCXPRT *
svcudp_create(sock) svcudp_create(sock)
int sock; int sock;
.fi .fi
@ -1557,7 +1557,7 @@ for some default size \fISZ\fP.
.nf .nf
.sp .5 .sp .5
xdr_accepted_reply(xdrs, ar) xdr_accepted_reply(xdrs, ar)
\s-1XDR\s0 *xdrs; XDR *xdrs;
struct accepted_reply *ar; struct accepted_reply *ar;
.fi .fi
.ft R .ft R
@ -1566,7 +1566,7 @@ Used for encoding
.SM RPC .SM RPC
reply messages. reply messages.
This routine is useful for users who wish to generate This routine is useful for users who wish to generate
\s-1RPC\s0-style RPC-style
messages without using the messages without using the
.SM RPC .SM RPC
package. package.
@ -1577,7 +1577,7 @@ package.
.nf .nf
.sp .5 .sp .5
xdr_authunix_parms(xdrs, aupp) xdr_authunix_parms(xdrs, aupp)
\s-1XDR\s0 *xdrs; XDR *xdrs;
struct authunix_parms *aupp; struct authunix_parms *aupp;
.fi .fi
.ft R .ft R
@ -1597,7 +1597,7 @@ authentication package.
.sp .5 .sp .5
void void
xdr_callhdr(xdrs, chdr) xdr_callhdr(xdrs, chdr)
\s-1XDR\s0 *xdrs; XDR *xdrs;
struct rpc_msg *chdr; struct rpc_msg *chdr;
.fi .fi
.ft R .ft R
@ -1606,7 +1606,7 @@ Used for describing
.SM RPC .SM RPC
call header messages. call header messages.
This routine is useful for users who wish to generate This routine is useful for users who wish to generate
.SM RPC\s0-style .SM RPC-style
messages without using the messages without using the
.SM RPC .SM RPC
package. package.
@ -1617,7 +1617,7 @@ package.
.nf .nf
.sp .5 .sp .5
xdr_callmsg(xdrs, cmsg) xdr_callmsg(xdrs, cmsg)
\s-1XDR\s0 *xdrs; XDR *xdrs;
struct rpc_msg *cmsg; struct rpc_msg *cmsg;
.fi .fi
.ft R .ft R
@ -1626,7 +1626,7 @@ Used for describing
.SM RPC .SM RPC
call messages. call messages.
This routine is useful for users who wish to generate This routine is useful for users who wish to generate
.SM RPC\s0-style .SM RPC-style
messages without using the messages without using the
.SM RPC .SM RPC
package. package.
@ -1637,7 +1637,7 @@ package.
.nf .nf
.sp .5 .sp .5
xdr_opaque_auth(xdrs, ap) xdr_opaque_auth(xdrs, ap)
\s-1XDR\s0 *xdrs; XDR *xdrs;
struct opaque_auth *ap; struct opaque_auth *ap;
.fi .fi
.ft R .ft R
@ -1646,7 +1646,7 @@ Used for describing
.SM RPC .SM RPC
authentication information messages. authentication information messages.
This routine is useful for users who wish to generate This routine is useful for users who wish to generate
.SM RPC\s0-style .SM RPC-style
messages without using the messages without using the
.SM RPC .SM RPC
package. package.
@ -1657,7 +1657,7 @@ package.
.nf .nf
.sp .5 .sp .5
xdr_pmap(xdrs, regs) xdr_pmap(xdrs, regs)
\s-1XDR\s0 *xdrs; XDR *xdrs;
struct pmap *regs; struct pmap *regs;
.fi .fi
.ft R .ft R
@ -1676,7 +1676,7 @@ interface.
.nf .nf
.sp .5 .sp .5
xdr_pmaplist(xdrs, rp) xdr_pmaplist(xdrs, rp)
\s-1XDR\s0 *xdrs; XDR *xdrs;
struct pmaplist **rp; struct pmaplist **rp;
.fi .fi
.ft R .ft R
@ -1693,7 +1693,7 @@ interface.
.nf .nf
.sp .5 .sp .5
xdr_rejected_reply(xdrs, rr) xdr_rejected_reply(xdrs, rr)
\s-1XDR\s0 *xdrs; XDR *xdrs;
struct rejected_reply *rr; struct rejected_reply *rr;
.fi .fi
.ft R .ft R
@ -1702,7 +1702,7 @@ Used for describing
.SM RPC .SM RPC
reply messages. reply messages.
This routine is useful for users who wish to generate This routine is useful for users who wish to generate
.SM RPC\s0-style .SM RPC-style
messages without using the messages without using the
.SM RPC .SM RPC
package. package.
@ -1713,7 +1713,7 @@ package.
.nf .nf
.sp .5 .sp .5
xdr_replymsg(xdrs, rmsg) xdr_replymsg(xdrs, rmsg)
\s-1XDR\s0 *xdrs; XDR *xdrs;
struct rpc_msg *rmsg; struct rpc_msg *rmsg;
.fi .fi
.ft R .ft R
@ -1734,7 +1734,7 @@ package.
.sp .5 .sp .5
void void
xprt_register(xprt) xprt_register(xprt)
\s-1SVCXPRT\s0 *xprt; SVCXPRT *xprt;
.fi .fi
.ft R .ft R
.IP .IP
@ -1755,7 +1755,7 @@ Service implementors usually do not need this routine.
.sp .5 .sp .5
void void
xprt_unregister(xprt) xprt_unregister(xprt)
\s-1SVCXPRT\s0 *xprt; SVCXPRT *xprt;
.fi .fi
.ft R .ft R
.IP .IP
@ -1784,6 +1784,6 @@ rpcgen Programming Guide
.br .br
.ft R .ft R
.RE .RE
.IR "\s-1RPC\s0: Remote Procedure Call Protocol Specification" , .IR "RPC: Remote Procedure Call Protocol Specification" ,
.SM RFC\ 1050, Sun Microsystems, Inc., .SM RFC\ 1050, Sun Microsystems, Inc.,
.SM USC-ISI\s0. .SM USC-ISI.

88
man3/xdr.3
View File

@ -15,7 +15,7 @@ routines.
.nf .nf
.sp .5 .sp .5
xdr_array(xdrs, arrp, sizep, maxsize, elsize, elproc) xdr_array(xdrs, arrp, sizep, maxsize, elsize, elproc)
\s-1XDR\s0 *xdrs; XDR *xdrs;
char **arrp; char **arrp;
u_int *sizep, maxsize, elsize; u_int *sizep, maxsize, elsize;
xdrproc_t elproc; xdrproc_t elproc;
@ -51,7 +51,7 @@ This routine returns one if it succeeds, zero otherwise.
.nf .nf
.sp .5 .sp .5
xdr_bool(xdrs, bp) xdr_bool(xdrs, bp)
\s-1XDR\s0 *xdrs; XDR *xdrs;
bool_t *bp; bool_t *bp;
.fi .fi
.ft R .ft R
@ -69,7 +69,7 @@ This routine returns one if it succeeds, zero otherwise.
.nf .nf
.sp .5 .sp .5
xdr_bytes(xdrs, sp, sizep, maxsize) xdr_bytes(xdrs, sp, sizep, maxsize)
\s-1XDR\s0 *xdrs; XDR *xdrs;
char **sp; char **sp;
u_int *sizep, maxsize; u_int *sizep, maxsize;
.fi .fi
@ -93,7 +93,7 @@ This routine returns one if it succeeds, zero otherwise.
.nf .nf
.sp .5 .sp .5
xdr_char(xdrs, cp) xdr_char(xdrs, cp)
\s-1XDR\s0 *xdrs; XDR *xdrs;
char *cp; char *cp;
.fi .fi
.ft R .ft R
@ -116,7 +116,7 @@ or
.sp .5 .sp .5
void void
xdr_destroy(xdrs) xdr_destroy(xdrs)
\s-1XDR\s0 *xdrs; XDR *xdrs;
.fi .fi
.ft R .ft R
.IP .IP
@ -138,7 +138,7 @@ is undefined.
.nf .nf
.sp .5 .sp .5
xdr_double(xdrs, dp) xdr_double(xdrs, dp)
\s-1XDR\s0 *xdrs; XDR *xdrs;
double *dp; double *dp;
.fi .fi
.ft R .ft R
@ -154,7 +154,7 @@ This routine returns one if it succeeds, zero otherwise.
.nf .nf
.sp .5 .sp .5
xdr_enum(xdrs, ep) xdr_enum(xdrs, ep)
\s-1XDR\s0 *xdrs; XDR *xdrs;
enum_t *ep; enum_t *ep;
.fi .fi
.ft R .ft R
@ -170,7 +170,7 @@ This routine returns one if it succeeds, zero otherwise.
.nf .nf
.sp .5 .sp .5
xdr_float(xdrs, fp) xdr_float(xdrs, fp)
\s-1XDR\s0 *xdrs; XDR *xdrs;
float *fp; float *fp;
.fi .fi
.ft R .ft R
@ -212,7 +212,7 @@ freed (recursively).
.sp .5 .sp .5
u_int u_int
xdr_getpos(xdrs) xdr_getpos(xdrs)
\s-1XDR\s0 *xdrs; XDR *xdrs;
.fi .fi
.ft R .ft R
.IP .IP
@ -240,7 +240,7 @@ stream instances need not guarantee this.
.br .br
long * long *
xdr_inline(xdrs, len) xdr_inline(xdrs, len)
\s-1XDR\s0 *xdrs; XDR *xdrs;
int len; int len;
.fi .fi
.ft R .ft R
@ -271,7 +271,7 @@ it exists for the sake of efficiency.
.nf .nf
.sp .5 .sp .5
xdr_int(xdrs, ip) xdr_int(xdrs, ip)
\s-1XDR\s0 *xdrs; XDR *xdrs;
int *ip; int *ip;
.fi .fi
.ft R .ft R
@ -286,7 +286,7 @@ This routine returns one if it succeeds, zero otherwise.
.nf .nf
.sp .5 .sp .5
xdr_long(xdrs, lp) xdr_long(xdrs, lp)
\s-1XDR\s0 *xdrs; XDR *xdrs;
long *lp; long *lp;
.fi .fi
.ft R .ft R
@ -303,7 +303,7 @@ This routine returns one if it succeeds, zero otherwise.
.sp .5 .sp .5
void void
xdrmem_create(xdrs, addr, size, op) xdrmem_create(xdrs, addr, size, op)
\s-1XDR\s0 *xdrs; XDR *xdrs;
char *addr; char *addr;
u_int size; u_int size;
enum xdr_op op; enum xdr_op op;
@ -326,10 +326,10 @@ determines the direction of the
.SM XDR .SM XDR
stream stream
(either (either
.BR \s-1XDR_ENCODE\s0 , .BR XDR_ENCODE ,
.BR \s-1XDR_DECODE\s0 , .BR XDR_DECODE ,
or or
.BR \s-1XDR_FREE\s0 ). .BR XDR_FREE ).
.br .br
.if t .ne 10 .if t .ne 10
.LP .LP
@ -337,7 +337,7 @@ or
.nf .nf
.sp .5 .sp .5
xdr_opaque(xdrs, cp, cnt) xdr_opaque(xdrs, cp, cnt)
\s-1XDR\s0 *xdrs; XDR *xdrs;
char *cp; char *cp;
u_int cnt; u_int cnt;
.fi .fi
@ -358,7 +358,7 @@ This routine returns one if it succeeds, zero otherwise.
.nf .nf
.sp .5 .sp .5
xdr_pointer(xdrs, objpp, objsize, xdrobj) xdr_pointer(xdrs, objpp, objsize, xdrobj)
\s-1XDR\s0 *xdrs; XDR *xdrs;
char **objpp; char **objpp;
u_int objsize; u_int objsize;
xdrproc_t xdrobj; xdrproc_t xdrobj;
@ -385,7 +385,7 @@ linked lists.
.sp .5 .sp .5
void void
xdrrec_create(xdrs, sendsize, recvsize, handle, readit, writeit) xdrrec_create(xdrs, sendsize, recvsize, handle, readit, writeit)
\s-1XDR\s0 *xdrs; XDR *xdrs;
u_int sendsize, recvsize; u_int sendsize, recvsize;
char *handle; char *handle;
int (*readit) (), (*writeit) (); int (*readit) (), (*writeit) ();
@ -436,7 +436,7 @@ to provide record boundary information.
.nf .nf
.sp .5 .sp .5
xdrrec_endofrecord(xdrs, sendnow) xdrrec_endofrecord(xdrs, sendnow)
\s-1XDR\s0 *xdrs; XDR *xdrs;
int sendnow; int sendnow;
.fi .fi
.ft R .ft R
@ -457,7 +457,7 @@ This routine returns one if it succeeds, zero otherwise.
.nf .nf
.sp .5 .sp .5
xdrrec_eof(xdrs) xdrrec_eof(xdrs)
\s-1XDR\s0 *xdrs; XDR *xdrs;
int empty; int empty;
.fi .fi
.ft R .ft R
@ -475,7 +475,7 @@ zero otherwise.
.nf .nf
.sp .5 .sp .5
xdrrec_skiprecord(xdrs) xdrrec_skiprecord(xdrs)
\s-1XDR\s0 *xdrs; XDR *xdrs;
.fi .fi
.ft R .ft R
.IP .IP
@ -494,7 +494,7 @@ This routine returns one if it succeeds, zero otherwise.
.nf .nf
.sp .5 .sp .5
xdr_reference(xdrs, pp, size, proc) xdr_reference(xdrs, pp, size, proc)
\s-1XDR\s0 *xdrs; XDR *xdrs;
char **pp; char **pp;
u_int size; u_int size;
xdrproc_t proc; xdrproc_t proc;
@ -531,7 +531,7 @@ instead.
.nf .nf
.sp .5 .sp .5
xdr_setpos(xdrs, pos) xdr_setpos(xdrs, pos)
\s-1XDR\s0 *xdrs; XDR *xdrs;
u_int pos; u_int pos;
.fi .fi
.ft R .ft R
@ -561,7 +561,7 @@ type of stream and succeed with another.
.nf .nf
.sp .5 .sp .5
xdr_short(xdrs, sp) xdr_short(xdrs, sp)
\s-1XDR\s0 *xdrs; XDR *xdrs;
short *sp; short *sp;
.fi .fi
.ft R .ft R
@ -578,8 +578,8 @@ This routine returns one if it succeeds, zero otherwise.
.sp .5 .sp .5
void void
xdrstdio_create(xdrs, file, op) xdrstdio_create(xdrs, file, op)
\s-1XDR\s0 *xdrs; XDR *xdrs;
\s-1FILE\s0 *file; FILE *file;
enum xdr_op op; enum xdr_op op;
.fi .fi
.ft R .ft R
@ -599,10 +599,10 @@ The parameter
determines the direction of the determines the direction of the
.SM XDR .SM XDR
stream (either stream (either
.BR \s-1XDR_ENCODE\s0 , .BR XDR_ENCODE ,
.BR \s-1XDR_DECODE\s0 , .BR XDR_DECODE ,
or or
.BR \s-1XDR_FREE\s0 ). .BR XDR_FREE ).
.IP .IP
Warning: the destroy routine associated with such Warning: the destroy routine associated with such
.SM XDR .SM XDR
@ -619,7 +619,7 @@ stream, but never
.nf .nf
.sp .5 .sp .5
xdr_string(xdrs, sp, maxsize) xdr_string(xdrs, sp, maxsize)
\s-1XDR\s0 XDR
*xdrs; *xdrs;
char **sp; char **sp;
u_int maxsize; u_int maxsize;
@ -642,7 +642,7 @@ This routine returns one if it succeeds, zero otherwise.
.nf .nf
.sp .5 .sp .5
xdr_u_char(xdrs, ucp) xdr_u_char(xdrs, ucp)
\s-1XDR\s0 *xdrs; XDR *xdrs;
unsigned char *ucp; unsigned char *ucp;
.fi .fi
.ft R .ft R
@ -658,7 +658,7 @@ This routine returns one if it succeeds, zero otherwise.
.nf .nf
.sp .5 .sp .5
xdr_u_int(xdrs, up) xdr_u_int(xdrs, up)
\s-1XDR\s0 *xdrs; XDR *xdrs;
unsigned *up; unsigned *up;
.fi .fi
.ft R .ft R
@ -674,7 +674,7 @@ This routine returns one if it succeeds, zero otherwise.
.nf .nf
.sp .5 .sp .5
xdr_u_long(xdrs, ulp) xdr_u_long(xdrs, ulp)
\s-1XDR\s0 *xdrs; XDR *xdrs;
unsigned long *ulp; unsigned long *ulp;
.fi .fi
.ft R .ft R
@ -690,7 +690,7 @@ This routine returns one if it succeeds, zero otherwise.
.nf .nf
.sp .5 .sp .5
xdr_u_short(xdrs, usp) xdr_u_short(xdrs, usp)
\s-1XDR\s0 *xdrs; XDR *xdrs;
unsigned short *usp; unsigned short *usp;
.fi .fi
.ft R .ft R
@ -706,11 +706,11 @@ This routine returns one if it succeeds, zero otherwise.
.nf .nf
.sp .5 .sp .5
xdr_union(xdrs, dscmp, unp, choices, dfault) xdr_union(xdrs, dscmp, unp, choices, dfault)
\s-1XDR\s0 *xdrs; XDR *xdrs;
int *dscmp; int *dscmp;
char *unp; char *unp;
struct xdr_discrim *choices; struct xdr_discrim *choices;
bool_t (*defaultarm) (); /* may equal \s-1NULL\s0 */ bool_t (*defaultarm) (); /* may equal NULL */
.fi .fi
.ft R .ft R
.IP .IP
@ -740,13 +740,13 @@ is called to translate the union.
The end of the The end of the
.BR xdr_discrim () .BR xdr_discrim ()
structure array is denoted by a routine of value structure array is denoted by a routine of value
.SM NULL\s0. .SM NULL.
If the discriminant is not found in the If the discriminant is not found in the
.I choices .I choices
array, then the array, then the
.I defaultarm .I defaultarm
procedure is called (if it is not procedure is called (if it is not
.SM NULL\s0). .SM NULL).
Returns one if it succeeds, zero otherwise. Returns one if it succeeds, zero otherwise.
.br .br
.if t .ne 6 .if t .ne 6
@ -755,7 +755,7 @@ Returns one if it succeeds, zero otherwise.
.nf .nf
.sp .5 .sp .5
xdr_vector(xdrs, arrp, size, elsize, elproc) xdr_vector(xdrs, arrp, size, elsize, elproc)
\s-1XDR\s0 *xdrs; XDR *xdrs;
char *arrp; char *arrp;
u_int size, elsize; u_int size, elsize;
xdrproc_t elproc; xdrproc_t elproc;
@ -804,13 +804,13 @@ where nothing is to be done.
.nf .nf
.sp .5 .sp .5
xdr_wrapstring(xdrs, sp) xdr_wrapstring(xdrs, sp)
\s-1XDR\s0 *xdrs; XDR *xdrs;
char **sp; char **sp;
.fi .fi
.ft R .ft R
.IP .IP
A primitive that calls A primitive that calls
.B "xdr_string(xdrs, sp,\s-1MAXUN.UNSIGNED\s0 );" .B "xdr_string(xdrs, sp,MAXUN.UNSIGNED );"
where where
.B .B
.SM MAXUN.UNSIGNED .SM MAXUN.UNSIGNED
@ -835,6 +835,6 @@ eXternal Data Representation Standard: Protocol Specification
eXternal Data Representation: Sun Technical Notes eXternal Data Representation: Sun Technical Notes
.ft R .ft R
.br .br
.IR "\s-1XDR\s0: External Data Representation Standard" , .IR "XDR: External Data Representation Standard" ,
.SM RFC\ 1014, Sun Microsystems, Inc., .SM RFC\ 1014, Sun Microsystems, Inc.,
.SM USC-ISI\s0. .SM USC-ISI.

10
man4/dsp56k.4
View File

@ -32,11 +32,11 @@ dsp56k \- DSP56001 interface device
.sp .sp
.BI "ssize_t read(int " fd ", void *" data ", size_t " length ); .BI "ssize_t read(int " fd ", void *" data ", size_t " length );
.BI "ssize_t write(int " fd ", void *" data ", size_t " length ); .BI "ssize_t write(int " fd ", void *" data ", size_t " length );
.BI "int ioctl(int " fd ", \s-1DSP56K_UPLOAD\s+1, struct dsp56k_upload *" program ); .BI "int ioctl(int " fd ", DSP56K_UPLOAD, struct dsp56k_upload *" program );
.BI "int ioctl(int " fd ", \s-1DSP56K_SET_TX_WSIZE\s+1, int " wsize ); .BI "int ioctl(int " fd ", DSP56K_SET_TX_WSIZE, int " wsize );
.BI "int ioctl(int " fd ", \s-1DSP56K_SET_RX_WSIZE\s+1, int " wsize ); .BI "int ioctl(int " fd ", DSP56K_SET_RX_WSIZE, int " wsize );
.BI "int ioctl(int " fd ", \s-1DSP56K_HOST_FLAGS\s+1, struct dsp56k_host_flags *" flags ); .BI "int ioctl(int " fd ", DSP56K_HOST_FLAGS, struct dsp56k_host_flags *" flags );
.BI "int ioctl(int " fd ", \s-1DSP56K_HOST_CMD\s+1, int " cmd ); .BI "int ioctl(int " fd ", DSP56K_HOST_CMD, int " cmd );
.fi .fi
.SH CONFIGURATION .SH CONFIGURATION
The dsp56k device is a character device with major number 55 and minor The dsp56k device is a character device with major number 55 and minor