xref: /openbsd-src/usr.bin/tmux/cmd.c (revision d4741794dd2f512d997014f8bd85fbb24d935059)
1 /* $OpenBSD: cmd.c,v 1.132 2017/01/10 18:10:24 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 #include <sys/time.h>
21 
22 #include <fnmatch.h>
23 #include <paths.h>
24 #include <pwd.h>
25 #include <stdlib.h>
26 #include <string.h>
27 #include <unistd.h>
28 
29 #include "tmux.h"
30 
31 extern const struct cmd_entry cmd_attach_session_entry;
32 extern const struct cmd_entry cmd_bind_key_entry;
33 extern const struct cmd_entry cmd_break_pane_entry;
34 extern const struct cmd_entry cmd_capture_pane_entry;
35 extern const struct cmd_entry cmd_choose_buffer_entry;
36 extern const struct cmd_entry cmd_choose_client_entry;
37 extern const struct cmd_entry cmd_choose_session_entry;
38 extern const struct cmd_entry cmd_choose_tree_entry;
39 extern const struct cmd_entry cmd_choose_window_entry;
40 extern const struct cmd_entry cmd_clear_history_entry;
41 extern const struct cmd_entry cmd_clock_mode_entry;
42 extern const struct cmd_entry cmd_command_prompt_entry;
43 extern const struct cmd_entry cmd_confirm_before_entry;
44 extern const struct cmd_entry cmd_copy_mode_entry;
45 extern const struct cmd_entry cmd_delete_buffer_entry;
46 extern const struct cmd_entry cmd_detach_client_entry;
47 extern const struct cmd_entry cmd_display_message_entry;
48 extern const struct cmd_entry cmd_display_panes_entry;
49 extern const struct cmd_entry cmd_down_pane_entry;
50 extern const struct cmd_entry cmd_find_window_entry;
51 extern const struct cmd_entry cmd_has_session_entry;
52 extern const struct cmd_entry cmd_if_shell_entry;
53 extern const struct cmd_entry cmd_join_pane_entry;
54 extern const struct cmd_entry cmd_kill_pane_entry;
55 extern const struct cmd_entry cmd_kill_server_entry;
56 extern const struct cmd_entry cmd_kill_session_entry;
57 extern const struct cmd_entry cmd_kill_window_entry;
58 extern const struct cmd_entry cmd_last_pane_entry;
59 extern const struct cmd_entry cmd_last_window_entry;
60 extern const struct cmd_entry cmd_link_window_entry;
61 extern const struct cmd_entry cmd_list_buffers_entry;
62 extern const struct cmd_entry cmd_list_clients_entry;
63 extern const struct cmd_entry cmd_list_commands_entry;
64 extern const struct cmd_entry cmd_list_keys_entry;
65 extern const struct cmd_entry cmd_list_panes_entry;
66 extern const struct cmd_entry cmd_list_sessions_entry;
67 extern const struct cmd_entry cmd_list_windows_entry;
68 extern const struct cmd_entry cmd_load_buffer_entry;
69 extern const struct cmd_entry cmd_lock_client_entry;
70 extern const struct cmd_entry cmd_lock_server_entry;
71 extern const struct cmd_entry cmd_lock_session_entry;
72 extern const struct cmd_entry cmd_move_pane_entry;
73 extern const struct cmd_entry cmd_move_window_entry;
74 extern const struct cmd_entry cmd_new_session_entry;
75 extern const struct cmd_entry cmd_new_window_entry;
76 extern const struct cmd_entry cmd_next_layout_entry;
77 extern const struct cmd_entry cmd_next_window_entry;
78 extern const struct cmd_entry cmd_paste_buffer_entry;
79 extern const struct cmd_entry cmd_pipe_pane_entry;
80 extern const struct cmd_entry cmd_previous_layout_entry;
81 extern const struct cmd_entry cmd_previous_window_entry;
82 extern const struct cmd_entry cmd_refresh_client_entry;
83 extern const struct cmd_entry cmd_rename_session_entry;
84 extern const struct cmd_entry cmd_rename_window_entry;
85 extern const struct cmd_entry cmd_resize_pane_entry;
86 extern const struct cmd_entry cmd_respawn_pane_entry;
87 extern const struct cmd_entry cmd_respawn_window_entry;
88 extern const struct cmd_entry cmd_rotate_window_entry;
89 extern const struct cmd_entry cmd_run_shell_entry;
90 extern const struct cmd_entry cmd_save_buffer_entry;
91 extern const struct cmd_entry cmd_select_layout_entry;
92 extern const struct cmd_entry cmd_select_pane_entry;
93 extern const struct cmd_entry cmd_select_window_entry;
94 extern const struct cmd_entry cmd_send_keys_entry;
95 extern const struct cmd_entry cmd_send_prefix_entry;
96 extern const struct cmd_entry cmd_server_info_entry;
97 extern const struct cmd_entry cmd_set_buffer_entry;
98 extern const struct cmd_entry cmd_set_environment_entry;
99 extern const struct cmd_entry cmd_set_hook_entry;
100 extern const struct cmd_entry cmd_set_option_entry;
101 extern const struct cmd_entry cmd_set_window_option_entry;
102 extern const struct cmd_entry cmd_show_buffer_entry;
103 extern const struct cmd_entry cmd_show_environment_entry;
104 extern const struct cmd_entry cmd_show_hooks_entry;
105 extern const struct cmd_entry cmd_show_messages_entry;
106 extern const struct cmd_entry cmd_show_options_entry;
107 extern const struct cmd_entry cmd_show_window_options_entry;
108 extern const struct cmd_entry cmd_source_file_entry;
109 extern const struct cmd_entry cmd_split_window_entry;
110 extern const struct cmd_entry cmd_start_server_entry;
111 extern const struct cmd_entry cmd_suspend_client_entry;
112 extern const struct cmd_entry cmd_swap_pane_entry;
113 extern const struct cmd_entry cmd_swap_window_entry;
114 extern const struct cmd_entry cmd_switch_client_entry;
115 extern const struct cmd_entry cmd_unbind_key_entry;
116 extern const struct cmd_entry cmd_unlink_window_entry;
117 extern const struct cmd_entry cmd_up_pane_entry;
118 extern const struct cmd_entry cmd_wait_for_entry;
119 
120 const struct cmd_entry *cmd_table[] = {
121 	&cmd_attach_session_entry,
122 	&cmd_bind_key_entry,
123 	&cmd_break_pane_entry,
124 	&cmd_capture_pane_entry,
125 	&cmd_choose_buffer_entry,
126 	&cmd_choose_client_entry,
127 	&cmd_choose_session_entry,
128 	&cmd_choose_tree_entry,
129 	&cmd_choose_window_entry,
130 	&cmd_clear_history_entry,
131 	&cmd_clock_mode_entry,
132 	&cmd_command_prompt_entry,
133 	&cmd_confirm_before_entry,
134 	&cmd_copy_mode_entry,
135 	&cmd_delete_buffer_entry,
136 	&cmd_detach_client_entry,
137 	&cmd_display_message_entry,
138 	&cmd_display_panes_entry,
139 	&cmd_find_window_entry,
140 	&cmd_has_session_entry,
141 	&cmd_if_shell_entry,
142 	&cmd_join_pane_entry,
143 	&cmd_kill_pane_entry,
144 	&cmd_kill_server_entry,
145 	&cmd_kill_session_entry,
146 	&cmd_kill_window_entry,
147 	&cmd_last_pane_entry,
148 	&cmd_last_window_entry,
149 	&cmd_link_window_entry,
150 	&cmd_list_buffers_entry,
151 	&cmd_list_clients_entry,
152 	&cmd_list_commands_entry,
153 	&cmd_list_keys_entry,
154 	&cmd_list_panes_entry,
155 	&cmd_list_sessions_entry,
156 	&cmd_list_windows_entry,
157 	&cmd_load_buffer_entry,
158 	&cmd_lock_client_entry,
159 	&cmd_lock_server_entry,
160 	&cmd_lock_session_entry,
161 	&cmd_move_pane_entry,
162 	&cmd_move_window_entry,
163 	&cmd_new_session_entry,
164 	&cmd_new_window_entry,
165 	&cmd_next_layout_entry,
166 	&cmd_next_window_entry,
167 	&cmd_paste_buffer_entry,
168 	&cmd_pipe_pane_entry,
169 	&cmd_previous_layout_entry,
170 	&cmd_previous_window_entry,
171 	&cmd_refresh_client_entry,
172 	&cmd_rename_session_entry,
173 	&cmd_rename_window_entry,
174 	&cmd_resize_pane_entry,
175 	&cmd_respawn_pane_entry,
176 	&cmd_respawn_window_entry,
177 	&cmd_rotate_window_entry,
178 	&cmd_run_shell_entry,
179 	&cmd_save_buffer_entry,
180 	&cmd_select_layout_entry,
181 	&cmd_select_pane_entry,
182 	&cmd_select_window_entry,
183 	&cmd_send_keys_entry,
184 	&cmd_send_prefix_entry,
185 	&cmd_server_info_entry,
186 	&cmd_set_buffer_entry,
187 	&cmd_set_environment_entry,
188 	&cmd_set_hook_entry,
189 	&cmd_set_option_entry,
190 	&cmd_set_window_option_entry,
191 	&cmd_show_buffer_entry,
192 	&cmd_show_environment_entry,
193 	&cmd_show_hooks_entry,
194 	&cmd_show_messages_entry,
195 	&cmd_show_options_entry,
196 	&cmd_show_window_options_entry,
197 	&cmd_source_file_entry,
198 	&cmd_split_window_entry,
199 	&cmd_start_server_entry,
200 	&cmd_suspend_client_entry,
201 	&cmd_swap_pane_entry,
202 	&cmd_swap_window_entry,
203 	&cmd_switch_client_entry,
204 	&cmd_unbind_key_entry,
205 	&cmd_unlink_window_entry,
206 	&cmd_wait_for_entry,
207 	NULL
208 };
209 
210 int
211 cmd_pack_argv(int argc, char **argv, char *buf, size_t len)
212 {
213 	size_t	arglen;
214 	int	i;
215 
216 	if (argc == 0)
217 		return (0);
218 
219 	*buf = '\0';
220 	for (i = 0; i < argc; i++) {
221 		if (strlcpy(buf, argv[i], len) >= len)
222 			return (-1);
223 		arglen = strlen(argv[i]) + 1;
224 		buf += arglen;
225 		len -= arglen;
226 	}
227 
228 	return (0);
229 }
230 
231 int
232 cmd_unpack_argv(char *buf, size_t len, int argc, char ***argv)
233 {
234 	int	i;
235 	size_t	arglen;
236 
237 	if (argc == 0)
238 		return (0);
239 	*argv = xcalloc(argc, sizeof **argv);
240 
241 	buf[len - 1] = '\0';
242 	for (i = 0; i < argc; i++) {
243 		if (len == 0) {
244 			cmd_free_argv(argc, *argv);
245 			return (-1);
246 		}
247 
248 		arglen = strlen(buf) + 1;
249 		(*argv)[i] = xstrdup(buf);
250 		buf += arglen;
251 		len -= arglen;
252 	}
253 
254 	return (0);
255 }
256 
257 char **
258 cmd_copy_argv(int argc, char **argv)
259 {
260 	char	**new_argv;
261 	int	  i;
262 
263 	if (argc == 0)
264 		return (NULL);
265 	new_argv = xcalloc(argc + 1, sizeof *new_argv);
266 	for (i = 0; i < argc; i++) {
267 		if (argv[i] != NULL)
268 			new_argv[i] = xstrdup(argv[i]);
269 	}
270 	return (new_argv);
271 }
272 
273 void
274 cmd_free_argv(int argc, char **argv)
275 {
276 	int	i;
277 
278 	if (argc == 0)
279 		return;
280 	for (i = 0; i < argc; i++)
281 		free(argv[i]);
282 	free(argv);
283 }
284 
285 char *
286 cmd_stringify_argv(int argc, char **argv)
287 {
288 	char	*buf;
289 	int	 i;
290 	size_t	 len;
291 
292 	if (argc == 0)
293 		return (xstrdup(""));
294 
295 	len = 0;
296 	buf = NULL;
297 
298 	for (i = 0; i < argc; i++) {
299 		len += strlen(argv[i]) + 1;
300 		buf = xrealloc(buf, len);
301 
302 		if (i == 0)
303 			*buf = '\0';
304 		else
305 			strlcat(buf, " ", len);
306 		strlcat(buf, argv[i], len);
307 	}
308 	return (buf);
309 }
310 
311 struct cmd *
312 cmd_parse(int argc, char **argv, const char *file, u_int line, char **cause)
313 {
314 	const struct cmd_entry **entryp, *entry;
315 	struct cmd		*cmd;
316 	struct args		*args;
317 	char			 s[BUFSIZ];
318 	int			 ambiguous = 0;
319 
320 	*cause = NULL;
321 	if (argc == 0) {
322 		xasprintf(cause, "no command");
323 		return (NULL);
324 	}
325 
326 	entry = NULL;
327 	for (entryp = cmd_table; *entryp != NULL; entryp++) {
328 		if ((*entryp)->alias != NULL &&
329 		    strcmp((*entryp)->alias, argv[0]) == 0) {
330 			ambiguous = 0;
331 			entry = *entryp;
332 			break;
333 		}
334 
335 		if (strncmp((*entryp)->name, argv[0], strlen(argv[0])) != 0)
336 			continue;
337 		if (entry != NULL)
338 			ambiguous = 1;
339 		entry = *entryp;
340 
341 		/* Bail now if an exact match. */
342 		if (strcmp(entry->name, argv[0]) == 0)
343 			break;
344 	}
345 	if (ambiguous)
346 		goto ambiguous;
347 	if (entry == NULL) {
348 		xasprintf(cause, "unknown command: %s", argv[0]);
349 		return (NULL);
350 	}
351 
352 	args = args_parse(entry->args.template, argc, argv);
353 	if (args == NULL)
354 		goto usage;
355 	if (entry->args.lower != -1 && args->argc < entry->args.lower)
356 		goto usage;
357 	if (entry->args.upper != -1 && args->argc > entry->args.upper)
358 		goto usage;
359 
360 	cmd = xcalloc(1, sizeof *cmd);
361 	cmd->entry = entry;
362 	cmd->args = args;
363 
364 	if (file != NULL)
365 		cmd->file = xstrdup(file);
366 	cmd->line = line;
367 
368 	return (cmd);
369 
370 ambiguous:
371 	*s = '\0';
372 	for (entryp = cmd_table; *entryp != NULL; entryp++) {
373 		if (strncmp((*entryp)->name, argv[0], strlen(argv[0])) != 0)
374 			continue;
375 		if (strlcat(s, (*entryp)->name, sizeof s) >= sizeof s)
376 			break;
377 		if (strlcat(s, ", ", sizeof s) >= sizeof s)
378 			break;
379 	}
380 	s[strlen(s) - 2] = '\0';
381 	xasprintf(cause, "ambiguous command: %s, could be: %s", argv[0], s);
382 	return (NULL);
383 
384 usage:
385 	if (args != NULL)
386 		args_free(args);
387 	xasprintf(cause, "usage: %s %s", entry->name, entry->usage);
388 	return (NULL);
389 }
390 
391 static int
392 cmd_prepare_state_flag(char c, const char *target, enum cmd_entry_flag flag,
393     struct cmdq_item *item)
394 {
395 	int			 targetflags, error;
396 	struct cmd_find_state	*fs = NULL;
397 	struct cmd_find_state	 current;
398 
399 	if (flag == CMD_NONE ||
400 	    flag == CMD_CLIENT ||
401 	    flag == CMD_CLIENT_CANFAIL)
402 		return (0);
403 
404 	if (c == 't')
405 		fs = &item->state.tflag;
406 	else if (c == 's')
407 		fs = &item->state.sflag;
408 
409 	if (flag == CMD_SESSION_WITHPANE) {
410 		if (target != NULL && target[strcspn(target, ":.")] != '\0')
411 			flag = CMD_PANE;
412 		else
413 			flag = CMD_SESSION_PREFERUNATTACHED;
414 	}
415 
416 	targetflags = 0;
417 	switch (flag) {
418 	case CMD_SESSION:
419 	case CMD_SESSION_CANFAIL:
420 	case CMD_SESSION_PREFERUNATTACHED:
421 	case CMD_SESSION_WITHPANE:
422 		if (flag == CMD_SESSION_CANFAIL)
423 			targetflags |= CMD_FIND_QUIET;
424 		if (flag == CMD_SESSION_PREFERUNATTACHED)
425 			targetflags |= CMD_FIND_PREFER_UNATTACHED;
426 		break;
427 	case CMD_MOVEW_R:
428 		flag = CMD_WINDOW_INDEX;
429 		/* FALLTHROUGH */
430 	case CMD_WINDOW:
431 	case CMD_WINDOW_CANFAIL:
432 	case CMD_WINDOW_MARKED:
433 	case CMD_WINDOW_INDEX:
434 		if (flag == CMD_WINDOW_CANFAIL)
435 			targetflags |= CMD_FIND_QUIET;
436 		if (flag == CMD_WINDOW_MARKED)
437 			targetflags |= CMD_FIND_DEFAULT_MARKED;
438 		if (flag == CMD_WINDOW_INDEX)
439 			targetflags |= CMD_FIND_WINDOW_INDEX;
440 		break;
441 	case CMD_PANE:
442 	case CMD_PANE_CANFAIL:
443 	case CMD_PANE_MARKED:
444 		if (flag == CMD_PANE_CANFAIL)
445 			targetflags |= CMD_FIND_QUIET;
446 		if (flag == CMD_PANE_MARKED)
447 			targetflags |= CMD_FIND_DEFAULT_MARKED;
448 		break;
449 	default:
450 		fatalx("unknown %cflag %d", c, flag);
451 	}
452 	log_debug("%s: flag %c %d %#x", __func__, c, flag, targetflags);
453 
454 	error = cmd_find_current(&current, item, targetflags);
455 	if (error != 0) {
456 		if (~targetflags & CMD_FIND_QUIET)
457 			return (-1);
458 		cmd_find_clear_state(&current, NULL, 0);
459 	}
460 	if (!cmd_find_empty_state(&current) && !cmd_find_valid_state(&current))
461 		fatalx("invalid current state");
462 
463 	switch (flag) {
464 	case CMD_NONE:
465 	case CMD_CLIENT:
466 	case CMD_CLIENT_CANFAIL:
467 		return (0);
468 	case CMD_SESSION:
469 	case CMD_SESSION_CANFAIL:
470 	case CMD_SESSION_PREFERUNATTACHED:
471 	case CMD_SESSION_WITHPANE:
472 		error = cmd_find_target(fs, &current, item, target,
473 		    CMD_FIND_SESSION, targetflags);
474 		if (error != 0)
475 			goto error;
476 		break;
477 	case CMD_MOVEW_R:
478 		error = cmd_find_target(fs, &current, item, target,
479 		    CMD_FIND_SESSION, CMD_FIND_QUIET);
480 		if (error == 0)
481 			break;
482 		/* FALLTHROUGH */
483 	case CMD_WINDOW:
484 	case CMD_WINDOW_CANFAIL:
485 	case CMD_WINDOW_MARKED:
486 	case CMD_WINDOW_INDEX:
487 		error = cmd_find_target(fs, &current, item, target,
488 		    CMD_FIND_WINDOW, targetflags);
489 		if (error != 0)
490 			goto error;
491 		break;
492 	case CMD_PANE:
493 	case CMD_PANE_CANFAIL:
494 	case CMD_PANE_MARKED:
495 		error = cmd_find_target(fs, &current, item, target,
496 		    CMD_FIND_PANE, targetflags);
497 		if (error != 0)
498 			goto error;
499 		break;
500 	default:
501 		fatalx("unknown %cflag %d", c, flag);
502 	}
503 	return (0);
504 
505 error:
506 	if (~targetflags & CMD_FIND_QUIET)
507 		return (-1);
508 	cmd_find_clear_state(fs, NULL, 0);
509 	return (0);
510 }
511 
512 int
513 cmd_prepare_state(struct cmd *cmd, struct cmdq_item *item)
514 {
515 	const struct cmd_entry	*entry = cmd->entry;
516 	struct cmd_state	*state = &item->state;
517 	char			*tmp;
518 	enum cmd_entry_flag	 flag;
519 	const char		*s;
520 	int			 error;
521 
522 	tmp = cmd_print(cmd);
523 	log_debug("preparing state for %s (client %p)", tmp, item->client);
524 	free(tmp);
525 
526 	state->c = NULL;
527 	cmd_find_clear_state(&state->tflag, NULL, 0);
528 	cmd_find_clear_state(&state->sflag, NULL, 0);
529 
530 	flag = cmd->entry->cflag;
531 	if (flag == CMD_NONE) {
532 		flag = cmd->entry->tflag;
533 		if (flag == CMD_CLIENT || flag == CMD_CLIENT_CANFAIL)
534 			s = args_get(cmd->args, 't');
535 		else
536 			s = NULL;
537 	} else
538 		s = args_get(cmd->args, 'c');
539 	switch (flag) {
540 	case CMD_CLIENT:
541 		state->c = cmd_find_client(item, s, 0);
542 		if (state->c == NULL)
543 			return (-1);
544 		break;
545 	default:
546 		state->c = cmd_find_client(item, s, 1);
547 		break;
548 	}
549 	log_debug("using client %p", state->c);
550 
551 	s = args_get(cmd->args, 't');
552 	log_debug("preparing -t state: target %s", s == NULL ? "none" : s);
553 
554 	error = cmd_prepare_state_flag('t', s, entry->tflag, item);
555 	if (error != 0)
556 		return (error);
557 
558 	s = args_get(cmd->args, 's');
559 	log_debug("preparing -s state: target %s", s == NULL ? "none" : s);
560 
561 	error = cmd_prepare_state_flag('s', s, entry->sflag, item);
562 	if (error != 0)
563 		return (error);
564 
565 	if (!cmd_find_empty_state(&state->tflag) &&
566 	    !cmd_find_valid_state(&state->tflag))
567 		fatalx("invalid -t state");
568 	if (!cmd_find_empty_state(&state->sflag) &&
569 	    !cmd_find_valid_state(&state->sflag))
570 		fatalx("invalid -s state");
571 
572 	return (0);
573 }
574 
575 char *
576 cmd_print(struct cmd *cmd)
577 {
578 	char	*out, *s;
579 
580 	s = args_print(cmd->args);
581 	if (*s != '\0')
582 		xasprintf(&out, "%s %s", cmd->entry->name, s);
583 	else
584 		out = xstrdup(cmd->entry->name);
585 	free(s);
586 
587 	return (out);
588 }
589 
590 /* Adjust current mouse position for a pane. */
591 int
592 cmd_mouse_at(struct window_pane *wp, struct mouse_event *m, u_int *xp,
593     u_int *yp, int last)
594 {
595 	u_int	x, y;
596 
597 	if (last) {
598 		x = m->lx;
599 		y = m->ly;
600 	} else {
601 		x = m->x;
602 		y = m->y;
603 	}
604 
605 	if (m->statusat == 0 && y > 0)
606 		y--;
607 	else if (m->statusat > 0 && y >= (u_int)m->statusat)
608 		y = m->statusat - 1;
609 
610 	if (x < wp->xoff || x >= wp->xoff + wp->sx)
611 		return (-1);
612 	if (y < wp->yoff || y >= wp->yoff + wp->sy)
613 		return (-1);
614 
615 	if (xp != NULL)
616 		*xp = x - wp->xoff;
617 	if (yp != NULL)
618 		*yp = y - wp->yoff;
619 	return (0);
620 }
621 
622 /* Get current mouse window if any. */
623 struct winlink *
624 cmd_mouse_window(struct mouse_event *m, struct session **sp)
625 {
626 	struct session	*s;
627 	struct window	*w;
628 
629 	if (!m->valid || m->s == -1 || m->w == -1)
630 		return (NULL);
631 	if ((s = session_find_by_id(m->s)) == NULL)
632 		return (NULL);
633 	if ((w = window_find_by_id(m->w)) == NULL)
634 		return (NULL);
635 
636 	if (sp != NULL)
637 		*sp = s;
638 	return (winlink_find_by_window(&s->windows, w));
639 }
640 
641 /* Get current mouse pane if any. */
642 struct window_pane *
643 cmd_mouse_pane(struct mouse_event *m, struct session **sp,
644     struct winlink **wlp)
645 {
646 	struct winlink		*wl;
647 	struct window_pane     	*wp;
648 
649 	if ((wl = cmd_mouse_window(m, sp)) == NULL)
650 		return (NULL);
651 	if ((wp = window_pane_find_by_id(m->wp)) == NULL)
652 		return (NULL);
653 	if (!window_has_pane(wl->window, wp))
654 		return (NULL);
655 
656 	if (wlp != NULL)
657 		*wlp = wl;
658 	return (wp);
659 }
660 
661 /* Replace the first %% or %idx in template by s. */
662 char *
663 cmd_template_replace(const char *template, const char *s, int idx)
664 {
665 	char		 ch, *buf;
666 	const char	*ptr, *cp, quote[] = "\"\\$";
667 	int		 replaced, quoted;
668 	size_t		 len;
669 
670 	if (strchr(template, '%') == NULL)
671 		return (xstrdup(template));
672 
673 	buf = xmalloc(1);
674 	*buf = '\0';
675 	len = 0;
676 	replaced = 0;
677 
678 	ptr = template;
679 	while (*ptr != '\0') {
680 		switch (ch = *ptr++) {
681 		case '%':
682 			if (*ptr < '1' || *ptr > '9' || *ptr - '0' != idx) {
683 				if (*ptr != '%' || replaced)
684 					break;
685 				replaced = 1;
686 			}
687 			ptr++;
688 
689 			quoted = (*ptr == '%');
690 			if (quoted)
691 				ptr++;
692 
693 			buf = xrealloc(buf, len + (strlen(s) * 3) + 1);
694 			for (cp = s; *cp != '\0'; cp++) {
695 				if (quoted && strchr(quote, *cp) != NULL)
696 					buf[len++] = '\\';
697 				if (quoted && *cp == ';') {
698 					buf[len++] = '\\';
699 					buf[len++] = '\\';
700 				}
701 				buf[len++] = *cp;
702 			}
703 			buf[len] = '\0';
704 			continue;
705 		}
706 		buf = xrealloc(buf, len + 2);
707 		buf[len++] = ch;
708 		buf[len] = '\0';
709 	}
710 
711 	return (buf);
712 }
713