/src/tmux/cmd-run-shell.c

Source
/* $OpenBSD: cmd-run-shell.c,v 1.93 2026/07/17 12:42:51 nicm Exp $ */

/*
 * Copyright (c) 2009 Tiago Cunha <me@tiagocunha.org>
 * Copyright (c) 2009 Nicholas Marriott <nicm@openbsd.org>
 *
 * Permission to use, copy, modify, and distribute this software for any
 * purpose with or without fee is hereby granted, provided that the above
 * copyright notice and this permission notice appear in all copies.
 *
 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
 * WHATSOEVER RESULTING FROM LOSS OF MIND, USE, DATA OR PROFITS, WHETHER
 * IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING
 * OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 */

#include <sys/types.h>
#include <sys/wait.h>

#include <ctype.h>
#include <stdlib.h>
#include <string.h>

#include "tmux.h"

/*
 * Runs a command without a window.
 */

static enum args_parse_type cmd_run_shell_args_parse(struct args *, u_int,
            char **);
static enum cmd_retval    cmd_run_shell_exec(struct cmd *,
            struct cmdq_item *);

static void cmd_run_shell_timer(int, short, void *);
static void cmd_run_shell_callback(struct job *);
static void cmd_run_shell_free(void *);
static void cmd_run_shell_print(struct job *, const char *);

const struct cmd_entry cmd_run_shell_entry = {
  .name = "run-shell",
  .alias = "run",

  .args = { "bd:Ct:Es:c:", 0, -1, cmd_run_shell_args_parse },
  .usage = "[-bCE] [-c start-directory] [-d delay] " CMD_TARGET_PANE_USAGE
           " [shell-command [argument ...]]",

  .target = { 't', CMD_FIND_PANE, CMD_FIND_CANFAIL },

  .flags = 0,
  .exec = cmd_run_shell_exec
};

struct cmd_run_shell_data {
  struct client     *client;
  char        *cmd;
  struct args_command_state *state;
  char        *cwd;
  struct cmdq_item    *item;
  struct session      *s;
  int        wp_id;
  struct event       timer;
  int        flags;
};

static enum args_parse_type
cmd_run_shell_args_parse(struct args *args, __unused u_int idx,
    __unused char **cause)
{
  if (args_has(args, 'C'))
    return (ARGS_PARSE_COMMANDS_OR_STRING);
  return (ARGS_PARSE_STRING);
}

static void
cmd_run_shell_print(struct job *job, const char *msg)
{
  struct cmd_run_shell_data *cdata = job_get_data(job);
  struct window_pane    *wp = NULL;
  struct cmd_find_state    fs;
  struct window_mode_entry  *wme;

  if (cdata->wp_id != -1)
    wp = window_pane_find_by_id(cdata->wp_id);
  if (wp == NULL) {
    if (cdata->item != NULL) {
      cmdq_print(cdata->item, "%s", msg);
      return;
    }
    if (cdata->client != NULL && cdata->client->session != NULL)
      wp = cdata->client->session->curw->window->active;
    if (wp == NULL && cmd_find_from_nothing(&fs, 0) == 0)
      wp = fs.wp;
    if (wp == NULL)
      return;
  }

  wme = TAILQ_FIRST(&wp->modes);
  if (wme == NULL || wme->mode != &window_view_mode)
    window_pane_set_mode(wp, NULL, &window_view_mode, NULL, NULL,
        NULL);
  window_copy_add(wp, 1, "%s", msg);
}

