Unlink socket when forkpty fails
[abduco.git] / abduco.1
blob611e35b68e619d2740ac6acccccd776e0546b684
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 it's controlling
39 terminal thus it provides roughly the same session attach/detach support as
40 .BR screen(1) , " tmux(1)" " or" " dtach(1)".
42 By default all session related information is stored in 
43 .B $HOME/.abduco
44 or as a fallback in 
45 .BR /tmp/.abduco .
46 However if a given session name starts either with a dot or a forward slash
47 it is interpreted as a path name and used unmodified i.e. relatively to the
48 current working directory.
49 .SH OPTIONS
50 If no command line arguments are given all currently active sessions are
51 printed together with their respective creation date.
52 .TP
53 .B \-v
54 Print version information to standard output and exit.
55 .TP
56 .BI \-e \ detachkey
57 Set the key to detach which by default is set to CTRL+\\ i.e. ^\\ to detachkey.
58 .TP
59 .BI \-c
60 Create a new session and attach immediately to it.
61 .TP
62 .BI \-n
63 Create a new session but don't attach to it.
64 .TP
65 .BI \-A
66 Try to connect to an existing session, upon failure create said session and attach immediately to it.
67 .TP
68 .BI \-a 
69 Attach to an existing session.
70 .SH AUTHOR
71 abduco is written by Marc AndrĂ© Tanner <mat at brain-dump.org>