[git/git.git] / pathspec.c

#include "cache.h"
#include "dir.h"
#include "pathspec.h"

/*
 * Finds which of the given pathspecs match items in the index.
 *
 * For each pathspec, sets the corresponding entry in the seen[] array
 * (which should be specs items long, i.e. the same size as pathspec)
 * to the nature of the "closest" (i.e. most specific) match found for
 * that pathspec in the index, if it was a closer type of match than
 * the existing entry.  As an optimization, matching is skipped
 * altogether if seen[] already only contains non-zero entries.
 *
 * If seen[] has not already been written to, it may make sense
 * to use find_pathspecs_matching_against_index() instead.
 */
void add_pathspec_matches_against_index(const char **pathspec,
					char *seen, int specs)
{
	int num_unmatched = 0, i;

	/*
	 * Since we are walking the index as if we were walking the directory,
	 * we have to mark the matched pathspec as seen; otherwise we will
	 * mistakenly think that the user gave a pathspec that did not match
	 * anything.
	 */
	for (i = 0; i < specs; i++)
		if (!seen[i])
			num_unmatched++;
	if (!num_unmatched)
		return;
	for (i = 0; i < active_nr; i++) {
		struct cache_entry *ce = active_cache[i];
		match_pathspec(pathspec, ce->name, ce_namelen(ce), 0, seen);
	}
}

/*
 * Finds which of the given pathspecs match items in the index.
 *
 * This is a one-shot wrapper around add_pathspec_matches_against_index()
 * which allocates, populates, and returns a seen[] array indicating the
 * nature of the "closest" (i.e. most specific) matches which each of the
 * given pathspecs achieves against all items in the index.
 */
char *find_pathspecs_matching_against_index(const char **pathspec)
{
	char *seen;
	int i;

	for (i = 0; pathspec[i];  i++)
		; /* just counting */
	seen = xcalloc(i, 1);
	add_pathspec_matches_against_index(pathspec, seen, i);
	return seen;
}

/*
 * Check the index to see whether path refers to a submodule, or
 * something inside a submodule.  If the former, returns the path with
 * any trailing slash stripped.  If the latter, dies with an error
 * message.
 */
const char *check_path_for_gitlink(const char *path)
{
	int i, path_len = strlen(path);
	for (i = 0; i < active_nr; i++) {
		struct cache_entry *ce = active_cache[i];
		if (S_ISGITLINK(ce->ce_mode)) {
			int ce_len = ce_namelen(ce);
			if (path_len <= ce_len || path[ce_len] != '/' ||
			    memcmp(ce->name, path, ce_len))
				/* path does not refer to this
				 * submodule or anything inside it */
				continue;
			if (path_len == ce_len + 1) {
				/* path refers to submodule;
				 * strip trailing slash */
				return xstrndup(ce->name, ce_len);
			} else {
				die (_("Path '%s' is in submodule '%.*s'"),
				     path, ce_len, ce->name);
			}
		}
	}
	return path;
}

/*
 * Dies if the given path refers to a file inside a symlinked
 * directory in the index.
 */
void die_if_path_beyond_symlink(const char *path, const char *prefix)
{
	if (has_symlink_leading_path(path, strlen(path))) {
		int len = prefix ? strlen(prefix) : 0;
		die(_("'%s' is beyond a symbolic link"), path + len);
	}
}

/*
 * Magic pathspec
 *
 * Possible future magic semantics include stuff like:
 *
 *	{ PATHSPEC_NOGLOB, '!', "noglob" },
 *	{ PATHSPEC_ICASE, '\0', "icase" },
 *	{ PATHSPEC_RECURSIVE, '*', "recursive" },
 *	{ PATHSPEC_REGEXP, '\0', "regexp" },
 *
 */

static struct pathspec_magic {
	unsigned bit;
	char mnemonic; /* this cannot be ':'! */
	const char *name;
} pathspec_magic[] = {
	{ PATHSPEC_FROMTOP, '/', "top" },
};

