diff options
author | Russ Allbery <rra@stanford.edu> | 2011-09-26 16:39:25 -0700 |
---|---|---|
committer | Russ Allbery <rra@stanford.edu> | 2011-09-26 16:39:25 -0700 |
commit | d27cab3132eef0f614efbe7208cab265cf8e281d (patch) | |
tree | 96c4315cc2980257b20a0c752987ad07d3cb901b /php | |
parent | 921e6cf0356ded77fc47933448bff96f9d8c6401 (diff) |
Documentation updates for set_ccache
Add documentation to the PHP and Python README files, and document
in the Perl Net::Remctl POD documentation that not all GSS-API
implementations support this. Also note the return value from the
set_* functions in more places.
Diffstat (limited to 'php')
-rw-r--r-- | php/README | 23 |
1 files changed, 22 insertions, 1 deletions
@@ -109,12 +109,33 @@ FULL INTERFACE Returns, as a string, the error message from the last failed operation on the connection object CONNECTION. + remctl_set_ccache(CCACHE) + Sets the credential cache for outgoing connections to CCACHE. This + is normally the full path to a Kerberos ticket cache, but may have + other valid forms depending on the underlying Kerberos + implementation in use by GSS-API. This method must be called prior + to calling remctl_open() and will affect all subsequent + remctl_open() calls on the same object. Returns true on success, + false on failure. + + For current GSS-API implementations, this will affect not only all + subsequent open() calls for the same object, but all subsequent + remctl connections of any kind from the same process, and even other + GSS-API connections from the same process unrelated to remctl. This + is due to a limitation in the GSS-API that makes this setting a + global setting for the process or thread. + + Not all GSS-API implementations support setting the credential + cache. If this is not supported, false (for failure) will be + returned. + remctl_set_source_ip(SOURCE) Sets the source IP for outgoing connections to SOURCE, which can be either an IPv4 or an IPv6 address (if IPv6 is supported). It must be an IP address, not a host name. This method must be called prior to calling remctl_open() and will affect all subsequent - remctl_open() calls on the same object. + remctl_open() calls on the same object. Returns true on success, + false on failure. remctl_open(CONNECTION, HOSTNAME[, PORT[, PRINCIPAL]]) Connect to HOSTNAME on port PORT using PRINCIPAL as the remote |