static enum cmd_retval
cmd_run_shell_exec(struct cmd *self, struct cmdq_item *item)
{
  struct args     *args = cmd_get_args(self);
  struct cmd_find_state   *target = cmdq_get_target(item);
  struct cmd_run_shell_data *cdata;
  struct client     *c = cmdq_get_client(item);
  struct client     *tc = cmdq_get_target_client(item);
  struct session      *s = target->s;
  struct window_pane    *wp = target->wp;
  const char      *delay, *cmd;
  struct format_tree    *ft;
  double         d;
  struct timeval       tv;
  char        *end, key[16];
  u_int        i;
  int        wait = !args_has(args, 'b');

  if ((delay = args_get(args, 'd')) != NULL) {
    d = strtod(delay, &end);
    if (*end != '\0') {
      cmdq_error(item, "invalid delay time: %s", delay);
      return (CMD_RETURN_ERROR);
    }
  } else if (args_count(args) == 0)
    return (CMD_RETURN_NORMAL);

  cdata = xcalloc(1, sizeof *cdata);
  if (!args_has(args, 'C')) {
    cmd = args_string(args, 0);
    if (cmd != NULL) {
      ft = format_create_from_target(item);
      for (i = 1; i < args_count(args); i++) {
        xsnprintf(key, sizeof key, "%u", i);
        format_add(ft, key, "%s", args_string(args, i));
      }
      cdata->cmd = format_expand(ft, cmd);
      format_free(ft);
    }
  } else {
    cdata->state = args_make_commands_prepare(self, item, 0, NULL,
        wait, 1);
  }

  if (args_has(args, 't') && wp != NULL)
    cdata->wp_id = wp->id;
  else
    cdata->wp_id = -1;

  if (wait) {
    cdata->client = c;
    cdata->item = item;
  } else {
    cdata->client = tc;
    cdata->flags |= JOB_NOWAIT;
  }
  if (cdata->client != NULL)
    cdata->client->references++;
  if (args_has(args, 'c'))
    cdata->cwd = xstrdup(args_get(args, 'c'));
  else
    cdata->cwd = xstrdup(server_client_get_cwd(c, s));

  if (args_has(args, 'E'))
    cdata->flags |= JOB_SHOWSTDERR;

  cdata->s = s;
  if (s != NULL)
    session_add_ref(s, __func__);

  evtimer_set(&cdata->timer, cmd_run_shell_timer, cdata);
  if (delay != NULL) {
    timerclear(&tv);
    tv.tv_sec = (time_t)d;
    tv.tv_usec = (d - (double)tv.tv_sec) * 1000000U;
    evtimer_add(&cdata->timer, &tv);
  } else
    event_active(&cdata->timer, EV_TIMEOUT, 1);

  if (!wait)
    return (CMD_RETURN_NORMAL);
  return (CMD_RETURN_WAIT);
}

static void
cmd_run_shell_timer(__unused int fd, __unused short events, void* arg)
{
  struct cmd_run_shell_data *cdata = arg;
  struct client     *c = cdata->client;
  const char      *cmd = cdata->cmd;
  struct cmdq_item    *item = cdata->item, *new_item;
  struct cmd_list     *cmdlist;
  char        *error;

  if (cdata->state == NULL) {
    if (cmd == NULL) {
      if (cdata->item != NULL)
        cmdq_continue(cdata->item);
      cmd_run_shell_free(cdata);
      return;
    }
    if (job_run(cmd, 0, NULL, NULL, cdata->s, cdata->cwd, NULL,
        cmd_run_shell_callback, cmd_run_shell_free, cdata,
        cdata->flags, -1, -1) == NULL) {
      if (cdata->item == NULL)
        status_message_set(c, -1, 1, 0, 0,
            "failed to run command: %s", cmd);
      else {
        cmdq_error(cdata->item,
            "failed to run command: %s", cmd);
        cmdq_continue(cdata->item);
      }
      cmd_run_shell_free(cdata);
    }
    return;
  }

  cmdlist = args_make_commands(cdata->state, 0, NULL, &error);
  if (cmdlist == NULL) {
    if (cdata->item == NULL) {
      *error = toupper((u_char)*error);
      status_message_set(c, -1, 1, 0, 0, "%s", error);
    } else
      cmdq_error(cdata->item, "%s", error);
    free(error);
  } else if (item == NULL) {
    new_item = cmdq_get_command(cmdlist, NULL);
    cmdq_append(c, new_item);
  } else {
    new_item = cmdq_get_command(cmdlist, cmdq_get_state(item));
    cmdq_insert_after(item, new_item);
  }

  if (cdata->item != NULL)
    cmdq_continue(cdata->item);
  cmd_run_shell_free(cdata);
}

static void
cmd_run_shell_callback(struct job *job)
{
  struct cmd_run_shell_data *cdata = job_get_data(job);
  struct bufferevent    *event = job_get_event(job);
  struct cmdq_item    *item = cdata->item;
  char        *cmd = cdata->cmd, *msg = NULL, *line;
  size_t         size;
  int        retcode, status;

  do {
    line = evbuffer_readln(event->input, NULL, EVBUFFER_EOL_LF);
    if (line != NULL) {
      cmd_run_shell_print(job, line);
      free(line);
    }
  } while (line != NULL);

  size = EVBUFFER_LENGTH(event->input);
  if (size != 0) {
    line = xmalloc(size + 1);
    memcpy(line, EVBUFFER_DATA(event->input), size);
    line[size] = '\0';

    cmd_run_shell_print(job, line);

    free(line);
  }

  status = job_get_status(job);
  if (WIFEXITED(status)) {
    if ((retcode = WEXITSTATUS(status)) != 0)
      xasprintf(&msg, "'%s' returned %d", cmd, retcode);
  } else if (WIFSIGNALED(status)) {
    retcode = WTERMSIG(status);
    xasprintf(&msg, "'%s' terminated by signal %d", cmd, retcode);
    retcode += 128;
  } else
    retcode = 0;
  if (msg != NULL)
    cmd_run_shell_print(job, msg);
  free(msg);

  if (item != NULL) {
    if (cmdq_get_client(item) != NULL &&
        cmdq_get_client(item)->session == NULL)
      cmdq_get_client(item)->retval = retcode;
    cmdq_continue(item);
  }
}