/*
 * Take an element of a pathspec and check for magic signatures.
 * Append the result to the prefix. Return the magic bitmap.
 *
 * For now, we only parse the syntax and throw out anything other than
 * "top" magic.
 *
 * NEEDSWORK: This needs to be rewritten when we start migrating
 * get_pathspec() users to use the "struct pathspec" interface.  For
 * example, a pathspec element may be marked as case-insensitive, but
 * the prefix part must always match literally, and a single stupid
 * string cannot express such a case.
 */
static unsigned prefix_pathspec(struct pathspec_item *item,
				unsigned *p_short_magic,
				const char **raw, unsigned flags,
				const char *prefix, int prefixlen,
				const char *elt)
{
	unsigned magic = 0, short_magic = 0;
	const char *copyfrom = elt;
	char *match;
	int i;

	if (elt[0] != ':') {
		; /* nothing to do */
	} else if (elt[1] == '(') {
		/* longhand */
		const char *nextat;
		for (copyfrom = elt + 2;
		     *copyfrom && *copyfrom != ')';
		     copyfrom = nextat) {
			size_t len = strcspn(copyfrom, ",)");
			if (copyfrom[len] == ',')
				nextat = copyfrom + len + 1;
			else
				/* handle ')' and '\0' */
				nextat = copyfrom + len;
			if (!len)
				continue;
			for (i = 0; i < ARRAY_SIZE(pathspec_magic); i++)
				if (strlen(pathspec_magic[i].name) == len &&
				    !strncmp(pathspec_magic[i].name, copyfrom, len)) {
					magic |= pathspec_magic[i].bit;
					break;
				}
			if (ARRAY_SIZE(pathspec_magic) <= i)
				die(_("Invalid pathspec magic '%.*s' in '%s'"),
				    (int) len, copyfrom, elt);
		}
		if (*copyfrom != ')')
			die(_("Missing ')' at the end of pathspec magic in '%s'"), elt);
		copyfrom++;
	} else {
		/* shorthand */
		for (copyfrom = elt + 1;
		     *copyfrom && *copyfrom != ':';
		     copyfrom++) {
			char ch = *copyfrom;

			if (!is_pathspec_magic(ch))
				break;
			for (i = 0; i < ARRAY_SIZE(pathspec_magic); i++)
				if (pathspec_magic[i].mnemonic == ch) {
					short_magic |= pathspec_magic[i].bit;
					break;
				}
			if (ARRAY_SIZE(pathspec_magic) <= i)
				die(_("Unimplemented pathspec magic '%c' in '%s'"),
				    ch, elt);
		}
		if (*copyfrom == ':')
			copyfrom++;
	}

	magic |= short_magic;
	*p_short_magic = short_magic;

	if (magic & PATHSPEC_FROMTOP)
		match = xstrdup(copyfrom);
	else
		match = prefix_path(prefix, prefixlen, copyfrom);
	*raw = item->match = match;
	/*
	 * Prefix the pathspec (keep all magic) and assign to
	 * original. Useful for passing to another command.
	 */
	if (flags & PATHSPEC_PREFIX_ORIGIN) {
		struct strbuf sb = STRBUF_INIT;
		strbuf_add(&sb, elt, copyfrom - elt);
		strbuf_addstr(&sb, match);
		item->original = strbuf_detach(&sb, NULL);
	} else
		item->original = elt;
	item->len = strlen(item->match);

	if ((flags & PATHSPEC_STRIP_SUBMODULE_SLASH_CHEAP) &&
	    (item->len >= 1 && item->match[item->len - 1] == '/') &&
	    (i = cache_name_pos(item->match, item->len - 1)) >= 0 &&
	    S_ISGITLINK(active_cache[i]->ce_mode)) {
		item->len--;
		match[item->len] = '\0';
	}

	if (flags & PATHSPEC_STRIP_SUBMODULE_SLASH_EXPENSIVE)
		for (i = 0; i < active_nr; i++) {
			struct cache_entry *ce = active_cache[i];
			int ce_len = ce_namelen(ce);

			if (!S_ISGITLINK(ce->ce_mode))
				continue;

			if (item->len <= ce_len || match[ce_len] != '/' ||
			    memcmp(ce->name, match, ce_len))
				continue;
			if (item->len == ce_len + 1) {
				/* strip trailing slash */
				item->len--;
				match[item->len] = '\0';
			} else
				die (_("Pathspec '%s' is in submodule '%.*s'"),
				     elt, ce_len, ce->name);
		}

	if (limit_pathspec_to_literal())
		item->nowildcard_len = item->len;
	else
		item->nowildcard_len = simple_length(item->match);
	item->flags = 0;
	if (item->nowildcard_len < item->len &&
	    item->match[item->nowildcard_len] == '*' &&
	    no_wildcard(item->match + item->nowildcard_len + 1))
		item->flags |= PATHSPEC_ONESTAR;
	return magic;
}

