Vous êtes dans : GNU/Linux Astuces / Pages man [Section3 - Sous-fonctions]

FTW

Index

1. NOM
2. SYNOPSIS
3. DESCRIPTION
   1. nftw()
4. VALEUR RENVOYÉE
5. NOTES
6. CONFORMITÉ À
7. EXEMPLE
8. VOIR AUSSI
9. TRADUCTION

NOM

SYNOPSIS

#include <ftw.h>

int ftw(const char *dirpath,
 int (*fn) (const char *fpath, const struct stat *sb,
 int typeflag),
 int nopenfd);

#define _XOPEN_SOURCE 500
#include <ftw.h>

int nftw(const char *dirpath,
 int (*fn) (const char *fpath, const struct stat *sb,
 int typeflag, struct FTW *ftwbuf),
 int nopenfd, int flags);

DESCRIPTION

FTW_F

fpath est un fichier normal.

FTW_D

fpath est un répertoire.

FTW_DNR

fpath est un répertoire non lisible.

FTW_NS

L'appel stat(2) a échoué sur fpath, qui n'est pas un lien symbolique.
Si fpath est un lien symbolique et que stat(2) échoue, POSIX.1-2001 précise que c'est indéfini si FTW_NS ou FTW_SL sont passés à typeflag (voyez ci-dessous).

nftw()

FTW_ACTIONRETVAL (depuis la glibc 2.3.3)

Si ce drapeau, spécifique à la glibc, est positionné, alors nftw() gère la valeur de retour de fn() différemment. fn() devrait renvoyer l'une des valeurs suivantes :

FTW_CONTINUE

nftw() va continuer normalement.

FTW_SKIP_SIBLINGS

Si fn() renvoie cette valeur, alors les « siblings » des entrées courantes seront passées, et la procédure continuera avec le parent.

FTW_SKIP_SUBTREE

Si fn() est appelée avec une entrée qui est un répertoire (typeflag vaut FTW_D), cette valeur de retour prévient les objets dans ce répertoire d'être passés comme argument à fn(). nftw() continue avec le « sibling » suivant du répertoire.

FTW_STOP

nftw() retourne immédiatement avec la valeur de retour FTW_STOP.

Les autres valeurs de retour pourront être associées avec une nouvelle action dans le futur ; fn ne devrait retourner que les valeurs citées ci-dessus.
La macro de test _GNU_SOURCE doit être définie afin d'obtenir la définition de FTW_ACTIONRETVAL depuis <ftw.h>.

FTW_CHDIR

Si défini, faire un chdir(2) avec chaque répertoire avant de traiter son contenu. C'est utile si le programme doit exécuter des actions dans le répertoire où fpath réside.

FTW_DEPTH

Si défini, faire une recherche « post-order » ; c'est-à-dire, appeler fn() pour le répertoire lui même après avoir traité son contenu et celui de ses sous-répertoires (par défaut chaque répertoire est traité avant son contenu).

FTW_MOUNT

Si défini, rester uniquement dans le même système de fichiers (p. ex. : ne pas parcourir un point de montage).

FTW_PHYS

Si défini, ne pas suivre les liens symboliques (c'est ce que l'on veut). Si non défini, les liens symboliques sont suivis, mais aucun fichier n'est traité plus d'une fois.
Si FTW_PHYS n'est pas défini, mais si FTW_DEPTH l'est, alors la fonction fn() n'est jamais appelée pour un répertoire que l'on retrouve dans ses propres descendants.

FTW_DP

fpath est un répertoire, et FTW_DEPTH a été défini dans flags. Tous les fichiers et les sous-répertoires dans fpath ont été traités.

FTW_SL

fpath est un lien symbolique, et FTW_PHYS a été défini dans flags.

FTW_SLN

fpath est un lien symbolique pointant nulle part. Ceci ne se produit que si FTW_PHYS n'est pas défini.

struct FTW {
    int base;
    int level;
};

VALEUR RENVOYÉE

NOTES

CONFORMITÉ À

EXEMPLE

#define _XOPEN_SOURCE 500
#include <ftw.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>

static int
display_info(const char *fpath, const struct stat *sb,
             int tflag, struct FTW *ftwbuf)
{
    printf("%-3s %2d %7lld   %-40s %d %s
",
        (tflag == FTW_D) ?   "d"   : (tflag == FTW_DNR) ? "dnr" :
        (tflag == FTW_DP) ?  "dp"  : (tflag == FTW_F) ?   "f" :
        (tflag == FTW_DP) ?  "dp"  : (tflag == FTW_SL) ?  "sl" :
        (tflag == FTW_SLN) ? "sln" : "???",
        ftwbuf->level, (long long) sb->st_size,
        fpath, ftwbuf->base, fpath + ftwbuf->base);
    return 0;           /* Pour dire à nftw() de continuer */
}

int
main(int argc, char *argv[])
{
    int flags = 0;

    if (argc > 2 && strchr(argv[2], 'd') != NULL)
        flags |= FTW_DEPTH;
    if (argc > 2 && strchr(argv[2], 'p') != NULL)
        flags |= FTW_PHYS;

    nftw((argc < 2) ? "." : argv[1], display_info, 20, flags);
    exit(EXIT_SUCCESS);
}

VOIR AUSSI

TRADUCTION