[thirdparty/git.git] / apply.h

#ifndef APPLY_H
#define APPLY_H

enum apply_ws_error_action {
	nowarn_ws_error,
	warn_on_ws_error,
	die_on_ws_error,
	correct_ws_error
};

enum apply_ws_ignore {
	ignore_ws_none,
	ignore_ws_change
};

/*
 * We need to keep track of how symlinks in the preimage are
 * manipulated by the patches.  A patch to add a/b/c where a/b
 * is a symlink should not be allowed to affect the directory
 * the symlink points at, but if the same patch removes a/b,
 * it is perfectly fine, as the patch removes a/b to make room
 * to create a directory a/b so that a/b/c can be created.
 *
 * See also "struct string_list symlink_changes" in "struct
 * apply_state".
 */
#define APPLY_SYMLINK_GOES_AWAY 01
#define APPLY_SYMLINK_IN_RESULT 02

struct apply_state {
	const char *prefix;
	int prefix_length;

	/* These are lock_file related */
	struct lock_file *lock_file;
	int newfd;

	/* These control what gets looked at and modified */
	int apply; /* this is not a dry-run */
	int cached; /* apply to the index only */
	int check; /* preimage must match working tree, don't actually apply */
	int check_index; /* preimage must match the indexed version */
	int update_index; /* check_index && apply */

	/* These control cosmetic aspect of the output */
	int diffstat; /* just show a diffstat, and don't actually apply */
	int numstat; /* just show a numeric diffstat, and don't actually apply */
	int summary; /* just report creation, deletion, etc, and don't actually apply */

	/* These boolean parameters control how the apply is done */
	int allow_overlap;
	int apply_in_reverse;
	int apply_with_reject;
	int apply_verbosely;
	int no_add;
	int threeway;
	int unidiff_zero;
	int unsafe_paths;

	/* Other non boolean parameters */
	const char *fake_ancestor;
	const char *patch_input_file;
	int line_termination;
	struct strbuf root;
	int p_value;
	int p_value_known;
	unsigned int p_context;

	/* Exclude and include path parameters */
	struct string_list limit_by_name;
	int has_include;

	/* Various "current state" */
	int linenr; /* current line number */
	struct string_list symlink_changes; /* we have to track symlinks */

	/*
	 * For "diff-stat" like behaviour, we keep track of the biggest change
	 * we've seen, and the longest filename. That allows us to do simple
	 * scaling.
	 */
	int max_change;
	int max_len;

	/*
	 * Records filenames that have been touched, in order to handle
	 * the case where more than one patches touch the same file.
	 */
	struct string_list fn_table;

	/* These control whitespace errors */
	enum apply_ws_error_action ws_error_action;
	enum apply_ws_ignore ws_ignore_action;
	const char *whitespace_option;
	int whitespace_error;
	int squelch_whitespace_errors;
	int applied_after_fixing_ws;
};

extern int apply_option_parse_exclude(const struct option *opt,
				      const char *arg, int unset);
extern int apply_option_parse_include(const struct option *opt,
				      const char *arg, int unset);
extern int apply_option_parse_p(const struct option *opt,
				const char *arg,
				int unset);
extern int apply_option_parse_whitespace(const struct option *opt,
					 const char *arg, int unset);
extern int apply_option_parse_directory(const struct option *opt,
					const char *arg, int unset);
extern int apply_option_parse_space_change(const struct option *opt,
					   const char *arg, int unset);

extern int init_apply_state(struct apply_state *state,
			    const char *prefix,
			    struct lock_file *lock_file);
extern void clear_apply_state(struct apply_state *state);
extern int check_apply_state(struct apply_state *state, int force_apply);

/*
 * Some aspects of the apply behavior are controlled by the following
 * bits in the "options" parameter passed to apply_all_patches().
 */
#define APPLY_OPT_INACCURATE_EOF	(1<<0) /* accept inaccurate eof */
#define APPLY_OPT_RECOUNT		(1<<1) /* accept inaccurate line count */

extern int apply_all_patches(struct apply_state *state,
			     int argc,
			     const char **argv,
			     int options);

