Function | Package: net.rpc | ToC | DocOverview | CGDoc | RelNotes | FAQ | Index | PermutedIndex
| Allegro CL version 9.0 Unrevised from 8.2 to 9.0. 8.2 version

## rpc-open-p

Arguments: &optional port-or-server verify verbose

This function reports on the state of one or more rpc ports and/or servers. The verbose argument causes output to be printed to the console. The verify argument, when non-`nil`, causes a connection to be verified with a round-trip message. When the first argument is `nil`, this function reports on the state of the default port. The return value depends on argument values.

When the first argument is a datagram port instance, this method will normally return `:idle`.

When the first argument is an `rpc-port` instance, this function returns two values:

- the state of the port - one of the keywords :idle :connected or `:closed` or some other keywords denoting short-lived connect and disconnect states. If the connection was verified, this value is `:verified`.
- a list of the form (home state role local-port remote-host remote-port).

When the first argument is a server instance, the value is a list of the form `(server-home-name :listening local-port p1 p2 ... )` where p1... are lists describing any ports derived from this server.

When the first argument is `:all`, the value is a list of the form `(s1 s2 ... [clients])` where s1... are reports for all known server instances. The client's entry is there if there are any client ports present. It is a list of the form `(:client-ports nil p1 p2 ... )`.

When the first argument is a string or symbol, the value returned is the `rpc-port-server` instance, or the `rpc-port` instance with that home name. All port instances are identified by their unique local home name.

See also rpc.htm for general information on the Remote Procedure Call utility in Allegro CL.

Copyright (c) 1998-2019, Franz Inc. Oakland, CA., USA. All rights reserved.
This page was not revised from the 8.2 page.
Created 2012.5.30.

|  | ToC | DocOverview | CGDoc | RelNotes | FAQ | Index | PermutedIndex
| Allegro CL version 9.0 Unrevised from 8.2 to 9.0. 8.2 version