2 * Copyright (C) 2004, 2005, 2007 Internet Systems Consortium, Inc. ("ISC")
3 * Copyright (C) 1999-2001 Internet Software Consortium.
5 * Permission to use, copy, modify, and/or distribute this software for any
6 * purpose with or without fee is hereby granted, provided that the above
7 * copyright notice and this permission notice appear in all copies.
9 * THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
10 * REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
11 * AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
12 * INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
13 * LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
14 * OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
15 * PERFORMANCE OF THIS SOFTWARE.
18 /* $Id: dir.h,v 1.21 2007/06/19 23:47:19 tbox Exp $ */
20 /* Principal Authors: DCL */
27 #include <sys/types.h> /* Required on some systems. */
31 #include <isc/result.h>
33 #define ISC_DIR_NAMEMAX 256
34 #define ISC_DIR_PATHMAX 1024
36 /*% Directory Entry */
37 typedef struct isc_direntry {
39 * Ideally, this should be NAME_MAX, but AIX does not define it by
40 * default and dynamically allocating the space based on pathconf()
41 * complicates things undesirably, as does adding special conditionals
42 * just for AIX. So a comfortably sized buffer is chosen instead.
44 char name[ISC_DIR_NAMEMAX];
49 typedef struct isc_dir {
52 * As with isc_direntry_t->name, making this "right" for all systems
53 * is slightly problematic because AIX does not define PATH_MAX.
55 char dirname[ISC_DIR_PATHMAX];
63 isc_dir_init(isc_dir_t *dir);
66 isc_dir_open(isc_dir_t *dir, const char *dirname);
69 isc_dir_read(isc_dir_t *dir);
72 isc_dir_reset(isc_dir_t *dir);
75 isc_dir_close(isc_dir_t *dir);
78 isc_dir_chdir(const char *dirname);
81 isc_dir_chroot(const char *dirname);
84 isc_dir_createunique(char *templet);
86 * Use a templet (such as from isc_file_mktemplate()) to create a uniquely
87 * named, empty directory. The templet string is modified in place.
88 * If result == ISC_R_SUCCESS, it is the name of the directory that was
94 #endif /* ISC_DIR_H */