home *** CD-ROM | disk | FTP | other *** search
/ Chip 2001 May / W2KPRK.iso / apps / posix / source / INCLUDE / BSD / FTS.H < prev    next >
C/C++ Source or Header  |  1999-11-17  |  5KB  |  122 lines
  1. /*
  2.  * Copyright (c) 1989 The Regents of the University of California.
  3.  * All rights reserved.
  4.  *
  5.  * Redistribution and use in source and binary forms, with or without
  6.  * modification, are permitted provided that the following conditions
  7.  * are met:
  8.  * 1. Redistributions of source code must retain the above copyright
  9.  *    notice, this list of conditions and the following disclaimer.
  10.  * 2. Redistributions in binary form must reproduce the above copyright
  11.  *    notice, this list of conditions and the following disclaimer in the
  12.  *    documentation and/or other materials provided with the distribution.
  13.  * 3. All advertising materials mentioning features or use of this software
  14.  *    must display the following acknowledgement:
  15.  *    This product includes software developed by the University of
  16.  *    California, Berkeley and its contributors.
  17.  * 4. Neither the name of the University nor the names of its contributors
  18.  *    may be used to endorse or promote products derived from this software
  19.  *    without specific prior written permission.
  20.  *
  21.  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  22.  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  23.  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  24.  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  25.  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  26.  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  27.  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  28.  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  29.  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  30.  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  31.  * SUCH DAMAGE.
  32.  *
  33.  *    @(#)fts.h    5.14 (Berkeley) 4/3/91
  34.  */
  35.  
  36.  
  37.  
  38. #ifndef    _FTS_H_
  39. #define    _FTS_H_
  40.  
  41. typedef struct {
  42.     struct _ftsent *fts_cur;    /* current node */
  43.     struct _ftsent *fts_child;    /* linked list of children */
  44.     struct _ftsent *fts_savelink;    /* saved link if node had a cycle */
  45.     struct _ftsent **fts_array;    /* sort array */
  46.     dev_t rdev;            /* starting device # */
  47.     char *fts_path;            /* path for this descent */
  48.     int fts_dfd;            /* fd for directories */
  49. #ifdef _POSIX_SOURCE            /* DF_DSC: bacause no fchdir in POSIX */
  50.         char *fts_rpath;                /* path to root of search */
  51. #else
  52.     int fts_rfd;            /* fd for root */
  53. #endif
  54.     int fts_pathlen;        /* sizeof(path) */
  55.     int fts_nitems;            /* elements in the sort array */
  56.     int (*fts_compar)();        /* compare function */
  57.  
  58. #define    FTS_LOGICAL    0x001        /* logical walk */
  59. #define    FTS_NOCHDIR    0x002        /* don't change directories */
  60. #define    FTS_NOSTAT    0x004        /* don't get stat info */
  61. #define    FTS_PHYSICAL    0x008        /* physical walk */
  62. #define    FTS_SEEDOT    0x010        /* return dot and dot-dot */
  63. #define    FTS_STOP    0x020        /* (private) unrecoverable error */
  64. #define    FTS_XDEV    0x040        /* don't cross devices */
  65.     int fts_options;        /* openfts() options */
  66. } FTS;
  67.  
  68. typedef struct _ftsent {
  69.     struct _ftsent *fts_parent;    /* parent directory */
  70.     struct _ftsent *fts_link;    /* cycle or next file structure */
  71.     union {
  72.         long number;        /* local numeric value */
  73.         void *pointer;        /* local address value */
  74.     } fts_local;
  75. #define    fts_number    fts_local.number
  76. #define    fts_pointer    fts_local.pointer
  77.     char *fts_accpath;        /* access path */
  78.     char *fts_path;            /* root path */
  79.     int fts_cderr;            /* chdir failed -- errno */
  80.     short fts_pathlen;        /* strlen(fts_path) */
  81.     short fts_namelen;        /* strlen(fts_name) */
  82.  
  83. #define    FTS_ROOTPARENTLEVEL    -1
  84. #define    FTS_ROOTLEVEL         0
  85.     short fts_level;        /* depth (-1 to N) */
  86.  
  87. #define    FTS_D         1        /* preorder directory */
  88. #define    FTS_DC         2        /* directory that causes cycles */
  89. #define    FTS_DEFAULT     3        /* none of the above */
  90. #define    FTS_DNR         4        /* unreadable directory */
  91. #define    FTS_DP         5        /* postorder directory */
  92. #define    FTS_ERR         6        /* error; errno is set */
  93. #define    FTS_F         7        /* regular file */
  94. #define    FTS_NS         8        /* stat(2) failed */
  95. #define    FTS_NSOK     9        /* no stat(2) requested */
  96. #define    FTS_SL        10        /* symbolic link */
  97. #define    FTS_SLNONE    11        /* symbolic link without target */
  98.     u_short fts_info;        /* user flags for FTSENT structure */
  99.  
  100. #define    FTS_AGAIN     1        /* read node again */
  101. #define    FTS_FOLLOW     2        /* follow symbolic link */
  102. #define    FTS_NOINSTR     3        /* no instructions */
  103. #define    FTS_SKIP     4        /* discard node */
  104.     u_short fts_instr;        /* fts_set() instructions */
  105.  
  106.     struct stat fts_statb;        /* stat(2) information */
  107.     char fts_name[1];        /* file name */
  108. } FTSENT;
  109.  
  110. #include <sys/cdefs.h>
  111.  
  112. __BEGIN_DECLS
  113. FTSENT    *fts_children __P((FTS *));
  114. int     fts_close __P((FTS *));
  115. FTS    *fts_open
  116.         __P((char * const *, int, int (*)(const FTSENT *, const FTSENT *)));
  117. FTSENT    *fts_read __P((FTS *));
  118. int     fts_set __P((FTS *, FTSENT *, int));
  119. __END_DECLS
  120.  
  121. #endif /* !_FTS_H_ */
  122.