summaryrefslogtreecommitdiff
path: root/boost/interprocess/detail/os_file_functions.hpp
diff options
context:
space:
mode:
Diffstat (limited to 'boost/interprocess/detail/os_file_functions.hpp')
-rw-r--r--boost/interprocess/detail/os_file_functions.hpp696
1 files changed, 696 insertions, 0 deletions
diff --git a/boost/interprocess/detail/os_file_functions.hpp b/boost/interprocess/detail/os_file_functions.hpp
new file mode 100644
index 0000000000..b680c57132
--- /dev/null
+++ b/boost/interprocess/detail/os_file_functions.hpp
@@ -0,0 +1,696 @@
+//////////////////////////////////////////////////////////////////////////////
+//
+// (C) Copyright Ion Gaztanaga 2005-2011. Distributed under the Boost
+// Software License, Version 1.0. (See accompanying file
+// LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+//
+// See http://www.boost.org/libs/interprocess for documentation.
+//
+//////////////////////////////////////////////////////////////////////////////
+
+#ifndef BOOST_INTERPROCESS_DETAIL_OS_FILE_FUNCTIONS_HPP
+#define BOOST_INTERPROCESS_DETAIL_OS_FILE_FUNCTIONS_HPP
+
+#include <boost/interprocess/detail/config_begin.hpp>
+#include <boost/interprocess/detail/workaround.hpp>
+#include <boost/interprocess/errors.hpp>
+#include <boost/interprocess/permissions.hpp>
+
+#include <string>
+#include <limits>
+#include <climits>
+
+#if (defined BOOST_INTERPROCESS_WINDOWS)
+# include <boost/interprocess/detail/win32_api.hpp>
+#else
+# ifdef BOOST_HAS_UNISTD_H
+# include <fcntl.h>
+# include <unistd.h>
+# include <sys/types.h>
+# include <sys/stat.h>
+# include <errno.h>
+# include <cstdio>
+# include <dirent.h>
+# if 0
+# include <sys/file.h>
+# endif
+# else
+# error Unknown platform
+# endif
+#endif
+
+#include <cstring>
+#include <cstdlib>
+
+namespace boost {
+namespace interprocess {
+
+#if (defined BOOST_INTERPROCESS_WINDOWS)
+
+typedef void * file_handle_t;
+typedef long long offset_t;
+typedef struct mapping_handle_impl_t{
+ void * handle;
+ bool is_shm;
+} mapping_handle_t;
+
+typedef enum { read_only = winapi::generic_read
+ , read_write = winapi::generic_read | winapi::generic_write
+ , copy_on_write
+ , read_private
+ , invalid_mode = 0xffff
+ } mode_t;
+
+typedef enum { file_begin = winapi::file_begin
+ , file_end = winapi::file_end
+ , file_current = winapi::file_current
+ } file_pos_t;
+
+namespace ipcdetail{
+
+inline mapping_handle_t mapping_handle_from_file_handle(file_handle_t hnd)
+{
+ mapping_handle_t ret;
+ ret.handle = hnd;
+ ret.is_shm = false;
+ return ret;
+}
+
+inline mapping_handle_t mapping_handle_from_shm_handle(file_handle_t hnd)
+{
+ mapping_handle_t ret;
+ ret.handle = hnd;
+ ret.is_shm = true;
+ return ret;
+}
+
+inline file_handle_t file_handle_from_mapping_handle(mapping_handle_t hnd)
+{ return hnd.handle; }
+
+inline bool create_directory(const char *path)
+{ return winapi::create_directory(path); }
+
+inline const char *get_temporary_path()
+{ return std::getenv("TMP"); }
+
+
+inline file_handle_t create_new_file
+ (const char *name, mode_t mode, const permissions & perm = permissions(), bool temporary = false)
+{
+ unsigned long attr = temporary ? winapi::file_attribute_temporary : 0;
+ return winapi::create_file
+ ( name, (unsigned int)mode, winapi::create_new, attr
+ , (winapi::interprocess_security_attributes*)perm.get_permissions());
+}
+
+inline file_handle_t create_or_open_file
+ (const char *name, mode_t mode, const permissions & perm = permissions(), bool temporary = false)
+{
+ unsigned long attr = temporary ? winapi::file_attribute_temporary : 0;
+ return winapi::create_file
+ ( name, (unsigned int)mode, winapi::open_always, attr
+ , (winapi::interprocess_security_attributes*)perm.get_permissions());
+}
+
+inline file_handle_t open_existing_file
+ (const char *name, mode_t mode, bool temporary = false)
+{
+ unsigned long attr = temporary ? winapi::file_attribute_temporary : 0;
+ return winapi::create_file
+ (name, (unsigned int)mode, winapi::open_existing, attr, 0);
+}
+
+inline bool delete_file(const char *name)
+{ return winapi::unlink_file(name); }
+
+inline bool truncate_file (file_handle_t hnd, std::size_t size)
+{
+ offset_t filesize;
+ if(!winapi::get_file_size(hnd, filesize))
+ return false;
+
+ const offset_t max_filesize = (std::numeric_limits<offset_t>::max)();
+ //Avoid unused variable warnings in 32 bit systems
+ (void)max_filesize;
+ if( sizeof(std::size_t) >= sizeof(offset_t) && size > std::size_t(max_filesize) ){
+ winapi::set_last_error(winapi::error_file_too_large);
+ return false;
+ }
+
+ if(offset_t(size) > filesize){
+ if(!winapi::set_file_pointer_ex(hnd, filesize, 0, winapi::file_begin)){
+ return false;
+ }
+ //We will write zeros in the end of the file
+ //since set_end_of_file does not guarantee this
+ for(std::size_t remaining = size - filesize, write_size = 0
+ ;remaining > 0
+ ;remaining -= write_size){
+ const std::size_t DataSize = 512;
+ static char data [DataSize];
+ write_size = DataSize < remaining ? DataSize : remaining;
+ unsigned long written;
+ winapi::write_file(hnd, data, (unsigned long)write_size, &written, 0);
+ if(written != write_size){
+ return false;
+ }
+ }
+ }
+ else{
+ if(!winapi::set_file_pointer_ex(hnd, size, 0, winapi::file_begin)){
+ return false;
+ }
+ if(!winapi::set_end_of_file(hnd)){
+ return false;
+ }
+ }
+ return true;
+}
+
+inline bool get_file_size(file_handle_t hnd, offset_t &size)
+{ return winapi::get_file_size(hnd, size); }
+
+inline bool set_file_pointer(file_handle_t hnd, offset_t off, file_pos_t pos)
+{ return winapi::set_file_pointer_ex(hnd, off, 0, (unsigned long) pos); }
+
+inline bool get_file_pointer(file_handle_t hnd, offset_t &off)
+{ return winapi::set_file_pointer_ex(hnd, 0, &off, winapi::file_current); }
+
+inline bool write_file(file_handle_t hnd, const void *data, std::size_t numdata)
+{
+ unsigned long written;
+ return 0 != winapi::write_file(hnd, data, (unsigned long)numdata, &written, 0);
+}
+
+inline file_handle_t invalid_file()
+{ return winapi::invalid_handle_value; }
+
+inline bool close_file(file_handle_t hnd)
+{ return 0 != winapi::close_handle(hnd); }
+
+inline bool acquire_file_lock(file_handle_t hnd)
+{
+ static winapi::interprocess_overlapped overlapped;
+ const unsigned long len = 0xffffffff;
+// winapi::interprocess_overlapped overlapped;
+// std::memset(&overlapped, 0, sizeof(overlapped));
+ return winapi::lock_file_ex
+ (hnd, winapi::lockfile_exclusive_lock, 0, len, len, &overlapped);
+}
+
+inline bool try_acquire_file_lock(file_handle_t hnd, bool &acquired)
+{
+ const unsigned long len = 0xffffffff;
+ winapi::interprocess_overlapped overlapped;
+ std::memset(&overlapped, 0, sizeof(overlapped));
+ if(!winapi::lock_file_ex
+ (hnd, winapi::lockfile_exclusive_lock | winapi::lockfile_fail_immediately,
+ 0, len, len, &overlapped)){
+ return winapi::get_last_error() == winapi::error_lock_violation ?
+ acquired = false, true : false;
+
+ }
+ return (acquired = true);
+}
+
+inline bool release_file_lock(file_handle_t hnd)
+{
+ const unsigned long len = 0xffffffff;
+ winapi::interprocess_overlapped overlapped;
+ std::memset(&overlapped, 0, sizeof(overlapped));
+ return winapi::unlock_file_ex(hnd, 0, len, len, &overlapped);
+}
+
+inline bool acquire_file_lock_sharable(file_handle_t hnd)
+{
+ const unsigned long len = 0xffffffff;
+ winapi::interprocess_overlapped overlapped;
+ std::memset(&overlapped, 0, sizeof(overlapped));
+ return winapi::lock_file_ex(hnd, 0, 0, len, len, &overlapped);
+}
+
+inline bool try_acquire_file_lock_sharable(file_handle_t hnd, bool &acquired)
+{
+ const unsigned long len = 0xffffffff;
+ winapi::interprocess_overlapped overlapped;
+ std::memset(&overlapped, 0, sizeof(overlapped));
+ if(!winapi::lock_file_ex
+ (hnd, winapi::lockfile_fail_immediately, 0, len, len, &overlapped)){
+ return winapi::get_last_error() == winapi::error_lock_violation ?
+ acquired = false, true : false;
+ }
+ return (acquired = true);
+}
+
+inline bool release_file_lock_sharable(file_handle_t hnd)
+{ return release_file_lock(hnd); }
+
+inline bool delete_subdirectories_recursive
+ (const std::string &refcstrRootDirectory, const char *dont_delete_this, unsigned int count)
+{
+ bool bSubdirectory = false; // Flag, indicating whether
+ // subdirectories have been found
+ void * hFile; // Handle to directory
+ std::string strFilePath; // Filepath
+ std::string strPattern; // Pattern
+ winapi::win32_find_data_t FileInformation; // File information
+
+ //Find all files and directories
+ strPattern = refcstrRootDirectory + "\\*.*";
+ hFile = winapi::find_first_file(strPattern.c_str(), &FileInformation);
+ if(hFile != winapi::invalid_handle_value){
+ do{
+ //If it's not "." or ".." or the pointed root_level dont_delete_this erase it
+ if(FileInformation.cFileName[0] != '.' &&
+ !(dont_delete_this && count == 0 && std::strcmp(dont_delete_this, FileInformation.cFileName) == 0)){
+ strFilePath.erase();
+ strFilePath = refcstrRootDirectory + "\\" + FileInformation.cFileName;
+
+ //If it's a directory, go recursive
+ if(FileInformation.dwFileAttributes & winapi::file_attribute_directory){
+ // Delete subdirectory
+ if(!delete_subdirectories_recursive(strFilePath, dont_delete_this, count+1))
+ return false;
+ }
+ //If it's a file, just delete it
+ else{
+ // Set file attributes
+ //if(::SetFileAttributes(strFilePath.c_str(), winapi::file_attribute_normal) == 0)
+ //return winapi::get_last_error();
+ // Delete file
+ winapi::delete_file(strFilePath.c_str());
+ }
+ }
+ //Go to the next file
+ } while(winapi::find_next_file(hFile, &FileInformation) == 1);
+
+ // Close handle
+ winapi::find_close(hFile);
+
+ //See if the loop has ended with an error or just because we've traversed all the files
+ if(winapi::get_last_error() != winapi::error_no_more_files){
+ return false;
+ }
+ else
+ {
+ //Erase empty subdirectories or original refcstrRootDirectory
+ if(!bSubdirectory && count)
+ {
+ // Set directory attributes
+ //if(::SetFileAttributes(refcstrRootDirectory.c_str(), FILE_ATTRIBUTE_NORMAL) == 0)
+ //return ::GetLastError();
+ // Delete directory
+ if(winapi::remove_directory(refcstrRootDirectory.c_str()) == 0)
+ return false;
+ }
+ }
+ }
+ return true;
+}
+
+//This function erases all the subdirectories of a directory except the one pointed by "dont_delete_this"
+inline bool delete_subdirectories(const std::string &refcstrRootDirectory, const char *dont_delete_this)
+{
+ return delete_subdirectories_recursive(refcstrRootDirectory, dont_delete_this, 0u);
+}
+
+
+template<class Function>
+inline bool for_each_file_in_dir(const char *dir, Function f)
+{
+ void * hFile; // Handle to directory
+ winapi::win32_find_data_t FileInformation; // File information
+
+ //Get base directory
+ std::string str(dir);
+ const std::size_t base_root_dir_len = str.size();
+
+ //Find all files and directories
+ str += "\\*.*";
+ hFile = winapi::find_first_file(str.c_str(), &FileInformation);
+ if(hFile != winapi::invalid_handle_value){
+ do{ //Now loop every file
+ str.erase(base_root_dir_len);
+ //If it's not "." or ".." skip it
+ if(FileInformation.cFileName[0] != '.'){
+ str += "\\"; str += FileInformation.cFileName;
+ //If it's a file, apply erase logic
+ if(!(FileInformation.dwFileAttributes & winapi::file_attribute_directory)){
+ f(str.c_str(), FileInformation.cFileName);
+ }
+ }
+ //Go to the next file
+ } while(winapi::find_next_file(hFile, &FileInformation) == 1);
+
+ // Close handle and see if the loop has ended with an error
+ winapi::find_close(hFile);
+ if(winapi::get_last_error() != winapi::error_no_more_files){
+ return false;
+ }
+ }
+ return true;
+}
+
+
+#else //#if (defined BOOST_INTERPROCESS_WINDOWS)
+
+typedef int file_handle_t;
+typedef off_t offset_t;
+
+typedef struct mapping_handle_impl_t
+{
+ file_handle_t handle;
+ bool is_xsi;
+} mapping_handle_t;
+
+typedef enum { read_only = O_RDONLY
+ , read_write = O_RDWR
+ , copy_on_write
+ , read_private
+ , invalid_mode = 0xffff
+ } mode_t;
+
+typedef enum { file_begin = SEEK_SET
+ , file_end = SEEK_END
+ , file_current = SEEK_CUR
+ } file_pos_t;
+
+namespace ipcdetail{
+
+inline mapping_handle_t mapping_handle_from_file_handle(file_handle_t hnd)
+{
+ mapping_handle_t ret;
+ ret.handle = hnd;
+ ret.is_xsi = false;
+ return ret;
+}
+
+inline file_handle_t file_handle_from_mapping_handle(mapping_handle_t hnd)
+{ return hnd.handle; }
+
+inline bool create_directory(const char *path)
+{ return ::mkdir(path, 0777) == 0 && ::chmod(path, 0777) == 0; }
+
+inline const char *get_temporary_path()
+{
+ const char *names[] = {"/tmp", "TMPDIR", "TMP", "TEMP" };
+ const int names_size = sizeof(names)/sizeof(names[0]);
+ struct stat data;
+ for(int i = 0; i != names_size; ++i){
+ if(::stat(names[i], &data) == 0){
+ return names[i];
+ }
+ }
+ return "/tmp";
+}
+
+inline file_handle_t create_new_file
+ (const char *name, mode_t mode, const permissions & perm = permissions(), bool temporary = false)
+{
+ (void)temporary;
+ int ret = ::open(name, ((int)mode) | O_EXCL | O_CREAT, perm.get_permissions());
+ if(ret >= 0){
+ ::fchmod(ret, perm.get_permissions());
+ }
+ return ret;
+}
+
+inline file_handle_t create_or_open_file
+ (const char *name, mode_t mode, const permissions & perm = permissions(), bool temporary = false)
+{
+ (void)temporary;
+ int ret = -1;
+ //We need a loop to change permissions correctly using fchmod, since
+ //with "O_CREAT only" ::open we don't know if we've created or opened the file.
+ while(1){
+ ret = ::open(name, ((int)mode) | O_EXCL | O_CREAT, perm.get_permissions());
+ if(ret >= 0){
+ ::fchmod(ret, perm.get_permissions());
+ break;
+ }
+ else if(errno == EEXIST){
+ if((ret = ::open(name, (int)mode)) >= 0 || errno != ENOENT){
+ break;
+ }
+ }
+ }
+ return ret;
+}
+
+inline file_handle_t open_existing_file
+ (const char *name, mode_t mode, bool temporary = false)
+{
+ (void)temporary;
+ return ::open(name, (int)mode);
+}
+
+inline bool delete_file(const char *name)
+{ return ::unlink(name) == 0; }
+
+inline bool truncate_file (file_handle_t hnd, std::size_t size)
+{
+ if(sizeof(off_t) == sizeof(std::size_t)){
+ if(size > ((~std::size_t(0)) >> 1)){
+ errno = EINVAL;
+ return false;
+ }
+ }
+ return 0 == ::ftruncate(hnd, off_t(size));
+}
+
+inline bool get_file_size(file_handle_t hnd, offset_t &size)
+{
+ struct stat data;
+ bool ret = 0 == ::fstat(hnd, &data);
+ if(ret){
+ size = data.st_size;
+ }
+ return ret;
+}
+
+inline bool set_file_pointer(file_handle_t hnd, offset_t off, file_pos_t pos)
+{ return ((off_t)(-1)) != ::lseek(hnd, off, (int)pos); }
+
+inline bool get_file_pointer(file_handle_t hnd, offset_t &off)
+{
+ off = ::lseek(hnd, 0, SEEK_CUR);
+ return off != ((off_t)-1);
+}
+
+inline bool write_file(file_handle_t hnd, const void *data, std::size_t numdata)
+{ return (ssize_t(numdata)) == ::write(hnd, data, numdata); }
+
+inline file_handle_t invalid_file()
+{ return -1; }
+
+inline bool close_file(file_handle_t hnd)
+{ return ::close(hnd) == 0; }
+
+inline bool acquire_file_lock(file_handle_t hnd)
+{
+ struct ::flock lock;
+ lock.l_type = F_WRLCK;
+ lock.l_whence = SEEK_SET;
+ lock.l_start = 0;
+ lock.l_len = 0;
+ return -1 != ::fcntl(hnd, F_SETLKW, &lock);
+}
+
+inline bool try_acquire_file_lock(file_handle_t hnd, bool &acquired)
+{
+ struct ::flock lock;
+ lock.l_type = F_WRLCK;
+ lock.l_whence = SEEK_SET;
+ lock.l_start = 0;
+ lock.l_len = 0;
+ int ret = ::fcntl(hnd, F_SETLK, &lock);
+ if(ret == -1){
+ return (errno == EAGAIN || errno == EACCES) ?
+ acquired = false, true : false;
+ }
+ return (acquired = true);
+}
+
+inline bool release_file_lock(file_handle_t hnd)
+{
+ struct ::flock lock;
+ lock.l_type = F_UNLCK;
+ lock.l_whence = SEEK_SET;
+ lock.l_start = 0;
+ lock.l_len = 0;
+ return -1 != ::fcntl(hnd, F_SETLK, &lock);
+}
+
+inline bool acquire_file_lock_sharable(file_handle_t hnd)
+{
+ struct ::flock lock;
+ lock.l_type = F_RDLCK;
+ lock.l_whence = SEEK_SET;
+ lock.l_start = 0;
+ lock.l_len = 0;
+ return -1 != ::fcntl(hnd, F_SETLKW, &lock);
+}
+
+inline bool try_acquire_file_lock_sharable(file_handle_t hnd, bool &acquired)
+{
+ struct flock lock;
+ lock.l_type = F_RDLCK;
+ lock.l_whence = SEEK_SET;
+ lock.l_start = 0;
+ lock.l_len = 0;
+ int ret = ::fcntl(hnd, F_SETLK, &lock);
+ if(ret == -1){
+ return (errno == EAGAIN || errno == EACCES) ?
+ acquired = false, true : false;
+ }
+ return (acquired = true);
+}
+
+inline bool release_file_lock_sharable(file_handle_t hnd)
+{ return release_file_lock(hnd); }
+
+#if 0
+inline bool acquire_file_lock(file_handle_t hnd)
+{ return 0 == ::flock(hnd, LOCK_EX); }
+
+inline bool try_acquire_file_lock(file_handle_t hnd, bool &acquired)
+{
+ int ret = ::flock(hnd, LOCK_EX | LOCK_NB);
+ acquired = ret == 0;
+ return (acquired || errno == EWOULDBLOCK);
+}
+
+inline bool release_file_lock(file_handle_t hnd)
+{ return 0 == ::flock(hnd, LOCK_UN); }
+
+inline bool acquire_file_lock_sharable(file_handle_t hnd)
+{ return 0 == ::flock(hnd, LOCK_SH); }
+
+inline bool try_acquire_file_lock_sharable(file_handle_t hnd, bool &acquired)
+{
+ int ret = ::flock(hnd, LOCK_SH | LOCK_NB);
+ acquired = ret == 0;
+ return (acquired || errno == EWOULDBLOCK);
+}
+
+inline bool release_file_lock_sharable(file_handle_t hnd)
+{ return 0 == ::flock(hnd, LOCK_UN); }
+#endif
+
+inline bool delete_subdirectories_recursive
+ (const std::string &refcstrRootDirectory, const char *dont_delete_this)
+{
+ DIR *d = opendir(refcstrRootDirectory.c_str());
+ if(!d) {
+ return false;
+ }
+
+ struct dir_close
+ {
+ DIR *d_;
+ dir_close(DIR *d) : d_(d) {}
+ ~dir_close() { ::closedir(d_); }
+ } dc(d); (void)dc;
+
+ struct ::dirent *de;
+ struct ::stat st;
+ std::string fn;
+
+ while((de=::readdir(d))) {
+ if( de->d_name[0] == '.' && ( de->d_name[1] == '\0'
+ || (de->d_name[1] == '.' && de->d_name[2] == '\0' )) ){
+ continue;
+ }
+ if(dont_delete_this && std::strcmp(dont_delete_this, de->d_name) == 0){
+ continue;
+ }
+ fn = refcstrRootDirectory;
+ fn += '/';
+ fn += de->d_name;
+
+ if(std::remove(fn.c_str())) {
+ if(::stat(fn.c_str(), & st)) {
+ return false;
+ }
+ if(S_ISDIR(st.st_mode)) {
+ if(!delete_subdirectories_recursive(fn, 0) ){
+ return false;
+ }
+ } else {
+ return false;
+ }
+ }
+ }
+ return std::remove(refcstrRootDirectory.c_str()) ? false : true;
+}
+
+template<class Function>
+inline bool for_each_file_in_dir(const char *dir, Function f)
+{
+ std::string refcstrRootDirectory(dir);
+
+ DIR *d = opendir(refcstrRootDirectory.c_str());
+ if(!d) {
+ return false;
+ }
+
+ struct dir_close
+ {
+ DIR *d_;
+ dir_close(DIR *d) : d_(d) {}
+ ~dir_close() { ::closedir(d_); }
+ } dc(d); (void)dc;
+
+ struct ::dirent *de;
+ struct ::stat st;
+ std::string fn;
+
+ while((de=::readdir(d))) {
+ if( de->d_name[0] == '.' && ( de->d_name[1] == '\0'
+ || (de->d_name[1] == '.' && de->d_name[2] == '\0' )) ){
+ continue;
+ }
+ fn = refcstrRootDirectory;
+ fn += '/';
+ fn += de->d_name;
+
+ if(::stat(fn.c_str(), & st)) {
+ return false;
+ }
+ //If it's a file, apply erase logic
+ if(!S_ISDIR(st.st_mode)) {
+ f(fn.c_str(), de->d_name);
+ }
+ }
+ return true;
+}
+
+
+//This function erases all the subdirectories of a directory except the one pointed by "dont_delete_this"
+inline bool delete_subdirectories(const std::string &refcstrRootDirectory, const char *dont_delete_this)
+{
+ return delete_subdirectories_recursive(refcstrRootDirectory, dont_delete_this );
+}
+
+#endif //#if (defined BOOST_INTERPROCESS_WINDOWS)
+
+inline bool open_or_create_directory(const char *dir_name)
+{
+ //If fails, check that it's because it already exists
+ if(!create_directory(dir_name)){
+ error_info info(system_error_code());
+ if(info.get_error_code() != already_exists_error){
+ return false;
+ }
+ }
+ return true;
+}
+
+
+} //namespace ipcdetail{
+} //namespace interprocess {
+} //namespace boost {
+
+#include <boost/interprocess/detail/config_end.hpp>
+
+#endif //BOOST_INTERPROCESS_DETAIL_OS_FILE_FUNCTIONS_HPP