1 /* $OpenBSD: cmd-list-clients.c,v 1.40 2023/02/06 09:20:30 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 <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_name}: #{session_name} " \ 33 "[#{client_width}x#{client_height} #{client_termname}] " \ 34 "#{?#{!=:#{client_uid},#{uid}}," \ 35 "[user #{?client_user,#{client_user},#{client_uid},}] ,}" \ 36 "#{?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:t:", 0, 0, NULL }, 45 .usage = "[-F format] [-f filter] " 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 { 56 struct args *args = cmd_get_args(self); 57 struct cmd_find_state *target = cmdq_get_target(item); 58 struct client *c; 59 struct session *s; 60 struct format_tree *ft; 61 const char *template, *filter; 62 u_int idx; 63 char *line, *expanded; 64 int flag; 65 66 if (args_has(args, 't')) 67 s = target->s; 68 else 69 s = NULL; 70 71 if ((template = args_get(args, 'F')) == NULL) 72 template = LIST_CLIENTS_TEMPLATE; 73 filter = args_get(args, 'f'); 74 75 idx = 0; 76 TAILQ_FOREACH(c, &clients, entry) { 77 if (c->session == NULL || (s != NULL && s != c->session)) 78 continue; 79 80 ft = format_create(cmdq_get_client(item), item, FORMAT_NONE, 0); 81 format_add(ft, "line", "%u", idx); 82 format_defaults(ft, c, NULL, NULL, NULL); 83 84 if (filter != NULL) { 85 expanded = format_expand(ft, filter); 86 flag = format_true(expanded); 87 free(expanded); 88 } else 89 flag = 1; 90 if (flag) { 91 line = format_expand(ft, template); 92 cmdq_print(item, "%s", line); 93 free(line); 94 } 95 96 format_free(ft); 97 98 idx++; 99 } 100 101 return (CMD_RETURN_NORMAL); 102 } 103