abduco.1

   1 .TH ABDUCO 1 abduco\-VERSION
   2 .nh
   3 .SH NAME
   4 abduco
   5 .SH SYNOPSIS
   6 .B abduco
   7 .RB [ \-e
   8 .IR detachkey ]
   9 .RB \-c
  10 .RB name
  11 .RB command
  12 .RI [ args \ ... "" ]
  13 .br
  14 .B abduco
  15 .RB [ \-r ]
  16 .RB [ \-e
  17 .IR detachkey ]
  18 .RB \-n
  19 .RB name
  20 .RB command
  21 .RI [ args \ ... "" ]
  22 .br
  23 .B abduco
  24 .RB [ \-e
  25 .IR detachkey ]
  26 .RB \-A
  27 .RB name
  28 .RB command
  29 .RI [ args \ ... "" ]
  30 .br
  31 .B abduco
  32 .RB [ \-r ]
  33 .RB [ \-e
  34 .IR detachkey ]
  35 .RB \-a
  36 .RB name
  37 .br
  38 .SH DESCRIPTION
  39 .B abduco
  40 provides a way to disconnect a given application from its controlling
  41 terminal, thus it provides roughly the same session attach/detach support as
  42 .BR screen(1) , " tmux(1)" " or" " dtach(1)".
  43
  44 If the
  45 .BR command
  46 to execute is not specified, the environment variable
  47 .BR $ABDUCO_CMD
  48 is examined, if it is not set
  49 .BR dvtm(1)
  50 is executed.
  51
  52 By default all session related information is stored in
  53 .B $HOME/.abduco
  54 with
  55 .BR $TMPDIR/.abduco
  56 as a fallback and
  57 .BR /tmp/.abduco
  58 as a last resort.
  59
  60 However if a given session name represents either a relative or absolute path
  61 it is used unmodified.
  62
  63 If for some reason the
  64 .BR unix(7)
  65 domain socket representing a session is deleted, sending
  66 .BR SIGUSR1
  67 to the server process will recreate it.
  68 .SH OPTIONS
  69 If no command line arguments are given all currently active sessions are
  70 printed sorted by their respective creation date. Lines starting with an
  71 asterik
  72 .BR *
  73 indicate that at least one client is connected.
  74 A plus sign
  75 .BR +
  76 indicates that the command terminated while no client was connected, attach
  77 to get its exit status.
  78 .TP
  79 .B \-v
  80 Print version information to standard output and exit.
  81 .TP
  82 .B \-r
  83 Readonly session, i.e. user input is ignored.
  84 .TP
  85 .BI \-e \ detachkey
  86 Set the key to detach which by default is set to CTRL+\\ i.e. ^\\ to detachkey.
  87 .TP
  88 .BI \-c
  89 Create a new session and attach immediately to it.
  90 .TP
  91 .BI \-n
  92 Create a new session but do not attach to it.
  93 .TP
  94 .BI \-A
  95 Try to connect to an existing session, upon failure create said session and attach immediately to it.
  96 .TP
  97 .BI \-a
  98 Attach to an existing session.
  99 .SH EXAMPLE
 100 Start a new session (assuming
 101 .BR dvtm(1)
 102 is in
 103 .BR $PATH )
 104 with
 105 .nf
 106
 107 .B abduco -c my-session
 108
 109 .fi
 110 do some work, then detach by pressing
 111 .B CTRL+\e
 112 and later reattach with
 113 .nf
 114
 115 .B abduco -a my-session
 116
 117 .fi
 118 .SH AUTHOR
 119 abduco is written by Marc André Tanner <mat at brain-dump.org>