.\" Copyright (c) 1993 Michael Haardt (u31b3hs@pool.informatik.rwth-aachen.de)
.\" Copyright (c) 1999 Andries Brouwer (aeb@cwi.nl)
.\" Fri Jun 25 00:34:07 CEST 1999
.\"
.\" This is free documentation; 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 2 of
.\" the License, or (at your option) any later version.
.\"
.\" The GNU General Public License's references to "object code"
.\" and "executables" are to be interpreted as the output of any
.\" document formatting or typesetting system, including
.\" intermediate and printed output.
.\"
.\" This manual 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 manual; if not, write to the Free
.\" Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139,
.\" USA.
.\"
.\" Modified Sun Jul 25 11:02:22 1993 by Rik Faith (faith@cs.unc.edu)
.\"
.\" Japanese Version Copyright (c) 1998 NAKANO Takeo all rights reserved.
.\" Translated Tue Apr 28 1998 by NAKANO Takeo <nakano@apm.seikei.ac.jp>
.\" Updated & Modified Tue Sep 14 1999
.\"       by NAKANO Takeo <nakano@apm.seikei.ac.jp>
.\"
.\" WORD:       file descriptor         եǥץ
.\"
.TH FTW 3 "25 June 1999" "Linux" "Linux Programmer's Manual"
.SH ̾
ftw, nftw \- եĥ꡼⤭ޤ
.SH 
.B #include <ftw.h>
.sp
.BI "int ftw(const char *" dir ", int (*" fn ")(const"
.BI "char *" file ", const struct stat *" sb ", int " flag ),
.BI "int " depth );
.sp
.BI "int nftw(const char *" dir ", int (*" fn ")(const"
.BI "char *" file ", const struct stat *" sb ", int " flag ,
.BI "struct FTW *" s ),
.BI "int " depth ", int " flags );
.SH 
BR ftw ()

.I dir
ǻꤵ줿ǥ쥯ȥʲΥĥ꡼Τ⤭롣
ĥ꡼ǥȥ꤬դ뤴Ȥˡ
ȥΥեѥ
.BR stat (2)
¤ΤؤΥݥ󥿡
ӰʲΤ줫ä int \fIflag\fP Ȥơ
.IR fn ()
ƤӽФ
.TP
.B FTW_F
оݤ̾ΥեǤ
.TP
.B FTW_D
оݤǥ쥯ȥǤ
.TP
.B FTW_DNR
оݤɤ߹ߤǤʤǥ쥯ȥǤ
.TP
.B FTW_SL
оݤܥå󥯤Ǥ
.TP
.B FTW_NS
оݤϥܥå󥯤ǤϤʤޤоݤФ stat Ԥ
.LP
оݤܥå󥯤ǡ stat ԤȤ֤ͤȤ
FTW_NS  FTW_SL ΤѤ뤫ϡ XPG4v2 ˤ̤Ǥ롣
.PP
.BR ftw ()
ϡʬȤƵŪ˸ƤӽФƥǥ쥯ȥ겼õ롣
ǥ쥯ȥꤽΤΤǼƤե䥵֥ǥ쥯ȥ
˽롣ĤΥץѲǽʥեǥץ
(file descriptor) ȤԤʤ褦Ʊ˥ץ󤹤ǥ쥯ȥο
.I depth
ˤä¤뤳ȤǤ롣
õοͤۤȡ
.BR ftw ()
ϰĤΥǥ쥯ȥĤƤ¾Υǥ쥯ȥ򥪡ץ󤹤褦ˤ
Τǡư٤ʤ롣
.BR ftw()
ϥե볬 1 ٥ˤĤǤĤ
եǥץѤʤ
.PP
ĥ꡼õߤ᤿ˤϡ\fIfn\fP()  0 ʳ֤ͤɤ
(ͤ \fBftw\fP() ȤͤȤʤ)ʳξ 
\fBftw\fP() ϥĥ꡼Τõ³٤ƤΥĥ꡼õȤ
 0 ֤ư EACCESS ʳΥ顼
