2006-05-01 20:55:46 +04:00
|
|
|
/*
|
|
|
|
* Copyright 2002-2006, Haiku Inc.
|
|
|
|
* Distributed under the terms of the MIT License.
|
|
|
|
*
|
|
|
|
* Authors:
|
|
|
|
* Tyler Dauwalder
|
|
|
|
*/
|
|
|
|
#ifndef _STORAGE_SUPPORT_H
|
|
|
|
#define _STORAGE_SUPPORT_H
|
|
|
|
|
2002-07-09 16:24:59 +04:00
|
|
|
/*!
|
|
|
|
\file storage_support.h
|
|
|
|
Interface declarations for miscellaneous internal
|
|
|
|
Storage Kit support functions.
|
|
|
|
*/
|
|
|
|
|
2006-05-01 20:55:46 +04:00
|
|
|
#include <StorageDefs.h>
|
|
|
|
#include <SupportDefs.h>
|
2002-07-09 16:24:59 +04:00
|
|
|
|
2004-08-29 00:14:46 +04:00
|
|
|
#include <dirent.h>
|
2002-08-24 08:54:52 +04:00
|
|
|
#include <string>
|
2002-07-09 16:24:59 +04:00
|
|
|
|
2006-05-01 20:55:46 +04:00
|
|
|
|
2002-08-12 12:42:01 +04:00
|
|
|
namespace BPrivate {
|
|
|
|
namespace Storage {
|
2002-07-09 16:24:59 +04:00
|
|
|
|
2004-08-29 00:14:46 +04:00
|
|
|
// For convenience:
|
2021-11-24 00:36:18 +03:00
|
|
|
struct LongDirEntry {
|
|
|
|
char _[sizeof(struct dirent) + B_FILE_NAME_LENGTH + 1];
|
|
|
|
struct dirent* dirent() { return (struct dirent*)_; }
|
2021-11-19 00:00:23 +03:00
|
|
|
};
|
2004-08-29 00:14:46 +04:00
|
|
|
|
2002-07-09 16:24:59 +04:00
|
|
|
//! Returns whether the supplied path is absolute.
|
|
|
|
bool is_absolute_path(const char *path);
|
|
|
|
|
2004-08-29 00:14:46 +04:00
|
|
|
status_t parse_path(const char *fullPath, int &dirEnd, int &leafStart,
|
|
|
|
int &leafEnd);
|
|
|
|
status_t parse_path(const char *fullPath, char *dirPath, char *leaf);
|
|
|
|
|
2002-07-09 16:24:59 +04:00
|
|
|
//! splits a path name into directory path and leaf name
|
|
|
|
status_t split_path(const char *fullPath, char *&path, char *&leaf);
|
|
|
|
|
|
|
|
//! splits a path name into directory path and leaf name
|
|
|
|
status_t split_path(const char *fullPath, char **path, char **leaf);
|
|
|
|
|
|
|
|
//! Parses the first component of a path name.
|
|
|
|
status_t parse_first_path_component(const char *path, int32& length,
|
|
|
|
int32& nextComponent);
|
|
|
|
|
|
|
|
//! Parses the first component of a path name.
|
|
|
|
status_t parse_first_path_component(const char *path, char *&component,
|
|
|
|
int32& nextComponent);
|
|
|
|
|
|
|
|
//! Checks whether an entry name is a valid entry name.
|
|
|
|
status_t check_entry_name(const char *entry);
|
|
|
|
|
|
|
|
//! Checks whether a path name is a valid path name.
|
|
|
|
status_t check_path_name(const char *path);
|
|
|
|
|
2002-11-08 03:37:46 +03:00
|
|
|
/*! \brief Returns a copy of \c str in which all alphabetic characters
|
|
|
|
are lowercase.
|
|
|
|
|
|
|
|
Returns \c "(null)" if you're a bonehead and pass in a \c NULL pointer.
|
|
|
|
*/
|
2002-08-24 08:54:52 +04:00
|
|
|
std::string to_lower(const char *str);
|
|
|
|
|
2002-11-08 03:37:46 +03:00
|
|
|
/*! \brief Places a copy of \c str in \c result in which all alphabetic
|
|
|
|
characters are lowercase.
|
|
|
|
|
|
|
|
Returns \c "(null)" if you're a bonehead and pass in a \c NULL pointer.
|
|
|
|
*/
|
2002-08-24 08:54:52 +04:00
|
|
|
void to_lower(const char *str, std::string &result);
|
|
|
|
|
2002-11-08 03:37:46 +03:00
|
|
|
/*! \brief Copies \c str into \c result, converting any uppercase alphabetics
|
|
|
|
to lowercase.
|
2021-11-24 00:36:18 +03:00
|
|
|
|
2002-11-08 03:37:46 +03:00
|
|
|
\a str and \a result may point to the same string. \a result is
|
2021-11-24 00:36:18 +03:00
|
|
|
assumed to be as long as or longer than \a str.
|
2002-11-08 03:37:46 +03:00
|
|
|
*/
|
2002-08-24 08:54:52 +04:00
|
|
|
void to_lower(const char *str, char *result);
|
|
|
|
|
|
|
|
//! Converts \c str to lowercase.
|
|
|
|
void to_lower(char *str);
|
|
|
|
|
2002-11-08 03:37:46 +03:00
|
|
|
/*! \brief Escapes any whitespace or other special characters in the path
|
|
|
|
|
|
|
|
\a result must be large enough to accomodate the addition of
|
|
|
|
escape sequences to \a str. \a str and \a result may *NOT* point to
|
|
|
|
the same string.
|
2021-11-24 00:36:18 +03:00
|
|
|
|
2002-11-08 03:37:46 +03:00
|
|
|
Note that this function was designed for use with the registrar's
|
|
|
|
RecentEntries class, and may not create escapes exactly like you're
|
|
|
|
hoping. Please double check the code for the function to see if this
|
|
|
|
is the case.
|
|
|
|
*/
|
|
|
|
void escape_path(const char *str, char *result);
|
|
|
|
|
|
|
|
/*! \brief Escapes any whitespace or other special characters in the path
|
|
|
|
|
|
|
|
\a str must be large enough to accomodate the addition of
|
|
|
|
escape sequences.
|
|
|
|
*/
|
|
|
|
void escape_path(char *str);
|
|
|
|
|
2004-08-29 00:14:46 +04:00
|
|
|
/*! \brief Returns whether the supplied device ID refers to the root FS.
|
|
|
|
*/
|
|
|
|
bool device_is_root_device(dev_t device);
|
|
|
|
|
|
|
|
// FDCloser
|
|
|
|
class FDCloser {
|
|
|
|
public:
|
|
|
|
FDCloser(int fd)
|
|
|
|
: fFD(fd)
|
|
|
|
{
|
|
|
|
}
|
|
|
|
|
|
|
|
~FDCloser()
|
|
|
|
{
|
|
|
|
Close();
|
|
|
|
}
|
|
|
|
|
|
|
|
void SetTo(int fd)
|
|
|
|
{
|
|
|
|
Close();
|
|
|
|
fFD = fd;
|
|
|
|
}
|
|
|
|
|
|
|
|
// implemented in the source file to not expose syscalls to the unit tests
|
|
|
|
// which include this file too
|
|
|
|
void Close();
|
|
|
|
// void Close()
|
|
|
|
// {
|
|
|
|
// if (fFD >= 0)
|
|
|
|
// _kern_close(fFD);
|
|
|
|
// fFD = -1;
|
|
|
|
// }
|
|
|
|
|
|
|
|
int Detach()
|
|
|
|
{
|
|
|
|
int fd = fFD;
|
|
|
|
fFD = -1;
|
|
|
|
return fd;
|
|
|
|
}
|
|
|
|
|
|
|
|
private:
|
|
|
|
int fFD;
|
|
|
|
};
|
|
|
|
|
2002-08-12 12:42:01 +04:00
|
|
|
}; // namespace Storage
|
|
|
|
}; // namespace BPrivate
|
2002-07-09 16:24:59 +04:00
|
|
|
|
2004-08-29 00:14:46 +04:00
|
|
|
using BPrivate::Storage::FDCloser;
|
|
|
|
|
2002-08-12 11:24:02 +04:00
|
|
|
#endif // _STORAGE_SUPPORT_H
|