Module Name: src Committed By: pooka Date: Wed Feb 16 19:46:42 UTC 2011
Modified Files: src/lib/librumphijack: rumphijack.3 Log Message: document RUMPHIJACK_RETRYCONNECT To generate a diff of this commit: cvs rdiff -u -r1.2 -r1.3 src/lib/librumphijack/rumphijack.3 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
Modified files: Index: src/lib/librumphijack/rumphijack.3 diff -u src/lib/librumphijack/rumphijack.3:1.2 src/lib/librumphijack/rumphijack.3:1.3 --- src/lib/librumphijack/rumphijack.3:1.2 Tue Jan 25 14:05:42 2011 +++ src/lib/librumphijack/rumphijack.3 Wed Feb 16 19:46:42 2011 @@ -1,4 +1,4 @@ -.\" $NetBSD: rumphijack.3,v 1.2 2011/01/25 14:05:42 pooka Exp $ +.\" $NetBSD: rumphijack.3,v 1.3 2011/02/16 19:46:42 pooka Exp $ .\" .\" Copyright (c) 2011 Antti Kantee. All rights reserved. .\" @@ -23,7 +23,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.Dd January 25, 2011 +.Dd February 16, 2011 .Dt RUMPHIJACK 3 .Os .Sh NAME @@ -43,20 +43,51 @@ to capture and redirect system call requests to a rump kernel instead of the host kernel. .Pp +The behaviour of hijacked applications is affected by the following +environment variables: +.Bl -tag -width 12345 +.It Dv RUMPHIJACK_RETRYCONNECT +Change how +.Xr rumpclient 3 +attempts to reconnect to the server in case the connection is lost. +Acceptable values are: +.Bl -tag -width xxinftimexx +.It Dq inftime +retry indefinitely +.It Dq once +retry once, when that connection fails, give up +.It Dq die +call +.Xr exit 3 +if connection failure is detected +.It n +Attempt reconnect for n seconds. +The value 0 means reconnection is not attempted. +The value n must be a positive integer. +.El +.Pp +See +.Xr rumpclient 3 +for more discussion. +.El +.Pp Currently .Nm supports only TCP/IP related system calls. The set of supported subsystems may change later along with the usage of the library. .Sh EXAMPLES -Use an alternate TCP/IP stack for firefox: +Use an alternate TCP/IP stack for firefox with a persistent server +connection: .Bd -literal -offset indent $ setenv RUMP_SERVER unix:///tmp/tcpip $ setenv LD_PRELOAD /usr/lib/librumphijack.so +$ setenv RUMPHIJACK_RETRYCONNECT inftime $ firefox .Ed .Sh SEE ALSO .Xr ld.so 1 , .Xr rump_server 1 , .Xr rump 3 , +.Xr rumpclient 3 , .Xr rump_sp 7