]> git.decadent.org.uk Git - dak.git/blob - tools/dsync-0.0/libdsync/contrib/fileutl.h
Add docs that the secret key only needs to be able to sign
[dak.git] / tools / dsync-0.0 / libdsync / contrib / fileutl.h
1 // -*- mode: cpp; mode: fold -*-
2 // Description                                                          /*{{{*/
3 // $Id: fileutl.h,v 1.3 1999/10/24 06:53:12 jgg Exp $
4 /* ######################################################################
5    
6    File Utilities
7    
8    CopyFile - Buffered copy of a single file
9    GetLock - dpkg compatible lock file manipulation (fcntl)
10    FileExists - Returns true if the file exists
11    SafeGetCWD - Returns the CWD in a string with overrun protection 
12    
13    The file class is a handy abstraction for various functions+classes
14    that need to accept filenames.
15    
16    This source is placed in the Public Domain, do with it what you will
17    It was originally written by Jason Gunthorpe.
18    
19    ##################################################################### */
20                                                                         /*}}}*/
21 #ifndef PKGLIB_FILEUTL_H
22 #define PKGLIB_FILEUTL_H
23
24 #ifdef __GNUG__
25 #pragma interface "dsync/fileutl.h"
26 #endif 
27
28 #include <string>
29
30 using namespace std;
31
32 class FileFd
33 {
34    protected:
35    int iFd;
36  
37    enum LocalFlags {AutoClose = (1<<0),Fail = (1<<1),DelOnFail = (1<<2),
38                     HitEof = (1<<3)};
39    unsigned long Flags;
40    string FileName;
41    
42    public:
43    enum OpenMode {ReadOnly,WriteEmpty,WriteExists,WriteAny};
44    
45    bool Read(void *To,unsigned long Size,bool AllowEof = false);
46    bool Write(const void *From,unsigned long Size);
47    bool Seek(unsigned long To);
48    bool Skip(unsigned long To);
49    bool Truncate(unsigned long To);
50    unsigned long Tell();
51    unsigned long Size();
52    bool Open(string FileName,OpenMode Mode,unsigned long Perms = 0666);
53    bool Close();
54
55    // Simple manipulators
56    inline int Fd() {return iFd;};
57    inline void Fd(int fd) {iFd = fd;};
58    inline bool IsOpen() {return iFd >= 0;};
59    inline bool Failed() {return (Flags & Fail) == Fail;};
60    inline void EraseOnFailure() {Flags |= DelOnFail;};
61    inline void OpFail() {Flags |= Fail;};
62    inline bool Eof() {return (Flags & HitEof) == HitEof;};
63    inline string &Name() {return FileName;};
64    
65    FileFd(string FileName,OpenMode Mode,unsigned long Perms = 0666) : iFd(-1), 
66             Flags(0) 
67    {
68       Open(FileName,Mode,Perms);
69    };
70    FileFd(int Fd = -1) : iFd(Fd), Flags(AutoClose) {};
71    FileFd(int Fd,bool) : iFd(Fd), Flags(0) {};
72    virtual ~FileFd();
73 };
74
75 bool CopyFile(FileFd &From,FileFd &To);
76 int GetLock(string File,bool Errors = true);
77 bool FileExists(string File);
78 string SafeGetCWD();
79 void SetCloseExec(int Fd,bool Close);
80 void SetNonBlock(int Fd,bool Block);
81 bool WaitFd(int Fd,bool write = false,unsigned long timeout = 0);
82 int ExecFork();
83 bool ExecWait(int Pid,const char *Name,bool Reap = false);
84
85 // File string manipulators
86 string flNotDir(string File);
87 string flNotFile(string File);
88 string flNoLink(string File);
89
90 #endif