static int pathspec_item_cmp(const void *a_, const void *b_)
{
	struct pathspec_item *a, *b;

	a = (struct pathspec_item *)a_;
	b = (struct pathspec_item *)b_;
	return strcmp(a->match, b->match);
}

static void NORETURN unsupported_magic(const char *pattern,
				       unsigned magic,
				       unsigned short_magic)
{
	struct strbuf sb = STRBUF_INIT;
	int i, n;
	for (n = i = 0; i < ARRAY_SIZE(pathspec_magic); i++) {
		const struct pathspec_magic *m = pathspec_magic + i;
		if (!(magic & m->bit))
			continue;
		if (sb.len)
			strbuf_addstr(&sb, " ");
		if (short_magic & m->bit)
			strbuf_addf(&sb, "'%c'", m->mnemonic);
		else
			strbuf_addf(&sb, "'%s'", m->name);
		n++;
	}
	/*
	 * We may want to substitute "this command" with a command
	 * name. E.g. when add--interactive dies when running
	 * "checkout -p"
	 */
	die(_("%s: pathspec magic not supported by this command: %s"),
	    pattern, sb.buf);
}

/*
 * Given command line arguments and a prefix, convert the input to
 * pathspec. die() if any magic in magic_mask is used.
 */
void parse_pathspec(struct pathspec *pathspec,
		    unsigned magic_mask, unsigned flags,
		    const char *prefix, const char **argv)
{
	struct pathspec_item *item;
	const char *entry = argv ? *argv : NULL;
	int i, n, prefixlen;

	memset(pathspec, 0, sizeof(*pathspec));

	if (flags & PATHSPEC_MAXDEPTH_VALID)
		pathspec->magic |= PATHSPEC_MAXDEPTH;

	/* No arguments, no prefix -> no pathspec */
	if (!entry && !prefix)
		return;

	if ((flags & PATHSPEC_PREFER_CWD) &&
	    (flags & PATHSPEC_PREFER_FULL))
		die("BUG: PATHSPEC_PREFER_CWD and PATHSPEC_PREFER_FULL are incompatible");

	/* No arguments with prefix -> prefix pathspec */
	if (!entry) {
		static const char *raw[2];

		if (flags & PATHSPEC_PREFER_FULL)
			return;

		if (!(flags & PATHSPEC_PREFER_CWD))
			die("BUG: PATHSPEC_PREFER_CWD requires arguments");

		pathspec->items = item = xmalloc(sizeof(*item));
		memset(item, 0, sizeof(*item));
		item->match = prefix;
		item->original = prefix;
		item->nowildcard_len = item->len = strlen(prefix);
		raw[0] = prefix;
		raw[1] = NULL;
		pathspec->nr = 1;
		pathspec->raw = raw;
		return;
	}

	n = 0;
	while (argv[n])
		n++;

	pathspec->nr = n;
	pathspec->items = item = xmalloc(sizeof(*item) * n);
	pathspec->raw = argv;
	prefixlen = prefix ? strlen(prefix) : 0;

	for (i = 0; i < n; i++) {
		unsigned short_magic;
		entry = argv[i];

		item[i].magic = prefix_pathspec(item + i, &short_magic,
						argv + i, flags,
						prefix, prefixlen, entry);
		if (item[i].magic & magic_mask)
			unsupported_magic(entry,
					  item[i].magic & magic_mask,
					  short_magic);

		if ((flags & PATHSPEC_SYMLINK_LEADING_PATH) &&
		    has_symlink_leading_path(item[i].match, item[i].len)) {
			die(_("pathspec '%s' is beyond a symbolic link"), entry);
		}

		if (item[i].nowildcard_len < item[i].len)
			pathspec->has_wildcard = 1;
		pathspec->magic |= item[i].magic;
	}

	if (pathspec->magic & PATHSPEC_MAXDEPTH)
		qsort(pathspec->items, pathspec->nr,
		      sizeof(struct pathspec_item), pathspec_item_cmp);
}

