The frpc Reference Manual

Table of Contents

The frpc Reference Manual

This is the frpc Reference Manual, version 1.3.1, generated automatically by Declt version 3.0 "Montgomery Scott" on Tue Apr 28 11:50:10 2020 GMT+0.

1 Introduction

frpc

This is an implementation of the ONC-RPC ("SunRPC") protocol in Common Lisp. It provides both a generalized eXtensible Data Representation (XDR) serializer and a flexible Remote Procedure Call (RPC) framework to build robust, secure networked services. It supports the most commonly used authentication flavours (see below) including RPCSEC_GSS (i.e. Kerberos).

See the related project nefarious, which uses frpc to implement an NFSv3 client and server.

An XDR protocol compiler is also included, which provides similar functionality to rpcgen typically used with the C programming language (see section 9).

1. Defining RPC interfaces

RPC interfaces are given a unique integer called a program number, see IANA for a detailed list. Each program may have multiple versions of its interface, with each version having a different set of functions/arguments. Each procedure in the interface is also given a unique integer. Together these 3 integers define the procedure identifier.

In frpc, both clients and servers must define the interface. This supplies argument and result types. Servers must additionally implement handlers for each procedure they wish to support.

For instance, a client should write:

(defrpc call-hello 0 :string :string)
(defrpc call-goodbye 1 :uint32 :string)

This defines a Lisp function for each RPC proc to call out to an RPC server to execute the procedure, e.g.

CL-USER> (call-hello "Bob" :host "10.1.1.1" :port 1234 :protocol :udp)
"Hello, Bob!"

Servers should additionally implement handlers for the procedures they wish to support

(defun handle-hello (msg)
  (format nil "Hello, ~A!" msg))

