Coverage Report

Created: 2026-06-10 06:31

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/tmux/cmd-detach-client.c
Line
Count
Source
1
/* $OpenBSD$ */
2
3
/*
4
 * Copyright (c) 2007 Nicholas Marriott <nicholas.marriott@gmail.com>
5
 *
6
 * Permission to use, copy, modify, and distribute this software for any
7
 * purpose with or without fee is hereby granted, provided that the above
8
 * copyright notice and this permission notice appear in all copies.
9
 *
10
 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
11
 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
12
 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
13
 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
14
 * WHATSOEVER RESULTING FROM LOSS OF MIND, USE, DATA OR PROFITS, WHETHER
15
 * IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING
16
 * OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
17
 */
18
19
#include <sys/types.h>
20
21
#include <string.h>
22
23
#include "tmux.h"
24
25
/*
26
 * Detach a client.
27
 */
28
29
static enum cmd_retval  cmd_detach_client_exec(struct cmd *,
30
          struct cmdq_item *);
31
32
const struct cmd_entry cmd_detach_client_entry = {
33
  .name = "detach-client",
34
  .alias = "detach",
35
36
  .args = { "aE:s:t:P", 0, 0, NULL },
37
  .usage = "[-aP] [-E shell-command] "
38
           "[-s target-session] " CMD_TARGET_CLIENT_USAGE,
39
40
  .source = { 's', CMD_FIND_SESSION, CMD_FIND_CANFAIL },
41
42
  .flags = CMD_READONLY|CMD_CLIENT_TFLAG,
43
  .exec = cmd_detach_client_exec
44
};
45
46
const struct cmd_entry cmd_suspend_client_entry = {
47
  .name = "suspend-client",
48
  .alias = "suspendc",
49
50
  .args = { "t:", 0, 0, NULL },
51
  .usage = CMD_TARGET_CLIENT_USAGE,
52
53
  .flags = CMD_CLIENT_TFLAG,
54
  .exec = cmd_detach_client_exec
55
};
56
57
static enum cmd_retval
58
cmd_detach_client_exec(struct cmd *self, struct cmdq_item *item)
59
0
{
60
0
  struct args   *args = cmd_get_args(self);
61
0
  struct cmd_find_state *source = cmdq_get_source(item);
62
0
  struct client   *c = cmdq_get_client(item);
63
0
  struct client   *tc = cmdq_get_target_client(item), *loop;
64
0
  struct session    *s;
65
0
  enum msgtype     msgtype;
66
0
  const char    *cmd = args_get(args, 'E');
67
68
0
  if (cmd_get_entry(self) == &cmd_suspend_client_entry) {
69
0
    server_client_suspend(tc);
70
0
    return (CMD_RETURN_NORMAL);
71
0
  }
72
73
0
  if (c->flags & CLIENT_READONLY) {
74
0
    if (args_has(args, 's') || args_has(args, 'a') || c != tc) {
75
0
      cmdq_error(item, "client is read-only");
76
0
      return (CMD_RETURN_ERROR);
77
0
    }
78
0
  }
79
80
0
  if (args_has(args, 'P'))
81
0
    msgtype = MSG_DETACHKILL;
82
0
  else
83
0
    msgtype = MSG_DETACH;
84
85
0
  if (args_has(args, 's')) {
86
0
    s = source->s;
87
0
    if (s == NULL)
88
0
      return (CMD_RETURN_NORMAL);
89
0
    TAILQ_FOREACH(loop, &clients, entry) {
90
0
      if (loop->session == s) {
91
0
        if (cmd != NULL)
92
0
          server_client_exec(loop, cmd);
93
0
        else
94
0
          server_client_detach(loop, msgtype);
95
0
      }
96
0
    }
97
0
    return (CMD_RETURN_STOP);
98
0
  }
99
100
0
  if (args_has(args, 'a')) {
101
0
    TAILQ_FOREACH(loop, &clients, entry) {
102
0
      if (loop->session != NULL && loop != tc) {
103
0
        if (cmd != NULL)
104
0
          server_client_exec(loop, cmd);
105
0
        else
106
0
          server_client_detach(loop, msgtype);
107
0
      }
108
0
    }
109
0
    return (CMD_RETURN_NORMAL);
110
0
  }
111
112
0
  if (cmd != NULL)
113
0
    server_client_exec(tc, cmd);
114
0
  else
115
0
    server_client_detach(tc, msgtype);
116
0
  return (CMD_RETURN_STOP);
117
0
}