kc3-lang/gnulib/lib/canonicalize.h

• Show log

  Commit

• Hash : 99ad8ac7
  Author :
  Date : 2009-09-11T12:18:10
  

  canonicalize, canonicalize-lgpl: use <stdlib.h>
  
  Match current gnulib conventions of glibc functions being declared in
  the same header as glibc.  This makes it easier to replace broken
  canonicalize_file_name.  canonicalize still requires "canonicalize.h"
  because canonicalize_filename_mode is not in glibc.  With this patch,
  canonicalize-lgpl always provides realpath and canonicalize_file_name,
  while canonicalize can provide canonicalize_file_name but not
  realpath; if both modules are in use, canonicalize_file_name comes
  from the LGPLv2+ sources, but the testing comes from canonicalize.
  
  * modules/canonicalize-lgpl (Files): Drop canonicalize.h.
  (Include): Mention <stdlib.h>.
  (configure.ac): Mention functions we provide.
  * modules/canonicalize (configure.ac): Likewise.
  * m4/canonicalize-lgpl.m4 (gl_CANONICALIZE_LGPL): Always replace
  realpath if canonicalize_file_name is missing.
  * m4/stdlib_h.m4 (gl_STDLIB_H_DEFAULTS): Provide defaults.
  * modules/stdlib (Makefile.am): Substitute witnesses.
  * lib/stdlib.in.h (canonicalize_file_name, realpath): Declare.
  * lib/canonicalize-lgpl.c (includes): Adjust accordingly.
  * lib/canonicalize.h (canonicalize_file_name): Drop declaration.
  * NEWS: Document this.
  * doc/glibc-functions/canonicalize_file_name.texi
  (canonicalize_file_name): Likewise.
  * doc/posix-functions/realpath.texi (realpath): Likewise.
  * tests/test-canonicalize-lgpl.c (includes): Use <stdlib.h>.
  
  Signed-off-by: Eric Blake <ebb9@byu.net>
  

Download

• lib/canonicalize.h

• /* Return the canonical absolute name of a given file.
     Copyright (C) 1996-2007, 2009 Free Software Foundation, Inc.
  
     This program is free software: you can redistribute it and/or modify
     it under the terms of the GNU General Public License as published by
     the Free Software Foundation; either version 3 of the License, or
     (at your option) any later version.
  
     This program is distributed in the hope that it will be useful,
     but WITHOUT ANY WARRANTY; without even the implied warranty of
     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
     GNU General Public License for more details.
  
     You should have received a copy of the GNU General Public License
     along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
  
  #ifndef CANONICALIZE_H_
  # define CANONICALIZE_H_
  
  #include <stdlib.h> /* for canonicalize_file_name */
  
  enum canonicalize_mode_t
    {
      /* All components must exist.  */
      CAN_EXISTING = 0,
  
      /* All components excluding last one must exist.  */
      CAN_ALL_BUT_LAST = 1,
  
      /* No requirements on components existence.  */
      CAN_MISSING = 2
    };
  typedef enum canonicalize_mode_t canonicalize_mode_t;
  
  /* Return a malloc'd string containing the canonical absolute name of
     the named file.  This acts like canonicalize_file_name, except that
     whether components must exist depends on the canonicalize_mode_t
     argument.  */
  char *canonicalize_filename_mode (const char *, canonicalize_mode_t);
  
  #endif /* !CANONICALIZE_H_ */
  

Download