libbe/storage/Entry.cpp

43 	\brief A filesystem entry represented as a name in a concrete directory.
46 	(abstract) files. However, the parent directory of the file \b must exist.
52 	For example, if the directory in which the entry resides (or a
53 	directory further up in the hierarchy) is moved or renamed, the entry_ref will
68 	directory((ino_t)-1),
75 	directory on the given device.
78 	directory, or a non-existent file. No explicit checking is done to verify validity of the given arguments, but
80 	is a not a directory on \p dev.
82 	\param dev the device on which the entry's parent directory resides
83 	\param dir the directory in which the entry resides
89 	directory(dir),
102 	directory(ref.directory),
152 		&& directory == ref.directory
182 	directory = ref.directory;
194 	\var ino_t entry_ref::directory
195 	\brief The inode number of the directory in which the entry resides
208 	hierarchy.  Each location (or entry) is given as a name within a directory. For
216 	called fido within the directory \c "/boot/home".
246 //! Creates a BEntry initialized to the given directory and path combination.
250 	\param dir directory in which \a path resides
287 	be reckoned off the current working directory. If \a path refers to a symlink and
385 /*! \brief Reinitializes the BEntry to the path or directory path combination,
432 	// open the directory and let set() do the rest
433 	int dirFD = _kern_open_dir_entry_ref(ref->device, ref->directory, NULL);
462 	// Close the directory
499 		ref->directory = st.st_ino;
560 	- \c B_ENTRY_NOT_FOUND - Attempted to get the parent of the root directory \c "/"
572 	// check whether we are the root directory
577 	// open the parent directory
603 	- \c B_ENTRY_NOT_FOUND - Attempted to get the parent of the root directory \c "/"
614 	// check whether we are the root directory
618 	// get a node ref for the directory and init it
628 	// TODO: This can be optimized: We already have a FD for the directory,
629 	// so we could dup() it and set it on the directory. We just need a private
668 	            current directory.
705 /*! \brief Moves the BEntry to directory or directory+path combination, replacing an existing entry if clobber is true.
859 	to the given directory. If \a traverse is \c true and the given entry is a
864 	If \a dirFD is -1, path is considered relative to the current directory
871 	\param dirFD File descriptor of a directory relative to which path is to
872 		   be considered. May be -1, when the current directory shall be
874 	\param path Pointer to a path relative to the given directory.
892 			// if no dir FD is supplied, we need to open the current directory
900 			// get the parent directory
910 			// open the parent directory
916 			// get the parent's parent directory
931 			// special case: root directory ("/")
940 				// if no directory was given, we need to open the current dir
1130 	The components are compared in order \c device, \c directory, \c name.
1142 			&& (a.directory < b.directory
1143 				|| (a.directory == b.directory