Coverage Report

Created: 2026-04-12 06:58

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/tmux/cmd-list-clients.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 <stdlib.h>
22
#include <string.h>
23
#include <time.h>
24
25
#include "tmux.h"
26
27
/*
28
 * List all clients.
29
 */
30
31
#define LIST_CLIENTS_TEMPLATE           \
32
0
  "#{client_name}: #{session_name} "        \
33
0
  "[#{client_width}x#{client_height} #{client_termname}] "  \
34
0
  "#{?#{!=:#{client_uid},#{uid}},"        \
35
0
  "[user #{?client_user,#{client_user},#{client_uid},}] ,}" \
36
0
  "#{?client_flags,(,}#{client_flags}#{?client_flags,),}"
37
38
static enum cmd_retval  cmd_list_clients_exec(struct cmd *, struct cmdq_item *);
39
40
const struct cmd_entry cmd_list_clients_entry = {
41
  .name = "list-clients",
42
  .alias = "lsc",
43
44
  .args = { "F:f:O:rt:", 0, 0, NULL },
45
  .usage = "[-F format] [-f filter] [-O order]" CMD_TARGET_SESSION_USAGE,
46
47
  .target = { 't', CMD_FIND_SESSION, 0 },
48
49
  .flags = CMD_READONLY|CMD_AFTERHOOK,
50
  .exec = cmd_list_clients_exec
51
};
52
53
static enum cmd_retval
54
cmd_list_clients_exec(struct cmd *self, struct cmdq_item *item)
55
0
{
56
0
  struct args      *args = cmd_get_args(self);
57
0
  struct cmd_find_state  *target = cmdq_get_target(item);
58
0
  struct client   **l;
59
0
  struct session     *s;
60
0
  struct format_tree   *ft;
61
0
  const char     *template, *filter;
62
0
  u_int       i, n;
63
0
  char       *line, *expanded;
64
0
  int       flag;
65
0
  struct sort_criteria    sort_crit;
66
67
0
  if (args_has(args, 't'))
68
0
    s = target->s;
69
0
  else
70
0
    s = NULL;
71
72
0
  if ((template = args_get(args, 'F')) == NULL)
73
0
    template = LIST_CLIENTS_TEMPLATE;
74
0
  filter = args_get(args, 'f');
75
76
0
  sort_crit.order = sort_order_from_string(args_get(args, 'O'));
77
0
  if (sort_crit.order == SORT_END && args_has(args, 'O')) {
78
0
    cmdq_error(item, "invalid sort order");
79
0
    return (CMD_RETURN_ERROR);
80
0
  }
81
0
  sort_crit.reversed = args_has(args, 'r');
82
83
0
  l = sort_get_clients(&n, &sort_crit);
84
0
  for (i = 0; i < n; i++) {
85
0
    if (l[i]->session == NULL || (s != NULL && s != l[i]->session))
86
0
      continue;
87
88
0
    ft = format_create(cmdq_get_client(item), item, FORMAT_NONE, 0);
89
0
    format_add(ft, "line", "%u", i);
90
0
    format_defaults(ft, l[i], NULL, NULL, NULL);
91
92
0
    if (filter != NULL) {
93
0
      expanded = format_expand(ft, filter);
94
0
      flag = format_true(expanded);
95
0
      free(expanded);
96
0
    } else
97
0
      flag = 1;
98
0
    if (flag) {
99
0
      line = format_expand(ft, template);
100
0
      cmdq_print(item, "%s", line);
101
0
      free(line);
102
0
    }
103
104
0
    format_free(ft);
105
0
  }
106
107
0
  return (CMD_RETURN_NORMAL);
108
0
}