xref: /openbsd-src/usr.bin/tmux/cmd-list-clients.c (revision 5b859c19fe53bbea08f5c342e0a4470e99f883e1)
1 /* $OpenBSD: cmd-list-clients.c,v 1.19 2014/10/20 23:35:28 nicm Exp $ */
2 
3 /*
4  * Copyright (c) 2007 Nicholas Marriott <nicm@users.sourceforge.net>
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 	"#{client_tty}: #{session_name} "			\
33 	"[#{client_width}x#{client_height} #{client_termname}]"	\
34 	"#{?client_utf8, (utf8),} #{?client_readonly, (ro),}"
35 
36 enum cmd_retval	cmd_list_clients_exec(struct cmd *, struct cmd_q *);
37 
38 const struct cmd_entry cmd_list_clients_entry = {
39 	"list-clients", "lsc",
40 	"F:t:", 0, 0,
41 	"[-F format] " CMD_TARGET_SESSION_USAGE,
42 	CMD_READONLY,
43 	cmd_list_clients_exec
44 };
45 
46 enum cmd_retval
47 cmd_list_clients_exec(struct cmd *self, struct cmd_q *cmdq)
48 {
49 	struct args 		*args = self->args;
50 	struct client		*c;
51 	struct session		*s;
52 	struct format_tree	*ft;
53 	const char		*template;
54 	u_int			 i;
55 	char			*line;
56 
57 	if (args_has(args, 't')) {
58 		s = cmd_find_session(cmdq, args_get(args, 't'), 0);
59 		if (s == NULL)
60 			return (CMD_RETURN_ERROR);
61 	} else
62 		s = NULL;
63 
64 	if ((template = args_get(args, 'F')) == NULL)
65 		template = LIST_CLIENTS_TEMPLATE;
66 
67 	for (i = 0; i < ARRAY_LENGTH(&clients); i++) {
68 		c = ARRAY_ITEM(&clients, i);
69 		if (c == NULL || c->session == NULL)
70 			continue;
71 
72 		if (s != NULL && s != c->session)
73 			continue;
74 
75 		ft = format_create();
76 		format_add(ft, "line", "%u", i);
77 		format_session(ft, c->session);
78 		format_client(ft, c);
79 
80 		line = format_expand(ft, template);
81 		cmdq_print(cmdq, "%s", line);
82 		free(line);
83 
84 		format_free(ft);
85 	}
86 
87 	return (CMD_RETURN_NORMAL);
88 }
89