/*
 * N.B. get_pathspec() is deprecated in favor of the "struct pathspec"
 * based interface - see pathspec.c:parse_pathspec().
 *
 * Arguments:
 *  - prefix - a path relative to the root of the working tree
 *  - pathspec - a list of paths underneath the prefix path
 *
 * Iterates over pathspec, prepending each path with prefix,
 * and return the resulting list.
 *
 * If pathspec is empty, return a singleton list containing prefix.
 *
 * If pathspec and prefix are both empty, return an empty list.
 *
 * This is typically used by built-in commands such as add.c, in order
 * to normalize argv arguments provided to the built-in into a list of
 * paths to process, all relative to the root of the working tree.
 */
const char **get_pathspec(const char *prefix, const char **pathspec)
{
	struct pathspec ps;
	parse_pathspec(&ps,
		       PATHSPEC_ALL_MAGIC & ~PATHSPEC_FROMTOP,
		       PATHSPEC_PREFER_CWD,
		       prefix, pathspec);
	return ps.raw;
}

void copy_pathspec(struct pathspec *dst, const struct pathspec *src)
{
	*dst = *src;
	dst->items = xmalloc(sizeof(struct pathspec_item) * dst->nr);
	memcpy(dst->items, src->items,
	       sizeof(struct pathspec_item) * dst->nr);
}
Commit	Line	Data
6f525e71 AS	1	#include "cache.h"
	2	#include "dir.h"
	3	#include "pathspec.h"
	4
	5	/*
	6	* Finds which of the given pathspecs match items in the index.
	7	*
	8	* For each pathspec, sets the corresponding entry in the seen[] array
	9	* (which should be specs items long, i.e. the same size as pathspec)
	10	* to the nature of the "closest" (i.e. most specific) match found for
	11	* that pathspec in the index, if it was a closer type of match than
	12	* the existing entry. As an optimization, matching is skipped
	13	* altogether if seen[] already only contains non-zero entries.
	14	*
	15	* If seen[] has not already been written to, it may make sense
4b78d7bc	16	* to use find_pathspecs_matching_against_index() instead.
6f525e71	17	*/
4b78d7bc AS	18	void add_pathspec_matches_against_index(const char **pathspec,
4b78d7bc AS	19	char *seen, int specs)
6f525e71 AS	20	{
	21	int num_unmatched = 0, i;
	22
	23	/*
	24	* Since we are walking the index as if we were walking the directory,
	25	* we have to mark the matched pathspec as seen; otherwise we will
	26	* mistakenly think that the user gave a pathspec that did not match
	27	* anything.
	28	*/
	29	for (i = 0; i < specs; i++)
	30	if (!seen[i])
	31	num_unmatched++;
	32	if (!num_unmatched)
	33	return;
	34	for (i = 0; i < active_nr; i++) {
	35	struct cache_entry *ce = active_cache[i];
	36	match_pathspec(pathspec, ce->name, ce_namelen(ce), 0, seen);
	37	}
	38	}
	39
	40	/*
	41	* Finds which of the given pathspecs match items in the index.
	42	*
4b78d7bc AS	43	* This is a one-shot wrapper around add_pathspec_matches_against_index()
	44	* which allocates, populates, and returns a seen[] array indicating the
	45	* nature of the "closest" (i.e. most specific) matches which each of the
	46	* given pathspecs achieves against all items in the index.
6f525e71	47	*/
4b78d7bc	48	char find_pathspecs_matching_against_index(const char *pathspec)
6f525e71 AS	49	{
	50	char *seen;
	51	int i;
	52
	53	for (i = 0; pathspec[i]; i++)
	54	; /* just counting */
	55	seen = xcalloc(i, 1);
4b78d7bc	56	add_pathspec_matches_against_index(pathspec, seen, i);
6f525e71 AS	57	return seen;
6f525e71 AS	58	}
9d67b61f AS	59
	60	/*
	61	* Check the index to see whether path refers to a submodule, or
	62	* something inside a submodule. If the former, returns the path with
	63	* any trailing slash stripped. If the latter, dies with an error
	64	* message.
	65	*/
	66	const char check_path_for_gitlink(const char path)
	67	{
	68	int i, path_len = strlen(path);
	69	for (i = 0; i < active_nr; i++) {
	70	struct cache_entry *ce = active_cache[i];
	71	if (S_ISGITLINK(ce->ce_mode)) {
	72	int ce_len = ce_namelen(ce);
	73	if (path_len <= ce_len \|\| path[ce_len] != '/' \|\|
	74	memcmp(ce->name, path, ce_len))
	75	/* path does not refer to this
	76	* submodule or anything inside it */
	77	continue;
	78	if (path_len == ce_len + 1) {
	79	/* path refers to submodule;
	80	* strip trailing slash */
	81	return xstrndup(ce->name, ce_len);
	82	} else {
	83	die (_("Path '%s' is in submodule '%.*s'"),
	84	path, ce_len, ce->name);
	85	}
	86	}
	87	}
	88	return path;
	89	}
