head 1.2; access; symbols perseant-exfatfs-base-20250801:1.2 perseant-exfatfs-base-20240630:1.2 perseant-exfatfs:1.2.0.24 perseant-exfatfs-base:1.2 cjep_sun2x:1.2.0.22 cjep_sun2x-base:1.2 cjep_staticlib_x-base1:1.2 cjep_staticlib_x:1.2.0.20 cjep_staticlib_x-base:1.2 phil-wifi-20200421:1.2 phil-wifi-20200411:1.2 phil-wifi-20200406:1.2 pgoyette-compat-merge-20190127:1.2 pgoyette-compat-20190127:1.2 pgoyette-compat-20190118:1.2 pgoyette-compat-1226:1.2 pgoyette-compat-1126:1.2 pgoyette-compat-1020:1.2 pgoyette-compat-0930:1.2 pgoyette-compat-0906:1.2 pgoyette-compat-0728:1.2 pgoyette-compat-0625:1.2 pgoyette-compat-0521:1.2 pgoyette-compat-0502:1.2 pgoyette-compat-0422:1.2 pgoyette-compat-0415:1.2 pgoyette-compat-0407:1.2 pgoyette-compat-0330:1.2 pgoyette-compat-0322:1.2 pgoyette-compat-0315:1.2 pgoyette-compat:1.2.0.18 pgoyette-compat-base:1.2 prg-localcount2-base3:1.2 prg-localcount2-base2:1.2 prg-localcount2-base1:1.2 prg-localcount2:1.2.0.16 prg-localcount2-base:1.2 pgoyette-localcount-20170426:1.2 bouyer-socketcan-base1:1.2 pgoyette-localcount-20170320:1.2 bouyer-socketcan:1.2.0.14 bouyer-socketcan-base:1.2 pgoyette-localcount-20170107:1.2 pgoyette-localcount-20161104:1.2 localcount-20160914:1.2 pgoyette-localcount-20160806:1.2 pgoyette-localcount-20160726:1.2 pgoyette-localcount:1.2.0.12 pgoyette-localcount-base:1.2 netbsd-5-2-3-RELEASE:1.1.1.1 netbsd-5-1-5-RELEASE:1.1.1.1 yamt-pagecache-base9:1.2 yamt-pagecache-tag8:1.2 tls-earlyentropy:1.2.0.8 tls-earlyentropy-base:1.2 riastradh-xf86-video-intel-2-7-1-pre-2-21-15:1.2 riastradh-drm2-base3:1.2 netbsd-5-2-2-RELEASE:1.1.1.1 netbsd-5-1-4-RELEASE:1.1.1.1 netbsd-5-2-1-RELEASE:1.1.1.1 netbsd-5-1-3-RELEASE:1.1.1.1 agc-symver:1.2.0.10 agc-symver-base:1.2 tls-maxphys-base:1.2 yamt-pagecache-base8:1.2 netbsd-5-2:1.1.1.1.0.6 yamt-pagecache-base7:1.2 netbsd-5-2-RELEASE:1.1.1.1 netbsd-5-2-RC1:1.1.1.1 yamt-pagecache-base6:1.2 yamt-pagecache-base5:1.2 yamt-pagecache-base4:1.2 netbsd-5-1-2-RELEASE:1.1.1.1 netbsd-5-1-1-RELEASE:1.1.1.1 yamt-pagecache-base3:1.2 yamt-pagecache-base2:1.2 yamt-pagecache:1.2.0.6 yamt-pagecache-base:1.2 bouyer-quota2-nbase:1.2 bouyer-quota2:1.2.0.4 bouyer-quota2-base:1.2 matt-nb5-mips64-premerge-20101231:1.1.1.1 matt-nb5-pq3:1.1.1.1.0.16 matt-nb5-pq3-base:1.1.1.1 netbsd-5-1:1.1.1.1.0.14 netbsd-5-1-RELEASE:1.1.1.1 netbsd-5-1-RC4:1.1.1.1 matt-nb5-mips64-k15:1.1.1.1 netbsd-5-1-RC3:1.1.1.1 netbsd-5-1-RC2:1.1.1.1 netbsd-5-1-RC1:1.1.1.1 netbsd-5-0-2-RELEASE:1.1.1.1 matt-nb5-mips64-premerge-20091211:1.1.1.1 matt-nb5-mips64-u2-k2-k4-k7-k8-k9:1.1.1.1 matt-nb4-mips64-k7-u2a-k9b:1.1.1.1 matt-nb5-mips64-u1-k1-k5:1.1.1.1 matt-nb5-mips64:1.1.1.1.0.12 netbsd-5-0-1-RELEASE:1.1.1.1 jym-xensuspend-nbase:1.2 netbsd-5-0:1.1.1.1.0.10 netbsd-5-0-RELEASE:1.1.1.1 netbsd-5-0-RC4:1.1.1.1 netbsd-5-0-RC3:1.1.1.1 netbsd-5-0-RC2:1.1.1.1 jym-xensuspend:1.2.0.2 jym-xensuspend-base:1.2 netbsd-5-0-RC1:1.1.1.1 netbsd-5:1.1.1.1.0.8 netbsd-5-base:1.1.1.1 matt-mips64-base2:1.1.1.1 wrstuden-revivesa-base-3:1.1.1.1 wrstuden-revivesa-base-2:1.1.1.1 wrstuden-revivesa-base-1:1.1.1.1 yamt-pf42-base4:1.1.1.1 yamt-pf42-base3:1.1.1.1 hpcarm-cleanup-nbase:1.1.1.1 yamt-pf42:1.1.1.1.0.4 yamt-pf42-base2:1.1.1.1 yamt-pf42-base:1.1.1.1 wrstuden-revivesa:1.1.1.1.0.2 wrstuden-revivesa-base:1.1.1.1 atf-0-5:1.1.1.1 TNF:1.1.1; locks; strict; comment @// @; 1.2 date 2009.01.19.07.08.16; author jmmv; state dead; branches; next 1.1; 1.1 date 2008.05.01.15.22.30; author jmmv; state Exp; branches 1.1.1.1; next ; 1.1.1.1 date 2008.05.01.15.22.30; author jmmv; state Exp; branches 1.1.1.1.4.1; next ; 1.1.1.1.4.1 date 2008.05.01.15.22.30; author yamt; state dead; branches; next 1.1.1.1.4.2; 1.1.1.1.4.2 date 2008.05.18.12.29.12; author yamt; state Exp; branches; next ; desc @@ 1.2 log @Remove ATF 0.5 from dist/atf and all of the reachover Makefiles used to build it. 0.6 is going to be imported in external/bsd/atf, with all the necessary Makefiles in that same hierarchy. @ text @// // Automated Testing Framework (atf) // // Copyright (c) 2007, 2008 The NetBSD Foundation, Inc. // All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions // are met: // 1. Redistributions of source code must retain the above copyright // notice, this list of conditions and the following disclaimer. // 2. Redistributions in binary form must reproduce the above copyright // notice, this list of conditions and the following disclaimer in the // documentation and/or other materials provided with the distribution. // // THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND // CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, // INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF // MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. // IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS BE LIABLE FOR ANY // DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL // DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE // GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS // INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER // IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR // OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN // IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. // #if !defined(_ATF_CXX_FS_HPP_) #define _ATF_CXX_FS_HPP_ extern "C" { #include } #include #include #include #include extern "C" { #include "atf-c/fs.h" } namespace atf { namespace fs { // ------------------------------------------------------------------------ // The "path" class. // ------------------------------------------------------------------------ //! //! \brief A class to represent a path to a file. //! //! The path class represents the route to a file or directory in the //! file system. All file manipulation operations use this class to //! represent their arguments as it takes care of normalizing user-provided //! strings and ensures they are valid. //! //! It is important to note that the file pointed to by a path need not //! exist. //! class path { //! //! \brief Internal representation of a path. //! atf_fs_path_t m_path; public: //! \brief Constructs a new path from a user-provided string. //! //! This constructor takes a string, either provided by the program's //! code or by the user and constructs a new path object. The string //! is normalized to not contain multiple delimiters together and to //! remove any trailing one. //! //! The input string cannot be empty. //! explicit path(const std::string&); //! //! \brief Copy constructor. //! path(const path&); //! //! \brief Destructor for the path class. //! ~path(void); //! //! \brief Returns a pointer to a C-style string representing this path. //! const char* c_str(void) const; //! //! \brief Returns a pointer to the implementation data. //! const atf_fs_path_t* c_path(void) const; //! //! \brief Returns a string representing this path. //! XXX Really needed? //! std::string str(void) const; //! //! \brief Returns the branch path of this path. //! //! Calculates and returns the branch path of this path. In other //! words, it returns what the standard ::dirname function would return. //! path branch_path(void) const; //! //! \brief Returns the leaf name of this path. //! //! Calculates and returns the leaf name of this path. In other words, //! it returns what the standard ::basename function would return. //! std::string leaf_name(void) const; //! //! \brief Checks whether this path is absolute or not. //! //! Returns a boolean indicating if this is an absolute path or not; //! i.e. if it starts with a slash. //! bool is_absolute(void) const; //! //! \brief Checks whether this path points to the root directory or not. //! //! Returns a boolean indicating if this is path points to the root //! directory or not. The checks made by this are extremely simple (so //! the results cannot always be trusted) but they are enough for our //! modest sanity-checking needs. I.e. "/../" could return false. //! bool is_root(void) const; //! //! \brief Converts the path to be absolute. //! //! \pre The path was not absolute. //! path to_absolute(void) const; //! //! \brief Assignment operator. //! path& operator=(const path&); //! //! \brief Checks if two paths are equal. //! bool operator==(const path&) const; //! //! \brief Checks if two paths are different. //! bool operator!=(const path&) const; //! //! \brief Concatenates a path with a string. //! //! Constructs a new path object that is the concatenation of the //! left-hand path with the right-hand string. The string is normalized //! before the concatenation, and a path delimiter is introduced between //! the two components if needed. //! path operator/(const std::string&) const; //! //! \brief Concatenates a path with another path. //! //! Constructs a new path object that is the concatenation of the //! left-hand path with the right-hand one. A path delimiter is //! introduced between the two components if needed. //! path operator/(const path&) const; //! //! \brief Checks if a path has to be sorted before another one //! lexicographically. //! bool operator<(const path&) const; }; // ------------------------------------------------------------------------ // The "file_info" class. // ------------------------------------------------------------------------ class directory; //! //! \brief A class that contains information about a file. //! //! The file_info class holds information about an specific file that //! exists in the file system. //! class file_info { atf_fs_stat_t m_stat; public: //! //! \brief The file's type. //! static const int blk_type; static const int chr_type; static const int dir_type; static const int fifo_type; static const int lnk_type; static const int reg_type; static const int sock_type; static const int wht_type; //! //! \brief Constructs a new file_info based on a given file. //! //! This constructor creates a new file_info object and fills it with //! the data returned by ::stat when run on the given file, which must //! exist. //! explicit file_info(const path&); //! //! \brief The copy constructor. //! file_info(const file_info&); //! //! \brief The destructor. //! ~file_info(void); //! //! \brief Returns the device containing the file. //! dev_t get_device(void) const; //! //! \brief Returns the file's inode. //! ino_t get_inode(void) const; //! //! \brief Returns the file's type. //! int get_type(void) const; //! //! \brief Returns whether the file is readable by its owner or not. //! bool is_owner_readable(void) const; //! //! \brief Returns whether the file is writable by its owner or not. //! bool is_owner_writable(void) const; //! //! \brief Returns whether the file is executable by its owner or not. //! bool is_owner_executable(void) const; //! //! \brief Returns whether the file is readable by the users belonging //! to its group or not. //! bool is_group_readable(void) const; //! //! \brief Returns whether the file is writable the users belonging to //! its group or not. //! bool is_group_writable(void) const; //! //! \brief Returns whether the file is executable by the users //! belonging to its group or not. //! bool is_group_executable(void) const; //! //! \brief Returns whether the file is readable by people different //! than the owner and those belonging to the group or not. //! bool is_other_readable(void) const; //! //! \brief Returns whether the file is write by people different //! than the owner and those belonging to the group or not. //! bool is_other_writable(void) const; //! //! \brief Returns whether the file is executable by people different //! than the owner and those belonging to the group or not. //! bool is_other_executable(void) const; }; // ------------------------------------------------------------------------ // The "directory" class. // ------------------------------------------------------------------------ //! //! \brief A class representing a file system directory. //! //! The directory class represents a group of files in the file system and //! corresponds to exactly one directory. //! class directory : public std::map< std::string, file_info > { public: //! //! \brief Constructs a new directory. //! //! Constructs a new directory object representing the given path. //! The directory must exist at creation time as the contents of the //! class are gathered from it. //! directory(const path&); //! //! \brief Returns the file names of the files in the directory. //! //! Returns the leaf names of all files contained in the directory. //! I.e. the keys of the directory map. //! std::set< std::string > names(void) const; }; // ------------------------------------------------------------------------ // The "temp_dir" class. // ------------------------------------------------------------------------ //! //! \brief A RAII model for temporary directories. //! //! The temp_dir class provides a RAII model for temporary directories. //! During construction, a safe temporary directory is created and during //! destruction it is carefully removed by making use of the cleanup //! function. //! class temp_dir { //! //! \brief The path to this temporary directory. //! path *m_path; public: //! //! \brief Creates a new temporary directory. //! //! Creates a new temporary directory based on the provided name //! template. The template must end with six X characters preceded //! by a dot. These characters are replaced with a unique name on //! the file system as described in mkdtemp(3). //! temp_dir(const path&); //! //! \brief Destroys the temporary directory. //! //! Destroys this temporary directory object as well as its file //! system representation. //! ~temp_dir(void); //! //! \brief Returns the path to this temporary directory. //! const path& get_path(void) const; }; // ------------------------------------------------------------------------ // Free functions. // ------------------------------------------------------------------------ //! //! \brief Changes the current working directory. //! //! Changes the current working directory to the given path. Returns the //! path to the directory just left. //! //! \throw system_error If ::chdir failed. //! path change_directory(const path&); //! //! \brief Checks if the given path exists. //! bool exists(const path&); //! //! \brief Looks for the given program in the PATH. //! //! Given a program name (without slashes) looks for it in the path and //! returns its full path name if found, otherwise an empty path. //! bool have_prog_in_path(const std::string&); //! //! \brief Returns the path to the current working directory. //! //! Calculates and returns the path to the current working directory, which //! is guessed using the ::getcwd function. //! //! \throw system_error If ::getcwd failed. //! path get_current_dir(void); //! //! \brief Checks if the given path exists, is accessible and is executable. //! bool is_executable(const path&); //! //! \brief Removes a given file. //! void remove(const path&); //! //! \brief Recursively cleans up a directory. //! //! This function cleans up a directory hierarchy. First of all, it looks //! for any file system that may be mounted under the given path and, if //! any is found, an attempt is made to unmount it. Later on, the //! directory is removed alongside all of its contents. //! void cleanup(const path&); } // namespace fs } // namespace atf #endif // !defined(_ATF_CXX_FS_HPP_) @ 1.1 log @Initial revision @ text @@ 1.1.1.1 log @Import ATF 0.5 Changes in this release: * Clauses 3 and 4 of the BSD license used by the project were dropped. All the code is now under a 2-clause BSD license compatible with the GNU General Public License (GPL). * Added a C-only binding so that binary test programs do not need to be tied to C++ at all. This binding is now known as the atf-c library. * Renamed the C++ binding to atf-c++ for consistency with the new atf-c. * Renamed the POSIX shell binding to atf-sh for consistency with the new atf-c and atf-c++. * Added a -w flag to test programs through which it is possible to specify the work directory to be used. This was possible in prior releases by defining the workdir configuration variable (-v workdir=...), but was a conceptually incorrect mechanism. * Test programs now preserve the execution order of test cases when they are given in the command line. Even those mentioned more than once are executed multiple times to comply with the user's requests. @ text @@ 1.1.1.1.4.1 log @file fs.hpp was added on branch yamt-pf42 on 2008-05-18 12:29:12 +0000 @ text @d1 437 @ 1.1.1.1.4.2 log @sync with head. @ text @a0 437 // // Automated Testing Framework (atf) // // Copyright (c) 2007, 2008 The NetBSD Foundation, Inc. // All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions // are met: // 1. Redistributions of source code must retain the above copyright // notice, this list of conditions and the following disclaimer. // 2. Redistributions in binary form must reproduce the above copyright // notice, this list of conditions and the following disclaimer in the // documentation and/or other materials provided with the distribution. // // THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND // CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, // INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF // MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. // IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS BE LIABLE FOR ANY // DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL // DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE // GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS // INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER // IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR // OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN // IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. // #if !defined(_ATF_CXX_FS_HPP_) #define _ATF_CXX_FS_HPP_ extern "C" { #include } #include #include #include #include extern "C" { #include "atf-c/fs.h" } namespace atf { namespace fs { // ------------------------------------------------------------------------ // The "path" class. // ------------------------------------------------------------------------ //! //! \brief A class to represent a path to a file. //! //! The path class represents the route to a file or directory in the //! file system. All file manipulation operations use this class to //! represent their arguments as it takes care of normalizing user-provided //! strings and ensures they are valid. //! //! It is important to note that the file pointed to by a path need not //! exist. //! class path { //! //! \brief Internal representation of a path. //! atf_fs_path_t m_path; public: //! \brief Constructs a new path from a user-provided string. //! //! This constructor takes a string, either provided by the program's //! code or by the user and constructs a new path object. The string //! is normalized to not contain multiple delimiters together and to //! remove any trailing one. //! //! The input string cannot be empty. //! explicit path(const std::string&); //! //! \brief Copy constructor. //! path(const path&); //! //! \brief Destructor for the path class. //! ~path(void); //! //! \brief Returns a pointer to a C-style string representing this path. //! const char* c_str(void) const; //! //! \brief Returns a pointer to the implementation data. //! const atf_fs_path_t* c_path(void) const; //! //! \brief Returns a string representing this path. //! XXX Really needed? //! std::string str(void) const; //! //! \brief Returns the branch path of this path. //! //! Calculates and returns the branch path of this path. In other //! words, it returns what the standard ::dirname function would return. //! path branch_path(void) const; //! //! \brief Returns the leaf name of this path. //! //! Calculates and returns the leaf name of this path. In other words, //! it returns what the standard ::basename function would return. //! std::string leaf_name(void) const; //! //! \brief Checks whether this path is absolute or not. //! //! Returns a boolean indicating if this is an absolute path or not; //! i.e. if it starts with a slash. //! bool is_absolute(void) const; //! //! \brief Checks whether this path points to the root directory or not. //! //! Returns a boolean indicating if this is path points to the root //! directory or not. The checks made by this are extremely simple (so //! the results cannot always be trusted) but they are enough for our //! modest sanity-checking needs. I.e. "/../" could return false. //! bool is_root(void) const; //! //! \brief Converts the path to be absolute. //! //! \pre The path was not absolute. //! path to_absolute(void) const; //! //! \brief Assignment operator. //! path& operator=(const path&); //! //! \brief Checks if two paths are equal. //! bool operator==(const path&) const; //! //! \brief Checks if two paths are different. //! bool operator!=(const path&) const; //! //! \brief Concatenates a path with a string. //! //! Constructs a new path object that is the concatenation of the //! left-hand path with the right-hand string. The string is normalized //! before the concatenation, and a path delimiter is introduced between //! the two components if needed. //! path operator/(const std::string&) const; //! //! \brief Concatenates a path with another path. //! //! Constructs a new path object that is the concatenation of the //! left-hand path with the right-hand one. A path delimiter is //! introduced between the two components if needed. //! path operator/(const path&) const; //! //! \brief Checks if a path has to be sorted before another one //! lexicographically. //! bool operator<(const path&) const; }; // ------------------------------------------------------------------------ // The "file_info" class. // ------------------------------------------------------------------------ class directory; //! //! \brief A class that contains information about a file. //! //! The file_info class holds information about an specific file that //! exists in the file system. //! class file_info { atf_fs_stat_t m_stat; public: //! //! \brief The file's type. //! static const int blk_type; static const int chr_type; static const int dir_type; static const int fifo_type; static const int lnk_type; static const int reg_type; static const int sock_type; static const int wht_type; //! //! \brief Constructs a new file_info based on a given file. //! //! This constructor creates a new file_info object and fills it with //! the data returned by ::stat when run on the given file, which must //! exist. //! explicit file_info(const path&); //! //! \brief The copy constructor. //! file_info(const file_info&); //! //! \brief The destructor. //! ~file_info(void); //! //! \brief Returns the device containing the file. //! dev_t get_device(void) const; //! //! \brief Returns the file's inode. //! ino_t get_inode(void) const; //! //! \brief Returns the file's type. //! int get_type(void) const; //! //! \brief Returns whether the file is readable by its owner or not. //! bool is_owner_readable(void) const; //! //! \brief Returns whether the file is writable by its owner or not. //! bool is_owner_writable(void) const; //! //! \brief Returns whether the file is executable by its owner or not. //! bool is_owner_executable(void) const; //! //! \brief Returns whether the file is readable by the users belonging //! to its group or not. //! bool is_group_readable(void) const; //! //! \brief Returns whether the file is writable the users belonging to //! its group or not. //! bool is_group_writable(void) const; //! //! \brief Returns whether the file is executable by the users //! belonging to its group or not. //! bool is_group_executable(void) const; //! //! \brief Returns whether the file is readable by people different //! than the owner and those belonging to the group or not. //! bool is_other_readable(void) const; //! //! \brief Returns whether the file is write by people different //! than the owner and those belonging to the group or not. //! bool is_other_writable(void) const; //! //! \brief Returns whether the file is executable by people different //! than the owner and those belonging to the group or not. //! bool is_other_executable(void) const; }; // ------------------------------------------------------------------------ // The "directory" class. // ------------------------------------------------------------------------ //! //! \brief A class representing a file system directory. //! //! The directory class represents a group of files in the file system and //! corresponds to exactly one directory. //! class directory : public std::map< std::string, file_info > { public: //! //! \brief Constructs a new directory. //! //! Constructs a new directory object representing the given path. //! The directory must exist at creation time as the contents of the //! class are gathered from it. //! directory(const path&); //! //! \brief Returns the file names of the files in the directory. //! //! Returns the leaf names of all files contained in the directory. //! I.e. the keys of the directory map. //! std::set< std::string > names(void) const; }; // ------------------------------------------------------------------------ // The "temp_dir" class. // ------------------------------------------------------------------------ //! //! \brief A RAII model for temporary directories. //! //! The temp_dir class provides a RAII model for temporary directories. //! During construction, a safe temporary directory is created and during //! destruction it is carefully removed by making use of the cleanup //! function. //! class temp_dir { //! //! \brief The path to this temporary directory. //! path *m_path; public: //! //! \brief Creates a new temporary directory. //! //! Creates a new temporary directory based on the provided name //! template. The template must end with six X characters preceded //! by a dot. These characters are replaced with a unique name on //! the file system as described in mkdtemp(3). //! temp_dir(const path&); //! //! \brief Destroys the temporary directory. //! //! Destroys this temporary directory object as well as its file //! system representation. //! ~temp_dir(void); //! //! \brief Returns the path to this temporary directory. //! const path& get_path(void) const; }; // ------------------------------------------------------------------------ // Free functions. // ------------------------------------------------------------------------ //! //! \brief Changes the current working directory. //! //! Changes the current working directory to the given path. Returns the //! path to the directory just left. //! //! \throw system_error If ::chdir failed. //! path change_directory(const path&); //! //! \brief Checks if the given path exists. //! bool exists(const path&); //! //! \brief Looks for the given program in the PATH. //! //! Given a program name (without slashes) looks for it in the path and //! returns its full path name if found, otherwise an empty path. //! bool have_prog_in_path(const std::string&); //! //! \brief Returns the path to the current working directory. //! //! Calculates and returns the path to the current working directory, which //! is guessed using the ::getcwd function. //! //! \throw system_error If ::getcwd failed. //! path get_current_dir(void); //! //! \brief Checks if the given path exists, is accessible and is executable. //! bool is_executable(const path&); //! //! \brief Removes a given file. //! void remove(const path&); //! //! \brief Recursively cleans up a directory. //! //! This function cleans up a directory hierarchy. First of all, it looks //! for any file system that may be mounted under the given path and, if //! any is found, an attempt is made to unmount it. Later on, the //! directory is removed alongside all of its contents. //! void cleanup(const path&); } // namespace fs } // namespace atf #endif // !defined(_ATF_CXX_FS_HPP_) @