xref: /vim-8.2.3635/src/if_cscope.c (revision 26190b27)
1 /* vi:set ts=8 sts=4 sw=4 noet:
2  *
3  * CSCOPE support for Vim added by Andy Kahn <[email protected]>
4  * Ported to Win32 by Sergey Khorev <[email protected]>
5  *
6  * The basic idea/structure of cscope for Vim was borrowed from Nvi.  There
7  * might be a few lines of code that look similar to what Nvi has.
8  *
9  * See README.txt for an overview of the Vim source code.
10  */
11 
12 #include "vim.h"
13 
14 #if defined(FEAT_CSCOPE) || defined(PROTO)
15 
16 #include <sys/types.h>
17 #include <sys/stat.h>
18 #if defined(UNIX)
19 # include <sys/wait.h>
20 #endif
21 #include "if_cscope.h"
22 
23 static int	    cs_add(exarg_T *eap);
24 static int	    cs_add_common(char *, char *, char *);
25 static int	    cs_check_for_connections(void);
26 static int	    cs_check_for_tags(void);
27 static int	    cs_cnt_connections(void);
28 static int	    cs_create_connection(int i);
29 #ifdef FEAT_QUICKFIX
30 static void	    cs_file_results(FILE *, int *);
31 #endif
32 static void	    cs_fill_results(char *, int , int *, char ***,
33 			char ***, int *);
34 static int	    cs_find(exarg_T *eap);
35 static int	    cs_find_common(char *opt, char *pat, int, int, int, char_u *cmdline);
36 static int	    cs_help(exarg_T *eap);
37 static int	    cs_insert_filelist(char *, char *, char *,
38 			stat_T *);
39 static int	    cs_kill(exarg_T *eap);
40 static void	    cs_kill_execute(int, char *);
41 static cscmd_T *    cs_lookup_cmd(exarg_T *eap);
42 static char *	    cs_make_vim_style_matches(char *, char *,
43 			char *, char *);
44 static char *	    cs_manage_matches(char **, char **, int, mcmd_e);
45 static void	    cs_print_tags_priv(char **, char **, int);
46 static int	    cs_read_prompt(int);
47 static void	    cs_release_csp(int, int freefnpp);
48 static int	    cs_reset(exarg_T *eap);
49 static char *	    cs_resolve_file(int, char *);
50 static int	    cs_show(exarg_T *eap);
51 
52 
53 static csinfo_T *   csinfo = NULL;
54 static int	    csinfo_size = 0;	// number of items allocated in
55 					// csinfo[]
56 
57 static int	    eap_arg_len;    // length of eap->arg, set in
58 				    // cs_lookup_cmd()
59 static cscmd_T	    cs_cmds[] =
60 {
61     { "add",	cs_add,
62 		N_("Add a new database"),     "add file|dir [pre-path] [flags]", 0 },
63     { "find",	cs_find,
64 		N_("Query for a pattern"),    "find a|c|d|e|f|g|i|s|t name", 1 },
65     { "help",	cs_help,
66 		N_("Show this message"),      "help", 0 },
67     { "kill",	cs_kill,
68 		N_("Kill a connection"),      "kill #", 0 },
69     { "reset",	cs_reset,
70 		N_("Reinit all connections"), "reset", 0 },
71     { "show",	cs_show,
72 		N_("Show connections"),       "show", 0 },
73     { NULL, NULL, NULL, NULL, 0 }
74 };
75 
76     static void
77 cs_usage_msg(csid_e x)
78 {
79     (void)semsg(_("E560: Usage: cs[cope] %s"), cs_cmds[(int)x].usage);
80 }
81 
82 static enum
83 {
84     EXP_CSCOPE_SUBCMD,	// expand ":cscope" sub-commands
85     EXP_SCSCOPE_SUBCMD,	// expand ":scscope" sub-commands
86     EXP_CSCOPE_FIND,	// expand ":cscope find" arguments
87     EXP_CSCOPE_KILL	// expand ":cscope kill" arguments
88 } expand_what;
89 
90 /*
91  * Function given to ExpandGeneric() to obtain the cscope command
92  * expansion.
93  */
94     char_u *
95 get_cscope_name(expand_T *xp UNUSED, int idx)
96 {
97     int		current_idx;
98     int		i;
99 
100     switch (expand_what)
101     {
102     case EXP_CSCOPE_SUBCMD:
103 	// Complete with sub-commands of ":cscope":
104 	// add, find, help, kill, reset, show
105 	return (char_u *)cs_cmds[idx].name;
106     case EXP_SCSCOPE_SUBCMD:
107 	// Complete with sub-commands of ":scscope": same sub-commands as
108 	// ":cscope" but skip commands which don't support split windows
109 	for (i = 0, current_idx = 0; cs_cmds[i].name != NULL; i++)
110 	    if (cs_cmds[i].cansplit)
111 		if (current_idx++ == idx)
112 		    break;
113 	return (char_u *)cs_cmds[i].name;
114     case EXP_CSCOPE_FIND:
115 	{
116 	    const char *query_type[] =
117 	    {
118 		"a", "c", "d", "e", "f", "g", "i", "s", "t", NULL
119 	    };
120 
121 	    // Complete with query type of ":cscope find {query_type}".
122 	    // {query_type} can be letters (c, d, ... a) or numbers (0, 1,
123 	    // ..., 9) but only complete with letters, since numbers are
124 	    // redundant.
125 	    return (char_u *)query_type[idx];
126 	}
127     case EXP_CSCOPE_KILL:
128 	{
129 	    static char	connection[5];
130 
131 	    // ":cscope kill" accepts connection numbers or partial names of
132 	    // the pathname of the cscope database as argument.  Only complete
133 	    // with connection numbers. -1 can also be used to kill all
134 	    // connections.
135 	    for (i = 0, current_idx = 0; i < csinfo_size; i++)
136 	    {
137 		if (csinfo[i].fname == NULL)
138 		    continue;
139 		if (current_idx++ == idx)
140 		{
141 		    vim_snprintf(connection, sizeof(connection), "%d", i);
142 		    return (char_u *)connection;
143 		}
144 	    }
145 	    return (current_idx == idx && idx > 0) ? (char_u *)"-1" : NULL;
146 	}
147     default:
148 	return NULL;
149     }
150 }
151 
152 /*
153  * Handle command line completion for :cscope command.
154  */
155     void
156 set_context_in_cscope_cmd(
157     expand_T	*xp,
158     char_u	*arg,
159     cmdidx_T	cmdidx)
160 {
161     char_u	*p;
162 
163     // Default: expand subcommands
164     xp->xp_context = EXPAND_CSCOPE;
165     xp->xp_pattern = arg;
166     expand_what = (cmdidx == CMD_scscope)
167 			? EXP_SCSCOPE_SUBCMD : EXP_CSCOPE_SUBCMD;
168 
169     // (part of) subcommand already typed
170     if (*arg != NUL)
171     {
172 	p = skiptowhite(arg);
173 	if (*p != NUL)		    // past first word
174 	{
175 	    xp->xp_pattern = skipwhite(p);
176 	    if (*skiptowhite(xp->xp_pattern) != NUL)
177 		xp->xp_context = EXPAND_NOTHING;
178 	    else if (STRNICMP(arg, "add", p - arg) == 0)
179 		xp->xp_context = EXPAND_FILES;
180 	    else if (STRNICMP(arg, "kill", p - arg) == 0)
181 		expand_what = EXP_CSCOPE_KILL;
182 	    else if (STRNICMP(arg, "find", p - arg) == 0)
183 		expand_what = EXP_CSCOPE_FIND;
184 	    else
185 		xp->xp_context = EXPAND_NOTHING;
186 	}
187     }
188 }
189 
190 /*
191  * Find the command, print help if invalid, and then call the corresponding
192  * command function.
193  */
194     static void
195 do_cscope_general(
196     exarg_T	*eap,
197     int		make_split UNUSED) // whether to split window
198 {
199     cscmd_T *cmdp;
200 
201     if ((cmdp = cs_lookup_cmd(eap)) == NULL)
202     {
203 	cs_help(eap);
204 	return;
205     }
206 
207     if (make_split)
208     {
209 	if (!cmdp->cansplit)
210 	{
211 	    (void)msg_puts(_("This cscope command does not support splitting the window.\n"));
212 	    return;
213 	}
214 	postponed_split = -1;
215 	postponed_split_flags = cmdmod.cmod_split;
216 	postponed_split_tab = cmdmod.cmod_tab;
217     }
218 
219     cmdp->func(eap);
220 
221     postponed_split_flags = 0;
222     postponed_split_tab = 0;
223 }
224 
225 /*
226  * Implementation of ":cscope" and ":lcscope"
227  */
228     void
229 ex_cscope(exarg_T *eap)
230 {
231     do_cscope_general(eap, FALSE);
232 }
233 
234 /*
235  * Implementation of ":scscope". Same as ex_cscope(), but splits window, too.
236  */
237     void
238 ex_scscope(exarg_T *eap)
239 {
240     do_cscope_general(eap, TRUE);
241 }
242 
243 /*
244  * Implementation of ":cstag"
245  */
246     void
247 ex_cstag(exarg_T *eap)
248 {
249     int ret = FALSE;
250 
251     if (*eap->arg == NUL)
252     {
253 	(void)emsg(_("E562: Usage: cstag <ident>"));
254 	return;
255     }
256 
257     switch (p_csto)
258     {
259     case 0 :
260 	if (cs_check_for_connections())
261 	{
262 	    ret = cs_find_common("g", (char *)(eap->arg), eap->forceit, FALSE,
263 						       FALSE, *eap->cmdlinep);
264 	    if (ret == FALSE)
265 	    {
266 		cs_free_tags();
267 		if (msg_col)
268 		    msg_putchar('\n');
269 
270 		if (cs_check_for_tags())
271 		    ret = do_tag(eap->arg, DT_JUMP, 0, eap->forceit, FALSE);
272 	    }
273 	}
274 	else if (cs_check_for_tags())
275 	{
276 	    ret = do_tag(eap->arg, DT_JUMP, 0, eap->forceit, FALSE);
277 	}
278 	break;
279     case 1 :
280 	if (cs_check_for_tags())
281 	{
282 	    ret = do_tag(eap->arg, DT_JUMP, 0, eap->forceit, FALSE);
283 	    if (ret == FALSE)
284 	    {
285 		if (msg_col)
286 		    msg_putchar('\n');
287 
288 		if (cs_check_for_connections())
289 		{
290 		    ret = cs_find_common("g", (char *)(eap->arg), eap->forceit,
291 						FALSE, FALSE, *eap->cmdlinep);
292 		    if (ret == FALSE)
293 			cs_free_tags();
294 		}
295 	    }
296 	}
297 	else if (cs_check_for_connections())
298 	{
299 	    ret = cs_find_common("g", (char *)(eap->arg), eap->forceit, FALSE,
300 						       FALSE, *eap->cmdlinep);
301 	    if (ret == FALSE)
302 		cs_free_tags();
303 	}
304 	break;
305     default :
306 	break;
307     }
308 
309     if (!ret)
310     {
311 	(void)emsg(_("E257: cstag: tag not found"));
312 #if defined(FEAT_QUICKFIX)
313 	g_do_tagpreview = 0;
314 #endif
315     }
316 
317 }
318 
319 
320 /*
321  * This simulates a vim_fgets(), but for cscope, returns the next line
322  * from the cscope output.  should only be called from find_tags()
323  *
324  * returns TRUE if eof, FALSE otherwise
325  */
326     int
327 cs_fgets(char_u *buf, int size)
328 {
329     char *p;
330 
331     if ((p = cs_manage_matches(NULL, NULL, -1, Get)) == NULL)
332 	return TRUE;
333     vim_strncpy(buf, (char_u *)p, size - 1);
334 
335     return FALSE;
336 }
337 
338 
339 /*
340  * Called only from do_tag(), when popping the tag stack.
341  */
342     void
343 cs_free_tags(void)
344 {
345     cs_manage_matches(NULL, NULL, -1, Free);
346 }
347 
348 
349 /*
350  * Called from do_tag().
351  */
352     void
353 cs_print_tags(void)
354 {
355     cs_manage_matches(NULL, NULL, -1, Print);
356 }
357 
358 
359 /*
360  * "cscope_connection([{num} , {dbpath} [, {prepend}]])" function
361  *
362  *		Checks for the existence of a |cscope| connection.  If no
363  *		parameters are specified, then the function returns:
364  *
365  *		0, if cscope was not available (not compiled in), or if there
366  *		are no cscope connections; or
367  *		1, if there is at least one cscope connection.
368  *
369  *		If parameters are specified, then the value of {num}
370  *		determines how existence of a cscope connection is checked:
371  *
372  *		{num}	Description of existence check
373  *		-----	------------------------------
374  *		0	Same as no parameters (e.g., "cscope_connection()").
375  *		1	Ignore {prepend}, and use partial string matches for
376  *			{dbpath}.
377  *		2	Ignore {prepend}, and use exact string matches for
378  *			{dbpath}.
379  *		3	Use {prepend}, use partial string matches for both
380  *			{dbpath} and {prepend}.
381  *		4	Use {prepend}, use exact string matches for both
382  *			{dbpath} and {prepend}.
383  *
384  *		Note: All string comparisons are case sensitive!
385  */
386 #if defined(FEAT_EVAL) || defined(PROTO)
387     static int
388 cs_connection(int num, char_u *dbpath, char_u *ppath)
389 {
390     int i;
391 
392     if (num < 0 || num > 4 || (num > 0 && !dbpath))
393 	return FALSE;
394 
395     for (i = 0; i < csinfo_size; i++)
396     {
397 	if (!csinfo[i].fname)
398 	    continue;
399 
400 	if (num == 0)
401 	    return TRUE;
402 
403 	switch (num)
404 	{
405 	case 1:
406 	    if (strstr(csinfo[i].fname, (char *)dbpath))
407 		return TRUE;
408 	    break;
409 	case 2:
410 	    if (strcmp(csinfo[i].fname, (char *)dbpath) == 0)
411 		return TRUE;
412 	    break;
413 	case 3:
414 	    if (strstr(csinfo[i].fname, (char *)dbpath)
415 		    && ((!ppath && !csinfo[i].ppath)
416 			|| (ppath
417 			    && csinfo[i].ppath
418 			    && strstr(csinfo[i].ppath, (char *)ppath))))
419 		return TRUE;
420 	    break;
421 	case 4:
422 	    if ((strcmp(csinfo[i].fname, (char *)dbpath) == 0)
423 		    && ((!ppath && !csinfo[i].ppath)
424 			|| (ppath
425 			    && csinfo[i].ppath
426 			    && (strcmp(csinfo[i].ppath, (char *)ppath) == 0))))
427 		return TRUE;
428 	    break;
429 	}
430     }
431 
432     return FALSE;
433 }
434 
435 #endif
436 
437 
438 /*
439  * PRIVATE functions
440  ****************************************************************************/
441 
442 /*
443  * Add cscope database or a directory name (to look for cscope.out)
444  * to the cscope connection list.
445  */
446     static int
447 cs_add(exarg_T *eap UNUSED)
448 {
449     char *fname, *ppath, *flags = NULL;
450 
451     if ((fname = strtok((char *)NULL, (const char *)" ")) == NULL)
452     {
453 	cs_usage_msg(Add);
454 	return CSCOPE_FAILURE;
455     }
456     if ((ppath = strtok((char *)NULL, (const char *)" ")) != NULL)
457 	flags = strtok((char *)NULL, (const char *)" ");
458 
459     return cs_add_common(fname, ppath, flags);
460 }
461 
462     static void
463 cs_stat_emsg(char *fname)
464 {
465     char *stat_emsg = _("E563: stat(%s) error: %d");
466     char *buf = alloc(strlen(stat_emsg) + MAXPATHL + 10);
467 
468     if (buf != NULL)
469     {
470 	(void)sprintf(buf, stat_emsg, fname, errno);
471 	(void)emsg(buf);
472 	vim_free(buf);
473     }
474     else
475 	(void)emsg(_("E563: stat error"));
476 }
477 
478 
479 /*
480  * The common routine to add a new cscope connection.  Called by
481  * cs_add() and cs_reset().  I really don't like to do this, but this
482  * routine uses a number of goto statements.
483  */
484     static int
485 cs_add_common(
486     char *arg1,	    // filename - may contain environment variables
487     char *arg2,	    // prepend path - may contain environment variables
488     char *flags)
489 {
490     stat_T	statbuf;
491     int		ret;
492     char	*fname = NULL;
493     char	*fname2 = NULL;
494     char	*ppath = NULL;
495     int		i;
496     int		len;
497     int		usedlen = 0;
498     char_u	*fbuf = NULL;
499 
500     // get the filename (arg1), expand it, and try to stat it
501     if ((fname = alloc(MAXPATHL + 1)) == NULL)
502 	goto add_err;
503 
504     expand_env((char_u *)arg1, (char_u *)fname, MAXPATHL);
505     len = (int)STRLEN(fname);
506     fbuf = (char_u *)fname;
507     (void)modify_fname((char_u *)":p", FALSE, &usedlen,
508 					      (char_u **)&fname, &fbuf, &len);
509     if (fname == NULL)
510 	goto add_err;
511     fname = (char *)vim_strnsave((char_u *)fname, len);
512     vim_free(fbuf);
513 
514     ret = mch_stat(fname, &statbuf);
515     if (ret < 0)
516     {
517 staterr:
518 	if (p_csverbose)
519 	    cs_stat_emsg(fname);
520 	goto add_err;
521     }
522 
523     // get the prepend path (arg2), expand it, and try to stat it
524     if (arg2 != NULL)
525     {
526 	stat_T	    statbuf2;
527 
528 	if ((ppath = alloc(MAXPATHL + 1)) == NULL)
529 	    goto add_err;
530 
531 	expand_env((char_u *)arg2, (char_u *)ppath, MAXPATHL);
532 	ret = mch_stat(ppath, &statbuf2);
533 	if (ret < 0)
534 	    goto staterr;
535     }
536 
537     // if filename is a directory, append the cscope database name to it
538     if (S_ISDIR(statbuf.st_mode))
539     {
540 	fname2 = alloc(strlen(CSCOPE_DBFILE) + strlen(fname) + 2);
541 	if (fname2 == NULL)
542 	    goto add_err;
543 
544 	while (fname[strlen(fname)-1] == '/'
545 #ifdef MSWIN
546 		|| fname[strlen(fname)-1] == '\\'
547 #endif
548 		)
549 	{
550 	    fname[strlen(fname)-1] = '\0';
551 	    if (fname[0] == '\0')
552 		break;
553 	}
554 	if (fname[0] == '\0')
555 	    (void)sprintf(fname2, "/%s", CSCOPE_DBFILE);
556 	else
557 	    (void)sprintf(fname2, "%s/%s", fname, CSCOPE_DBFILE);
558 
559 	ret = mch_stat(fname2, &statbuf);
560 	if (ret < 0)
561 	{
562 	    if (p_csverbose)
563 		cs_stat_emsg(fname2);
564 	    goto add_err;
565 	}
566 
567 	i = cs_insert_filelist(fname2, ppath, flags, &statbuf);
568     }
569     else if (S_ISREG(statbuf.st_mode) || S_ISLNK(statbuf.st_mode))
570     {
571 	i = cs_insert_filelist(fname, ppath, flags, &statbuf);
572     }
573     else
574     {
575 	if (p_csverbose)
576 	    (void)semsg(
577 		_("E564: %s is not a directory or a valid cscope database"),
578 		fname);
579 	goto add_err;
580     }
581 
582     if (i != -1)
583     {
584 	if (cs_create_connection(i) == CSCOPE_FAILURE
585 		|| cs_read_prompt(i) == CSCOPE_FAILURE)
586 	{
587 	    cs_release_csp(i, TRUE);
588 	    goto add_err;
589 	}
590 
591 	if (p_csverbose)
592 	{
593 	    msg_clr_eos();
594 	    (void)smsg_attr(HL_ATTR(HLF_R),
595 			    _("Added cscope database %s"),
596 			    csinfo[i].fname);
597 	}
598     }
599 
600     vim_free(fname);
601     vim_free(fname2);
602     vim_free(ppath);
603     return CSCOPE_SUCCESS;
604 
605 add_err:
606     vim_free(fname2);
607     vim_free(fname);
608     vim_free(ppath);
609     return CSCOPE_FAILURE;
610 }
611 
612 
613     static int
614 cs_check_for_connections(void)
615 {
616     return (cs_cnt_connections() > 0);
617 }
618 
619 
620     static int
621 cs_check_for_tags(void)
622 {
623     return (p_tags[0] != NUL && curbuf->b_p_tags != NULL);
624 }
625 
626 
627 /*
628  * Count the number of cscope connections.
629  */
630     static int
631 cs_cnt_connections(void)
632 {
633     short i;
634     short cnt = 0;
635 
636     for (i = 0; i < csinfo_size; i++)
637     {
638 	if (csinfo[i].fname != NULL)
639 	    cnt++;
640     }
641     return cnt;
642 }
643 
644     static void
645 cs_reading_emsg(
646     int idx)	// connection index
647 {
648     semsg(_("E262: error reading cscope connection %d"), idx);
649 }
650 
651 #define	CSREAD_BUFSIZE	2048
652 /*
653  * Count the number of matches for a given cscope connection.
654  */
655     static int
656 cs_cnt_matches(int idx)
657 {
658     char *stok;
659     char *buf;
660     int nlines = 0;
661 
662     buf = alloc(CSREAD_BUFSIZE);
663     if (buf == NULL)
664 	return 0;
665     for (;;)
666     {
667 	if (!fgets(buf, CSREAD_BUFSIZE, csinfo[idx].fr_fp))
668 	{
669 	    if (feof(csinfo[idx].fr_fp))
670 		errno = EIO;
671 
672 	    cs_reading_emsg(idx);
673 
674 	    vim_free(buf);
675 	    return -1;
676 	}
677 
678 	/*
679 	 * If the database is out of date, or there's some other problem,
680 	 * cscope will output error messages before the number-of-lines output.
681 	 * Display/discard any output that doesn't match what we want.
682 	 * Accept "\S*cscope: X lines", also matches "mlcscope".
683 	 * Bail out for the "Unable to search" error.
684 	 */
685 	if (strstr((const char *)buf, "Unable to search database") != NULL)
686 	    break;
687 	if ((stok = strtok(buf, (const char *)" ")) == NULL)
688 	    continue;
689 	if (strstr((const char *)stok, "cscope:") == NULL)
690 	    continue;
691 
692 	if ((stok = strtok(NULL, (const char *)" ")) == NULL)
693 	    continue;
694 	nlines = atoi(stok);
695 	if (nlines < 0)
696 	{
697 	    nlines = 0;
698 	    break;
699 	}
700 
701 	if ((stok = strtok(NULL, (const char *)" ")) == NULL)
702 	    continue;
703 	if (strncmp((const char *)stok, "lines", 5))
704 	    continue;
705 
706 	break;
707     }
708 
709     vim_free(buf);
710     return nlines;
711 }
712 
713 
714 /*
715  * Creates the actual cscope command query from what the user entered.
716  */
717     static char *
718 cs_create_cmd(char *csoption, char *pattern)
719 {
720     char *cmd;
721     short search;
722     char *pat;
723 
724     switch (csoption[0])
725     {
726     case '0' : case 's' :
727 	search = 0;
728 	break;
729     case '1' : case 'g' :
730 	search = 1;
731 	break;
732     case '2' : case 'd' :
733 	search = 2;
734 	break;
735     case '3' : case 'c' :
736 	search = 3;
737 	break;
738     case '4' : case 't' :
739 	search = 4;
740 	break;
741     case '6' : case 'e' :
742 	search = 6;
743 	break;
744     case '7' : case 'f' :
745 	search = 7;
746 	break;
747     case '8' : case 'i' :
748 	search = 8;
749 	break;
750     case '9' : case 'a' :
751 	search = 9;
752 	break;
753     default :
754 	(void)emsg(_("E561: unknown cscope search type"));
755 	cs_usage_msg(Find);
756 	return NULL;
757     }
758 
759     // Skip white space before the patter, except for text and pattern search,
760     // they may want to use the leading white space.
761     pat = pattern;
762     if (search != 4 && search != 6)
763 	while VIM_ISWHITE(*pat)
764 	    ++pat;
765 
766     if ((cmd = alloc(strlen(pat) + 2)) == NULL)
767 	return NULL;
768 
769     (void)sprintf(cmd, "%d%s", search, pat);
770 
771     return cmd;
772 }
773 
774 
775 /*
776  * This piece of code was taken/adapted from nvi.  do we need to add
777  * the BSD license notice?
778  */
779     static int
780 cs_create_connection(int i)
781 {
782 #ifdef UNIX
783     int		to_cs[2], from_cs[2];
784 #endif
785     int		len;
786     char	*prog, *cmd, *ppath = NULL;
787 #ifdef MSWIN
788     int		fd;
789     SECURITY_ATTRIBUTES sa;
790     PROCESS_INFORMATION pi;
791     STARTUPINFO si;
792     BOOL	pipe_stdin = FALSE, pipe_stdout = FALSE;
793     HANDLE	stdin_rd, stdout_rd;
794     HANDLE	stdout_wr, stdin_wr;
795     BOOL	created;
796 # if (defined(_MSC_VER) && (_MSC_VER >= 1300)) || defined(__MINGW32__)
797 #  define OPEN_OH_ARGTYPE intptr_t
798 # else
799 #  define OPEN_OH_ARGTYPE long
800 # endif
801 #endif
802 
803 #if defined(UNIX)
804     /*
805      * Cscope reads from to_cs[0] and writes to from_cs[1]; vi reads from
806      * from_cs[0] and writes to to_cs[1].
807      */
808     to_cs[0] = to_cs[1] = from_cs[0] = from_cs[1] = -1;
809     if (pipe(to_cs) < 0 || pipe(from_cs) < 0)
810     {
811 	(void)emsg(_("E566: Could not create cscope pipes"));
812 err_closing:
813 	if (to_cs[0] != -1)
814 	    (void)close(to_cs[0]);
815 	if (to_cs[1] != -1)
816 	    (void)close(to_cs[1]);
817 	if (from_cs[0] != -1)
818 	    (void)close(from_cs[0]);
819 	if (from_cs[1] != -1)
820 	    (void)close(from_cs[1]);
821 	return CSCOPE_FAILURE;
822     }
823 
824     switch (csinfo[i].pid = fork())
825     {
826     case -1:
827 	(void)emsg(_("E622: Could not fork for cscope"));
828 	goto err_closing;
829     case 0:				// child: run cscope.
830 	if (dup2(to_cs[0], STDIN_FILENO) == -1)
831 	    PERROR("cs_create_connection 1");
832 	if (dup2(from_cs[1], STDOUT_FILENO) == -1)
833 	    PERROR("cs_create_connection 2");
834 	if (dup2(from_cs[1], STDERR_FILENO) == -1)
835 	    PERROR("cs_create_connection 3");
836 
837 	// close unused
838 	(void)close(to_cs[1]);
839 	(void)close(from_cs[0]);
840 #else
841 	// MSWIN
842 	// Create pipes to communicate with cscope
843 	sa.nLength = sizeof(SECURITY_ATTRIBUTES);
844 	sa.bInheritHandle = TRUE;
845 	sa.lpSecurityDescriptor = NULL;
846 
847 	if (!(pipe_stdin = CreatePipe(&stdin_rd, &stdin_wr, &sa, 0))
848 		|| !(pipe_stdout = CreatePipe(&stdout_rd, &stdout_wr, &sa, 0)))
849 	{
850 	    (void)emsg(_("E566: Could not create cscope pipes"));
851 err_closing:
852 	    if (pipe_stdin)
853 	    {
854 		CloseHandle(stdin_rd);
855 		CloseHandle(stdin_wr);
856 	    }
857 	    if (pipe_stdout)
858 	    {
859 		CloseHandle(stdout_rd);
860 		CloseHandle(stdout_wr);
861 	    }
862 	    return CSCOPE_FAILURE;
863 	}
864 #endif
865 	// expand the cscope exec for env var's
866 	if ((prog = alloc(MAXPATHL + 1)) == NULL)
867 	{
868 #ifdef UNIX
869 	    return CSCOPE_FAILURE;
870 #else
871 	    // MSWIN
872 	    goto err_closing;
873 #endif
874 	}
875 	expand_env((char_u *)p_csprg, (char_u *)prog, MAXPATHL);
876 
877 	// alloc space to hold the cscope command
878 	len = (int)(strlen(prog) + strlen(csinfo[i].fname) + 32);
879 	if (csinfo[i].ppath)
880 	{
881 	    // expand the prepend path for env var's
882 	    if ((ppath = alloc(MAXPATHL + 1)) == NULL)
883 	    {
884 		vim_free(prog);
885 #ifdef UNIX
886 		return CSCOPE_FAILURE;
887 #else
888 		// MSWIN
889 		goto err_closing;
890 #endif
891 	    }
892 	    expand_env((char_u *)csinfo[i].ppath, (char_u *)ppath, MAXPATHL);
893 
894 	    len += (int)strlen(ppath);
895 	}
896 
897 	if (csinfo[i].flags)
898 	    len += (int)strlen(csinfo[i].flags);
899 
900 	if ((cmd = alloc(len)) == NULL)
901 	{
902 	    vim_free(prog);
903 	    vim_free(ppath);
904 #ifdef UNIX
905 	    return CSCOPE_FAILURE;
906 #else
907 	    // MSWIN
908 	    goto err_closing;
909 #endif
910 	}
911 
912 	// run the cscope command; is there execl for non-unix systems?
913 #if defined(UNIX)
914 	(void)sprintf(cmd, "exec %s -dl -f %s", prog, csinfo[i].fname);
915 #else
916 	// MSWIN
917 	(void)sprintf(cmd, "%s -dl -f %s", prog, csinfo[i].fname);
918 #endif
919 	if (csinfo[i].ppath != NULL)
920 	{
921 	    (void)strcat(cmd, " -P");
922 	    (void)strcat(cmd, csinfo[i].ppath);
923 	}
924 	if (csinfo[i].flags != NULL)
925 	{
926 	    (void)strcat(cmd, " ");
927 	    (void)strcat(cmd, csinfo[i].flags);
928 	}
929 # ifdef UNIX
930 	// on Win32 we still need prog
931 	vim_free(prog);
932 # endif
933 	vim_free(ppath);
934 
935 #if defined(UNIX)
936 # if defined(HAVE_SETSID) || defined(HAVE_SETPGID)
937 	// Change our process group to avoid cscope receiving SIGWINCH.
938 #  if defined(HAVE_SETSID)
939 	(void)setsid();
940 #  else
941 	if (setpgid(0, 0) == -1)
942 	    PERROR(_("cs_create_connection setpgid failed"));
943 #  endif
944 # endif
945 	if (execl("/bin/sh", "sh", "-c", cmd, (char *)NULL) == -1)
946 	    PERROR(_("cs_create_connection exec failed"));
947 
948 	exit(127);
949 	// NOTREACHED
950     default:	// parent.
951 	/*
952 	 * Save the file descriptors for later duplication, and
953 	 * reopen as streams.
954 	 */
955 	if ((csinfo[i].to_fp = fdopen(to_cs[1], "w")) == NULL)
956 	    PERROR(_("cs_create_connection: fdopen for to_fp failed"));
957 	if ((csinfo[i].fr_fp = fdopen(from_cs[0], "r")) == NULL)
958 	    PERROR(_("cs_create_connection: fdopen for fr_fp failed"));
959 
960 	// close unused
961 	(void)close(to_cs[0]);
962 	(void)close(from_cs[1]);
963 
964 	break;
965     }
966 
967 #else
968     // MSWIN
969     // Create a new process to run cscope and use pipes to talk with it
970     GetStartupInfo(&si);
971     si.dwFlags = STARTF_USESTDHANDLES | STARTF_USESHOWWINDOW;
972     si.wShowWindow = SW_HIDE;  // Hide child application window
973     si.hStdOutput = stdout_wr;
974     si.hStdError  = stdout_wr;
975     si.hStdInput  = stdin_rd;
976     created = CreateProcess(NULL, cmd, NULL, NULL, TRUE, CREATE_NEW_CONSOLE,
977 							NULL, NULL, &si, &pi);
978     vim_free(prog);
979     vim_free(cmd);
980 
981     if (!created)
982     {
983 	PERROR(_("cs_create_connection exec failed"));
984 	(void)emsg(_("E623: Could not spawn cscope process"));
985 	goto err_closing;
986     }
987     // else
988     csinfo[i].pid = pi.dwProcessId;
989     csinfo[i].hProc = pi.hProcess;
990     CloseHandle(pi.hThread);
991 
992     // TODO - tidy up after failure to create files on pipe handles.
993     if (((fd = _open_osfhandle((OPEN_OH_ARGTYPE)stdin_wr,
994 						      _O_TEXT|_O_APPEND)) < 0)
995 	    || ((csinfo[i].to_fp = _fdopen(fd, "w")) == NULL))
996 	PERROR(_("cs_create_connection: fdopen for to_fp failed"));
997     if (((fd = _open_osfhandle((OPEN_OH_ARGTYPE)stdout_rd,
998 						      _O_TEXT|_O_RDONLY)) < 0)
999 	    || ((csinfo[i].fr_fp = _fdopen(fd, "r")) == NULL))
1000 	PERROR(_("cs_create_connection: fdopen for fr_fp failed"));
1001 
1002     // Close handles for file descriptors inherited by the cscope process
1003     CloseHandle(stdin_rd);
1004     CloseHandle(stdout_wr);
1005 
1006 #endif // !UNIX
1007 
1008     return CSCOPE_SUCCESS;
1009 }
1010 
1011 
1012 /*
1013  * Query cscope using command line interface.  Parse the output and use tselect
1014  * to allow choices.  Like Nvi, creates a pipe to send to/from query/cscope.
1015  *
1016  * returns TRUE if we jump to a tag or abort, FALSE if not.
1017  */
1018     static int
1019 cs_find(exarg_T *eap)
1020 {
1021     char *opt, *pat;
1022     int i;
1023 
1024     if (cs_check_for_connections() == FALSE)
1025     {
1026 	(void)emsg(_("E567: no cscope connections"));
1027 	return FALSE;
1028     }
1029 
1030     if ((opt = strtok((char *)NULL, (const char *)" ")) == NULL)
1031     {
1032 	cs_usage_msg(Find);
1033 	return FALSE;
1034     }
1035 
1036     pat = opt + strlen(opt) + 1;
1037     if (pat >= (char *)eap->arg + eap_arg_len)
1038     {
1039 	cs_usage_msg(Find);
1040 	return FALSE;
1041     }
1042 
1043     /*
1044      * Let's replace the NULs written by strtok() with spaces - we need the
1045      * spaces to correctly display the quickfix/location list window's title.
1046      */
1047     for (i = 0; i < eap_arg_len; ++i)
1048 	if (NUL == eap->arg[i])
1049 	    eap->arg[i] = ' ';
1050 
1051     return cs_find_common(opt, pat, eap->forceit, TRUE,
1052 				  eap->cmdidx == CMD_lcscope, *eap->cmdlinep);
1053 }
1054 
1055 
1056 /*
1057  * Common code for cscope find, shared by cs_find() and ex_cstag().
1058  */
1059     static int
1060 cs_find_common(
1061     char *opt,
1062     char *pat,
1063     int forceit,
1064     int verbose,
1065     int	use_ll UNUSED,
1066     char_u *cmdline UNUSED)
1067 {
1068     int i;
1069     char *cmd;
1070     int *nummatches;
1071     int totmatches;
1072 #ifdef FEAT_QUICKFIX
1073     char cmdletter;
1074     char *qfpos;
1075 
1076     // get cmd letter
1077     switch (opt[0])
1078     {
1079     case '0' :
1080 	cmdletter = 's';
1081 	break;
1082     case '1' :
1083 	cmdletter = 'g';
1084 	break;
1085     case '2' :
1086 	cmdletter = 'd';
1087 	break;
1088     case '3' :
1089 	cmdletter = 'c';
1090 	break;
1091     case '4' :
1092 	cmdletter = 't';
1093 	break;
1094     case '6' :
1095 	cmdletter = 'e';
1096 	break;
1097     case '7' :
1098 	cmdletter = 'f';
1099 	break;
1100     case '8' :
1101 	cmdletter = 'i';
1102 	break;
1103     case '9' :
1104 	cmdletter = 'a';
1105 	break;
1106     default :
1107 	cmdletter = opt[0];
1108     }
1109 
1110     qfpos = (char *)vim_strchr(p_csqf, cmdletter);
1111     if (qfpos != NULL)
1112     {
1113 	qfpos++;
1114 	// next symbol must be + or -
1115 	if (strchr(CSQF_FLAGS, *qfpos) == NULL)
1116 	{
1117 	    char *nf = _("E469: invalid cscopequickfix flag %c for %c");
1118 	    char *buf = alloc(strlen(nf));
1119 
1120 	    // strlen will be enough because we use chars
1121 	    if (buf != NULL)
1122 	    {
1123 		sprintf(buf, nf, *qfpos, *(qfpos-1));
1124 		(void)emsg(buf);
1125 		vim_free(buf);
1126 	    }
1127 	    return FALSE;
1128 	}
1129 
1130 	if (*qfpos != '0'
1131 		&& apply_autocmds(EVENT_QUICKFIXCMDPRE, (char_u *)"cscope",
1132 					       curbuf->b_fname, TRUE, curbuf))
1133 	{
1134 # ifdef FEAT_EVAL
1135 	    if (aborting())
1136 		return FALSE;
1137 # endif
1138 	}
1139     }
1140 #endif
1141 
1142     // create the actual command to send to cscope
1143     cmd = cs_create_cmd(opt, pat);
1144     if (cmd == NULL)
1145 	return FALSE;
1146 
1147     nummatches = ALLOC_MULT(int, csinfo_size);
1148     if (nummatches == NULL)
1149     {
1150 	vim_free(cmd);
1151 	return FALSE;
1152     }
1153 
1154     // Send query to all open connections, then count the total number
1155     // of matches so we can alloc all in one swell foop.
1156     for (i = 0; i < csinfo_size; i++)
1157 	nummatches[i] = 0;
1158     totmatches = 0;
1159     for (i = 0; i < csinfo_size; i++)
1160     {
1161 	if (csinfo[i].fname == NULL || csinfo[i].to_fp == NULL)
1162 	    continue;
1163 
1164 	// send cmd to cscope
1165 	(void)fprintf(csinfo[i].to_fp, "%s\n", cmd);
1166 	(void)fflush(csinfo[i].to_fp);
1167 
1168 	nummatches[i] = cs_cnt_matches(i);
1169 
1170 	if (nummatches[i] > -1)
1171 	    totmatches += nummatches[i];
1172 
1173 	if (nummatches[i] == 0)
1174 	    (void)cs_read_prompt(i);
1175     }
1176     vim_free(cmd);
1177 
1178     if (totmatches == 0)
1179     {
1180 	char *nf = _("E259: no matches found for cscope query %s of %s");
1181 	char *buf;
1182 
1183 	if (!verbose)
1184 	{
1185 	    vim_free(nummatches);
1186 	    return FALSE;
1187 	}
1188 
1189 	buf = alloc(strlen(opt) + strlen(pat) + strlen(nf));
1190 	if (buf == NULL)
1191 	    (void)emsg(nf);
1192 	else
1193 	{
1194 	    sprintf(buf, nf, opt, pat);
1195 	    (void)emsg(buf);
1196 	    vim_free(buf);
1197 	}
1198 	vim_free(nummatches);
1199 	return FALSE;
1200     }
1201 
1202 #ifdef FEAT_QUICKFIX
1203     if (qfpos != NULL && *qfpos != '0' && totmatches > 0)
1204     {
1205 	// fill error list
1206 	FILE	    *f;
1207 	char_u	    *tmp = vim_tempname('c', TRUE);
1208 	qf_info_T   *qi = NULL;
1209 	win_T	    *wp = NULL;
1210 
1211 	f = mch_fopen((char *)tmp, "w");
1212 	if (f == NULL)
1213 	    semsg(_(e_notopen), tmp);
1214 	else
1215 	{
1216 	    cs_file_results(f, nummatches);
1217 	    fclose(f);
1218 	    if (use_ll)	    // Use location list
1219 		wp = curwin;
1220 	    // '-' starts a new error list
1221 	    if (qf_init(wp, tmp, (char_u *)"%f%*\\t%l%*\\t%m",
1222 					  *qfpos == '-', cmdline, NULL) > 0)
1223 	    {
1224 		if (postponed_split != 0)
1225 		{
1226 		    (void)win_split(postponed_split > 0 ? postponed_split : 0,
1227 						       postponed_split_flags);
1228 		    RESET_BINDING(curwin);
1229 		    postponed_split = 0;
1230 		}
1231 
1232 		apply_autocmds(EVENT_QUICKFIXCMDPOST, (char_u *)"cscope",
1233 					       curbuf->b_fname, TRUE, curbuf);
1234 		if (use_ll)
1235 		    /*
1236 		     * In the location list window, use the displayed location
1237 		     * list. Otherwise, use the location list for the window.
1238 		     */
1239 		    qi = (bt_quickfix(wp->w_buffer) && wp->w_llist_ref != NULL)
1240 			?  wp->w_llist_ref : wp->w_llist;
1241 		qf_jump(qi, 0, 0, forceit);
1242 	    }
1243 	}
1244 	mch_remove(tmp);
1245 	vim_free(tmp);
1246 	vim_free(nummatches);
1247 	return TRUE;
1248     }
1249     else
1250 #endif // FEAT_QUICKFIX
1251     {
1252 	char **matches = NULL, **contexts = NULL;
1253 	int matched = 0;
1254 
1255 	// read output
1256 	cs_fill_results(pat, totmatches, nummatches, &matches,
1257 							 &contexts, &matched);
1258 	vim_free(nummatches);
1259 	if (matches == NULL)
1260 	    return FALSE;
1261 
1262 	(void)cs_manage_matches(matches, contexts, matched, Store);
1263 
1264 	return do_tag((char_u *)pat, DT_CSCOPE, 0, forceit, verbose);
1265     }
1266 
1267 }
1268 
1269 /*
1270  * Print help.
1271  */
1272     static int
1273 cs_help(exarg_T *eap UNUSED)
1274 {
1275     cscmd_T *cmdp = cs_cmds;
1276 
1277     (void)msg_puts(_("cscope commands:\n"));
1278     while (cmdp->name != NULL)
1279     {
1280 	char *help = _(cmdp->help);
1281 	int  space_cnt = 30 - vim_strsize((char_u *)help);
1282 
1283 	// Use %*s rather than %30s to ensure proper alignment in utf-8
1284 	if (space_cnt < 0)
1285 	    space_cnt = 0;
1286 	(void)smsg(_("%-5s: %s%*s (Usage: %s)"),
1287 				      cmdp->name,
1288 				      help, space_cnt, " ",
1289 				      cmdp->usage);
1290 	if (strcmp(cmdp->name, "find") == 0)
1291 	    msg_puts(_("\n"
1292 		       "       a: Find assignments to this symbol\n"
1293 		       "       c: Find functions calling this function\n"
1294 		       "       d: Find functions called by this function\n"
1295 		       "       e: Find this egrep pattern\n"
1296 		       "       f: Find this file\n"
1297 		       "       g: Find this definition\n"
1298 		       "       i: Find files #including this file\n"
1299 		       "       s: Find this C symbol\n"
1300 		       "       t: Find this text string\n"));
1301 
1302 	cmdp++;
1303     }
1304 
1305     wait_return(TRUE);
1306     return 0;
1307 }
1308 
1309 
1310     static void
1311 clear_csinfo(int i)
1312 {
1313     csinfo[i].fname  = NULL;
1314     csinfo[i].ppath  = NULL;
1315     csinfo[i].flags  = NULL;
1316 #if defined(UNIX)
1317     csinfo[i].st_dev = (dev_t)0;
1318     csinfo[i].st_ino = (ino_t)0;
1319 #else
1320     csinfo[i].nVolume = 0;
1321     csinfo[i].nIndexHigh = 0;
1322     csinfo[i].nIndexLow = 0;
1323 #endif
1324     csinfo[i].pid    = 0;
1325     csinfo[i].fr_fp  = NULL;
1326     csinfo[i].to_fp  = NULL;
1327 #if defined(MSWIN)
1328     csinfo[i].hProc = NULL;
1329 #endif
1330 }
1331 
1332 /*
1333  * Insert a new cscope database filename into the filelist.
1334  */
1335     static int
1336 cs_insert_filelist(
1337     char *fname,
1338     char *ppath,
1339     char *flags,
1340     stat_T *sb UNUSED)
1341 {
1342     short	i, j;
1343 #ifndef UNIX
1344     BY_HANDLE_FILE_INFORMATION bhfi;
1345 
1346     switch (win32_fileinfo((char_u *)fname, &bhfi))
1347     {
1348 	case FILEINFO_ENC_FAIL:		// enc_to_utf16() failed
1349 	case FILEINFO_READ_FAIL:	// CreateFile() failed
1350 	    if (p_csverbose)
1351 	    {
1352 		char *cant_msg = _("E625: cannot open cscope database: %s");
1353 		char *winmsg = GetWin32Error();
1354 
1355 		if (winmsg != NULL)
1356 		{
1357 		    (void)semsg(cant_msg, winmsg);
1358 		    LocalFree(winmsg);
1359 		}
1360 		else
1361 		    // subst filename if can't get error text
1362 		    (void)semsg(cant_msg, fname);
1363 	    }
1364 	    return -1;
1365 
1366 	case FILEINFO_INFO_FAIL:    // GetFileInformationByHandle() failed
1367 	    if (p_csverbose)
1368 		(void)emsg(_("E626: cannot get cscope database information"));
1369 	    return -1;
1370     }
1371 #endif
1372 
1373     i = -1; // can be set to the index of an empty item in csinfo
1374     for (j = 0; j < csinfo_size; j++)
1375     {
1376 	if (csinfo[j].fname != NULL
1377 #if defined(UNIX)
1378 	    && csinfo[j].st_dev == sb->st_dev && csinfo[j].st_ino == sb->st_ino
1379 #else
1380 	    // compare pathnames first
1381 	    && ((fullpathcmp((char_u *)csinfo[j].fname,
1382 			(char_u *)fname, FALSE, TRUE) & FPC_SAME)
1383 		// test index file attributes too
1384 		|| (csinfo[j].nVolume == bhfi.dwVolumeSerialNumber
1385 		    && csinfo[j].nIndexHigh == bhfi.nFileIndexHigh
1386 		    && csinfo[j].nIndexLow == bhfi.nFileIndexLow))
1387 #endif
1388 	    )
1389 	{
1390 	    if (p_csverbose)
1391 		(void)emsg(_("E568: duplicate cscope database not added"));
1392 	    return -1;
1393 	}
1394 
1395 	if (csinfo[j].fname == NULL && i == -1)
1396 	    i = j; // remember first empty entry
1397     }
1398 
1399     if (i == -1)
1400     {
1401 	i = csinfo_size;
1402 	if (csinfo_size == 0)
1403 	{
1404 	    // First time allocation: allocate only 1 connection. It should
1405 	    // be enough for most users.  If more is needed, csinfo will be
1406 	    // reallocated.
1407 	    csinfo_size = 1;
1408 	    csinfo = ALLOC_CLEAR_ONE(csinfo_T);
1409 	}
1410 	else
1411 	{
1412 	    csinfo_T *t_csinfo = csinfo;
1413 
1414 	    // Reallocate space for more connections.
1415 	    csinfo_size *= 2;
1416 	    csinfo = vim_realloc(csinfo, sizeof(csinfo_T)*csinfo_size);
1417 	    if (csinfo == NULL)
1418 	    {
1419 		vim_free(t_csinfo);
1420 		csinfo_size = 0;
1421 	    }
1422 	}
1423 	if (csinfo == NULL)
1424 	    return -1;
1425 	for (j = csinfo_size/2; j < csinfo_size; j++)
1426 	    clear_csinfo(j);
1427     }
1428 
1429     if ((csinfo[i].fname = alloc(strlen(fname)+1)) == NULL)
1430 	return -1;
1431 
1432     (void)strcpy(csinfo[i].fname, (const char *)fname);
1433 
1434     if (ppath != NULL)
1435     {
1436 	if ((csinfo[i].ppath = alloc(strlen(ppath) + 1)) == NULL)
1437 	{
1438 	    VIM_CLEAR(csinfo[i].fname);
1439 	    return -1;
1440 	}
1441 	(void)strcpy(csinfo[i].ppath, (const char *)ppath);
1442     } else
1443 	csinfo[i].ppath = NULL;
1444 
1445     if (flags != NULL)
1446     {
1447 	if ((csinfo[i].flags = alloc(strlen(flags) + 1)) == NULL)
1448 	{
1449 	    VIM_CLEAR(csinfo[i].fname);
1450 	    VIM_CLEAR(csinfo[i].ppath);
1451 	    return -1;
1452 	}
1453 	(void)strcpy(csinfo[i].flags, (const char *)flags);
1454     } else
1455 	csinfo[i].flags = NULL;
1456 
1457 #if defined(UNIX)
1458     csinfo[i].st_dev = sb->st_dev;
1459     csinfo[i].st_ino = sb->st_ino;
1460 
1461 #else
1462     csinfo[i].nVolume = bhfi.dwVolumeSerialNumber;
1463     csinfo[i].nIndexLow = bhfi.nFileIndexLow;
1464     csinfo[i].nIndexHigh = bhfi.nFileIndexHigh;
1465 #endif
1466     return i;
1467 }
1468 
1469 
1470 /*
1471  * Find cscope command in command table.
1472  */
1473     static cscmd_T *
1474 cs_lookup_cmd(exarg_T *eap)
1475 {
1476     cscmd_T *cmdp;
1477     char *stok;
1478     size_t len;
1479 
1480     if (eap->arg == NULL)
1481 	return NULL;
1482 
1483     // Store length of eap->arg before it gets modified by strtok().
1484     eap_arg_len = (int)STRLEN(eap->arg);
1485 
1486     if ((stok = strtok((char *)(eap->arg), (const char *)" ")) == NULL)
1487 	return NULL;
1488 
1489     len = strlen(stok);
1490     for (cmdp = cs_cmds; cmdp->name != NULL; ++cmdp)
1491     {
1492 	if (strncmp((const char *)(stok), cmdp->name, len) == 0)
1493 	    return (cmdp);
1494     }
1495     return NULL;
1496 }
1497 
1498 
1499 /*
1500  * Nuke em.
1501  */
1502     static int
1503 cs_kill(exarg_T *eap UNUSED)
1504 {
1505     char *stok;
1506     short i;
1507 
1508     if ((stok = strtok((char *)NULL, (const char *)" ")) == NULL)
1509     {
1510 	cs_usage_msg(Kill);
1511 	return CSCOPE_FAILURE;
1512     }
1513 
1514     // only single digit positive and negative integers are allowed
1515     if ((strlen(stok) < 2 && VIM_ISDIGIT((int)(stok[0])))
1516 	    || (strlen(stok) < 3 && stok[0] == '-'
1517 					      && VIM_ISDIGIT((int)(stok[1]))))
1518 	i = atoi(stok);
1519     else
1520     {
1521 	// It must be part of a name.  We will try to find a match
1522 	// within all the names in the csinfo data structure
1523 	for (i = 0; i < csinfo_size; i++)
1524 	{
1525 	    if (csinfo[i].fname != NULL && strstr(csinfo[i].fname, stok))
1526 		break;
1527 	}
1528     }
1529 
1530     if ((i != -1) && (i >= csinfo_size || i < -1 || csinfo[i].fname == NULL))
1531     {
1532 	if (p_csverbose)
1533 	    (void)semsg(_("E261: cscope connection %s not found"), stok);
1534     }
1535     else
1536     {
1537 	if (i == -1)
1538 	{
1539 	    for (i = 0; i < csinfo_size; i++)
1540 	    {
1541 		if (csinfo[i].fname)
1542 		    cs_kill_execute(i, csinfo[i].fname);
1543 	    }
1544 	}
1545 	else
1546 	    cs_kill_execute(i, stok);
1547     }
1548 
1549     return 0;
1550 }
1551 
1552 
1553 /*
1554  * Actually kills a specific cscope connection.
1555  */
1556     static void
1557 cs_kill_execute(
1558     int i,	    // cscope table index
1559     char *cname)    // cscope database name
1560 {
1561     if (p_csverbose)
1562     {
1563 	msg_clr_eos();
1564 	(void)smsg_attr(HL_ATTR(HLF_R) | MSG_HIST,
1565 			_("cscope connection %s closed"), cname);
1566     }
1567     cs_release_csp(i, TRUE);
1568 }
1569 
1570 
1571 /*
1572  * Convert the cscope output into a ctags style entry (as might be found
1573  * in a ctags tags file).  there's one catch though: cscope doesn't tell you
1574  * the type of the tag you are looking for.  for example, in Darren Hiebert's
1575  * ctags (the one that comes with vim), #define's use a line number to find the
1576  * tag in a file while function definitions use a regexp search pattern.
1577  *
1578  * I'm going to always use the line number because cscope does something
1579  * quirky (and probably other things i don't know about):
1580  *
1581  *     if you have "#  define" in your source file, which is
1582  *     perfectly legal, cscope thinks you have "#define".  this
1583  *     will result in a failed regexp search. :(
1584  *
1585  * Besides, even if this particular case didn't happen, the search pattern
1586  * would still have to be modified to escape all the special regular expression
1587  * characters to comply with ctags formatting.
1588  */
1589     static char *
1590 cs_make_vim_style_matches(
1591     char *fname,
1592     char *slno,
1593     char *search,
1594     char *tagstr)
1595 {
1596     // vim style is ctags:
1597     //
1598     //	    <tagstr>\t<filename>\t<linenum_or_search>"\t<extra>
1599     //
1600     // but as mentioned above, we'll always use the line number and
1601     // put the search pattern (if one exists) as "extra"
1602     //
1603     // buf is used as part of vim's method of handling tags, and
1604     // (i think) vim frees it when you pop your tags and get replaced
1605     // by new ones on the tag stack.
1606     char *buf;
1607     int amt;
1608 
1609     if (search != NULL)
1610     {
1611 	amt = (int)(strlen(fname) + strlen(slno) + strlen(tagstr) + strlen(search)+6);
1612 	if ((buf = alloc(amt)) == NULL)
1613 	    return NULL;
1614 
1615 	(void)sprintf(buf, "%s\t%s\t%s;\"\t%s", tagstr, fname, slno, search);
1616     }
1617     else
1618     {
1619 	amt = (int)(strlen(fname) + strlen(slno) + strlen(tagstr) + 5);
1620 	if ((buf = alloc(amt)) == NULL)
1621 	    return NULL;
1622 
1623 	(void)sprintf(buf, "%s\t%s\t%s;\"", tagstr, fname, slno);
1624     }
1625 
1626     return buf;
1627 }
1628 
1629 
1630 /*
1631  * This is kind of hokey, but i don't see an easy way round this.
1632  *
1633  * Store: keep a ptr to the (malloc'd) memory of matches originally
1634  * generated from cs_find().  the matches are originally lines directly
1635  * from cscope output, but transformed to look like something out of a
1636  * ctags.  see cs_make_vim_style_matches for more details.
1637  *
1638  * Get: used only from cs_fgets(), this simulates a vim_fgets() to return
1639  * the next line from the cscope output.  it basically keeps track of which
1640  * lines have been "used" and returns the next one.
1641  *
1642  * Free: frees up everything and resets
1643  *
1644  * Print: prints the tags
1645  */
1646     static char *
1647 cs_manage_matches(
1648     char **matches,
1649     char **contexts,
1650     int totmatches,
1651     mcmd_e cmd)
1652 {
1653     static char **mp = NULL;
1654     static char **cp = NULL;
1655     static int cnt = -1;
1656     static int next = -1;
1657     char *p = NULL;
1658 
1659     switch (cmd)
1660     {
1661     case Store:
1662 	assert(matches != NULL);
1663 	assert(totmatches > 0);
1664 	if (mp != NULL || cp != NULL)
1665 	    (void)cs_manage_matches(NULL, NULL, -1, Free);
1666 	mp = matches;
1667 	cp = contexts;
1668 	cnt = totmatches;
1669 	next = 0;
1670 	break;
1671     case Get:
1672 	if (next >= cnt)
1673 	    return NULL;
1674 
1675 	p = mp[next];
1676 	next++;
1677 	break;
1678     case Free:
1679 	if (mp != NULL)
1680 	{
1681 	    if (cnt > 0)
1682 		while (cnt--)
1683 		{
1684 		    vim_free(mp[cnt]);
1685 		    if (cp != NULL)
1686 			vim_free(cp[cnt]);
1687 		}
1688 	    vim_free(mp);
1689 	    vim_free(cp);
1690 	}
1691 	mp = NULL;
1692 	cp = NULL;
1693 	cnt = 0;
1694 	next = 0;
1695 	break;
1696     case Print:
1697 	cs_print_tags_priv(mp, cp, cnt);
1698 	break;
1699     default:	// should not reach here
1700 	iemsg(_("E570: fatal error in cs_manage_matches"));
1701 	return NULL;
1702     }
1703 
1704     return p;
1705 }
1706 
1707 
1708 /*
1709  * Parse cscope output.
1710  */
1711     static char *
1712 cs_parse_results(
1713     int cnumber,
1714     char *buf,
1715     int bufsize,
1716     char **context,
1717     char **linenumber,
1718     char **search)
1719 {
1720     int ch;
1721     char *p;
1722     char *name;
1723 
1724     if (fgets(buf, bufsize, csinfo[cnumber].fr_fp) == NULL)
1725     {
1726 	if (feof(csinfo[cnumber].fr_fp))
1727 	    errno = EIO;
1728 
1729 	cs_reading_emsg(cnumber);
1730 
1731 	return NULL;
1732     }
1733 
1734     // If the line's too long for the buffer, discard it.
1735     if ((p = strchr(buf, '\n')) == NULL)
1736     {
1737 	while ((ch = getc(csinfo[cnumber].fr_fp)) != EOF && ch != '\n')
1738 	    ;
1739 	return NULL;
1740     }
1741     *p = '\0';
1742 
1743     /*
1744      * cscope output is in the following format:
1745      *
1746      *	<filename> <context> <line number> <pattern>
1747      */
1748     if ((name = strtok(buf, (const char *)" ")) == NULL)
1749 	return NULL;
1750     if ((*context = strtok(NULL, (const char *)" ")) == NULL)
1751 	return NULL;
1752     if ((*linenumber = strtok(NULL, (const char *)" ")) == NULL)
1753 	return NULL;
1754     *search = *linenumber + strlen(*linenumber) + 1;	// +1 to skip \0
1755 
1756     // --- nvi ---
1757     // If the file is older than the cscope database, that is,
1758     // the database was built since the file was last modified,
1759     // or there wasn't a search string, use the line number.
1760     if (strcmp(*search, "<unknown>") == 0)
1761 	*search = NULL;
1762 
1763     name = cs_resolve_file(cnumber, name);
1764     return name;
1765 }
1766 
1767 #ifdef FEAT_QUICKFIX
1768 /*
1769  * Write cscope find results to file.
1770  */
1771     static void
1772 cs_file_results(FILE *f, int *nummatches_a)
1773 {
1774     int i, j;
1775     char *buf;
1776     char *search, *slno;
1777     char *fullname;
1778     char *cntx;
1779     char *context;
1780 
1781     buf = alloc(CSREAD_BUFSIZE);
1782     if (buf == NULL)
1783 	return;
1784 
1785     for (i = 0; i < csinfo_size; i++)
1786     {
1787 	if (nummatches_a[i] < 1)
1788 	    continue;
1789 
1790 	for (j = 0; j < nummatches_a[i]; j++)
1791 	{
1792 	   if ((fullname = cs_parse_results(i, buf, CSREAD_BUFSIZE, &cntx,
1793 			   &slno, &search)) == NULL)
1794 	       continue;
1795 
1796 	   context = alloc(strlen(cntx)+5);
1797 	   if (context == NULL)
1798 	   {
1799 	       vim_free(fullname);
1800 	       continue;
1801 	   }
1802 
1803 	   if (strcmp(cntx, "<global>")==0)
1804 	       strcpy(context, "<<global>>");
1805 	   else
1806 	       sprintf(context, "<<%s>>", cntx);
1807 
1808 	   if (search == NULL)
1809 	       fprintf(f, "%s\t%s\t%s\n", fullname, slno, context);
1810 	   else
1811 	       fprintf(f, "%s\t%s\t%s %s\n", fullname, slno, context, search);
1812 
1813 	   vim_free(context);
1814 	   vim_free(fullname);
1815 	} // for all matches
1816 
1817 	(void)cs_read_prompt(i);
1818 
1819     } // for all cscope connections
1820     vim_free(buf);
1821 }
1822 #endif
1823 
1824 /*
1825  * Get parsed cscope output and calls cs_make_vim_style_matches to convert
1826  * into ctags format.
1827  * When there are no matches sets "*matches_p" to NULL.
1828  */
1829     static void
1830 cs_fill_results(
1831     char *tagstr,
1832     int totmatches,
1833     int *nummatches_a,
1834     char ***matches_p,
1835     char ***cntxts_p,
1836     int *matched)
1837 {
1838     int i, j;
1839     char *buf;
1840     char *search, *slno;
1841     int totsofar = 0;
1842     char **matches = NULL;
1843     char **cntxts = NULL;
1844     char *fullname;
1845     char *cntx;
1846 
1847     assert(totmatches > 0);
1848 
1849     buf = alloc(CSREAD_BUFSIZE);
1850     if (buf == NULL)
1851 	return;
1852 
1853     if ((matches = ALLOC_MULT(char *, totmatches)) == NULL)
1854 	goto parse_out;
1855     if ((cntxts = ALLOC_MULT(char *, totmatches)) == NULL)
1856 	goto parse_out;
1857 
1858     for (i = 0; i < csinfo_size; i++)
1859     {
1860 	if (nummatches_a[i] < 1)
1861 	    continue;
1862 
1863 	for (j = 0; j < nummatches_a[i]; j++)
1864 	{
1865 	   if ((fullname = cs_parse_results(i, buf, CSREAD_BUFSIZE, &cntx,
1866 			   &slno, &search)) == NULL)
1867 		continue;
1868 
1869 	    matches[totsofar] = cs_make_vim_style_matches(fullname, slno,
1870 							  search, tagstr);
1871 
1872 	    vim_free(fullname);
1873 
1874 	    if (strcmp(cntx, "<global>") == 0)
1875 		cntxts[totsofar] = NULL;
1876 	    else
1877 		// note: if vim_strsave returns NULL, then the context
1878 		// will be "<global>", which is misleading.
1879 		cntxts[totsofar] = (char *)vim_strsave((char_u *)cntx);
1880 
1881 	    if (matches[totsofar] != NULL)
1882 		totsofar++;
1883 
1884 	} // for all matches
1885 
1886 	(void)cs_read_prompt(i);
1887 
1888     } // for all cscope connections
1889 
1890 parse_out:
1891     if (totsofar == 0)
1892     {
1893 	// No matches, free the arrays and return NULL in "*matches_p".
1894 	VIM_CLEAR(matches);
1895 	VIM_CLEAR(cntxts);
1896     }
1897     *matched = totsofar;
1898     *matches_p = matches;
1899     *cntxts_p = cntxts;
1900 
1901     vim_free(buf);
1902 }
1903 
1904 
1905 /*
1906  * get the requested path components
1907  */
1908     static char *
1909 cs_pathcomponents(char *path)
1910 {
1911     int		i;
1912     char	*s;
1913 
1914     if (p_cspc == 0)
1915 	return path;
1916 
1917     s = path + strlen(path) - 1;
1918     for (i = 0; i < p_cspc; ++i)
1919 	while (s > path && *--s != '/'
1920 #ifdef MSWIN
1921 		&& *--s != '\\'
1922 #endif
1923 		)
1924 	    ;
1925     if ((s > path && *s == '/')
1926 #ifdef MSWIN
1927 	|| (s > path && *s == '\\')
1928 #endif
1929 	    )
1930 	++s;
1931     return s;
1932 }
1933 
1934 /*
1935  * Called from cs_manage_matches().
1936  */
1937     static void
1938 cs_print_tags_priv(char **matches, char **cntxts, int num_matches)
1939 {
1940     char	*buf = NULL;
1941     char	*t_buf;
1942     int		bufsize = 0; // Track available bufsize
1943     int		newsize = 0;
1944     char	*ptag;
1945     char	*fname, *lno, *extra, *tbuf;
1946     int		i, idx, num;
1947     char	*globalcntx = "GLOBAL";
1948     char	*cntxformat = " <<%s>>";
1949     char	*context;
1950     char	*cstag_msg = _("Cscope tag: %s");
1951     char	*csfmt_str = "%4d %6s  ";
1952 
1953     assert(num_matches > 0);
1954 
1955     if ((tbuf = alloc(strlen(matches[0]) + 1)) == NULL)
1956 	return;
1957 
1958     strcpy(tbuf, matches[0]);
1959     ptag = strtok(tbuf, "\t");
1960     if (ptag == NULL)
1961     {
1962 	vim_free(tbuf);
1963 	return;
1964     }
1965 
1966     newsize = (int)(strlen(cstag_msg) + strlen(ptag));
1967     buf = alloc(newsize);
1968     if (buf != NULL)
1969     {
1970 	bufsize = newsize;
1971 	(void)sprintf(buf, cstag_msg, ptag);
1972 	msg_puts_attr(buf, HL_ATTR(HLF_T));
1973     }
1974 
1975     vim_free(tbuf);
1976 
1977     msg_puts_attr(_("\n   #   line"), HL_ATTR(HLF_T));    // strlen is 7
1978     msg_advance(msg_col + 2);
1979     msg_puts_attr(_("filename / context / line\n"), HL_ATTR(HLF_T));
1980 
1981     num = 1;
1982     for (i = 0; i < num_matches; i++)
1983     {
1984 	idx = i;
1985 
1986 	// if we really wanted to, we could avoid this malloc and strcpy
1987 	// by parsing matches[i] on the fly and placing stuff into buf
1988 	// directly, but that's too much of a hassle
1989 	if ((tbuf = alloc(strlen(matches[idx]) + 1)) == NULL)
1990 	    continue;
1991 	(void)strcpy(tbuf, matches[idx]);
1992 
1993 	if (strtok(tbuf, (const char *)"\t") == NULL
1994 		|| (fname = strtok(NULL, (const char *)"\t")) == NULL
1995 		|| (lno = strtok(NULL, (const char *)"\t")) == NULL)
1996 	{
1997 	    vim_free(tbuf);
1998 	    continue;
1999 	}
2000 	extra = strtok(NULL, (const char *)"\t");
2001 
2002 	lno[strlen(lno)-2] = '\0';  // ignore ;" at the end
2003 
2004 	// hopefully 'num' (num of matches) will be less than 10^16
2005 	newsize = (int)(strlen(csfmt_str) + 16 + strlen(lno));
2006 	if (bufsize < newsize)
2007 	{
2008 	    t_buf = buf;
2009 	    buf = vim_realloc(buf, newsize);
2010 	    if (buf == NULL)
2011 	    {
2012 		bufsize = 0;
2013 		vim_free(t_buf);
2014 	    }
2015 	    else
2016 		bufsize = newsize;
2017 	}
2018 	if (buf != NULL)
2019 	{
2020 	    // csfmt_str = "%4d %6s  ";
2021 	    (void)sprintf(buf, csfmt_str, num, lno);
2022 	    msg_puts_attr(buf, HL_ATTR(HLF_CM));
2023 	}
2024 	msg_outtrans_long_attr((char_u *)cs_pathcomponents(fname),
2025 							      HL_ATTR(HLF_CM));
2026 
2027 	// compute the required space for the context
2028 	if (cntxts[idx] != NULL)
2029 	    context = cntxts[idx];
2030 	else
2031 	    context = globalcntx;
2032 	newsize = (int)(strlen(context) + strlen(cntxformat));
2033 
2034 	if (bufsize < newsize)
2035 	{
2036 	    t_buf = buf;
2037 	    buf = vim_realloc(buf, newsize);
2038 	    if (buf == NULL)
2039 	    {
2040 		bufsize = 0;
2041 		vim_free(t_buf);
2042 	    }
2043 	    else
2044 		bufsize = newsize;
2045 	}
2046 	if (buf != NULL)
2047 	{
2048 	    (void)sprintf(buf, cntxformat, context);
2049 
2050 	    // print the context only if it fits on the same line
2051 	    if (msg_col + (int)strlen(buf) >= (int)Columns)
2052 		msg_putchar('\n');
2053 	    msg_advance(12);
2054 	    msg_outtrans_long_attr((char_u *)buf, 0);
2055 	    msg_putchar('\n');
2056 	}
2057 	if (extra != NULL)
2058 	{
2059 	    msg_advance(13);
2060 	    msg_outtrans_long_attr((char_u *)extra, 0);
2061 	}
2062 
2063 	vim_free(tbuf); // only after printing extra due to strtok use
2064 
2065 	if (msg_col)
2066 	    msg_putchar('\n');
2067 
2068 	ui_breakcheck();
2069 	if (got_int)
2070 	{
2071 	    got_int = FALSE;	// don't print any more matches
2072 	    break;
2073 	}
2074 
2075 	num++;
2076     } // for all matches
2077 
2078     vim_free(buf);
2079 }
2080 
2081 
2082 /*
2083  * Read a cscope prompt (basically, skip over the ">> ").
2084  */
2085     static int
2086 cs_read_prompt(int i)
2087 {
2088     int		ch;
2089     char	*buf = NULL; // buffer for possible error message from cscope
2090     int		bufpos = 0;
2091     char	*cs_emsg;
2092     int		maxlen;
2093     static char *eprompt = "Press the RETURN key to continue:";
2094     int		epromptlen = (int)strlen(eprompt);
2095     int		n;
2096 
2097     cs_emsg = _("E609: Cscope error: %s");
2098     // compute maximum allowed len for Cscope error message
2099     maxlen = (int)(IOSIZE - strlen(cs_emsg));
2100 
2101     for (;;)
2102     {
2103 	while ((ch = getc(csinfo[i].fr_fp)) != EOF && ch != CSCOPE_PROMPT[0])
2104 	    // if there is room and char is printable
2105 	    if (bufpos < maxlen - 1 && vim_isprintc(ch))
2106 	    {
2107 		if (buf == NULL) // lazy buffer allocation
2108 		    buf = alloc(maxlen);
2109 		if (buf != NULL)
2110 		{
2111 		    // append character to the message
2112 		    buf[bufpos++] = ch;
2113 		    buf[bufpos] = NUL;
2114 		    if (bufpos >= epromptlen
2115 			    && strcmp(&buf[bufpos - epromptlen], eprompt) == 0)
2116 		    {
2117 			// remove eprompt from buf
2118 			buf[bufpos - epromptlen] = NUL;
2119 
2120 			// print message to user
2121 			(void)semsg(cs_emsg, buf);
2122 
2123 			// send RETURN to cscope
2124 			(void)putc('\n', csinfo[i].to_fp);
2125 			(void)fflush(csinfo[i].to_fp);
2126 
2127 			// clear buf
2128 			bufpos = 0;
2129 			buf[bufpos] = NUL;
2130 		    }
2131 		}
2132 	    }
2133 
2134 	for (n = 0; n < (int)strlen(CSCOPE_PROMPT); ++n)
2135 	{
2136 	    if (n > 0)
2137 		ch = getc(csinfo[i].fr_fp);
2138 	    if (ch == EOF)
2139 	    {
2140 		if (buf != NULL && buf[0] != NUL)
2141 		    (void)semsg(cs_emsg, buf);
2142 		else if (p_csverbose)
2143 		    cs_reading_emsg(i); // don't have additional information
2144 		cs_release_csp(i, TRUE);
2145 		vim_free(buf);
2146 		return CSCOPE_FAILURE;
2147 	    }
2148 
2149 	    if (ch != CSCOPE_PROMPT[n])
2150 	    {
2151 		ch = EOF;
2152 		break;
2153 	    }
2154 	}
2155 
2156 	if (ch == EOF)
2157 	    continue;	    // didn't find the prompt
2158 	break;		    // did find the prompt
2159     }
2160 
2161     vim_free(buf);
2162     return CSCOPE_SUCCESS;
2163 }
2164 
2165 #if defined(UNIX) && defined(SIGALRM)
2166 /*
2167  * Used to catch and ignore SIGALRM below.
2168  */
2169     static RETSIGTYPE
2170 sig_handler SIGDEFARG(sigarg)
2171 {
2172     // do nothing
2173     SIGRETURN;
2174 }
2175 #endif
2176 
2177 /*
2178  * Does the actual free'ing for the cs ptr with an optional flag of whether
2179  * or not to free the filename.  Called by cs_kill and cs_reset.
2180  */
2181     static void
2182 cs_release_csp(int i, int freefnpp)
2183 {
2184     /*
2185      * Trying to exit normally (not sure whether it is fit to UNIX cscope
2186      */
2187     if (csinfo[i].to_fp != NULL)
2188     {
2189 	(void)fputs("q\n", csinfo[i].to_fp);
2190 	(void)fflush(csinfo[i].to_fp);
2191     }
2192 #if defined(UNIX)
2193     {
2194 	int waitpid_errno;
2195 	int pstat;
2196 	pid_t pid;
2197 
2198 # if defined(HAVE_SIGACTION)
2199 	struct sigaction sa, old;
2200 
2201 	// Use sigaction() to limit the waiting time to two seconds.
2202 	sigemptyset(&sa.sa_mask);
2203 	sa.sa_handler = sig_handler;
2204 #  ifdef SA_NODEFER
2205 	sa.sa_flags = SA_NODEFER;
2206 #  else
2207 	sa.sa_flags = 0;
2208 #  endif
2209 	sigaction(SIGALRM, &sa, &old);
2210 	alarm(2); // 2 sec timeout
2211 
2212 	// Block until cscope exits or until timer expires
2213 	pid = waitpid(csinfo[i].pid, &pstat, 0);
2214 	waitpid_errno = errno;
2215 
2216 	// cancel pending alarm if still there and restore signal
2217 	alarm(0);
2218 	sigaction(SIGALRM, &old, NULL);
2219 # else
2220 	int waited;
2221 
2222 	// Can't use sigaction(), loop for two seconds.  First yield the CPU
2223 	// to give cscope a chance to exit quickly.
2224 	sleep(0);
2225 	for (waited = 0; waited < 40; ++waited)
2226 	{
2227 	    pid = waitpid(csinfo[i].pid, &pstat, WNOHANG);
2228 	    waitpid_errno = errno;
2229 	    if (pid != 0)
2230 		break;  // break unless the process is still running
2231 	    mch_delay(50L, 0); // sleep 50 ms
2232 	}
2233 # endif
2234 	/*
2235 	 * If the cscope process is still running: kill it.
2236 	 * Safety check: If the PID would be zero here, the entire X session
2237 	 * would be killed.  -1 and 1 are dangerous as well.
2238 	 */
2239 	if (pid < 0 && csinfo[i].pid > 1)
2240 	{
2241 # ifdef ECHILD
2242 	    int alive = TRUE;
2243 
2244 	    if (waitpid_errno == ECHILD)
2245 	    {
2246 		/*
2247 		 * When using 'vim -g', vim is forked and cscope process is
2248 		 * no longer a child process but a sibling.  So waitpid()
2249 		 * fails with errno being ECHILD (No child processes).
2250 		 * Don't send SIGKILL to cscope immediately but wait
2251 		 * (polling) for it to exit normally as result of sending
2252 		 * the "q" command, hence giving it a chance to clean up
2253 		 * its temporary files.
2254 		 */
2255 		int waited;
2256 
2257 		sleep(0);
2258 		for (waited = 0; waited < 40; ++waited)
2259 		{
2260 		    // Check whether cscope process is still alive
2261 		    if (kill(csinfo[i].pid, 0) != 0)
2262 		    {
2263 			alive = FALSE; // cscope process no longer exists
2264 			break;
2265 		    }
2266 		    mch_delay(50L, 0); // sleep 50 ms
2267 		}
2268 	    }
2269 	    if (alive)
2270 # endif
2271 	    {
2272 		kill(csinfo[i].pid, SIGKILL);
2273 		(void)waitpid(csinfo[i].pid, &pstat, 0);
2274 	    }
2275 	}
2276     }
2277 #else  // !UNIX
2278     if (csinfo[i].hProc != NULL)
2279     {
2280 	// Give cscope a chance to exit normally
2281 	if (WaitForSingleObject(csinfo[i].hProc, 1000) == WAIT_TIMEOUT)
2282 	    TerminateProcess(csinfo[i].hProc, 0);
2283 	CloseHandle(csinfo[i].hProc);
2284     }
2285 #endif
2286 
2287     if (csinfo[i].fr_fp != NULL)
2288 	(void)fclose(csinfo[i].fr_fp);
2289     if (csinfo[i].to_fp != NULL)
2290 	(void)fclose(csinfo[i].to_fp);
2291 
2292     if (freefnpp)
2293     {
2294 	vim_free(csinfo[i].fname);
2295 	vim_free(csinfo[i].ppath);
2296 	vim_free(csinfo[i].flags);
2297     }
2298 
2299     clear_csinfo(i);
2300 }
2301 
2302 
2303 /*
2304  * Calls cs_kill on all cscope connections then reinits.
2305  */
2306     static int
2307 cs_reset(exarg_T *eap UNUSED)
2308 {
2309     char	**dblist = NULL, **pplist = NULL, **fllist = NULL;
2310     int	i;
2311     char buf[20]; // for sprintf " (#%d)"
2312 
2313     if (csinfo_size == 0)
2314 	return CSCOPE_SUCCESS;
2315 
2316     // malloc our db and ppath list
2317     dblist = ALLOC_MULT(char *, csinfo_size);
2318     pplist = ALLOC_MULT(char *, csinfo_size);
2319     fllist = ALLOC_MULT(char *, csinfo_size);
2320     if (dblist == NULL || pplist == NULL || fllist == NULL)
2321     {
2322 	vim_free(dblist);
2323 	vim_free(pplist);
2324 	vim_free(fllist);
2325 	return CSCOPE_FAILURE;
2326     }
2327 
2328     for (i = 0; i < csinfo_size; i++)
2329     {
2330 	dblist[i] = csinfo[i].fname;
2331 	pplist[i] = csinfo[i].ppath;
2332 	fllist[i] = csinfo[i].flags;
2333 	if (csinfo[i].fname != NULL)
2334 	    cs_release_csp(i, FALSE);
2335     }
2336 
2337     // rebuild the cscope connection list
2338     for (i = 0; i < csinfo_size; i++)
2339     {
2340 	if (dblist[i] != NULL)
2341 	{
2342 	    cs_add_common(dblist[i], pplist[i], fllist[i]);
2343 	    if (p_csverbose)
2344 	    {
2345 		// don't use smsg_attr() because we want to display the
2346 		// connection number in the same line as
2347 		// "Added cscope database..."
2348 		sprintf(buf, " (#%d)", i);
2349 		msg_puts_attr(buf, HL_ATTR(HLF_R));
2350 	    }
2351 	}
2352 	vim_free(dblist[i]);
2353 	vim_free(pplist[i]);
2354 	vim_free(fllist[i]);
2355     }
2356     vim_free(dblist);
2357     vim_free(pplist);
2358     vim_free(fllist);
2359 
2360     if (p_csverbose)
2361 	msg_attr(_("All cscope databases reset"), HL_ATTR(HLF_R) | MSG_HIST);
2362     return CSCOPE_SUCCESS;
2363 }
2364 
2365 
2366 /*
2367  * Construct the full pathname to a file found in the cscope database.
2368  * (Prepends ppath, if there is one and if it's not already prepended,
2369  * otherwise just uses the name found.)
2370  *
2371  * We need to prepend the prefix because on some cscope's (e.g., the one that
2372  * ships with Solaris 2.6), the output never has the prefix prepended.
2373  * Contrast this with my development system (Digital Unix), which does.
2374  */
2375     static char *
2376 cs_resolve_file(int i, char *name)
2377 {
2378     char	*fullname;
2379     int		len;
2380     char_u	*csdir = NULL;
2381 
2382     /*
2383      * Ppath is freed when we destroy the cscope connection.
2384      * Fullname is freed after cs_make_vim_style_matches, after it's been
2385      * copied into the tag buffer used by Vim.
2386      */
2387     len = (int)(strlen(name) + 2);
2388     if (csinfo[i].ppath != NULL)
2389 	len += (int)strlen(csinfo[i].ppath);
2390     else if (p_csre && csinfo[i].fname != NULL)
2391     {
2392 	// If 'cscoperelative' is set and ppath is not set, use cscope.out
2393 	// path in path resolution.
2394 	csdir = alloc(MAXPATHL);
2395 	if (csdir != NULL)
2396 	{
2397 	    vim_strncpy(csdir, (char_u *)csinfo[i].fname,
2398 					  gettail((char_u *)csinfo[i].fname)
2399 						 - (char_u *)csinfo[i].fname);
2400 	    len += (int)STRLEN(csdir);
2401 	}
2402     }
2403 
2404     // Note/example: this won't work if the cscope output already starts
2405     // "../.." and the prefix path is also "../..".  if something like this
2406     // happens, you are screwed up and need to fix how you're using cscope.
2407     if (csinfo[i].ppath != NULL
2408 	    && (strncmp(name, csinfo[i].ppath, strlen(csinfo[i].ppath)) != 0)
2409 	    && (name[0] != '/')
2410 #ifdef MSWIN
2411 	    && name[0] != '\\' && name[1] != ':'
2412 #endif
2413        )
2414     {
2415 	if ((fullname = alloc(len)) != NULL)
2416 	    (void)sprintf(fullname, "%s/%s", csinfo[i].ppath, name);
2417     }
2418     else if (csdir != NULL && csinfo[i].fname != NULL && *csdir != NUL)
2419     {
2420 	// Check for csdir to be non empty to avoid empty path concatenated to
2421 	// cscope output.
2422 	fullname = (char *)concat_fnames(csdir, (char_u *)name, TRUE);
2423     }
2424     else
2425     {
2426 	fullname = (char *)vim_strsave((char_u *)name);
2427     }
2428 
2429     vim_free(csdir);
2430     return fullname;
2431 }
2432 
2433 
2434 /*
2435  * Show all cscope connections.
2436  */
2437     static int
2438 cs_show(exarg_T *eap UNUSED)
2439 {
2440     short i;
2441     if (cs_cnt_connections() == 0)
2442 	msg_puts(_("no cscope connections\n"));
2443     else
2444     {
2445 	msg_puts_attr(
2446 	    _(" # pid    database name                       prepend path\n"),
2447 	    HL_ATTR(HLF_T));
2448 	for (i = 0; i < csinfo_size; i++)
2449 	{
2450 	    if (csinfo[i].fname == NULL)
2451 		continue;
2452 
2453 	    if (csinfo[i].ppath != NULL)
2454 		(void)smsg("%2d %-5ld  %-34s  %-32s",
2455 		    i, (long)csinfo[i].pid, csinfo[i].fname, csinfo[i].ppath);
2456 	    else
2457 		(void)smsg("%2d %-5ld  %-34s  <none>",
2458 			   i, (long)csinfo[i].pid, csinfo[i].fname);
2459 	}
2460     }
2461 
2462     wait_return(TRUE);
2463     return CSCOPE_SUCCESS;
2464 }
2465 
2466 
2467 /*
2468  * Only called when VIM exits to quit any cscope sessions.
2469  */
2470     void
2471 cs_end(void)
2472 {
2473     int i;
2474 
2475     for (i = 0; i < csinfo_size; i++)
2476 	cs_release_csp(i, TRUE);
2477     vim_free(csinfo);
2478     csinfo_size = 0;
2479 }
2480 
2481 #endif	// FEAT_CSCOPE
2482 
2483 #if defined(FEAT_EVAL) || defined(PROTO)
2484 
2485 /*
2486  * "cscope_connection([{num} , {dbpath} [, {prepend}]])" function
2487  *
2488  * Checks the existence of a cscope connection.
2489  */
2490     void
2491 f_cscope_connection(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
2492 {
2493 # ifdef FEAT_CSCOPE
2494     int		num = 0;
2495     char_u	*dbpath = NULL;
2496     char_u	*prepend = NULL;
2497     char_u	buf[NUMBUFLEN];
2498 
2499     if (in_vim9script()
2500 	    && (check_for_opt_number_arg(argvars, 0) == FAIL
2501 		|| (argvars[0].v_type != VAR_UNKNOWN
2502 		    && (check_for_opt_string_arg(argvars, 1) == FAIL
2503 			|| (argvars[1].v_type != VAR_UNKNOWN
2504 			    && check_for_opt_string_arg(argvars, 2) == FAIL)))))
2505 	return;
2506 
2507     if (argvars[0].v_type != VAR_UNKNOWN
2508 	    && argvars[1].v_type != VAR_UNKNOWN)
2509     {
2510 	num = (int)tv_get_number(&argvars[0]);
2511 	dbpath = tv_get_string(&argvars[1]);
2512 	if (argvars[2].v_type != VAR_UNKNOWN)
2513 	    prepend = tv_get_string_buf(&argvars[2], buf);
2514     }
2515 
2516     rettv->vval.v_number = cs_connection(num, dbpath, prepend);
2517 # endif
2518 }
2519 
2520 #endif // FEAT_EVAL
2521