lyx_mirror/src/support/FileInfo.h
Lars Gullik Bjønnes 797d87b451 make doc++ able to generate the source documentation for lyx
git-svn-id: svn://svn.lyx.org/lyx/lyx-devel/trunk@956 a592a061-630c-0410-9148-cb99ea01b6c8
2000-08-07 20:58:24 +00:00

150 lines
3.0 KiB
C++

// -*- C++ -*-
/* This file is part of
* ======================================================
*
* LyX, The Document Processor
*
* Copyright 1995 Matthias Ettrich
* Copyright 1995-2000 The LyX Team.
*
* ====================================================== */
#ifndef FILE_INFO_H
#define FILE_INFO_H
#ifdef __GNUG__
#pragma interface
#endif
#include <ctime>
#include <unistd.h>
#include <sys/types.h>
#include <sys/stat.h>
#include "LString.h"
/** Use objects of this class to get information about files.
*/
class FileInfo {
public:
///
FileInfo();
/** Get information about file.
If link is true, the information is about the link itself, not
the file that is obtained by tracing the links. */
explicit
FileInfo(string const & path, bool link = false);
/// File descriptor
explicit
FileInfo(int fildes);
/// Query a new file
FileInfo & newFile(string const & path, bool link = false);
/// Query a new file descriptor
FileInfo & newFile(int fildes);
/// Returns a character describing file type (ls -F)
char const * typeIndicator() const;
/// File protection mode
mode_t getMode() const;
/// Constructs standard mode string (ls style)
void modeString(char * szString) const;
/// returns a letter describing a file type (ls style)
char typeLetter() const;
/// builds 'rwx' string describing file access rights
void flagRWX(unsigned short i, char * szString) const;
/// updates mode string to match suid/sgid/sticky bits
void setSticky(char * szString) const;
///
time_t getModificationTime() const;
///
time_t getAccessTime() const;
///
time_t getStatusChangeTime() const;
/// Total file size in bytes
off_t getSize() const;
/// Number of hard links
nlink_t getNumberOfLinks() const;
/// User ID of owner
uid_t getUid() const;
/// Group ID of owner
gid_t getGid() const;
/// Is the file information correct? Did the query succeed?
bool isOK() const;
/// Permission flags
enum perm_test {
/// test for read permission
rperm = R_OK,
/// test for write permission
wperm = W_OK,
/// test for execute (search) permission
xperm = X_OK,
/// test for existence of file
eperm = F_OK
};
/// Test whether the current user has a given set of permissions
bool access(int p);
/// Is the file writable for the current user?
bool writable() { return access(FileInfo::wperm); }
/// Is the file readable for the current user?
bool readable() { return access(FileInfo::rperm); }
/// Is the file executable for the current user?
bool executable() { return access(FileInfo::xperm); }
/// Does the file exist?
bool exist() { return access(FileInfo::eperm); }
///
bool isLink() const;
///
bool isRegular() const;
///
bool isDir() const;
///
bool isChar() const;
///
bool isBlock() const;
///
bool isFifo() const;
///
bool isSocket() const;
///
int getError() const;
///
enum Err {
///
NoErr = -1
};
private:
///
void init();
///
void dostat(bool);
///
struct stat buf;
///
int status;
///
int err;
///
string fname;
};
#endif