|-a||Attach to an existing session. dtach attaches itself to the session specified by <socket>. After the attach is completed, the window size of the current terminal is sent to the master process, and a redraw is also requested.|
|-A||Attach to an existing session, or create a new one. dtach first tries to attach to the session specified by <socket> if possible. If the attempt to open the socket fails, dtach tries to create a new session before attaching to it.|
|-c||Creates a new session. A new session is created in which the specified program is executed. dtach then tries to attach itself to the newly created session.|
Creates a new session, without attaching to it. A new session is created in
which the specified program is executed.
dtach does not try to attach to the newly created session, however, and exits
dtach has a few options that allow you to modify its behavior. Each attaching process can have separate settings for these options, which allows for some flexibility.
-e <char> Sets the detach character to <char>. When the detach character is pressed, dtach detaches itself from the current session and exits. The process running in the session is unaffected by the detach. By default, the detach character is set to ^\ (Ctrl-\).
-E Disables the detach character. dtach does not try to scan input from the terminal for a detach character. The only way to detach from the session is then by sending the attaching process an appropriate signal.
-r <method> Sets the redraw method to <method>. The valid methods are none, ctrl_l, or winch.
none disables redrawing completely, ctrl_l sends a Ctrl L character to the program if the terminal is in character-at-a-time and no-echo mode, and winch forces a WINCH signal to be sent to the program.
When creating a new session, the specified method is used as the default redraw method for the session. If not specified, the ctrl_l method is used.
-z Disables processing of the suspend key. Normally, dtach will suspend itself when the suspend key is pressed. With this option, the suspend character is sent to the session instead of being handled by dtach.
The following example creates a new session that has the detach character and suspend processing disabled. A socket is created in the /tmp directory for the session.
$ dtach -c /tmp/foozle -Ez bash
The following example attaches to the /tmp/foozle session if it exists, and if not, creates a new session using /tmp/foozle as the socket for the session. Processing of the suspend character is also disabled for the attach instance.
$ dtach -A /tmp/foozle -z bash
The following example attaches to the /tmp/foozle session, using the winch redraw method to redraw the screen.
$ dtach -a /tmp/foozle -r winch
The following example creates a new session and sets the default redraw method for the session to the winch redraw method.
$ dtach -c /tmp/foozle -r winch bash
Ned T. Crigler <email@example.com>.
|dtach 0.8||DTACH (1)||Jan 2008|