1 /*
2  * Copyright (c) 2018 Stefan Sperling <stsp@openbsd.org>
3  *
4  * Permission to use, copy, modify, and distribute this software for any
5  * purpose with or without fee is hereby granted, provided that the above
6  * copyright notice and this permission notice appear in all copies.
7  *
8  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
9  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
10  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
11  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
12  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
13  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
14  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
15  */
16 
17 /* Utilities for dealing with filesystem paths. */
18 
19 #define GOT_DEFAULT_FILE_MODE	(S_IRUSR|S_IWUSR | S_IRGRP | S_IROTH)
20 #define GOT_DEFAULT_DIR_MODE	(S_IRWXU | S_IRGRP|S_IXGRP | S_IROTH|S_IXOTH)
21 
22 /* Determine whether a path is an absolute path. */
23 int got_path_is_absolute(const char *);
24 
25 /*
26  * Return an absolute version of a relative path.
27  * The result is allocated with malloc(3).
28  */
29 char *got_path_get_absolute(const char *);
30 
31 /* 
32  * Normalize a path for internal processing.
33  * The result is allocated with malloc(3).
34  */
35 char *got_path_normalize(const char *);
36 
37 /*
38  * Canonicalize absolute paths by removing redundant path separators
39  * and resolving references to parent directories ("/../").
40  * Relative paths are copied from input to buf as-is.
41  */
42 const struct got_error *got_canonpath(const char *, char *, size_t);
43 
44 /*
45  * Get child part of two absolute paths. The second path must equal the first
46  * path up to some path component, and must be longer than the first path.
47  * The result is allocated with malloc(3).
48  */
49 const struct got_error *got_path_skip_common_ancestor(char **, const char *,
50     const char *);