1 /* Return the canonical absolute name of a given file.
2 Copyright (C) 1996-2007 Free Software Foundation, Inc.
4 This program is free software; you can redistribute it and/or modify
5 it under the terms of the GNU General Public License as published by
6 the Free Software Foundation; either version 2, or (at your option)
9 This program is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 GNU General Public License for more details.
14 You should have received a copy of the GNU General Public License
15 along with this program; see the file COPYING.
16 If not, write to the Free Software Foundation,
17 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. */
19 #ifndef CANONICALIZE_H_
20 # define CANONICALIZE_H_
22 # if GNULIB_CANONICALIZE
23 enum canonicalize_mode_t
25 /* All components must exist. */
28 /* All components excluding last one must exist. */
31 /* No requirements on components existence. */
34 typedef enum canonicalize_mode_t canonicalize_mode_t;
36 /* Return a malloc'd string containing the canonical absolute name of
37 the named file. This acts like canonicalize_file_name, except that
38 whether components must exist depends on the canonicalize_mode_t
40 char *canonicalize_filename_mode (const char *, canonicalize_mode_t);
43 # if HAVE_DECL_CANONICALIZE_FILE_NAME
46 /* Return a malloc'd string containing the canonical absolute name of
47 the named file. If any file name component does not exist or is a
48 symlink to a nonexistent file, return NULL. A canonical name does
49 not contain any `.', `..' components nor any repeated file name
50 separators ('/') or symlinks. */
51 char *canonicalize_file_name (const char *);
54 #endif /* !CANONICALIZE_H_ */