.RB ( malloc (3)
μԤʤ) ǥ顼ˤʤä \-1 ֤
.PP
.BR ftw ()
ưŪʥǡ¤ѤΤǡĥ꡼õǤͣˡ 
0 ʳͤ \fIfn\fP() ͤȤ뤳ȤǤ롣ߤ򰷤
ϡ㤨еäߤޡƤơ 0 ʳ֤ͤ褦
롣\(emץλΤǤʤ
.BR longjmp (3)
ȤäƤϤʤʤ

ؿ
.BR nftw ()
ϤۤȤ
.BR ftw ()
Ʊư򤹤뤬;ʬ˰ \fIflags\fP 
(ƸƤӽФؿˤ;פ˰Ϳ)
 \fIflags\fP ϰʲΥե饰 0 İʾ¤
äΤǤ롣
.TP
.B FTW_CHDIR
åȤƤȡǥ쥯ȥƤ
.IR chdir ()
롣
.TP
.B FTW_DEPTH
åȤƤȡͥθԤĤޤ
ǥ쥯ȥꤽΤΤȤؿƽФϡ
Υǥ쥯ȥ˴ޤޤեȥ֥ǥ쥯ȥȤ
Ԥ롣
.TP
.B FTW_MOUNT
åȤƤȡñΥե륷ƥαޤ롣
.TP
.B FTW_PHYS
åȤƤȡܥå󥯤éʤ (餯餬
̾˾ޤư)åȤƤʤȥܥå󥯤
é뤬Ʊե뤬𤵤뤳ȤϤʤ
.LP
FTW_PHYS åȤƤʤ FTW_DEPTH åȤƤȡ
ʬȤФ륷ܥå󥯤۲˻ĥǥ쥯ȥϡ
褷ƴؿ
.IR fn ()
ΰȤʤ뤳Ȥʤ
.LP
ؿ
.IR fn ()
 4 Ĥΰ롣𤵤줿ȥΥѥ̾
Υȥ stat ¤ΤؤΥݥ󥿡
ȥΥפ򵭽Ҥ
FTW ¤ΤؤΥݥ󥿡Ǥ롣
פ FTW_F, FTW_D, FTW_DNR, FTW_SL, FTW_NS Τ줫
(̣Ͼ嵭̤ꡣ FTW_SL  FTW_PHYS åȤƤ
ΤߥåȤ줦)ޤϰʲ롣
.TP
.B FTW_DP
оݤǥ쥯ȥǡ۲ϴƽƤ
(줬åȤΤ FTW_DEPTH åȤƤ)
.TP
.B FTW_SLN
оݤܥå󥯤ǡ¸ߤʤեؤƤ롣
(줬åȤΤ FTW_PHYS åȤƤʤ)
.LP
.IR fn ()
Ϥ 4 ؤƤ
FTW ¤ΤϡʤȤ
.I base
եɤ
.I level
եɤġԤ
.IR fn ()
Ϳ줿ѥ̾ΤΡ
оݤΥե̾ΥեåȤǤꡢ
ԤϽȯ ( 0) оݤޤǤγؿͤǤ롣
.SH 
ؿ
.IR nftw ()
ȡؿ
.IR ftw ()
ˤ FTW_SL ѤȤϡ XPG4v2 Ƴ줿
.LP
.IR ftw ()
 FTW_SL ڻȤʤƥ䡢
¸ߤʤեؤƤ륷ܥå󥯤ξˤΤ
FTW_SL ȯ륷ƥࡢ
.IR ftw ()
ƤΥܥå󥯤Ф FTW_SL Ȥƥब롣
ͽ¬ǽΤˤϡ
.IR nftw ()
Ȥȡ
.LP
Linux Ǥϡ libc4, libc5, glibc 2.0.6 
stat Ǥ뤬ǥ쥯ȥǤϤʤ֥ȡ
(ե, ܥå, fifo )
ФƤϤ٤ FTW_F Ȥ
.IR nftw ()
ؿ glibc 2.1 ѤǤ褦ˤʤä
.SH 
AES, SVID2, SVID3, XPG2, XPG3, XPG4, XPG4v2.
.SH Ϣ
.BR stat (2)