Coverage Report

Created: 2026-10-17 06:19

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/tmux/cmd-list-windows.c
Line
Count
Source
1
/* $OpenBSD: cmd-list-windows.c,v 1.52 2026/10/09 13:12:14 nicm Exp $ */
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 <unistd.h>
23
24
#include "tmux.h"
25
26
/*
27
 * List windows on given session.
28
 */
29
30
#define LIST_WINDOWS_TEMPLATE         \
31
0
  "#{window_index}: #{window_name}#{window_raw_flags} " \
32
0
  "(#{window_panes} panes) "        \
33
0
  "[#{window_width}x#{window_height}] "     \
34
0
  "[layout #{window_layout}] #{window_id}"    \
35
0
  "#{?window_active, (active),}";
36
#define LIST_WINDOWS_WITH_SESSION_TEMPLATE      \
37
0
  "#{session_name}:"          \
38
0
  "#{window_index}: #{window_name}#{window_raw_flags} " \
39
0
  "(#{window_panes} panes) "        \
40
0
  "[#{window_width}x#{window_height}] "
41
42
static enum cmd_retval  cmd_list_windows_exec(struct cmd *, struct cmdq_item *);
43
44
const struct cmd_entry cmd_list_windows_entry = {
45
  .name = "list-windows",
46
  .description = "List windows and their state.",
47
  .alias = "lsw",
48
49
  .args = { "aF:f:O:rt:", 0, 0, NULL },
50
  .usage = "[-ar] [-F format] [-f filter] [-O order]"
51
     CMD_TARGET_SESSION_USAGE,
52
53
  .target = { 't', CMD_FIND_SESSION, 0 },
54
55
  .flags = CMD_AFTERHOOK,
56
  .exec = cmd_list_windows_exec
57
};
58
59
static enum cmd_retval
60
cmd_list_windows_exec(struct cmd *self, struct cmdq_item *item)
61
0
{
62
0
  struct args   *args = cmd_get_args(self);
63
0
  struct cmd_find_state *target = cmdq_get_target(item);
64
0
  struct client   *c = cmdq_get_client(item);
65
0
  struct winlink    *wl, **l;
66
0
  struct session    *s;
67
0
  u_int      i, n;
68
0
  struct format_tree  *ft;
69
0
  const char    *template, *filter;
70
0
  char      *line, *expanded;
71
0
  int      flag;
72
0
  struct sort_criteria   sort_crit;
73
74
0
  template = args_get(args, 'F');
75
0
  filter = args_get(args, 'f');
76
77
0
  sort_crit.order = sort_order_from_string(args_get(args, 'O'));
78
0
  if (sort_crit.order == SORT_END && args_has(args, 'O')) {
79
0
    cmdq_error(item, "invalid sort order");
80
0
    return (CMD_RETURN_ERROR);
81
0
  }
82
0
  sort_crit.reversed = args_has(args, 'r');
83
84
0
  if (args_has(args, 'a')) {
85
0
    l = sort_get_winlinks(&n, &sort_crit);
86
0
    if (template == NULL)
87
0
      template = LIST_WINDOWS_WITH_SESSION_TEMPLATE;
88
0
  } else {
89
0
    l = sort_get_winlinks_session(target->s, &n, &sort_crit);
90
0
    if (template == NULL)
91
0
      template = LIST_WINDOWS_TEMPLATE;
92
0
  }
93
94
0
  for (i = 0; i < n; i++) {
95
0
    wl = l[i];
96
0
    s = wl->session;
97
0
    ft = format_create(cmdq_get_client(item), item, FORMAT_NONE, 0);
98
0
    format_add(ft, "line", "%u", n);
99
0
    format_defaults(ft, c, s, wl, NULL);
100
101
0
    if (filter != NULL) {
102
0
      expanded = format_expand(ft, filter);
103
0
      flag = format_true(expanded);
104
0
      free(expanded);
105
0
    } else
106
0
      flag = 1;
107
0
    if (flag) {
108
0
      line = format_expand(ft, template);
109
0
      cmdq_print(item, "%s", line);
110
0
      free(line);
111
0
    }
112
113
0
    format_free(ft);
114
0
  }
115
116
0
  return (CMD_RETURN_NORMAL);
117
0
}