(defrpc call-hello 0 :string :string
  (:handler #'handle-hello))

(defun handle-goodbye (u)
  (format nil "Goodbye ~A!" u))

(defrpc call-goodbye 1 :uint32 :string
  (:handler #'handle-goodbye))

The :HANDLER option specifies a function which accepts a single argument, which will be the value decoded according to the rule defined for the arg-type by the DEFRPC form. The handler function should return a single value which will be passed to the result-type serializer defined by the DEFRPC form. If the handler signals an error, the RPC server will be silent (i.e. not send a reply). Typically, you should indicate to the caller that an error occured by returning a status code as a part of your return value. Most RPC interfaces define return value structures in this way.

The types provided to DEFRPC can be a generalized type specifier, as described below in section 4.5.

2. Client

The DEFRPC macro defines a wrapper around the underlying CALL-RPC function, with default values provided for the argument writer, result reader, program, version and proc arguments.

Thus, with the example above, the client will be able to call a remote RPC server using, e.g.,

(call-hello "hello" :host "10.1.1.1" :port 8000)

The default client function accepts a single mandatory argument, which must match the corresponding XDR type specifier. However, typically the programmer would like to provide a better interface to hide the underlying implementation. For instance, consider a procedure which accepts and returns a structure of two strings:

(defxstruct my-arg ()
  (a :string)
  (b :string))
(defrpc call-my-proc 1 my-arg my-arg
  (:arg-transformer (a &key (b ""))
    (make-my-arg :a a :b b))
  (:transformer (res)
    (values (string-upcase (my-arg-a res)) (string-upcase (my-arg-b res))))
  (:documentation "Accepts two strings A and B. Returns (values (string-upcase A) (string-upcase B))."))

The resulting client function can then be called:

CL-USER> (call-my-proc "Alice" :b "Bob" :host "10.1.1.1" :port 1234 :protocol :udp)
"ALICE"
"BOB"

The :ARG-TRANSFORMER option specifies how to transform the arguments to the function into arguments for the RPC call. You may use this to allow some of the arguments be passed in as keyword parameters. The :TRANSFORMER option specifies how to transform the result of the RPC call back to Lisp. Documentation strings can be provided with the :DOCUMENTATION option.

2.1 CALL-RPC

The low-level client functionality is provided by CALL-RPC. This function is used by a client to send an RPC request to a remote server and blocks until a reply is received.

2.2 TCP connections

You can provide a connection to the functions defined by DEFRPC. This makes it more efficient to send multiple messages to a single server, without having to reconnect for each request.

Use RPC-CONNECT and RPC-CLOSE to establish and close a connection. The macro WITH-RPC-CONNECTION can be used to ensure the connection is closed on exit.

;; normal way to do it. establishes a connection and closes it at the end 
(frpc.bind:call-dump "192.168.0.8" :protocol :tcp)

;; reuses a connection to the server 
(frpc:with-rpc-connection (c "192.168.0.8" 111 :tcp)  
  (list (frpc.bind:call-dump :connection c) 
        (frpc.bind:call-dump :connection c)))

2.3 UDP

Specifying :UDP as the protocol will send the message using the UDP transport instead of TCP (UDP is the default). If you care about the result, then specify a timeout in seconds to wait for the reply. If no reply is received an RPC-TIMEOUT-ERROR will be signalled, otherwise the function returns immediately with result nil.

(frpc.bind:call-null :host "192.168.0.1" :protocol :udp)

Users may also supply a connection argument for UDP so that they don't need to keep making new UDP sockets for each RPC.

(with-rpc-connection (conn host port :udp)
  (frpc.bind:call-null :protocol :udp :connection conn)
  (frpc.bind:call-dump :protocol :udp :connection conn))

2.4 UDP broadcast

You may send messages using UDP broadcast to find services on your local network.

(frpc.bind:call-null :host "255.255.255.255" :protocol :broadcast)

Broadcast messages return a list of the responses received within the timeout -- no timeout error is raised if no replies are received. Each element in the list is a list of 2 items (host result), where host is where the response came from and result is the result of decoding the message that was received.

Note: not all implementations support UDP broadcast. Check with usocket to find out whether your implementation is supported.

3. RPC Server

An RPC server runs from within a single thread and listens on a set of TCP and UDP ports. It may serve a subset of available RPC programs, by default serving all programs.

;; make a server instance
(defvar *server* (make-rpc-server :tcp-ports '(8000) :udp-ports '(8000)))

;; start the server in a new thread, it will listen for requests on TCP and UDP ports 8000
(start-rpc-server *server*)

;; stop the server thread
(stop-rpc-server *server*)

When the server accepts a TCP connection, it is added to a list of currently open connections. The server will select a connection to process using USOCKET:WAIT-FOR-INPUT. This allows the server to keep open multiple TCP connections without blocking other traffic. Note that the socket IO is still synchronous. Connections which are idle for TIMEOUT seconds (default 60 seconds) are closed by the RPC server.

3.1 Server handlers

The handler function, which is invoked to process an RPC request, should return an object which matches the type specified in the associated DEFRPC form. If the handler signals an RPC-AUTH-ERROR, the request will be rejected with the auth-stat provided (or AUTH-TOOWEAK otherwise).

It is the handler's responsibility to ensure both that the caller has authenticated to a suffiently secure level and that the caller is authorized to call the function.

If any other error is signalled, then the RPC server will be silent, i.e. not return any response to the caller. Some APIs require this behaviour, this is the way server handlers should support it.

Please note that because the RPC server is singly threaded, your handler function must not block execution because that will prevent the server from processing other requests. If your handler needs to do work which takes an extended period of time (lots of disk IO, making other RPCs etc.) then you should design your API in such a way that the initial call returns immediately with the work taking place in another thread; the client can poll for progress or be notified on completion (e.g. via a callback RPC).

3.2 Restricting programs

By default, an RPC server will serve all available programs. However, it might be that you want only a subset of defined programs to be served from a particular RPC server. For instance, you might want an NFS server to run from one thread and your portmap to run from another. To do this, supply a list of program identifiers (integers, symbols or strings) naming the programs you wish to run in that server.

CL-USER> (defparameter *portmap* (frpc:make-rpc-server :udp-ports '(111) :tcp-ports '(111) :programs '(100000)))
CL-USER> (defparameter *nfs* (frpc:make-rpc-server :programs '("nfs" "nfs.mount" "nsm")))
CL-USER> (frpc:start-rpc-server *portmap*)
CL-USER> (frpc:start-rpc-server *nfs*)

3.3 Listening on wildcard ports

If you don't supply any ports to MAKE-RPC-SERVER then a wildcard port will be selected for TCP and UDP (port number 0), this allows for a randomly allocated high-numberd port to be used. You may enforce such befhaviour yourself by supplying 0 as a port number if you wish.

3.4 Advanced usage

If you want more fine-grained control over the RPC server processing, you can make use of the following functions:

CL-USER> (defvar *server* (make-rpc-server))
CL-USER> (startup-rpc-server *server*)
CL-USER> (accept-rpc-request *server*) ;; keep calling this to process requests
CL-USER> (shutdown-rpc-server *server*)

• Allocate a server using MAKE-RPC-SERVER as described above.
• Allocate sockets and setup port bindings by calling STARTUP-RPC-SERVER.
• Keep processing RPC requests by calling ACCEPT-RPC-REQUEST.
• Remove port mappings and close all sockets by calling SHUTDOWN-RPC-SERVER.

Note that by using this lower-level API you get to control which thread the RPC processing occurs in. It also gives you the possibility to perform extra processing in your processing loop.

At present ACCEPT-RPC-REQUEST is not thread safe.

4. XDR serializer

The XDR serializer is largely decoupled from the rpc implementation. This means it could be used for other purposes as a generalised binary serialization system.

4.1 Primitive types

The primitive types which come predefined are:

• :int32 :uint32 :int64 :uint64 :octet
• :string
• :boolean
• :real32 :real64
• :void

You may define new primitive types using:

(defxtype name ((:reader reader-name) (:writer writer-name))
  ((stream) body-reading-value-from-stream)
  ((stream obj) body-writing-obj-to-stream))

Only very rare circumstances should require doing this.

The optional parameters READER-NAME and WRITER-NAME are the function names generated for the type's reader and writer. If not provided, %READ- and %WRITE- prepended with the type's name are used.

Use XTYPE-READER and XTYPE-WRITER to lookup the type's reader and writer functions.

Use READ-XTYPE and WRITE-XTYPE to read/write an instance of the type to/from a stream.

Use PACK/UNPACK to store/extract instances from buffers rather than streams.

4.2 enums

Enumerated types are lists of symbol/integer pairs. Define enum types using

(defxenum enum-name
  (symbol integer)
  ...)

;; example 
(defxenum myenum 
  (:a 0)
  (:b 1)
  (:c 2))

Lookup a corresponding integer or symbol using

(enum enum-type val)

where val is either an integer or a symbol.

4.3 unions

Discriminated unions are an enum followed by a value, with the type of the value specified by the provided enum. Define union types using:

(defxunion union-type (enum-type)
  (enum-symbol type-name)
  ...
  (otherwise type-name))

;; example
(defxunion myunion (myenum)
  (:a :int32)
  (:b :string)
  (otherwise :void))

This essentially expands to a CASE form, so you may put an OTHERWISE clause at the end, usually this will be a :VOID type.

Make instances of unions using MAKE-XUNION, get the tag and value using XUNION-TAG and XUNION-VAL e.g.

(let ((u (make-xunion :a 123)))
  (values (xunion-tag u) (xunion-val u)))
:A
123

4.4 structures

Define structures using:

(defxstruct struct-name ()
  (slot-name xtype-name &optional initial-value)
  ...)

This expands to a DEFSTRUCT form to define a structure.

For smaller structures it may be more convenient to use lists or plists:

(defxtype* my-list () (:list :uint32 :string))
(defxtype* my-plist () (:plist foo :uint32 bar :string))

4.5 Generalized types

(defxtype* name ()
  form)

Where the FORM is:

• a symbol, naming another xtype
• (:list &rest forms) ::= a list of objects of each type
• (:alist &rest (tag form)) ::= an alist of objects keyed on the tag
• (:plist &rest key form) ::= a plist of objects keyed on the key
• (:struct struct-name &rest (slot-name form)) ::= a structure with each slot of type form
• (:union enum-name &rest (enum-keys form)) ::= a union discriminated on the enum-name
• (:array form length) ::= a fixed-size array
• (:varray form &optional length) ::= a variable sized array, expands to a list of objects
• (:varray* form &optional length) ::= a variable sized array, expands to a vector of objects

These rules can be applied recursively.

You may define global readers/writers using DEFREADER and DEFWRITER. These macros generate DEFUN forms. The equivalent macros using FLET are WITH-READER and WITH-WRITER.

4.6 XDR examples

;; defstruct and define reader/writer for it 
(defxstruct foobar ((:reader read-foobar) (:writer write-foobar))
  (x :string)
  (y :uint32))

;; serialize the structure to a file 
(with-open-file (f "foobar.dat" :direction :output :if-exists :supersede :element-type '(unsigned-byte 8))
  (write-foobar f (make-foobar :x "hello" :y 123)))
;; deserialize the stucture from a file 
(with-open-file (f "foobar.dat" :direction :intput :element-type '(unsigned-byte 8))
  (read-foobar f))

5. Authentication

The authentication system that was used for the request is bound to *RPC-REMOTE-AUTH* special variable in the context of an rpc handler function. This allows handlers to implemente authorization, i.e. determining whether the client is permitted to perform the action requested.

Supported flavours:

• [x] AUTH-NULL: i.e. no authentication
• [x] AUTH-UNIX and AUTH-SHORT: uid/gid and machine name. Not really authentication as such, but a simple tagging mechanism. Provided directly by frpc.
• [x] AUTH-DES: public-key exchange verified by encrypted timestamps. This requires both the client and server have access to the public keys for each other. frpc implements its own system using a shared database for local access and an RPC interface for remote access.
• [x] AUTH-GSS: GSS (i.e. Kerberos) authentication, supports authentication, integrity validation and privacy. Uses the package cerberus to implement Kerberos v5 authentication. Provided by FRPC-GSS system.

To use client authentication you must create an instance of a subclass of RPC-CLIENT (see below). This can also be used as a "bag" of default values for the CALL-RPC keyword parameters.

;; allocate a client 
CL-USER> (defvar *client* (make-instance 'frpc:rpc-client :host "10.1.1.1" :port 123 :protocol :udp :timeout 1))

;; use it to perform an RPC
CL-USER> (frpc.bind:call-null :client *client*)

5.1 AUTH-NULL

This is the default mechanism and requires no special treatment.

5.2 AUTH-UNIX

(defvar *client* (make-instance 'frpc:unix-client :uid 1000 :gid 1001 :gids '(1002 1005)))

;; the first call uses AUTH-UNIX and if successful will recive a nickname
(frpc.bind:call-null :client *client*)

;; subsequent calls use AUTH-SHORT i.e. the nickname
(frpc.bind:call-null :client *client*)

5.3 AUTH-DES

This is provided by the FRPC-DES system and should be loaded using, e.g.

CL-USER> (ql:quickload "frpc-des")

5.3.1 Overview

AUTH-DES authentication is based on a Diffie-Hellman key exchange. Each party (client and server) have a secret key, from which public keys are derived. The public keys are exchanged beforehand by some unspecified mechanism. Traditionally this was implemented using an RPC service (defined by key_prot.x, see programs/keyserv.lisp) but this is somewhat award to use. Instead frpc implements its own shared database of public keys, which is exported using RPC so that remote machines can access its entries. Local processes can simply read from the database, remote processes use the RPC interface.

The local API is

• FIND-PUBLIC-KEY name ::= lookup the public key for this name
• ADD-PUBLIC-KEY name public ::= store the public key for this name
• REMOVE-PUBLIC-KEY name ::= delete the entry for this name
• LIST-PUBLIC-KEYS ::= list all entries in the local database.

The RPC API is:

• CALL-GET name ::= lookup the public key for this name
• CALL-SET name public ::= set the public key for this name
• CALL-UNSET name ::= delete the entry for this name
• CALL-LIST ::= enumerate all entries

CALL-SET and CALL-UNSET may only be called by the named user and must have been authenticated using AUTH-DES. Note that this means the database entry can only be created using the local API. However, they can be modified/deleted remotely.

5.3.2 Usage

Note that the client must know the name of the principal the service is running under. That has to be agreed in advance.

On the server:

;; open the database and ensure the database has an entry with the service name and secret key
CL-USER> (frpc-des:des-init "service-user" 123123123)

On the client:

;; get the public key for the service user
CL-USER> (defvar *service-public* (frpc-des:call-get "service-user"))

;; create a client
CL-USER> (defvar *client* (make-instance 'frpc-des:des-client :name "user-name" :secret 111122223333 :public *service-public*))

;; call a function, e.g. change my database entry
CL-USER> (frpc-des:call-set "user-name" (frpc-des:des-public 666666666) :client *client*)

5.4 AUTH-GSS (Kerberos)

This is provided by the FRPC-GSS system, load using e.g.

CL-USER> (ql:quickload "frpc-gss")

RPCSEC_GSS provides both integrity (checksumming) and privacy (encryption) of the call arguments/results. Set the :SERVICE level to :INTEGRITY for checksumming and :PRIVACY for encryption and checksumming of the call arguments/results. The default is :NONE which sends the args/results as normal.

;; you must first logon before you can request credentials for the application server
CL-USER> (cerberus:logon-user "myusername@myrealm" "mypassword" :kdc-address "10.1.2.3")
CL-USER> (defvar *cred* (glass:acquire-credentials :kerberos "service/hostname.com@myrealm"))
;; make the instance of the gss client
CL-USER> (defvar *client* (make-instance 'frpc:gss-client :credentials *cred* :service :privacy))
;; attempt to call the function, this will first negotiate the authentication before calling the proc
CL-USER> (frpc.bind:call-null :client *client*)

;; the server should initialize itself with a credentials handle
CL-USER> (cerberus:logon-service "service/hostname.com@myrealm" "password")
CL-USER> (frpc:gss-init)

5.5 Reauthentication

RPC servers are free to flush their tables of allocated nicknames/handles. When this happens you will receive an RPC-AUTH-ERROR (AUTH-REJECTED) error. You should set your client back to its initial state and retry, this should reallocate a new nickname/context handle.

CL-USER> (reinitialize-instance *client*)

5.6 Authorization

When server handlers are executed, the special variable *RPC-REMOTE-AUTH* is bound to the authenticator that was used in the request. This allows the server to decide whether to honour the request or to signal an RPC-AUTH-ERROR instead.

You may call RPC-AUTH-PRINCIPAL to get a string representing the authenticated caller. This can be used to aid authorization.

6. Portmap/rpcbind

Typically each RPC service listens on a randomly allocated high-numbered port. In order to find out the port number to contact the service on you must first query a service which listens on a well-known port, this service is called portmap or rpcbind.

CL-USER> (frpc.bind:call-dump :host "10.1.1.1")
(#S(MAPPING :PROGRAM 100000 :VERSION 2 :PORT 111 :PROTOCOL :TCP)
 #S(MAPPING :PROGRAM 100000 :VERSION 2 :PORT 111 :PROTOCOL :UDP))

7. Examples

Several example programs are included. For more serious usages, see Nefarious, an NFS implementation in Common Lisp.

7.1 Hello world (hello.lisp)

This program shows the basics, provides a function to upcase a string. An xfile is also included for testing with rpcgen. On Linux,

$ rpcgen -a hello.x 
$ Make -f Makefile.hello

You will probably need to modify the client, hello_client.c, to pass in correct arguments.

8. Logging

Debug logging is provided by pounds. By default this will create a 2MB log file in your home directory named "frpc.log". You should change the path by modifying:

(setf frpc:*frpc-log-path* (merge-pathnames (user-homedir-pathname) "foo.log"))

The log is created on the first call to FRPC-LOG, this is typically when you make your first RPC call or start your RPC server.

By default only log messages with :INFO or greater level are actually written to the log. You can increase the logging verbosity by pushing :TRACE to FRPC:*FRPC-LOG-LEVELS*.

For debugging and development you may follow the log to see output as it arrives:

(pounds.log:start-following *frpc-log*)

(pounds.log:stop-following)

Users may also write to this log if they wish, you should simply use a different tag (note: nefarious shares the frpc log).

(let ((tag (babel:string-to-octets "MYLG")))
  (defun my-log (lvl format-control &rest args)
    (unless *frpc-log*		  
      (frpc-log :info "Initializing log"))
    (pounds.log:write-message *frpc-log* 
    			      lvl 		      
			      (apply #'format nil format-control args)
			      :tag tag)))

See the pounds documentation for more information on the logging system.

9. XDR parser/generator

Typically RPC interfaces are described by an "x-file" which is used as input into the program rpcgen which generates code for the C programming language. The system frpcgen (file gen/gen.lisp) provides a function to parse xfiles and generate a Lisp file with contents suitable for use with frpc.

This makes it easy to freely interoperate between Lisp and C services using RPC, because they will both be derived from the same definition.

Usage:

(frpcgen:gen "test.x")

This generates a file called "test.lisp" which contains Lisp code suitable for use with frpc. Some hand modifications will be probably be required to make the generated code more usable, but it should at least provide a reasonable starting point.

10. Notes

• At the moment, reading from TCP streams requires buffering the input to cope with reading multiple fragments. This is REALLY bad if large payloads are sent. A fragmented-stream type could be defined to wrap the underlying socket stream so that we can avoid the buffering on reads. You still need to buffer writes because you need to know how much you intend to write before you've written it.
• Could make it easier to add more transports, e.g. SSL/TLS stream, writing to shared memory etc. Probably not much call for this though.
• UDP multicast?
• Currently no way to define transient programs, i.e. programs which get assigned a random program number at runtime.
• Need to support batching in some sort of useful way. So that a client can setup a connection and use wait-for-input to process replies. Basically need a pair of functions to send requests and receive replies from the connection.
• The XDR serializer is probably not as efficient as it could be, but who really cares so long as it works.
• Developed using SBCL on Windows. Also tested with Clozure CL on Windows, LispWorks on Windows and SBCL on Linux.

11. License

Released under the terms of the MIT license.

Frank James Febuary 2015.

2 Systems

The main system appears first, followed by any subsystem dependency.

2.1 frpc

Author

Frank James <frank.a.james@gmail.com>

License

MIT

Description

An ONC-RPC implementation.

Version

1.3.1

Dependencies

• alexandria
• nibbles
• flexi-streams
• usocket
• bordeaux-threads
• pounds
• babel
• glass

Source

frpc.asd (file)

Components

• package.lisp (file)
• log.lisp (file)
• xdr.lisp (file)
• rpc.lisp (file)
• unix.lisp (file)
• gss.lisp (file)
• errors.lisp (file)
• streams.lisp (file)
• client.lisp (file)
• bind.lisp (file)
• server.lisp (file)
• extras.lisp (file)

3 Files

Files are sorted by type and then listed depth-first from the systems components trees.

3.1 Lisp

3.1.1 frpc.asd

Location

frpc.asd

Systems

frpc (system)

3.1.2 frpc/package.lisp

Parent

frpc (system)

Location

package.lisp

Packages

frpc

3.1.3 frpc/log.lisp

Dependency

package.lisp (file)

Parent

frpc (system)

Location

log.lisp

Exported Definitions

• *frpc-log* (special variable)
• *frpc-log-levels* (special variable)
• *frpc-log-path* (special variable)
• frpc-log (function)

3.1.4 frpc/xdr.lisp

Dependency

log.lisp (file)

Parent

frpc (system)

Location

xdr.lisp

Exported Definitions

• defreader (macro)
• defwriter (macro)
• defxenum (macro)
• defxstruct (macro)
• defxtype (macro)
• defxtype* (macro)
• defxunion (macro)
• enum (function)
• enump (function)
• make-xdr-reader (function)
• make-xdr-writer (function)
• make-xunion (function)
• pack (function)
• read-xdr-object (function)
• read-xtype (function)
• read-xtype-list (function)
• unpack (function)
• with-reader (macro)
• with-writer (macro)
• write-xdr-object (function)
• write-xtype (function)
• write-xtype-list (function)
• xtype-reader (function)
• xtype-writer (function)
• xunion-tag (function)
• xunion-val (function)

Internal Definitions

• %defxtype (function)
• %read-real32 (function)
• %read-real64 (function)
• %read-void (function)
• %write-real32 (function)
• %write-real64 (function)
• %write-void (function)
• *enums* (special variable)
• *xtypes* (special variable)
• +max-octet-array-length+ (constant)
• compile-reader (function)
• compile-writer (function)
• cyclic-find-if (function)
• cyclic-push (function)
• make-cyclic-buffer (function)
• pad-index (function)
• read-array-padding (function)
• read-boolean (function)
• read-enum (function)
• read-fixed-array (function)
• read-int32 (function)
• read-int64 (function)
• read-octet (function)
• read-octet-array (function)
• read-optional (function)
• read-uint32 (function)
• read-uint64 (function)
• read-xstring (function)
• with-reader/writer (macro)
• write-array-padding (function)
• write-boolean (function)
• write-enum (function)
• write-fixed-array (function)
• write-int32 (function)
• write-int64 (function)
• write-octet (function)
• write-octet-array (function)
• write-optional (function)
• write-uint32 (function)
• write-uint64 (function)
• write-xstring (function)

3.1.5 frpc/rpc.lisp

Dependency

xdr.lisp (file)

Parent

frpc (system)

Location

rpc.lisp

Exported Definitions

• *rpc-host* (special variable)
• *rpc-port* (special variable)
• auth-principal-name (generic function)
• auth-principal-name (method)
• authenticate (generic function)
• authenticate (method)
• authenticate (method)
• define-auth-flavour (macro)
• defprogram (macro)
• find-program (function)
• generate-program-number (function)
• list-all-programs (function)
• make-opaque-auth (function)
• opaque-auth-data (function)
• (setf opaque-auth-data) (function)
• opaque-auth-flavour (function)
• pack-auth-data (generic function)
• pack-auth-data (method)
• pack-auth-data (method)
• program-id (function)
• rpc-client (class)
• rpc-client-auth (generic function)
• rpc-client-auth (method)
• rpc-client-initial (method)
• (setf rpc-client-initial) (method)
• rpc-client-verf (generic function)
• rpc-client-verf (method)
• unpack-auth-data (generic function)
• unpack-auth-data (method)
• unpack-auth-data (method)
• use-rpc-program (macro)
• verify (generic function)
• verify (method)

Internal Definitions

• %define-auth-flavour (function)
• %defprogram (function)
• %read-%opaque-auth (function)
• %read-accepted-reply (function)
• %read-auth-flavour (function)
• %read-call-body (function)
• %read-opaque-auth (function)
• %read-rejected-reply (function)
• %read-reply-body (function)
• %read-rpc-msg (function)
• %write-%opaque-auth (function)
• %write-accepted-reply (function)
• %write-auth-flavour (function)
• %write-call-body (function)
• %write-opaque-auth (function)
• %write-rejected-reply (function)
• %write-reply-body (function)
• %write-rpc-msg (function)
• *auth-flavours* (special variable)
• *default-opaque-auth* (special variable)
• *programs* (special variable)
• *rpc-msgid* (special variable)
• *rpc-program* (special variable)
• *rpc-version* (special variable)
• accepted-reply (structure)
• accepted-reply-p (function)
• accepted-reply-reply-data (function)
• (setf accepted-reply-reply-data) (function)
• accepted-reply-verf (function)
• (setf accepted-reply-verf) (function)
• call-body (structure)
• call-body-auth (function)
• (setf call-body-auth) (function)
• call-body-p (function)
• call-body-proc (function)
• (setf call-body-proc) (function)
• call-body-prog (function)
• (setf call-body-prog) (function)
• call-body-rpcvers (function)
• (setf call-body-rpcvers) (function)
• call-body-verf (function)
• (setf call-body-verf) (function)
• call-body-vers (function)
• (setf call-body-vers) (function)
• copy-accepted-reply (function)
• copy-call-body (function)
• copy-rpc-msg (function)
• make-accepted-reply (function)
• make-call-body (function)
• make-msgid (function)
• make-rpc-msg (function)
• make-rpc-request (function)
• make-rpc-response (function)
• rpc-client-connection (method)
• (setf rpc-client-connection) (method)
• rpc-client-host (method)
• (setf rpc-client-host) (method)
• rpc-client-port (method)
• (setf rpc-client-port) (method)
• rpc-client-program (method)
• (setf rpc-client-program) (method)
• rpc-client-protocol (method)
• (setf rpc-client-protocol) (method)
• rpc-client-timeout (method)
• (setf rpc-client-timeout) (method)
• rpc-client-version (method)
• (setf rpc-client-version) (method)
• rpc-msg (structure)
• rpc-msg-body (function)
• (setf rpc-msg-body) (function)
• rpc-msg-p (function)
• rpc-msg-verifier (function)
• rpc-msg-xid (function)
• (setf rpc-msg-xid) (function)

3.1.6 frpc/unix.lisp

Dependency

rpc.lisp (file)

Parent

frpc (system)

Location

unix.lisp

Exported Definitions

• auth-principal-name (method)
• auth-principal-name (method)
• auth-unix (structure)
• auth-unix-gid (function)
• (setf auth-unix-gid) (function)
• auth-unix-gids (function)
• (setf auth-unix-gids) (function)
• auth-unix-machine-name (function)
• (setf auth-unix-machine-name) (function)
• auth-unix-stamp (function)
• (setf auth-unix-stamp) (function)
• auth-unix-uid (function)
• (setf auth-unix-uid) (function)
• authenticate (method)
• authenticate (method)
• pack-auth-data (method)
• rpc-client-auth (method)
• unix-client (class)
• unix-init (function)
• unpack-auth-data (method)
• verify (method)

Internal Definitions

• %read-auth-unix (function)
• %write-auth-unix (function)
• *unix-contexts* (special variable)
• add-unix-context (function)
• auth-unix-p (function)
• copy-auth-unix (function)
• copy-unix-context (function)
• find-unix-context (function)
• make-auth-unix (function)
• make-unix-context (function)
• unix-client-gid (method)
• (setf unix-client-gid) (method)
• unix-client-gids (method)
• (setf unix-client-gids) (method)
• unix-client-machine-name (method)
• unix-client-nickname (method)
• (setf unix-client-nickname) (method)
• unix-client-uid (method)
• (setf unix-client-uid) (method)
• unix-context (structure)
• unix-context-p (function)
• unix-context-short (function)
• (setf unix-context-short) (function)
• unix-context-unix (function)
• (setf unix-context-unix) (function)

3.1.7 frpc/gss.lisp

Dependency

rpc.lisp (file)

Parent

frpc (system)

Location

gss.lisp

Exported Definitions

• auth-principal-name (method)
• authenticate (method)
• gss-client (class)
• gss-init (function)
• pack-auth-data (method)
• rpc-client-auth (method)
• unpack-auth-data (method)

Internal Definitions

• %read-gss-cred (function)
• %read-gss-init-arg (function)
• %read-gss-init-res (function)
• %read-gss-integ-data (function)
• %read-gss-priv-data (function)
• %write-gss-cred (function)
• %write-gss-init-arg (function)
• %write-gss-init-res (function)
• %write-gss-integ-data (function)
• %write-gss-priv-data (function)
• *gss-contexts* (special variable)
• *server-credentials* (special variable)
• +gss-version+ (constant)
• add-gss-context (function)
• copy-gss-context (function)
• copy-gss-cred (function)
• copy-gss-init-res (function)
• copy-gss-integ-data (function)
• find-gss-context (function)
• gss-authenticate (function)
• gss-authenticate-handle (function)
• gss-client-context (method)
• (setf gss-client-context) (method)
• gss-client-credentials (method)
• (setf gss-client-credentials) (method)
• gss-client-handle (method)
• (setf gss-client-handle) (method)
• gss-client-seqno (method)
• (setf gss-client-seqno) (method)
• gss-client-service (method)
• (setf gss-client-service) (method)
• gss-context (structure)
• gss-context-context (function)
• (setf gss-context-context) (function)
• gss-context-handle (function)
• (setf gss-context-handle) (function)
• gss-context-p (function)
• gss-context-seqno (function)
• (setf gss-context-seqno) (function)
• gss-context-timestamp (function)
• (setf gss-context-timestamp) (function)
• gss-context-window (function)
• (setf gss-context-window) (function)
• gss-cred (structure)
• gss-cred-handle (function)
• (setf gss-cred-handle) (function)
• gss-cred-p (function)
• gss-cred-proc (function)
• (setf gss-cred-proc) (function)
• gss-cred-seqno (function)
• (setf gss-cred-seqno) (function)
• gss-cred-service (function)
• (setf gss-cred-service) (function)
• gss-cred-version (function)
• (setf gss-cred-version) (function)
• gss-init-res (structure)
• gss-init-res-handle (function)
• (setf gss-init-res-handle) (function)
• gss-init-res-major (function)
• (setf gss-init-res-major) (function)
• gss-init-res-minor (function)
• (setf gss-init-res-minor) (function)
• gss-init-res-p (function)
• gss-init-res-token (function)
• (setf gss-init-res-token) (function)
• gss-init-res-window (function)
• (setf gss-init-res-window) (function)
• gss-integ-data (structure)
• gss-integ-data-checksum (function)
• (setf gss-integ-data-checksum) (function)
• gss-integ-data-integ (function)
• (setf gss-integ-data-integ) (function)
• gss-integ-data-p (function)
• make-gss-context (function)
• make-gss-cred (function)
• make-gss-init-res (function)
• make-gss-integ-data (function)
• read-gss-integ (function)
• read-gss-priv (function)
• write-gss-integ (function)
• write-gss-priv (function)

3.1.8 frpc/errors.lisp

Dependency

rpc.lisp (file)

Parent

frpc (system)

Location

errors.lisp

Exported Definitions

• rpc-accept-error (condition)
• rpc-auth-error (condition)
• rpc-error (condition)
• rpc-mismatch-error (condition)
• rpc-prog-mismatch-error (condition)
• rpc-timeout-error (condition)

Internal Definitions

• auth-error-stat (method)
• rpc-accept-error-stat (method)
• rpc-error-description (method)
• rpc-mismatch-error-high (method)
• rpc-mismatch-error-low (method)
• rpc-prog-mismatch-error-high (method)
• rpc-prog-mismatch-error-low (method)

3.1.9 frpc/streams.lisp

Parent

frpc (system)

Location

streams.lisp

Packages

frpc.streams

Exported Definitions

• allocate-buffer (function)
• buffer-stream-buffer (method)
• buffer-stream-position (method)
• (setf buffer-stream-position) (method)
• make-buffer-stream (function)
• with-buffer-stream (macro)

Internal Definitions

• *buffers* (special variable)
• *index* (special variable)
• buffer-stream (class)
• buffer-stream-end (method)
• check-if-open (function)

3.1.10 frpc/client.lisp

Dependencies

• errors.lisp (file)
• streams.lisp (file)
• gss.lisp (file)

Parent

frpc (system)

Location

client.lisp

Exported Definitions

• call-rpc (function)
• defrpc (macro)
• find-handler (function)
• receive-rpc (function)
• rpc-close (function)
• rpc-connect (function)
• send-rpc (function)
• use-rpc-host (macro)
• with-rpc-connection (macro)

Internal Definitions

• %defhandler (function)
• *default-rpc-host* (special variable)
• *default-rpc-port* (special variable)
• *handlers* (special variable)
• broadcast-rpc (function)
• call-rpc-server (function)
• call-rpc-udp (function)
• collect-udp-replies (function)
• defhandler (macro)
• read-fragmented-message (function)
• read-response (function)
• send-rpc-udp (function)
• write-request (function)

3.1.11 frpc/bind.lisp

Dependency

client.lisp (file)

Parent

frpc (system)

Location

bind.lisp

Packages

frpc.bind

Exported Definitions

• add-all-mappings (function)
• add-mapping (function)
• binding (structure)
• binding-addr (function)
• (setf binding-addr) (function)
• binding-netid (function)
• (setf binding-netid) (function)
• binding-owner (function)
• (setf binding-owner) (function)
• binding-program (function)
• (setf binding-program) (function)
• binding-version (function)
• (setf binding-version) (function)
• call-broadcast3 (function)
• call-broadcast4 (function)
• call-callit (function)
• call-dump (function)
• call-dump3 (function)
• call-dump4 (function)
• call-get-addr-list (function)
• call-get-addr3 (function)
• call-get-addr4 (function)
• call-get-port (function)
• call-get-time3 (function)
• call-get-time4 (function)
• call-get-version-addr (function)
• call-indirect (function)
• call-null (function)
• call-null3 (function)
• call-null4 (function)
• call-set (function)
• call-set3 (function)
• call-set4 (function)
• call-stat-by-version (function)
• call-taddr2uaddr3 (function)
• call-taddr2uaddr4 (function)
• call-uaddr2taddr3 (function)
• call-uaddr2taddr4 (function)
• call-unset (function)
• call-unset3 (function)
• call-unset4 (function)
• find-mapping (function)
• make-mapping (function)
• mapping (structure)
• mapping-port (function)
• (setf mapping-port) (function)
• mapping-program (function)
• (setf mapping-program) (function)
• mapping-protocol (function)
• (setf mapping-protocol) (function)
• mapping-version (function)
• (setf mapping-version) (function)
• rem-mapping (function)
• remove-all-mappings (function)

Internal Definitions

• %handle-callit (function)
• %handle-dump (function)
• %handle-get-port (function)
• %handle-null (function)
• %handle-set (function)
• %handle-unset (function)
• %read-binding (function)
• %read-binding-list (function)
• %read-call-broadcast3-arg (function)
• %read-call-broadcast3-res (function)
• %read-call-broadcast4-arg (function)
• %read-call-broadcast4-res (function)
• %read-call-callit-arg (function)
• %read-call-callit-res (function)
• %read-call-dump-arg (function)
• %read-call-dump-res (function)
• %read-call-dump3-arg (function)
• %read-call-dump3-res (function)
• %read-call-dump4-arg (function)
• %read-call-dump4-res (function)
• %read-call-get-addr-list-arg (function)
• %read-call-get-addr-list-res (function)
• %read-call-get-addr3-arg (function)
• %read-call-get-addr3-res (function)
• %read-call-get-addr4-arg (function)
• %read-call-get-addr4-res (function)
• %read-call-get-port-arg (function)
• %read-call-get-port-res (function)
• %read-call-get-time3-arg (function)
• %read-call-get-time3-res (function)
• %read-call-get-time4-arg (function)
• %read-call-get-time4-res (function)
• %read-call-get-version-addr-arg (function)
• %read-call-get-version-addr-res (function)
• %read-call-indirect-arg (function)
• %read-call-indirect-res (function)
• %read-call-null-arg (function)
• %read-call-null-res (function)
• %read-call-null3-arg (function)
• %read-call-null3-res (function)
• %read-call-null4-arg (function)
• %read-call-null4-res (function)
• %read-call-set-arg (function)
• %read-call-set-res (function)
• %read-call-set3-arg (function)
• %read-call-set3-res (function)
• %read-call-set4-arg (function)
• %read-call-set4-res (function)
• %read-call-stat-by-version-arg (function)
• %read-call-stat-by-version-res (function)
• %read-call-taddr2uaddr3-arg (function)
• %read-call-taddr2uaddr3-res (function)
• %read-call-taddr2uaddr4-arg (function)
• %read-call-taddr2uaddr4-res (function)
• %read-call-uaddr2taddr3-arg (function)
• %read-call-uaddr2taddr3-res (function)
• %read-call-uaddr2taddr4-arg (function)
• %read-call-uaddr2taddr4-res (function)
• %read-call-unset-arg (function)
• %read-call-unset-res (function)
• %read-call-unset3-arg (function)
• %read-call-unset3-res (function)
• %read-call-unset4-arg (function)
• %read-call-unset4-res (function)
• %read-mapping (function)
• %read-mapping-list (function)
• %read-netbuf (function)
• %read-rpb-remote-call-res (function)
• %read-rpcb-entry (function)
• %read-rpcb-entry-list (function)
• %read-rpcb-remote-call-arg (function)
• %read-rpcb-stat (function)
• %read-rpcb-stat-byvers (function)
• %read-rpcbs-addr (function)
• %read-rpcbs-addr-list (function)
• %read-rpcbs-proc (function)
• %read-rpcbs-rmtcall (function)
• %read-rpcbs-rmtcall-list (function)
• %write-binding (function)
• %write-binding-list (function)
• %write-call-broadcast3-arg (function)
• %write-call-broadcast3-res (function)
• %write-call-broadcast4-arg (function)
• %write-call-broadcast4-res (function)
• %write-call-callit-arg (function)
• %write-call-callit-res (function)
• %write-call-dump-arg (function)
• %write-call-dump-res (function)
• %write-call-dump3-arg (function)
• %write-call-dump3-res (function)
• %write-call-dump4-arg (function)
• %write-call-dump4-res (function)
• %write-call-get-addr-list-arg (function)
• %write-call-get-addr-list-res (function)
• %write-call-get-addr3-arg (function)
• %write-call-get-addr3-res (function)
• %write-call-get-addr4-arg (function)
• %write-call-get-addr4-res (function)
• %write-call-get-port-arg (function)
• %write-call-get-port-res (function)
• %write-call-get-time3-arg (function)
• %write-call-get-time3-res (function)
• %write-call-get-time4-arg (function)
• %write-call-get-time4-res (function)
• %write-call-get-version-addr-arg (function)
• %write-call-get-version-addr-res (function)
• %write-call-indirect-arg (function)
• %write-call-indirect-res (function)
• %write-call-null-arg (function)
• %write-call-null-res (function)
• %write-call-null3-arg (function)
• %write-call-null3-res (function)
• %write-call-null4-arg (function)
• %write-call-null4-res (function)
• %write-call-set-arg (function)
• %write-call-set-res (function)
• %write-call-set3-arg (function)
• %write-call-set3-res (function)
• %write-call-set4-arg (function)
• %write-call-set4-res (function)
• %write-call-stat-by-version-arg (function)
• %write-call-stat-by-version-res (function)
• %write-call-taddr2uaddr3-arg (function)
• %write-call-taddr2uaddr3-res (function)
• %write-call-taddr2uaddr4-arg (function)
• %write-call-taddr2uaddr4-res (function)
• %write-call-uaddr2taddr3-arg (function)
• %write-call-uaddr2taddr3-res (function)
• %write-call-uaddr2taddr4-arg (function)
• %write-call-uaddr2taddr4-res (function)
• %write-call-unset-arg (function)
• %write-call-unset-res (function)
• %write-call-unset3-arg (function)
• %write-call-unset3-res (function)
• %write-call-unset4-arg (function)
• %write-call-unset4-res (function)
• %write-mapping (function)
• %write-mapping-list (function)
• %write-netbuf (function)
• %write-rpb-remote-call-res (function)
• %write-rpcb-entry (function)
• %write-rpcb-entry-list (function)
• %write-rpcb-remote-call-arg (function)
• %write-rpcb-stat (function)
• %write-rpcb-stat-byvers (function)
• %write-rpcbs-addr (function)
• %write-rpcbs-addr-list (function)
• %write-rpcbs-proc (function)
• %write-rpcbs-rmtcall (function)
• %write-rpcbs-rmtcall-list (function)
• *mappings* (special variable)
• +pmapper-program+ (constant)
• +rpcb-vers-stat+ (constant)
• +rpcbs-highproc+ (constant)
• auth-or-fail (function)
• binding-p (function)
• copy-binding (function)
• copy-mapping (function)
• copy-rpcb-entry (function)
• copy-rpcb-remote-call-arg (function)
• copy-rpcb-stat (function)
• copy-rpcbs-addr (function)
• copy-rpcbs-rmtcall (function)
• generate-mapping-list (function)
• make-binding (function)
• make-rpcb-entry (function)
• make-rpcb-remote-call-arg (function)
• make-rpcb-stat (function)
• make-rpcbs-addr (function)
• make-rpcbs-rmtcall (function)
• mapping-eql (function)
• mapping-p (function)
• rpcb-entry (structure)
• rpcb-entry-maddr (function)
• (setf rpcb-entry-maddr) (function)
• rpcb-entry-netid (function)
• (setf rpcb-entry-netid) (function)
• rpcb-entry-p (function)
• rpcb-entry-proto (function)
• (setf rpcb-entry-proto) (function)
• rpcb-entry-protof (function)
• (setf rpcb-entry-protof) (function)
• rpcb-entry-semantics (function)
• (setf rpcb-entry-semantics) (function)
• rpcb-remote-call-arg (structure)
• rpcb-remote-call-arg-args (function)
• (setf rpcb-remote-call-arg-args) (function)
• rpcb-remote-call-arg-p (function)
• rpcb-remote-call-arg-proc (function)
• (setf rpcb-remote-call-arg-proc) (function)
• rpcb-remote-call-arg-program (function)
• (setf rpcb-remote-call-arg-program) (function)
• rpcb-remote-call-arg-version (function)
• (setf rpcb-remote-call-arg-version) (function)
• rpcb-stat (structure)
• rpcb-stat-addrinfo (function)
• (setf rpcb-stat-addrinfo) (function)
• rpcb-stat-info (function)
• (setf rpcb-stat-info) (function)
• rpcb-stat-p (function)
• rpcb-stat-rmtinfo (function)
• (setf rpcb-stat-rmtinfo) (function)
• rpcb-stat-setinfo (function)
• (setf rpcb-stat-setinfo) (function)
• rpcb-stat-unsetinfo (function)
• (setf rpcb-stat-unsetinfo) (function)
• rpcbs-addr (structure)
• rpcbs-addr-failure (function)
• (setf rpcbs-addr-failure) (function)
• rpcbs-addr-netid (function)
• (setf rpcbs-addr-netid) (function)
• rpcbs-addr-p (function)
• rpcbs-addr-program (function)
• (setf rpcbs-addr-program) (function)
• rpcbs-addr-success (function)
• (setf rpcbs-addr-success) (function)
• rpcbs-addr-version (function)
• (setf rpcbs-addr-version) (function)
• rpcbs-rmtcall (structure)
• rpcbs-rmtcall-failure (function)
• (setf rpcbs-rmtcall-failure) (function)
• rpcbs-rmtcall-indirect (function)
• (setf rpcbs-rmtcall-indirect) (function)
• rpcbs-rmtcall-netid (function)
• (setf rpcbs-rmtcall-netid) (function)
• rpcbs-rmtcall-p (function)
• rpcbs-rmtcall-proc (function)
• (setf rpcbs-rmtcall-proc) (function)
• rpcbs-rmtcall-program (function)
• (setf rpcbs-rmtcall-program) (function)
• rpcbs-rmtcall-success (function)
• (setf rpcbs-rmtcall-success) (function)
• rpcbs-rmtcall-version (function)
• (setf rpcbs-rmtcall-version) (function)

3.1.12 frpc/server.lisp

Dependencies

• client.lisp (file)
• gss.lisp (file)
• bind.lisp (file)

Parent

frpc (system)

Location

server.lisp

Exported Definitions

• *rpc-remote-auth* (special variable)
• *rpc-remote-host* (special variable)
• *rpc-remote-port* (special variable)
• *rpc-remote-protocol* (special variable)
• accept-rpc-request (function)
• default-null-handler (function)
• get-unix-creds (function)
• make-rpc-server (function)
• rpc-auth-principal (function)
• rpc-server (structure)
• rpc-server-tcp-ports (function)
• (setf rpc-server-tcp-ports) (function)
• rpc-server-udp-ports (function)
• (setf rpc-server-udp-ports) (function)
• run-rpc-server (function)
• shutdown-rpc-server (function)
• start-rpc-server (function)
• startup-rpc-server (function)
• stop-rpc-server (function)

Internal Definitions

• %make-rpc-server (function)
• copy-rpc-connection (function)
• copy-rpc-server (function)
• make-rpc-connection (function)
• process-gss-init-command (function)
• process-rpc-auth (function)
• process-rpc-call (function)
• process-rpc-request (function)
• purge-connection-list (function)
• rpc-connection (structure)
• rpc-connection-conn (function)
• (setf rpc-connection-conn) (function)
• rpc-connection-p (function)
• rpc-connection-time (function)
• (setf rpc-connection-time) (function)
• rpc-server-connections (function)
• (setf rpc-server-connections) (function)
• rpc-server-exiting (function)
• (setf rpc-server-exiting) (function)
• rpc-server-p (function)
• rpc-server-programs (function)
• (setf rpc-server-programs) (function)
• rpc-server-tcp-sockets (function)
• (setf rpc-server-tcp-sockets) (function)
• rpc-server-thread (function)
• (setf rpc-server-thread) (function)
• rpc-server-timeout (function)
• (setf rpc-server-timeout) (function)
• rpc-server-udp-sockets (function)
• (setf rpc-server-udp-sockets) (function)
• with-caller-binded (macro)
• write-rpc-response (function)

3.1.13 frpc/extras.lisp

Dependency

bind.lisp (file)

Parent

frpc (system)

Location

extras.lisp

4 Packages

Packages are listed by definition order.

4.1 frpc

Source

package.lisp (file)

Use List

common-lisp

Used By List

frpc.bind

Exported Definitions

• *frpc-log* (special variable)
• *frpc-log-levels* (special variable)
• *frpc-log-path* (special variable)
• *rpc-host* (special variable)
• *rpc-port* (special variable)
• *rpc-remote-auth* (special variable)
• *rpc-remote-host* (special variable)
• *rpc-remote-port* (special variable)
• *rpc-remote-protocol* (special variable)
• accept-rpc-request (function)
• auth-principal-name (generic function)
• auth-principal-name (method)
• auth-principal-name (method)
• auth-principal-name (method)
• auth-principal-name (method)
• auth-unix (structure)
• auth-unix-gid (function)
• (setf auth-unix-gid) (function)
• auth-unix-gids (function)
• (setf auth-unix-gids) (function)
• auth-unix-machine-name (function)
• (setf auth-unix-machine-name) (function)
• auth-unix-stamp (function)
• (setf auth-unix-stamp) (function)
• auth-unix-uid (function)
• (setf auth-unix-uid) (function)
• authenticate (generic function)
• authenticate (method)
• authenticate (method)
• authenticate (method)
• authenticate (method)
• authenticate (method)
• call-rpc (function)
• default-null-handler (function)
• define-auth-flavour (macro)
• defprogram (macro)
• defreader (macro)
• defrpc (macro)
• defwriter (macro)
• defxenum (macro)
• defxstruct (macro)
• defxtype (macro)
• defxtype* (macro)
• defxunion (macro)
• enum (function)
• enump (function)
• find-handler (function)
• find-program (function)
• frpc-log (function)
• generate-program-number (function)
• get-unix-creds (function)
• gss-client (class)
• gss-init (function)
• list-all-programs (function)
• make-opaque-auth (function)
• make-rpc-server (function)
• make-xdr-reader (function)
• make-xdr-writer (function)
• make-xunion (function)
• opaque-auth-data (function)
• (setf opaque-auth-data) (function)
• opaque-auth-flavour (function)
• pack (function)
• pack-auth-data (generic function)
• pack-auth-data (method)
• pack-auth-data (method)
• pack-auth-data (method)
• pack-auth-data (method)
• program-id (function)
• read-xdr-object (function)
• read-xtype (function)
• read-xtype-list (function)
• receive-rpc (function)
• rpc-accept-error (condition)
• rpc-auth-error (condition)
• rpc-auth-principal (function)
• rpc-client (class)
• rpc-client-auth (generic function)
• rpc-client-auth (method)
• rpc-client-auth (method)
• rpc-client-auth (method)
• rpc-client-initial (generic function)
• rpc-client-initial (method)
• (setf rpc-client-initial) (method)
• (setf rpc-client-initial) (generic function)
• rpc-client-verf (generic function)
• rpc-client-verf (method)
• rpc-close (function)
• rpc-connect (function)
• rpc-error (condition)
• rpc-mismatch-error (condition)
• rpc-prog-mismatch-error (condition)
• rpc-server (structure)
• rpc-server-tcp-ports (function)
• (setf rpc-server-tcp-ports) (function)
• rpc-server-udp-ports (function)
• (setf rpc-server-udp-ports) (function)
• rpc-timeout-error (condition)
• run-rpc-server (function)
• send-rpc (function)
• shutdown-rpc-server (function)
• start-rpc-server (function)
• startup-rpc-server (function)
• stop-rpc-server (function)
• unix-client (class)
• unix-init (function)
• unpack (function)
• unpack-auth-data (generic function)
• unpack-auth-data (method)
• unpack-auth-data (method)
• unpack-auth-data (method)
• unpack-auth-data (method)
• use-rpc-host (macro)
• use-rpc-program (macro)
• verify (generic function)
• verify (method)
• verify (method)
• with-reader (macro)
• with-rpc-connection (macro)
• with-writer (macro)
• write-xdr-object (function)
• write-xtype (function)
• write-xtype-list (function)
• xtype-reader (function)
• xtype-writer (function)
• xunion-tag (function)
• xunion-val (function)

Internal Definitions

• %defhandler (function)
• %define-auth-flavour (function)
• %defprogram (function)
• %defxtype (function)
• %make-rpc-server (function)
• %read-%opaque-auth (function)
• %read-accepted-reply (function)
• %read-auth-flavour (function)
• %read-auth-unix (function)
• %read-call-body (function)
• %read-gss-cred (function)
• %read-gss-init-arg (function)
• %read-gss-init-res (function)
• %read-gss-integ-data (function)
• %read-gss-priv-data (function)
• %read-opaque-auth (function)
• %read-real32 (function)
• %read-real64 (function)
• %read-rejected-reply (function)
• %read-reply-body (function)
• %read-rpc-msg (function)
• %read-void (function)
• %write-%opaque-auth (function)
• %write-accepted-reply (function)
• %write-auth-flavour (function)
• %write-auth-unix (function)
• %write-call-body (function)
• %write-gss-cred (function)
• %write-gss-init-arg (function)
• %write-gss-init-res (function)
• %write-gss-integ-data (function)
• %write-gss-priv-data (function)
• %write-opaque-auth (function)
• %write-real32 (function)
• %write-real64 (function)
• %write-rejected-reply (function)
• %write-reply-body (function)
• %write-rpc-msg (function)
• %write-void (function)
• *auth-flavours* (special variable)
• *default-opaque-auth* (special variable)
• *default-rpc-host* (special variable)
• *default-rpc-port* (special variable)
• *enums* (special variable)
• *gss-contexts* (special variable)
• *handlers* (special variable)
• *programs* (special variable)
• *rpc-msgid* (special variable)
• *rpc-program* (special variable)
• *rpc-version* (special variable)
• *server-credentials* (special variable)
• *unix-contexts* (special variable)
• *xtypes* (special variable)
• +gss-version+ (constant)
• +max-octet-array-length+ (constant)
• accepted-reply (structure)
• accepted-reply-p (function)
• accepted-reply-reply-data (function)
• (setf accepted-reply-reply-data) (function)
• accepted-reply-verf (function)
• (setf accepted-reply-verf) (function)
• add-gss-context (function)
• add-unix-context (function)
• auth-error-stat (generic function)
• auth-error-stat (method)
• auth-unix-p (function)
• broadcast-rpc (function)
• call-body (structure)
• call-body-auth (function)
• (setf call-body-auth) (function)
• call-body-p (function)
• call-body-proc (function)
• (setf call-body-proc) (function)
• call-body-prog (function)
• (setf call-body-prog) (function)
• call-body-rpcvers (function)
• (setf call-body-rpcvers) (function)
• call-body-verf (function)
• (setf call-body-verf) (function)
• call-body-vers (function)
• (setf call-body-vers) (function)
• call-rpc-server (function)
• call-rpc-udp (function)
• collect-udp-replies (function)
• compile-reader (function)
• compile-writer (function)
• copy-accepted-reply (function)
• copy-auth-unix (function)
• copy-call-body (function)
• copy-gss-context (function)
• copy-gss-cred (function)
• copy-gss-init-res (function)
• copy-gss-integ-data (function)
• copy-rpc-connection (function)
• copy-rpc-msg (function)
• copy-rpc-server (function)
• copy-unix-context (function)
• cyclic-find-if (function)
• cyclic-push (function)
• defhandler (macro)
• find-gss-context (function)
• find-unix-context (function)
• gss-authenticate (function)
• gss-authenticate-handle (function)
• gss-client-context (generic function)
• gss-client-context (method)
• (setf gss-client-context) (method)
• (setf gss-client-context) (generic function)
• gss-client-credentials (generic function)
• gss-client-credentials (method)
• (setf gss-client-credentials) (method)
• (setf gss-client-credentials) (generic function)
• gss-client-handle (generic function)
• gss-client-handle (method)
• (setf gss-client-handle) (method)
• (setf gss-client-handle) (generic function)
• gss-client-seqno (generic function)
• gss-client-seqno (method)
• (setf gss-client-seqno) (method)
• (setf gss-client-seqno) (generic function)
• gss-client-service (generic function)
• gss-client-service (method)
• (setf gss-client-service) (method)
• (setf gss-client-service) (generic function)
• gss-context (structure)
• gss-context-context (function)
• (setf gss-context-context) (function)
• gss-context-handle (function)
• (setf gss-context-handle) (function)
• gss-context-p (function)
• gss-context-seqno (function)
• (setf gss-context-seqno) (function)
• gss-context-timestamp (function)
• (setf gss-context-timestamp) (function)
• gss-context-window (function)
• (setf gss-context-window) (function)
• gss-cred (structure)
• gss-cred-handle (function)
• (setf gss-cred-handle) (function)
• gss-cred-p (function)
• gss-cred-proc (function)
• (setf gss-cred-proc) (function)
• gss-cred-seqno (function)
• (setf gss-cred-seqno) (function)
• gss-cred-service (function)
• (setf gss-cred-service) (function)
• gss-cred-version (function)
• (setf gss-cred-version) (function)
• gss-init-res (structure)
• gss-init-res-handle (function)
• (setf gss-init-res-handle) (function)
• gss-init-res-major (function)
• (setf gss-init-res-major) (function)
• gss-init-res-minor (function)
• (setf gss-init-res-minor) (function)
• gss-init-res-p (function)
• gss-init-res-token (function)
• (setf gss-init-res-token) (function)
• gss-init-res-window (function)
• (setf gss-init-res-window) (function)
• gss-integ-data (structure)
• gss-integ-data-checksum (function)
• (setf gss-integ-data-checksum) (function)
• gss-integ-data-integ (function)
• (setf gss-integ-data-integ) (function)
• gss-integ-data-p (function)
• make-accepted-reply (function)
• make-auth-unix (function)
• make-call-body (function)
• make-cyclic-buffer (function)
• make-gss-context (function)
• make-gss-cred (function)
• make-gss-init-res (function)
• make-gss-integ-data (function)
• make-msgid (function)
• make-rpc-connection (function)
• make-rpc-msg (function)
• make-rpc-request (function)
• make-rpc-response (function)
• make-unix-context (function)
• pad-index (function)
• process-gss-init-command (function)
• process-rpc-auth (function)
• process-rpc-call (function)
• process-rpc-request (function)
• purge-connection-list (function)
• read-array-padding (function)
• read-boolean (function)
• read-enum (function)
• read-fixed-array (function)
• read-fragmented-message (function)
• read-gss-integ (function)
• read-gss-priv (function)
• read-int32 (function)
• read-int64 (function)
• read-octet (function)
• read-octet-array (function)
• read-optional (function)
• read-response (function)
• read-uint32 (function)
• read-uint64 (function)
• read-xstring (function)
• rpc-accept-error-stat (generic function)
• rpc-accept-error-stat (method)
• rpc-client-connection (generic function)
• rpc-client-connection (method)
• (setf rpc-client-connection) (method)
• (setf rpc-client-connection) (generic function)
• rpc-client-host (generic function)
• rpc-client-host (method)
• (setf rpc-client-host) (method)
• (setf rpc-client-host) (generic function)
• rpc-client-port (generic function)
• rpc-client-port (method)
• (setf rpc-client-port) (method)
• (setf rpc-client-port) (generic function)
• rpc-client-program (generic function)
• rpc-client-program (method)
• (setf rpc-client-program) (method)
• (setf rpc-client-program) (generic function)
• rpc-client-protocol (generic function)
• rpc-client-protocol (method)
• (setf rpc-client-protocol) (method)
• (setf rpc-client-protocol) (generic function)
• rpc-client-timeout (generic function)
• rpc-client-timeout (method)
• (setf rpc-client-timeout) (method)
• (setf rpc-client-timeout) (generic function)
• rpc-client-version (generic function)
• rpc-client-version (method)
• (setf rpc-client-version) (method)
• (setf rpc-client-version) (generic function)
• rpc-connection (structure)
• rpc-connection-conn (function)
• (setf rpc-connection-conn) (function)
• rpc-connection-p (function)
• rpc-connection-time (function)
• (setf rpc-connection-time) (function)
• rpc-error-description (generic function)
• rpc-error-description (method)
• rpc-mismatch-error-high (generic function)
• rpc-mismatch-error-high (method)
• rpc-mismatch-error-low (generic function)
• rpc-mismatch-error-low (method)
• rpc-msg (structure)
• rpc-msg-body (function)
• (setf rpc-msg-body) (function)
• rpc-msg-p (function)
• rpc-msg-verifier (function)
• rpc-msg-xid (function)
• (setf rpc-msg-xid) (function)
• rpc-prog-mismatch-error-high (generic function)
• rpc-prog-mismatch-error-high (method)
• rpc-prog-mismatch-error-low (generic function)
• rpc-prog-mismatch-error-low (method)
• rpc-server-connections (function)
• (setf rpc-server-connections) (function)
• rpc-server-exiting (function)
• (setf rpc-server-exiting) (function)
• rpc-server-p (function)
• rpc-server-programs (function)
• (setf rpc-server-programs) (function)
• rpc-server-tcp-sockets (function)
• (setf rpc-server-tcp-sockets) (function)
• rpc-server-thread (function)
• (setf rpc-server-thread) (function)
• rpc-server-timeout (function)
• (setf rpc-server-timeout) (function)
• rpc-server-udp-sockets (function)
• (setf rpc-server-udp-sockets) (function)
• send-rpc-udp (function)
• unix-client-gid (generic function)
• unix-client-gid (method)
• (setf unix-client-gid) (method)
• (setf unix-client-gid) (generic function)
• unix-client-gids (generic function)
• unix-client-gids (method)
• (setf unix-client-gids) (method)
• (setf unix-client-gids) (generic function)
• unix-client-machine-name (generic function)
• unix-client-machine-name (method)
• unix-client-nickname (generic function)
• unix-client-nickname (method)
• (setf unix-client-nickname) (method)
• (setf unix-client-nickname) (generic function)
• unix-client-uid (generic function)
• unix-client-uid (method)
• (setf unix-client-uid) (method)
• (setf unix-client-uid) (generic function)
• unix-context (structure)
• unix-context-p (function)
• unix-context-short (function)
• (setf unix-context-short) (function)
• unix-context-unix (function)
• (setf unix-context-unix) (function)
• with-caller-binded (macro)
• with-reader/writer (macro)
• write-array-padding (function)
• write-boolean (function)
• write-enum (function)
• write-fixed-array (function)
• write-gss-integ (function)
• write-gss-priv (function)
• write-int32 (function)
• write-int64 (function)
• write-octet (function)
• write-octet-array (function)
• write-optional (function)
• write-request (function)
• write-rpc-response (function)
• write-uint32 (function)
• write-uint64 (function)
• write-xstring (function)

4.2 frpc.streams

Source

streams.lisp (file)

Use List

• trivial-gray-streams
• common-lisp

Exported Definitions

• allocate-buffer (function)
• buffer-stream-buffer (generic function)
• buffer-stream-buffer (method)
• buffer-stream-position (generic function)
• buffer-stream-position (method)
• (setf buffer-stream-position) (method)
• (setf buffer-stream-position) (generic function)
• make-buffer-stream (function)
• with-buffer-stream (macro)

Internal Definitions

• *buffers* (special variable)
• *index* (special variable)
• buffer-stream (class)
• buffer-stream-end (generic function)
• buffer-stream-end (method)
• check-if-open (function)

4.3 frpc.bind

Source

bind.lisp (file)

Use List

• frpc
• common-lisp

Exported Definitions

• add-all-mappings (function)
• add-mapping (function)
• binding (structure)
• binding-addr (function)
• (setf binding-addr) (function)
• binding-netid (function)
• (setf binding-netid) (function)
• binding-owner (function)
• (setf binding-owner) (function)
• binding-program (function)
• (setf binding-program) (function)
• binding-version (function)
• (setf binding-version) (function)
• call-broadcast3 (function)
• call-broadcast4 (function)
• call-callit (function)
• call-dump (function)
• call-dump3 (function)
• call-dump4 (function)
• call-get-addr-list (function)
• call-get-addr3 (function)
• call-get-addr4 (function)
• call-get-port (function)
• call-get-time3 (function)
• call-get-time4 (function)
• call-get-version-addr (function)
• call-indirect (function)
• call-null (function)
• call-null3 (function)
• call-null4 (function)
• call-set (function)
• call-set3 (function)
• call-set4 (function)
• call-stat-by-version (function)
• call-taddr2uaddr3 (function)
• call-taddr2uaddr4 (function)
• call-uaddr2taddr3 (function)
• call-uaddr2taddr4 (function)
• call-unset (function)
• call-unset3 (function)
• call-unset4 (function)
• find-mapping (function)
• make-mapping (function)
• mapping (structure)
• mapping-port (function)
• (setf mapping-port) (function)
• mapping-program (function)
• (setf mapping-program) (function)
• mapping-protocol (function)
• (setf mapping-protocol) (function)
• mapping-version (function)
• (setf mapping-version) (function)
• rem-mapping (function)
• remove-all-mappings (function)

Internal Definitions

• %handle-callit (function)
• %handle-dump (function)
• %handle-get-port (function)
• %handle-null (function)
• %handle-set (function)
• %handle-unset (function)
• %read-binding (function)
• %read-binding-list (function)
• %read-call-broadcast3-arg (function)
• %read-call-broadcast3-res (function)
• %read-call-broadcast4-arg (function)
• %read-call-broadcast4-res (function)
• %read-call-callit-arg (function)
• %read-call-callit-res (function)
• %read-call-dump-arg (function)
• %read-call-dump-res (function)
• %read-call-dump3-arg (function)
• %read-call-dump3-res (function)
• %read-call-dump4-arg (function)
• %read-call-dump4-res (function)
• %read-call-get-addr-list-arg (function)
• %read-call-get-addr-list-res (function)
• %read-call-get-addr3-arg (function)
• %read-call-get-addr3-res (function)
• %read-call-get-addr4-arg (function)
• %read-call-get-addr4-res (function)
• %read-call-get-port-arg (function)
• %read-call-get-port-res (function)
• %read-call-get-time3-arg (function)
• %read-call-get-time3-res (function)
• %read-call-get-time4-arg (function)
• %read-call-get-time4-res (function)
• %read-call-get-version-addr-arg (function)
• %read-call-get-version-addr-res (function)
• %read-call-indirect-arg (function)
• %read-call-indirect-res (function)
• %read-call-null-arg (function)
• %read-call-null-res (function)
• %read-call-null3-arg (function)
• %read-call-null3-res (function)
• %read-call-null4-arg (function)
• %read-call-null4-res (function)
• %read-call-set-arg (function)
• %read-call-set-res (function)
• %read-call-set3-arg (function)
• %read-call-set3-res (function)
• %read-call-set4-arg (function)
• %read-call-set4-res (function)
• %read-call-stat-by-version-arg (function)
• %read-call-stat-by-version-res (function)
• %read-call-taddr2uaddr3-arg (function)
• %read-call-taddr2uaddr3-res (function)
• %read-call-taddr2uaddr4-arg (function)
• %read-call-taddr2uaddr4-res (function)
• %read-call-uaddr2taddr3-arg (function)
• %read-call-uaddr2taddr3-res (function)
• %read-call-uaddr2taddr4-arg (function)
• %read-call-uaddr2taddr4-res (function)
• %read-call-unset-arg (function)
• %read-call-unset-res (function)
• %read-call-unset3-arg (function)
• %read-call-unset3-res (function)
• %read-call-unset4-arg (function)
• %read-call-unset4-res (function)
• %read-mapping (function)
• %read-mapping-list (function)
• %read-netbuf (function)
• %read-rpb-remote-call-res (function)
• %read-rpcb-entry (function)
• %read-rpcb-entry-list (function)
• %read-rpcb-remote-call-arg (function)
• %read-rpcb-stat (function)
• %read-rpcb-stat-byvers (function)
• %read-rpcbs-addr (function)
• %read-rpcbs-addr-list (function)
• %read-rpcbs-proc (function)
• %read-rpcbs-rmtcall (function)
• %read-rpcbs-rmtcall-list (function)
• %write-binding (function)
• %write-binding-list (function)
• %write-call-broadcast3-arg (function)
• %write-call-broadcast3-res (function)
• %write-call-broadcast4-arg (function)
• %write-call-broadcast4-res (function)
• %write-call-callit-arg (function)
• %write-call-callit-res (function)
• %write-call-dump-arg (function)
• %write-call-dump-res (function)
• %write-call-dump3-arg (function)
• %write-call-dump3-res (function)
• %write-call-dump4-arg (function)
• %write-call-dump4-res (function)
• %write-call-get-addr-list-arg (function)
• %write-call-get-addr-list-res (function)
• %write-call-get-addr3-arg (function)
• %write-call-get-addr3-res (function)
• %write-call-get-addr4-arg (function)
• %write-call-get-addr4-res (function)
• %write-call-get-port-arg (function)
• %write-call-get-port-res (function)
• %write-call-get-time3-arg (function)
• %write-call-get-time3-res (function)
• %write-call-get-time4-arg (function)
• %write-call-get-time4-res (function)
• %write-call-get-version-addr-arg (function)
• %write-call-get-version-addr-res (function)
• %write-call-indirect-arg (function)
• %write-call-indirect-res (function)
• %write-call-null-arg (function)
• %write-call-null-res (function)
• %write-call-null3-arg (function)
• %write-call-null3-res (function)
• %write-call-null4-arg (function)
• %write-call-null4-res (function)
• %write-call-set-arg (function)
• %write-call-set-res (function)
• %write-call-set3-arg (function)
• %write-call-set3-res (function)
• %write-call-set4-arg (function)
• %write-call-set4-res (function)
• %write-call-stat-by-version-arg (function)
• %write-call-stat-by-version-res (function)
• %write-call-taddr2uaddr3-arg (function)
• %write-call-taddr2uaddr3-res (function)
• %write-call-taddr2uaddr4-arg (function)
• %write-call-taddr2uaddr4-res (function)
• %write-call-uaddr2taddr3-arg (function)
• %write-call-uaddr2taddr3-res (function)
• %write-call-uaddr2taddr4-arg (function)
• %write-call-uaddr2taddr4-res (function)
• %write-call-unset-arg (function)
• %write-call-unset-res (function)
• %write-call-unset3-arg (function)
• %write-call-unset3-res (function)
• %write-call-unset4-arg (function)
• %write-call-unset4-res (function)
• %write-mapping (function)
• %write-mapping-list (function)
• %write-netbuf (function)
• %write-rpb-remote-call-res (function)
• %write-rpcb-entry (function)
• %write-rpcb-entry-list (function)
• %write-rpcb-remote-call-arg (function)
• %write-rpcb-stat (function)
• %write-rpcb-stat-byvers (function)
• %write-rpcbs-addr (function)
• %write-rpcbs-addr-list (function)
• %write-rpcbs-proc (function)
• %write-rpcbs-rmtcall (function)
• %write-rpcbs-rmtcall-list (function)
• *mappings* (special variable)
• +pmapper-program+ (constant)
• +rpcb-vers-stat+ (constant)
• +rpcbs-highproc+ (constant)
• auth-or-fail (function)
• binding-p (function)
• copy-binding (function)
• copy-mapping (function)
• copy-rpcb-entry (function)
• copy-rpcb-remote-call-arg (function)
• copy-rpcb-stat (function)
• copy-rpcbs-addr (function)
• copy-rpcbs-rmtcall (function)
• generate-mapping-list (function)
• make-binding (function)
• make-rpcb-entry (function)
• make-rpcb-remote-call-arg (function)
• make-rpcb-stat (function)
• make-rpcbs-addr (function)
• make-rpcbs-rmtcall (function)
• mapping-eql (function)
• mapping-p (function)
• rpcb-entry (structure)
• rpcb-entry-maddr (function)
• (setf rpcb-entry-maddr) (function)
• rpcb-entry-netid (function)
• (setf rpcb-entry-netid) (function)
• rpcb-entry-p (function)
• rpcb-entry-proto (function)
• (setf rpcb-entry-proto) (function)
• rpcb-entry-protof (function)
• (setf rpcb-entry-protof) (function)
• rpcb-entry-semantics (function)
• (setf rpcb-entry-semantics) (function)
• rpcb-remote-call-arg (structure)
• rpcb-remote-call-arg-args (function)
• (setf rpcb-remote-call-arg-args) (function)
• rpcb-remote-call-arg-p (function)
• rpcb-remote-call-arg-proc (function)
• (setf rpcb-remote-call-arg-proc) (function)
• rpcb-remote-call-arg-program (function)
• (setf rpcb-remote-call-arg-program) (function)
• rpcb-remote-call-arg-version (function)
• (setf rpcb-remote-call-arg-version) (function)
• rpcb-stat (structure)
• rpcb-stat-addrinfo (function)
• (setf rpcb-stat-addrinfo) (function)
• rpcb-stat-info (function)
• (setf rpcb-stat-info) (function)
• rpcb-stat-p (function)
• rpcb-stat-rmtinfo (function)
• (setf rpcb-stat-rmtinfo) (function)
• rpcb-stat-setinfo (function)
• (setf rpcb-stat-setinfo) (function)
• rpcb-stat-unsetinfo (function)
• (setf rpcb-stat-unsetinfo) (function)
• rpcbs-addr (structure)
• rpcbs-addr-failure (function)
• (setf rpcbs-addr-failure) (function)
• rpcbs-addr-netid (function)
• (setf rpcbs-addr-netid) (function)
• rpcbs-addr-p (function)
• rpcbs-addr-program (function)
• (setf rpcbs-addr-program) (function)
• rpcbs-addr-success (function)
• (setf rpcbs-addr-success) (function)
• rpcbs-addr-version (function)
• (setf rpcbs-addr-version) (function)
• rpcbs-rmtcall (structure)
• rpcbs-rmtcall-failure (function)
• (setf rpcbs-rmtcall-failure) (function)
• rpcbs-rmtcall-indirect (function)
• (setf rpcbs-rmtcall-indirect) (function)
• rpcbs-rmtcall-netid (function)
• (setf rpcbs-rmtcall-netid) (function)
• rpcbs-rmtcall-p (function)
• rpcbs-rmtcall-proc (function)
• (setf rpcbs-rmtcall-proc) (function)
• rpcbs-rmtcall-program (function)
• (setf rpcbs-rmtcall-program) (function)
• rpcbs-rmtcall-success (function)
• (setf rpcbs-rmtcall-success) (function)
• rpcbs-rmtcall-version (function)
• (setf rpcbs-rmtcall-version) (function)

5 Definitions

Definitions are sorted by export status, category, package, and then by lexicographic order.

5.1 Exported definitions

5.1.1 Special variables

Special Variable: *frpc-log*

The log to write messages to. Gets opened on the first call to FRPC-LOG.

Package

frpc

Source

log.lisp (file)

Special Variable: *frpc-log-levels*

Package

frpc

Source

log.lisp (file)

Special Variable: *frpc-log-path*

The path to the log file. If this is NIL then no log will be opened, no logging will be performed.

Package

frpc

Source

log.lisp (file)

Special Variable: *rpc-host*

Package

frpc

Source

rpc.lisp (file)

Special Variable: *rpc-port*

Package

frpc

Source

rpc.lisp (file)

Special Variable: *rpc-remote-auth*

Package

frpc

Source

server.lisp (file)

Special Variable: *rpc-remote-host*

Package

frpc

Source

server.lisp (file)

Special Variable: *rpc-remote-port*

Package

frpc

Source

server.lisp (file)

Special Variable: *rpc-remote-protocol*

Package

frpc

Source

server.lisp (file)

5.1.2 Macros

Macro: define-auth-flavour NAME VAL

Package

frpc

Source

rpc.lisp (file)

Macro: defprogram NAME NUMBER

Define a program identifier mapping.
NAME ::= a symbol naming the program.
NUMBER ::= a positive integer specifying the program number.

Package

frpc

Source

rpc.lisp (file)

Macro: defreader NAME SPEC

Package

frpc

Source

xdr.lisp (file)

Macro: defrpc NAME PROC ARG-TYPE RESULT-TYPE &rest OPTIONS

Declare an RPC interface and define a client function that invokes CALL-RPC. This must be defined before a partner DEFHANDLER form.

NAME should be a symbol naming the client function to be defined.

PROC should be an integer or constant form.

ARG-TYPE and RESULT-TYPE should be XDR type specification forms.

By default the generated function will accept a single argument which must match the type specifed by the ARG-TYPE.

OPTIONS allow customization of the generated client function:

(:program program version) PROGRAM and VERSION name the program name/number and the version number.

(:arg-transformer lambda-list &body body) makes it possible to augment the default function parameters before passing them to CALL-RPC. The body should return a value matching the type specified by ARG-TYPE.

(:transformer (var) &body body) runs after CALL-RPC has returned with VAR bound to the result. This makes it possible to destructure the result object.

(:documentation doc-string) specifies the docu-string for the client function.

(:handler function-designator) specifies a server handler for the rpc. It should designate a function of a single parameter.

Package

frpc

Source

client.lisp (file)

Macro: defwriter NAME SPEC

Package

frpc

Source

xdr.lisp (file)

Macro: defxenum NAME &rest SLOTS

Package

frpc

Source

xdr.lisp (file)

Macro: defxstruct NAME-AND-OPTIONS OPTIONS &rest SLOTS

Package

frpc

Source

xdr.lisp (file)

Macro: defxtype NAME (&rest OPTIONS) ((READER-STREAM) &body READER-BODY) ((WRITER-STREAM OBJ) &body WRITER-BODY)

Package

frpc

Source

xdr.lisp (file)

Macro: defxtype* NAME OPTIONS SPEC

Package

frpc

Source

xdr.lisp (file)

Macro: defxunion NAME (ENUM &rest OPTIONS) &rest ARMS

Package

frpc

Source

xdr.lisp (file)

Macro: use-rpc-host HOST PORT

Package

frpc

Source

client.lisp (file)

Macro: use-rpc-program PROGRAM VERSION

Package

frpc

Source

rpc.lisp (file)

Macro: with-buffer-stream (VAR BUFFER &key START END) &body BODY

Execute the body in the context of a buffer stream. Returns the number of bytes written to the buffer.

Package

frpc.streams

Source

streams.lisp (file)

Macro: with-reader (VAR SPEC) &body BODY

Package

frpc

Source

xdr.lisp (file)

Macro: with-rpc-connection (VAR HOST PORT &optional PROTOCOL) &body BODY

Execute the body in the context of a connection.

Package

frpc

Source

client.lisp (file)

Macro: with-writer (VAR SPEC) &body BODY

Package

frpc

Source

xdr.lisp (file)

5.1.3 Functions

Function: accept-rpc-request SERVER &key TIMEOUT

Accept and process a single RPC request.

SERVER ::= an RPC-SERVER instance that has been started, by first calling STARTUP-RPC-SERVER. TIMEOUT ::= timeout in seconds to wait for the request. NIL implies waiting indefinitely.

No meaningful return value.

Package

frpc

Source

server.lisp (file)

Function: add-all-mappings TCP-PORTS UDP-PORTS &key RPC PROGRAMS

Package

frpc.bind

Source

bind.lisp (file)

Function: add-mapping MAPPING

Add a port mapping.

Package

frpc.bind

Source

bind.lisp (file)

Function: allocate-buffer ()

Returns one of a set of statically allocated buffers. Cycles round after a few calls.

Package

frpc.streams

Source

streams.lisp (file)

Function: auth-unix-gid INSTANCE

Function: (setf auth-unix-gid) VALUE INSTANCE

Package

frpc

Source

unix.lisp (file)

Function: auth-unix-gids INSTANCE

Function: (setf auth-unix-gids) VALUE INSTANCE

Package

frpc

Source

unix.lisp (file)

Function: auth-unix-machine-name INSTANCE

Function: (setf auth-unix-machine-name) VALUE INSTANCE

Package

frpc

Source

unix.lisp (file)

Function: auth-unix-stamp INSTANCE

Function: (setf auth-unix-stamp) VALUE INSTANCE

Package

frpc

Source

unix.lisp (file)

Function: auth-unix-uid INSTANCE

Function: (setf auth-unix-uid) VALUE INSTANCE

Package

frpc

Source

unix.lisp (file)

Function: binding-addr INSTANCE

Function: (setf binding-addr) VALUE INSTANCE

Package

frpc.bind

Source

bind.lisp (file)

Function: binding-netid INSTANCE

Function: (setf binding-netid) VALUE INSTANCE

Package

frpc.bind

Source

bind.lisp (file)

Function: binding-owner INSTANCE

Function: (setf binding-owner) VALUE INSTANCE

Package

frpc.bind

Source

bind.lisp (file)

Function: binding-program INSTANCE

Function: (setf binding-program) VALUE INSTANCE

Package

frpc.bind

Source

bind.lisp (file)

Function: binding-version INSTANCE

Function: (setf binding-version) VALUE INSTANCE

Package

frpc.bind

Source

bind.lisp (file)

Function: call-broadcast3 ARG &key HOST PORT PROTOCOL TIMEOUT CONNECTION CLIENT

Package

frpc.bind

Source

bind.lisp (file)

Function: call-broadcast4 ARG &key HOST PORT PROTOCOL TIMEOUT CONNECTION CLIENT

Package

frpc.bind

Source

bind.lisp (file)

Function: call-callit PROGRAM VERSION PROC PACKED-ARGS &key HOST PORT PROTOCOL TIMEOUT CONNECTION CLIENT

Execute an RPC via the remote port mapper proxy. Returns (list PORT RES) where RES is an opaque array of the packed result. The result needs to be extracted using FRPC:UNPACK. The result type is recommended to be a well-defined type, i.e. represented by a symbol, so that it has an easy reader function available.

Package

frpc.bind

Source

bind.lisp (file)

Function: call-dump &key HOST PORT PROTOCOL TIMEOUT CONNECTION CLIENT

List all available port mappings.

Package

frpc.bind

Source

bind.lisp (file)

Function: call-dump3 &key HOST PORT PROTOCOL TIMEOUT CONNECTION CLIENT

Package

frpc.bind

Source

bind.lisp (file)

Function: call-dump4 &key HOST PORT PROTOCOL TIMEOUT CONNECTION CLIENT

Package

frpc.bind

Source

bind.lisp (file)

Function: call-get-addr-list ARG &key HOST PORT PROTOCOL TIMEOUT CONNECTION CLIENT

Package

frpc.bind

Source

bind.lisp (file)

Function: call-get-addr3 ARG &key HOST PORT PROTOCOL TIMEOUT CONNECTION CLIENT

Package

frpc.bind

Source

bind.lisp (file)

Function: call-get-addr4 ARG &key HOST PORT PROTOCOL TIMEOUT CONNECTION CLIENT

Package

frpc.bind

Source

bind.lisp (file)

Function: call-get-port PROGRAM &key QUERY-PROTOCOL HOST PORT PROTOCOL TIMEOUT CONNECTION CLIENT

Query the port for the specified program.

Package

frpc.bind

Source

bind.lisp (file)

Function: call-get-time3 &key HOST PORT PROTOCOL TIMEOUT CONNECTION CLIENT

Package

frpc.bind

Source

bind.lisp (file)

Function: call-get-time4 &key HOST PORT PROTOCOL TIMEOUT CONNECTION CLIENT

Package

frpc.bind

Source

bind.lisp (file)

Function: call-get-version-addr ARG &key HOST PORT PROTOCOL TIMEOUT CONNECTION CLIENT

Package

frpc.bind

Source

bind.lisp (file)

Function: call-indirect ARG &key HOST PORT PROTOCOL TIMEOUT CONNECTION CLIENT

Package

frpc.bind

Source

bind.lisp (file)

Function: call-null &key HOST PORT PROTOCOL TIMEOUT CONNECTION CLIENT

Package

frpc.bind

Source

bind.lisp (file)

Function: call-null3 &key HOST PORT PROTOCOL TIMEOUT CONNECTION CLIENT

Package

frpc.bind

Source

bind.lisp (file)

Function: call-null4 &key HOST PORT PROTOCOL TIMEOUT CONNECTION CLIENT

Package

frpc.bind

Source

bind.lisp (file)

Function: call-rpc ARG-TYPE ARG RESULT-TYPE &key HOST PORT PROGRAM VERSION PROC AUTH VERF REQUEST-ID PROTOCOL TIMEOUT CONNECTION CLIENT

Establish a connection and execute an RPC to a remote machine. Returns the value decoded by the RESULT-TYPE.
This function will block until a reply is received or the request times out.

ARG-TYPE should be either a writer function or a symbol naming a valid XTYPE.

ARG should be a value which can be passed to the ARG-TYPE function.

RESULT-TYPE should be either a reader function or a symbol naming a valid XTYPE.

HOST and PORT name the server to send the message to.

PROGRAM, VERSION and PROC define the RPC procedure to call.

If provided, AUTH and VERF should be OPAQUE-AUTH structures, as returned from MAKE-OPAQUE-AUTH. These are used to authenticate the request. Note: do not use these unless you understand what you are doing.
The easy way to authenticate requests is to provide a CLIENT parameter (see below).

If provided, REQUEST-ID should be an integer specifying the message ID to use. If not provided an incrementing seqno will be used. Generally there is no reason for users to provide this parameter.

If TIMEOUT is specified, it will be set as the RECEIVE-TIMEOUT (is using TCP) or to time to wait for UDP responses.

PROTOCOL should be :TCP, :UDP or :BROADCAST. :UDP is the default, and will block until TIMEOUT seconds for a reply
and will raise an RPC-TIMEOUT-ERROR if it doesn’t receive one. Specify TIMEOUT to NIL to return immediately and not await
a response.
:TCP will block until a response it received.
:BROADCAST should be used for UDP broadcasts. The client will wait for up to TIMEOUT seconds and collect all the repsonses received in that time. Note that it will return a list of (host port result) instead of just the result.

CONNECTION should be a TCP or UDP connection, as returned by RPC-CONNECT.

CLIENT should be an instance of RPC-CLIENT or its subclasses. This is the ONLY way to authenticate calls.

Package

frpc

Source

client.lisp (file)

Function: call-set MAPPING &key HOST PORT PROTOCOL TIMEOUT CONNECTION CLIENT

Set a port mapping.

Package

frpc.bind

Source

bind.lisp (file)

Function: call-set3 ARG &key HOST PORT PROTOCOL TIMEOUT CONNECTION CLIENT

Package

frpc.bind

Source

bind.lisp (file)

Function: call-set4 ARG &key HOST PORT PROTOCOL TIMEOUT CONNECTION CLIENT

Package

frpc.bind

Source

bind.lisp (file)

Function: call-stat-by-version &key HOST PORT PROTOCOL TIMEOUT CONNECTION CLIENT

Package

frpc.bind

Source

bind.lisp (file)

Function: call-taddr2uaddr3 ARG &key HOST PORT PROTOCOL TIMEOUT CONNECTION CLIENT

Package

frpc.bind

Source

bind.lisp (file)

Function: call-taddr2uaddr4 ARG &key HOST PORT PROTOCOL TIMEOUT CONNECTION CLIENT

Package

frpc.bind

Source

bind.lisp (file)

Function: call-uaddr2taddr3 ARG &key HOST PORT PROTOCOL TIMEOUT CONNECTION CLIENT

Package

frpc.bind

Source

bind.lisp (file)

Function: call-uaddr2taddr4 ARG &key HOST PORT PROTOCOL TIMEOUT CONNECTION CLIENT

Package

frpc.bind

Source

bind.lisp (file)

Function: call-unset MAPPING &key HOST PORT PROTOCOL TIMEOUT CONNECTION CLIENT

Remove a port mapping.

Package

frpc.bind

Source

bind.lisp (file)

Function: call-unset3 ARG &key HOST PORT PROTOCOL TIMEOUT CONNECTION CLIENT

Package

frpc.bind

Source

bind.lisp (file)

Function: call-unset4 ARG &key HOST PORT PROTOCOL TIMEOUT CONNECTION CLIENT

Package

frpc.bind

Source

bind.lisp (file)

Function: default-null-handler VOID

Package

frpc

Source

server.lisp (file)

Function: enum ENUM SLOT

Package

frpc

Source

xdr.lisp (file)

Function: enump ENUM-TYPE

Package

frpc

Source

xdr.lisp (file)

Function: find-handler &optional PROGRAM VERSION PROC

Look up the handler(s) for the given PROGRAM, VERSION and PROC IDs.

Package

frpc

Source

client.lisp (file)

Function: find-mapping MAPPING &optional MAP-PORT

Lookup a port mapping matching the program, version and protocol specified in the mapping structure. if MAP-PORT is provided, will also match this port.

Package

frpc.bind

Source

bind.lisp (file)

Function: find-program ID

Lookup the program identifier. The type of ID changes behaviour: Integer: the program with a this program number is returned.
String: the first program with a case-insensitive program name is returned. Symbol: the program with a matching symbol name is returned.

In all cases returns a list of (name number) or nil if not found.

Package

frpc

Source

rpc.lisp (file)

Function: frpc-log LVL CONTROL-STRING &rest ARGS

Write a message to the debug log.

Package

frpc

Source

log.lisp (file)

Function: generate-program-number &optional TRANSIENT

Generate a program identifier in the user-defined range, as specified by the RFC.
If TRANSIENT is true, a runtime program number is generated. These should be used by programs which need to generate program numbers at runtime.

Package

frpc

Source

rpc.lisp (file)

Function: get-unix-creds &optional AUTH

Get the UNIX credentials from this authenticator. Returns the AUTH-UNIX associated with this authenticator if it is of type :AUTH-UNIX or :AUTH-SHORT. Returns nil if could not be found.

Package

frpc

Source

server.lisp (file)

Function: gss-init &optional MAX-CONTEXTS

Setup the application server’s GSS support.

Package

frpc

Source

gss.lisp (file)

Function: list-all-programs ()

List all known program mappings.

Package

frpc

Source

rpc.lisp (file)

Function: make-buffer-stream BUFFER &key START END

Package

frpc.streams

Source

streams.lisp (file)

Function: make-mapping &key (PROGRAM PROGRAM) (VERSION VERSION) (PROTOCOL PROTOCOL) (PORT PORT)

Package

frpc.bind

Source

bind.lisp (file)

Function: make-opaque-auth FLAVOUR DATA

Package

frpc

Source

rpc.lisp (file)

Function: make-rpc-server &key UDP-PORTS TCP-PORTS PROGRAMS TIMEOUT

Make an RPC server instance.

PROGRAMS should be a list of program numbers to be accepted by the server,
all RPC requests for programs not in this list will be rejected.
If not supplied all program requests are accepted.

UDP-PORTS and TCP-PORTS should each be a list of integers, specifying the ports
to listen on. If USOCKET:*WILDCARD-PORT* is supplied, a random unused port will be selected. These lists will be replaced with the ports actually used once the server starts.

TIMEOUT specifies the duration (in seconds) that a TCP connection should remain open.

Package

frpc

Source

server.lisp (file)

Function: make-xdr-reader SPEC

Returns a function which can read the object specified by the SPEC.

Package

frpc

Source

xdr.lisp (file)

Function: make-xdr-writer SPEC

Returns a function which can write an object of the specified SPEC.

Package

frpc

Source

xdr.lisp (file)

Function: make-xunion TAG VAL

Package

frpc

Source

xdr.lisp (file)

Function: mapping-port INSTANCE

Function: (setf mapping-port) VALUE INSTANCE

Package

frpc.bind

Source

bind.lisp (file)

Function: mapping-program INSTANCE

Function: (setf mapping-program) VALUE INSTANCE

Package

frpc.bind

Source

bind.lisp (file)

Function: mapping-protocol INSTANCE

Function: (setf mapping-protocol) VALUE INSTANCE

Package

frpc.bind

Source

bind.lisp (file)

Function: mapping-version INSTANCE

Function: (setf mapping-version) VALUE INSTANCE

Package

frpc.bind

Source

bind.lisp (file)

Function: opaque-auth-data AUTH

Function: (setf opaque-auth-data) VALUE AUTH

Package

frpc

Source

rpc.lisp (file)

Function: opaque-auth-flavour AUTH

Package

frpc

Source

rpc.lisp (file)

Function: pack WRITER OBJ

Write the object into an octet-buffer.

Package

frpc

Source

xdr.lisp (file)

Function: program-id ID

Lookup the program name or number.

Package

frpc

Source

rpc.lisp (file)

Function: read-xdr-object STREAM SPEC

Read an XDR serialized object from the stream.
This function is the runtime equivalent of the functions produced by DEFREADER.
STREAM ::= binary input stream.
SPEC ::= XDR type specification.

Returns the parsed object.

Package

frpc

Source

xdr.lisp (file)

Function: read-xtype TYPE STREAM

Package

frpc

Source

xdr.lisp (file)

Function: read-xtype-list STREAM TYPE

A useful utility function to read a list-type object. I.e. a type which consists of a structure followed by an optional next structure, e.g. (defxstruct a (x :int32) (y :int32) (next (:optional a)))

Package

frpc

Source

xdr.lisp (file)

Function: receive-rpc CLIENT RES-TYPE

Waits for an RPC reply. If the TIMEOUT slot of the client is set then will wait for TIMEOUT seconds, otherwise waits indefinitely.

CLIENT ::= an RPC-CLIENT instance.
The client MUST have its CONNECTION slot set.

RES-TYPE ::= reader function or symbol naming an XDR type.

Returns (values result xid) where XID is the transaction ID of the
reply received. This should be used to match up replies with requests
sent from SEND-RPC.

Package

frpc

Source

client.lisp (file)

Function: rem-mapping MAPPING

Remove a port mapping.

Package

frpc.bind

Source

bind.lisp (file)

Function: remove-all-mappings TCP-PORTS UDP-PORTS &key RPC PROGRAMS

Package

frpc.bind

Source

bind.lisp (file)

Function: rpc-auth-principal &optional AUTH

Returns a string representing the authenticated caller, or nil if none available.

Package

frpc

Source

server.lisp (file)

Function: rpc-close CONN

Close the connection to the server.

Package

frpc

Source

client.lisp (file)

Function: rpc-connect HOST PORT &optional PROTOCOL

Establish a connection to the rpc server. MUST be closed with a call to RPC-CLOSE.

Package

frpc

Source

client.lisp (file)