512aaf94 AS	90
	91	/*
	92	* Dies if the given path refers to a file inside a symlinked
	93	* directory in the index.
	94	*/
	95	void die_if_path_beyond_symlink(const char path, const char prefix)
	96	{
	97	if (has_symlink_leading_path(path, strlen(path))) {
	98	int len = prefix ? strlen(prefix) : 0;
	99	die(_("'%s' is beyond a symbolic link"), path + len);
	100	}
	101	}
64acde94 NTND	102
	103	/*
	104	* Magic pathspec
	105	*
64acde94 NTND	106	* Possible future magic semantics include stuff like:
	107	*
	108	* { PATHSPEC_NOGLOB, '!', "noglob" },
	109	* { PATHSPEC_ICASE, '\0', "icase" },
	110	* { PATHSPEC_RECURSIVE, '*', "recursive" },
	111	* { PATHSPEC_REGEXP, '\0', "regexp" },
	112	*
	113	*/
64acde94 NTND	114
	115	static struct pathspec_magic {
	116	unsigned bit;
	117	char mnemonic; /* this cannot be ':'! */
	118	const char *name;
	119	} pathspec_magic[] = {
	120	{ PATHSPEC_FROMTOP, '/', "top" },
	121	};
	122
	123	/*
	124	* Take an element of a pathspec and check for magic signatures.
87323bda	125	* Append the result to the prefix. Return the magic bitmap.
64acde94 NTND	126	*
	127	* For now, we only parse the syntax and throw out anything other than
	128	* "top" magic.
	129	*
	130	* NEEDSWORK: This needs to be rewritten when we start migrating
	131	* get_pathspec() users to use the "struct pathspec" interface. For
	132	* example, a pathspec element may be marked as case-insensitive, but
	133	* the prefix part must always match literally, and a single stupid
	134	* string cannot express such a case.
	135	*/