static void
cmd_run_shell_free(void *data)
{
  struct cmd_run_shell_data *cdata = data;

  evtimer_del(&cdata->timer);
  if (cdata->s != NULL)
    session_remove_ref(cdata->s, __func__);
  if (cdata->client != NULL)
    server_client_unref(cdata->client);
  if (cdata->state != NULL)
    args_make_commands_free(cdata->state);
  free(cdata->cwd);
  free(cdata->cmd);
  free(cdata);
}

Coverage Report

Created: 2026-07-30 07:08

Line	Count	Source
1		/* $OpenBSD: cmd-run-shell.c,v 1.93 2026/07/17 12:42:51 nicm Exp $ */
2
3		/*
4		* Copyright (c) 2009 Tiago Cunha <me@tiagocunha.org>
5		* Copyright (c) 2009 Nicholas Marriott <nicm@openbsd.org>
6		*
7		* Permission to use, copy, modify, and distribute this software for any
8		* purpose with or without fee is hereby granted, provided that the above
9		* copyright notice and this permission notice appear in all copies.
10		*
11		* THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
12		* WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
13		* MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
14		* ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
15		* WHATSOEVER RESULTING FROM LOSS OF MIND, USE, DATA OR PROFITS, WHETHER
16		* IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING
17		* OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
18		*/
19
20		#include <sys/types.h>
21		#include <sys/wait.h>
22
23		#include <ctype.h>
24		#include <stdlib.h>
25		#include <string.h>
26
27		#include "tmux.h"
28
29		/*
30		* Runs a command without a window.
31		*/
32
33		static enum args_parse_type cmd_run_shell_args_parse(struct args *, u_int,
34		char **);
35		static enum cmd_retval cmd_run_shell_exec(struct cmd *,
36		struct cmdq_item *);
37
38		static void cmd_run_shell_timer(int, short, void *);
39		static void cmd_run_shell_callback(struct job *);
40		static void cmd_run_shell_free(void *);
41		static void cmd_run_shell_print(struct job , const char );
42
43		const struct cmd_entry cmd_run_shell_entry = {
44		.name = "run-shell",
45		.alias = "run",
46
47		.args = { "bd:Ct:Es:c:", 0, -1, cmd_run_shell_args_parse },
48		.usage = "[-bCE] [-c start-directory] [-d delay] " CMD_TARGET_PANE_USAGE
49		" [shell-command [argument ...]]",
50
51		.target = { 't', CMD_FIND_PANE, CMD_FIND_CANFAIL },
52
53		.flags = 0,
54		.exec = cmd_run_shell_exec
55		};
56
57		struct cmd_run_shell_data {
58		struct client *client;
59		char *cmd;
60		struct args_command_state *state;
61		char *cwd;
62		struct cmdq_item *item;
63		struct session *s;
64		int wp_id;
65		struct event timer;
66		int flags;
67		};
68
69		static enum args_parse_type
70		cmd_run_shell_args_parse(struct args *args, __unused u_int idx,
71		__unused char **cause)
72	1.64k	{
73	1.64k	if (args_has(args, 'C'))
74	209	return (ARGS_PARSE_COMMANDS_OR_STRING);
75	1.43k	return (ARGS_PARSE_STRING);
76	1.64k	}
77
78		static void
79		cmd_run_shell_print(struct job job, const char msg)
80	0	{
81	0	struct cmd_run_shell_data *cdata = job_get_data(job);
82	0	struct window_pane *wp = NULL;
83	0	struct cmd_find_state fs;
84	0	struct window_mode_entry *wme;
85
86	0	if (cdata->wp_id != -1)
87	0	wp = window_pane_find_by_id(cdata->wp_id);
88	0	if (wp == NULL) {
89	0	if (cdata->item != NULL) {
90	0	cmdq_print(cdata->item, "%s", msg);
91	0	return;
92	0	}
93	0	if (cdata->client != NULL && cdata->client->session != NULL)
94	0	wp = cdata->client->session->curw->window->active;
95	0	if (wp == NULL && cmd_find_from_nothing(&fs, 0) == 0)
96	0	wp = fs.wp;
97	0	if (wp == NULL)
98	0	return;
99	0	}
100
101	0	wme = TAILQ_FIRST(&wp->modes);
102	0	if (wme == NULL \|\| wme->mode != &window_view_mode)
103	0	window_pane_set_mode(wp, NULL, &window_view_mode, NULL, NULL,
104	0	NULL);
105	0	window_copy_add(wp, 1, "%s", msg);
106	0	}
107
108		static enum cmd_retval
109		cmd_run_shell_exec(struct cmd self, struct cmdq_item item)
110	0	{
111	0	struct args *args = cmd_get_args(self);
112	0	struct cmd_find_state *target = cmdq_get_target(item);
113	0	struct cmd_run_shell_data *cdata;
114	0	struct client *c = cmdq_get_client(item);
115	0	struct client *tc = cmdq_get_target_client(item);
116	0	struct session *s = target->s;
117	0	struct window_pane *wp = target->wp;
118	0	const char delay, cmd;
119	0	struct format_tree *ft;
120	0	double d;
121	0	struct timeval tv;
122	0	char *end, key[16];
123	0	u_int i;
124	0	int wait = !args_has(args, 'b');
125
126	0	if ((delay = args_get(args, 'd')) != NULL) {
127	0	d = strtod(delay, &end);
128	0	if (*end != '\0') {
129	0	cmdq_error(item, "invalid delay time: %s", delay);
130	0	return (CMD_RETURN_ERROR);
131	0	}
132	0	} else if (args_count(args) == 0)
133	0	return (CMD_RETURN_NORMAL);
134
135	0	cdata = xcalloc(1, sizeof *cdata);
136	0	if (!args_has(args, 'C')) {
137	0	cmd = args_string(args, 0);
138	0	if (cmd != NULL) {
139	0	ft = format_create_from_target(item);
140	0	for (i = 1; i < args_count(args); i++) {
141	0	xsnprintf(key, sizeof key, "%u", i);
142	0	format_add(ft, key, "%s", args_string(args, i));
143	0	}
144	0	cdata->cmd = format_expand(ft, cmd);
145	0	format_free(ft);
146	0	}
147	0	} else {
148	0	cdata->state = args_make_commands_prepare(self, item, 0, NULL,
149	0	wait, 1);
150	0	}
151
152	0	if (args_has(args, 't') && wp != NULL)
153	0	cdata->wp_id = wp->id;
154	0	else
155	0	cdata->wp_id = -1;
156
157	0	if (wait) {
158	0	cdata->client = c;
159	0	cdata->item = item;
160	0	} else {
161	0	cdata->client = tc;
162	0	cdata->flags \|= JOB_NOWAIT;
163	0	}
164	0	if (cdata->client != NULL)
165	0	cdata->client->references++;
166	0	if (args_has(args, 'c'))
167	0	cdata->cwd = xstrdup(args_get(args, 'c'));
168	0	else
169	0	cdata->cwd = xstrdup(server_client_get_cwd(c, s));
170
171	0	if (args_has(args, 'E'))
172	0	cdata->flags \|= JOB_SHOWSTDERR;
173
174	0	cdata->s = s;
175	0	if (s != NULL)
176	0	session_add_ref(s, __func__);
177
178	0	evtimer_set(&cdata->timer, cmd_run_shell_timer, cdata);
179	0	if (delay != NULL) {
180	0	timerclear(&tv);
181	0	tv.tv_sec = (time_t)d;
182	0	tv.tv_usec = (d - (double)tv.tv_sec) * 1000000U;
183	0	evtimer_add(&cdata->timer, &tv);
184	0	} else
185	0	event_active(&cdata->timer, EV_TIMEOUT, 1);
186
187	0	if (!wait)
188	0	return (CMD_RETURN_NORMAL);
189	0	return (CMD_RETURN_WAIT);
190	0	}
191
192		static void
193		cmd_run_shell_timer(__unused int fd, __unused short events, void* arg)
194	0	{
195	0	struct cmd_run_shell_data *cdata = arg;
196	0	struct client *c = cdata->client;
197	0	const char *cmd = cdata->cmd;
198	0	struct cmdq_item item = cdata->item, new_item;
199	0	struct cmd_list *cmdlist;
200	0	char *error;
201
202	0	if (cdata->state == NULL) {
203	0	if (cmd == NULL) {
204	0	if (cdata->item != NULL)
205	0	cmdq_continue(cdata->item);
206	0	cmd_run_shell_free(cdata);
207	0	return;
208	0	}
209	0	if (job_run(cmd, 0, NULL, NULL, cdata->s, cdata->cwd, NULL,
210	0	cmd_run_shell_callback, cmd_run_shell_free, cdata,
211	0	cdata->flags, -1, -1) == NULL) {
212	0	if (cdata->item == NULL)
213	0	status_message_set(c, -1, 1, 0, 0,
214	0	"failed to run command: %s", cmd);
215	0	else {
216	0	cmdq_error(cdata->item,
217	0	"failed to run command: %s", cmd);
218	0	cmdq_continue(cdata->item);
219	0	}
220	0	cmd_run_shell_free(cdata);
221	0	}
222	0	return;
223	0	}
224
225	0	cmdlist = args_make_commands(cdata->state, 0, NULL, &error);
226	0	if (cmdlist == NULL) {
227	0	if (cdata->item == NULL) {
228	0	error = toupper((u_char)error);
229	0	status_message_set(c, -1, 1, 0, 0, "%s", error);
230	0	} else
231	0	cmdq_error(cdata->item, "%s", error);
232	0	free(error);
233	0	} else if (item == NULL) {
234	0	new_item = cmdq_get_command(cmdlist, NULL);
235	0	cmdq_append(c, new_item);
236	0	} else {
237	0	new_item = cmdq_get_command(cmdlist, cmdq_get_state(item));
238	0	cmdq_insert_after(item, new_item);
239	0	}
240
241	0	if (cdata->item != NULL)
242	0	cmdq_continue(cdata->item);
243	0	cmd_run_shell_free(cdata);
244	0	}
245
246		static void
247		cmd_run_shell_callback(struct job *job)
248	0	{
249	0	struct cmd_run_shell_data *cdata = job_get_data(job);
250	0	struct bufferevent *event = job_get_event(job);
251	0	struct cmdq_item *item = cdata->item;
252	0	char cmd = cdata->cmd, msg = NULL, *line;
253	0	size_t size;
254	0	int retcode, status;
255
256	0	do {
257	0	line = evbuffer_readln(event->input, NULL, EVBUFFER_EOL_LF);
258	0	if (line != NULL) {
259	0	cmd_run_shell_print(job, line);
260	0	free(line);
261	0	}
262	0	} while (line != NULL);
263
264	0	size = EVBUFFER_LENGTH(event->input);
265	0	if (size != 0) {
266	0	line = xmalloc(size + 1);
267	0	memcpy(line, EVBUFFER_DATA(event->input), size);
268	0	line[size] = '\0';
269
270	0	cmd_run_shell_print(job, line);
271
272	0	free(line);
273	0	}
274
275	0	status = job_get_status(job);
276	0	if (WIFEXITED(status)) {
277	0	if ((retcode = WEXITSTATUS(status)) != 0)
278	0	xasprintf(&msg, "'%s' returned %d", cmd, retcode);
279	0	} else if (WIFSIGNALED(status)) {
280	0	retcode = WTERMSIG(status);
281	0	xasprintf(&msg, "'%s' terminated by signal %d", cmd, retcode);
282	0	retcode += 128;
283	0	} else
284	0	retcode = 0;
285	0	if (msg != NULL)
286	0	cmd_run_shell_print(job, msg);
287	0	free(msg);
288
289	0	if (item != NULL) {
290	0	if (cmdq_get_client(item) != NULL &&
291	0	cmdq_get_client(item)->session == NULL)
292	0	cmdq_get_client(item)->retval = retcode;
293	0	cmdq_continue(item);
294	0	}
295	0	}
296
297		static void
298		cmd_run_shell_free(void *data)
299	0	{
300	0	struct cmd_run_shell_data *cdata = data;
301
302	0	evtimer_del(&cdata->timer);
303	0	if (cdata->s != NULL)
304	0	session_remove_ref(cdata->s, __func__);
305	0	if (cdata->client != NULL)
306	0	server_client_unref(cdata->client);
307	0	if (cdata->state != NULL)
308	0	args_make_commands_free(cdata->state);
309	0	free(cdata->cwd);
310	0	free(cdata->cmd);
311	0	free(cdata);
312	0	}