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 [ \-e
  16 .IR detachkey ]
  17 .RB \-n
  18 .RB name
  19 .RB command
  20 .RI [ args \ ... "" ]
  21 .br
  22 .B abduco
  23 .RB [ \-e
  24 .IR detachkey ]
  25 .RB \-A
  26 .RB name
  27 .RB command
  28 .RI [ args \ ... "" ]
  29 .br
  30 .B abduco
  31 .RB [ \-e
  32 .IR detachkey ]
  33 .RB \-a
  34 .RB name
  35 .br
  36 .SH DESCRIPTION
  37 .B abduco
  38 provides a way to disconnect a given application from its controlling
  39 terminal thus it provides roughly the same session attach/detach support as
  40 .BR screen(1) , " tmux(1)" " or" " dtach(1)".
  41
  42 If the
  43 .BR command
  44 to execute is not specified, the environment variable
  45 .BR $ABDUCO_CMD
  46 is checked, if it is not set
  47 .BR dvtm(1)
  48 is executed.
  49
  50 By default all session related information is stored in
  51 .B $HOME/.abduco
  52 with
  53 .BR $TMPDIR/.abduco
  54 as a fallback and
  55 .BR /tmp/.abduco
  56 as a last resort.
  57
  58 However if a given session name starts either with a dot or a forward slash
  59 it is interpreted as a path name and used unmodified i.e. relatively to the
  60 current working directory.
  61
  62 If for some reason the
  63 .BR unix(7)
  64 domain socket representing a session is deleted, sending
  65 .BR SIGUSR1
  66 to the server process will recreate it.
  67 .SH OPTIONS
  68 If no command line arguments are given all currently active sessions are
  69 printed sorted by their respective creation date. Lines starting with an
  70 asterik
  71 .BR *
  72 indicate that at least one client is connected.
  73 .TP
  74 .B \-v
  75 Print version information to standard output and exit.
  76 .TP
  77 .BI \-e \ detachkey
  78 Set the key to detach which by default is set to CTRL+\\ i.e. ^\\ to detachkey.
  79 .TP
  80 .BI \-c
  81 Create a new session and attach immediately to it.
  82 .TP
  83 .BI \-n
  84 Create a new session but do not attach to it.
  85 .TP
  86 .BI \-A
  87 Try to connect to an existing session, upon failure create said session and attach immediately to it.
  88 .TP
  89 .BI \-a
  90 Attach to an existing session.
  91 .SH AUTHOR
  92 abduco is written by Marc André Tanner <mat at brain-dump.org>