#endif
Commit	Line	Data
71501a71 CC	1	#ifndef APPLY_H
	2	#define APPLY_H
	3
	4	enum apply_ws_error_action {
	5	nowarn_ws_error,
	6	warn_on_ws_error,
	7	die_on_ws_error,
	8	correct_ws_error
	9	};
	10
	11	enum apply_ws_ignore {
	12	ignore_ws_none,
	13	ignore_ws_change
	14	};
	15
	16	/*
	17	* We need to keep track of how symlinks in the preimage are
	18	* manipulated by the patches. A patch to add a/b/c where a/b
	19	* is a symlink should not be allowed to affect the directory
	20	* the symlink points at, but if the same patch removes a/b,
	21	* it is perfectly fine, as the patch removes a/b to make room
	22	* to create a directory a/b so that a/b/c can be created.
	23	*
	24	* See also "struct string_list symlink_changes" in "struct
	25	* apply_state".
	26	*/
	27	#define APPLY_SYMLINK_GOES_AWAY 01
	28	#define APPLY_SYMLINK_IN_RESULT 02
	29
	30	struct apply_state {
	31	const char *prefix;
	32	int prefix_length;
	33
	34	/* These are lock_file related */
	35	struct lock_file *lock_file;
	36	int newfd;
	37
	38	/* These control what gets looked at and modified */
	39	int apply; /* this is not a dry-run */
	40	int cached; /* apply to the index only */
	41	int check; /* preimage must match working tree, don't actually apply */
	42	int check_index; /* preimage must match the indexed version */
	43	int update_index; /* check_index && apply */
	44
	45	/* These control cosmetic aspect of the output */
	46	int diffstat; /* just show a diffstat, and don't actually apply */
	47	int numstat; /* just show a numeric diffstat, and don't actually apply */
	48	int summary; /* just report creation, deletion, etc, and don't actually apply */
	49
	50	/* These boolean parameters control how the apply is done */
	51	int allow_overlap;
	52	int apply_in_reverse;
	53	int apply_with_reject;
	54	int apply_verbosely;
	55	int no_add;
	56	int threeway;
	57	int unidiff_zero;
	58	int unsafe_paths;
	59
	60	/* Other non boolean parameters */
	61	const char *fake_ancestor;
	62	const char *patch_input_file;
	63	int line_termination;
	64	struct strbuf root;
65	int p_value;
66	int p_value_known;
67	unsigned int p_context;
68
69	/* Exclude and include path parameters */
70	struct string_list limit_by_name;
71	int has_include;
72
73	/* Various "current state" */
74	int linenr; /* current line number */
75	struct string_list symlink_changes; /* we have to track symlinks */
76
77	/*
78	* For "diff-stat" like behaviour, we keep track of the biggest change
79	* we've seen, and the longest filename. That allows us to do simple
80	* scaling.
81	*/
82	int max_change;
83	int max_len;
84
85	/*
86	* Records filenames that have been touched, in order to handle
87	* the case where more than one patches touch the same file.
88	*/
89	struct string_list fn_table;
90
91	/* These control whitespace errors */
92	enum apply_ws_error_action ws_error_action;
93	enum apply_ws_ignore ws_ignore_action;
94	const char *whitespace_option;
95	int whitespace_error;
96	int squelch_whitespace_errors;
97	int applied_after_fixing_ws;
98	};
99
13b5af22 CC	100	extern int apply_option_parse_exclude(const struct option *opt,
	101	const char *arg, int unset);
	102	extern int apply_option_parse_include(const struct option *opt,
	103	const char *arg, int unset);
	104	extern int apply_option_parse_p(const struct option *opt,
	105	const char *arg,
	106	int unset);
	107	extern int apply_option_parse_whitespace(const struct option *opt,
	108	const char *arg, int unset);
	109	extern int apply_option_parse_directory(const struct option *opt,
	110	const char *arg, int unset);
	111	extern int apply_option_parse_space_change(const struct option *opt,
	112	const char *arg, int unset);
	113
2f5a6d12 CC	114	extern int init_apply_state(struct apply_state *state,
	115	const char *prefix,
	116	struct lock_file *lock_file);
bb493a5c	117	extern void clear_apply_state(struct apply_state *state);
b6446d54	118	extern int check_apply_state(struct apply_state *state, int force_apply);
bb493a5c	119
803bf4e0 CC	120	/*
	121	* Some aspects of the apply behavior are controlled by the following
	122	* bits in the "options" parameter passed to apply_all_patches().
	123	*/
	124	#define APPLY_OPT_INACCURATE_EOF (1<<0) /* accept inaccurate eof */
	125	#define APPLY_OPT_RECOUNT (1<<1) /* accept inaccurate line count */
	126
13b5af22 CC	127	extern int apply_all_patches(struct apply_state *state,
	128	int argc,
	129	const char **argv,
	130	int options);
	131
71501a71	132	#endif