87323bda NTND	136	static unsigned prefix_pathspec(struct pathspec_item *item,
	137	unsigned *p_short_magic,
	138	const char **raw, unsigned flags,
	139	const char *prefix, int prefixlen,
	140	const char *elt)
64acde94	141	{
87323bda	142	unsigned magic = 0, short_magic = 0;
64acde94	143	const char *copyfrom = elt;
87323bda	144	char *match;
64acde94 NTND	145	int i;
	146
	147	if (elt[0] != ':') {
	148	; /* nothing to do */
	149	} else if (elt[1] == '(') {
	150	/* longhand */
	151	const char *nextat;
	152	for (copyfrom = elt + 2;
	153	copyfrom && copyfrom != ')';
	154	copyfrom = nextat) {
	155	size_t len = strcspn(copyfrom, ",)");
	156	if (copyfrom[len] == ',')
	157	nextat = copyfrom + len + 1;
	158	else
	159	/* handle ')' and '\0' */
	160	nextat = copyfrom + len;
	161	if (!len)
	162	continue;
	163	for (i = 0; i < ARRAY_SIZE(pathspec_magic); i++)
	164	if (strlen(pathspec_magic[i].name) == len &&
	165	!strncmp(pathspec_magic[i].name, copyfrom, len)) {
	166	magic \|= pathspec_magic[i].bit;
	167	break;
	168	}
	169	if (ARRAY_SIZE(pathspec_magic) <= i)
f01d9820	170	die(_("Invalid pathspec magic '%.*s' in '%s'"),
64acde94 NTND	171	(int) len, copyfrom, elt);
	172	}
	173	if (*copyfrom != ')')
f01d9820	174	die(_("Missing ')' at the end of pathspec magic in '%s'"), elt);
64acde94 NTND	175	copyfrom++;
	176	} else {
	177	/* shorthand */
	178	for (copyfrom = elt + 1;
	179	copyfrom && copyfrom != ':';
	180	copyfrom++) {
	181	char ch = *copyfrom;
	182
	183	if (!is_pathspec_magic(ch))
	184	break;
	185	for (i = 0; i < ARRAY_SIZE(pathspec_magic); i++)
	186	if (pathspec_magic[i].mnemonic == ch) {
87323bda	187	short_magic \|= pathspec_magic[i].bit;
64acde94 NTND	188	break;
	189	}
	190	if (ARRAY_SIZE(pathspec_magic) <= i)
f01d9820	191	die(_("Unimplemented pathspec magic '%c' in '%s'"),
64acde94 NTND	192	ch, elt);
	193	}
	194	if (*copyfrom == ':')
	195	copyfrom++;
	196	}
	197
87323bda NTND	198	magic \|= short_magic;
	199	*p_short_magic = short_magic;
	200
64acde94	201	if (magic & PATHSPEC_FROMTOP)
87323bda	202	match = xstrdup(copyfrom);
64acde94	203	else
87323bda NTND	204	match = prefix_path(prefix, prefixlen, copyfrom);
87323bda NTND	205	*raw = item->match = match;
dad2586a NTND	206	/*
	207	* Prefix the pathspec (keep all magic) and assign to
	208	* original. Useful for passing to another command.
	209	*/
	210	if (flags & PATHSPEC_PREFIX_ORIGIN) {
	211	struct strbuf sb = STRBUF_INIT;
	212	strbuf_add(&sb, elt, copyfrom - elt);
	213	strbuf_addstr(&sb, match);
	214	item->original = strbuf_detach(&sb, NULL);
	215	} else
	216	item->original = elt;
87323bda	217	item->len = strlen(item->match);
b69bb3fc NTND	218
	219	if ((flags & PATHSPEC_STRIP_SUBMODULE_SLASH_CHEAP) &&
	220	(item->len >= 1 && item->match[item->len - 1] == '/') &&
	221	(i = cache_name_pos(item->match, item->len - 1)) >= 0 &&
	222	S_ISGITLINK(active_cache[i]->ce_mode)) {
	223	item->len--;
	224	match[item->len] = '\0';
	225	}
	226
87450244 NTND	227	if (flags & PATHSPEC_STRIP_SUBMODULE_SLASH_EXPENSIVE)
	228	for (i = 0; i < active_nr; i++) {
	229	struct cache_entry *ce = active_cache[i];
	230	int ce_len = ce_namelen(ce);
	231
	232	if (!S_ISGITLINK(ce->ce_mode))
	233	continue;
	234
	235	if (item->len <= ce_len \|\| match[ce_len] != '/' \|\|
	236	memcmp(ce->name, match, ce_len))
	237	continue;
	238	if (item->len == ce_len + 1) {
	239	/* strip trailing slash */
	240	item->len--;
	241	match[item->len] = '\0';
	242	} else
	243	die (_("Pathspec '%s' is in submodule '%.*s'"),
	244	elt, ce_len, ce->name);
	245	}
	246
87323bda NTND	247	if (limit_pathspec_to_literal())
	248	item->nowildcard_len = item->len;
	249	else
	250	item->nowildcard_len = simple_length(item->match);
	251	item->flags = 0;
	252	if (item->nowildcard_len < item->len &&
	253	item->match[item->nowildcard_len] == '*' &&
	254	no_wildcard(item->match + item->nowildcard_len + 1))
	255	item->flags \|= PATHSPEC_ONESTAR;
	256	return magic;
	257	}
	258
	259	static int pathspec_item_cmp(const void a_, const void b_)
	260	{
	261	struct pathspec_item a, b;
	262
	263	a = (struct pathspec_item *)a_;
	264	b = (struct pathspec_item *)b_;
	265	return strcmp(a->match, b->match);
	266	}
	267
	268	static void NORETURN unsupported_magic(const char *pattern,
	269	unsigned magic,
	270	unsigned short_magic)
	271	{
	272	struct strbuf sb = STRBUF_INIT;
	273	int i, n;
	274	for (n = i = 0; i < ARRAY_SIZE(pathspec_magic); i++) {
	275	const struct pathspec_magic *m = pathspec_magic + i;
	276	if (!(magic & m->bit))
	277	continue;
	278	if (sb.len)
	279	strbuf_addstr(&sb, " ");
	280	if (short_magic & m->bit)
	281	strbuf_addf(&sb, "'%c'", m->mnemonic);
	282	else
	283	strbuf_addf(&sb, "'%s'", m->name);
	284	n++;
	285	}
	286	/*
	287	* We may want to substitute "this command" with a command
	288	* name. E.g. when add--interactive dies when running
	289	* "checkout -p"
	290	*/
	291	die(_("%s: pathspec magic not supported by this command: %s"),
	292	pattern, sb.buf);
	293	}
	294
	295	/*
	296	* Given command line arguments and a prefix, convert the input to
	297	* pathspec. die() if any magic in magic_mask is used.
	298	*/
	299	void parse_pathspec(struct pathspec *pathspec,
	300	unsigned magic_mask, unsigned flags,
	301	const char prefix, const char *argv)
	302	{
	303	struct pathspec_item *item;
	304	const char entry = argv ? argv : NULL;
	305	int i, n, prefixlen;
	306
	307	memset(pathspec, 0, sizeof(*pathspec));
	308
6330a171 NTND	309	if (flags & PATHSPEC_MAXDEPTH_VALID)
	310	pathspec->magic \|= PATHSPEC_MAXDEPTH;
	311
87323bda NTND	312	/* No arguments, no prefix -> no pathspec */
	313	if (!entry && !prefix)
	314	return;
	315
fc12261f NTND	316	if ((flags & PATHSPEC_PREFER_CWD) &&
	317	(flags & PATHSPEC_PREFER_FULL))
	318	die("BUG: PATHSPEC_PREFER_CWD and PATHSPEC_PREFER_FULL are incompatible");
	319
87323bda NTND	320	/* No arguments with prefix -> prefix pathspec */
	321	if (!entry) {
	322	static const char *raw[2];
	323
fc12261f NTND	324	if (flags & PATHSPEC_PREFER_FULL)
	325	return;
	326
	327	if (!(flags & PATHSPEC_PREFER_CWD))
	328	die("BUG: PATHSPEC_PREFER_CWD requires arguments");
	329
87323bda NTND	330	pathspec->items = item = xmalloc(sizeof(*item));
	331	memset(item, 0, sizeof(*item));
	332	item->match = prefix;
d2ce1331	333	item->original = prefix;
87323bda NTND	334	item->nowildcard_len = item->len = strlen(prefix);
	335	raw[0] = prefix;
	336	raw[1] = NULL;
	337	pathspec->nr = 1;
	338	pathspec->raw = raw;
	339	return;
	340	}
	341
	342	n = 0;
	343	while (argv[n])
	344	n++;
	345
	346	pathspec->nr = n;
	347	pathspec->items = item = xmalloc(sizeof(item) n);
	348	pathspec->raw = argv;
	349	prefixlen = prefix ? strlen(prefix) : 0;
	350
	351	for (i = 0; i < n; i++) {
	352	unsigned short_magic;
	353	entry = argv[i];
	354
	355	item[i].magic = prefix_pathspec(item + i, &short_magic,
	356	argv + i, flags,
	357	prefix, prefixlen, entry);
	358	if (item[i].magic & magic_mask)
	359	unsupported_magic(entry,
	360	item[i].magic & magic_mask,
	361	short_magic);
87450244 NTND	362
	363	if ((flags & PATHSPEC_SYMLINK_LEADING_PATH) &&
	364	has_symlink_leading_path(item[i].match, item[i].len)) {
	365	die(_("pathspec '%s' is beyond a symbolic link"), entry);
	366	}
	367
87323bda NTND	368	if (item[i].nowildcard_len < item[i].len)
	369	pathspec->has_wildcard = 1;
	370	pathspec->magic \|= item[i].magic;
	371	}
	372
6330a171 NTND	373	if (pathspec->magic & PATHSPEC_MAXDEPTH)
	374	qsort(pathspec->items, pathspec->nr,
	375	sizeof(struct pathspec_item), pathspec_item_cmp);
64acde94 NTND	376	}
	377
	378	/*
	379	* N.B. get_pathspec() is deprecated in favor of the "struct pathspec"
87323bda	380	* based interface - see pathspec.c:parse_pathspec().
64acde94 NTND	381	*
	382	* Arguments:
	383	* - prefix - a path relative to the root of the working tree
	384	* - pathspec - a list of paths underneath the prefix path
	385	*
	386	* Iterates over pathspec, prepending each path with prefix,
	387	* and return the resulting list.
	388	*
	389	* If pathspec is empty, return a singleton list containing prefix.
	390	*
	391	* If pathspec and prefix are both empty, return an empty list.
	392	*
	393	* This is typically used by built-in commands such as add.c, in order
	394	* to normalize argv arguments provided to the built-in into a list of
	395	* paths to process, all relative to the root of the working tree.
	396	*/
	397	const char *get_pathspec(const char prefix, const char **pathspec)
	398	{
87323bda NTND	399	struct pathspec ps;
	400	parse_pathspec(&ps,
	401	PATHSPEC_ALL_MAGIC & ~PATHSPEC_FROMTOP,
fc12261f NTND	402	PATHSPEC_PREFER_CWD,
fc12261f NTND	403	prefix, pathspec);
87323bda	404	return ps.raw;
64acde94	405	}
e4d92cdc NTND	406
	407	void copy_pathspec(struct pathspec dst, const struct pathspec src)
	408	{
	409	dst = src;
	410	dst->items = xmalloc(sizeof(struct pathspec_item) * dst->nr);
	411	memcpy(dst->items, src->items,
	412	sizeof(struct pathspec_item) * dst->nr);
	413	}