abduco.1

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