rxrpc: Provide functions for allowing cleaner handling of signals
authorDavid Howells <dhowells@redhat.com>
Wed, 18 Oct 2017 10:07:31 +0000 (11:07 +0100)
committerDavid Howells <dhowells@redhat.com>
Wed, 18 Oct 2017 10:42:48 +0000 (11:42 +0100)
commitf4d15fb6f99af9b99f688bd87579137be44f85ee
treecfc9781d2fc813a91f2ce4e5b38794b9dc4dd6bf
parenta68f4a27f55f1d54e35c270aff89383da4b1b656
rxrpc: Provide functions for allowing cleaner handling of signals

Provide a couple of functions to allow cleaner handling of signals in a
kernel service.  They are:

 (1) rxrpc_kernel_get_rtt()

     This allows the kernel service to find out the RTT time for a call, so
     as to better judge how large a timeout to employ.

     Note, though, that whilst this returns a value in nanoseconds, the
     timeouts can only actually be in jiffies.

 (2) rxrpc_kernel_check_life()

     This returns a number that is updated when ACKs are received from the
     peer (notably including PING RESPONSE ACKs which we can elicit by
     sending PING ACKs to see if the call still exists on the server).

     The caller should compare the numbers of two calls to see if the call
     is still alive.

These can be used to provide an extending timeout rather than returning
immediately in the case that a signal occurs that would otherwise abort an
RPC operation.  The timeout would be extended if the server is still
responsive and the call is still apparently alive on the server.

For most operations this isn't that necessary - but for FS.StoreData it is:
OpenAFS writes the data to storage as it comes in without making a backup,
so if we immediately abort it when partially complete on a CTRL+C, say, we
have no idea of the state of the file after the abort.

Signed-off-by: David Howells <dhowells@redhat.com>
Documentation/networking/rxrpc.txt
include/net/af_rxrpc.h
net/rxrpc/af_rxrpc.c
net/rxrpc/peer_object.c