1 // -*- mode: cpp; mode: fold -*-
3 // $Id: fileutl.h,v 1.26 2001/05/07 05:06:52 jgg Exp $
4 /* ######################################################################
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
13 The file class is a handy abstraction for various functions+classes
14 that need to accept filenames.
16 This source is placed in the Public Domain, do with it what you will
17 It was originally written by Jason Gunthorpe.
19 ##################################################################### */
21 #ifndef PKGLIB_FILEUTL_H
22 #define PKGLIB_FILEUTL_H
24 #include <apt-pkg/macros.h>
25 #include <apt-pkg/aptconfiguration.h>
32 #ifndef APT_8_CLEANER_HEADERS
36 /* Define this for python-apt */
37 #define APT_HAS_GZIP 1
45 enum LocalFlags
{AutoClose
= (1<<0),Fail
= (1<<1),DelOnFail
= (1<<2),
46 HitEof
= (1<<3), Replace
= (1<<4), Compressed
= (1<<5) };
49 std::string TemporaryFileName
;
55 ReadWrite
= ReadOnly
| WriteOnly
,
59 Atomic
= Exclusive
| (1 << 4),
62 WriteEmpty
= ReadWrite
| Create
| Empty
,
63 WriteExists
= ReadWrite
,
64 WriteAny
= ReadWrite
| Create
,
65 WriteTemp
= ReadWrite
| Create
| Exclusive
,
67 WriteAtomic
= ReadWrite
| Create
| Atomic
69 enum CompressMode
{ Auto
= 'A', None
= 'N', Extension
= 'E', Gzip
= 'G', Bzip2
= 'B', Lzma
= 'L', Xz
= 'X' };
71 inline bool Read(void *To
,unsigned long long Size
,bool AllowEof
)
73 unsigned long long Jnk
;
75 return Read(To
,Size
,&Jnk
);
78 bool Read(void *To
,unsigned long long Size
,unsigned long long *Actual
= 0);
79 char* ReadLine(char *To
, unsigned long long const Size
);
80 bool Write(const void *From
,unsigned long long Size
);
81 bool Seek(unsigned long long To
);
82 bool Skip(unsigned long long To
);
83 bool Truncate(unsigned long long To
);
84 unsigned long long Tell();
85 unsigned long long Size();
86 unsigned long long FileSize();
87 time_t ModificationTime();
89 /* You want to use 'unsigned long long' if you are talking about a file
90 to be able to support large files (>2 or >4 GB) properly.
91 This shouldn't happen all to often for the indexes, but deb's might be…
92 And as the auto-conversation converts a 'unsigned long *' to a 'bool'
93 instead of 'unsigned long long *' we need to provide this explicitely -
94 otherwise applications magically start to fail… */
95 __deprecated
bool Read(void *To
,unsigned long long Size
,unsigned long *Actual
)
98 bool const T
= Read(To
, Size
, &R
);
103 bool Open(std::string FileName
,unsigned int const Mode
,CompressMode Compress
,unsigned long const Perms
= 0666);
104 bool Open(std::string FileName
,unsigned int const Mode
,APT::Configuration::Compressor
const &compressor
,unsigned long const Perms
= 0666);
105 inline bool Open(std::string
const &FileName
,unsigned int const Mode
, unsigned long const Perms
= 0666) {
106 return Open(FileName
, Mode
, None
, Perms
);
108 bool OpenDescriptor(int Fd
, unsigned int const Mode
, CompressMode Compress
, bool AutoClose
=false);
109 bool OpenDescriptor(int Fd
, unsigned int const Mode
, APT::Configuration::Compressor
const &compressor
, bool AutoClose
=false);
110 inline bool OpenDescriptor(int Fd
, unsigned int const Mode
, bool AutoClose
=false) {
111 if (Mode
== ReadOnlyGzip
)
112 return OpenDescriptor(Fd
, Mode
, Gzip
, AutoClose
);
114 return OpenDescriptor(Fd
, Mode
, None
, AutoClose
);
119 // Simple manipulators
120 inline int Fd() {return iFd
;};
121 inline void Fd(int fd
) { OpenDescriptor(fd
, ReadWrite
);};
122 __deprecated gzFile
gzFd();
124 inline bool IsOpen() {return iFd
>= 0;};
125 inline bool Failed() {return (Flags
& Fail
) == Fail
;};
126 inline void EraseOnFailure() {Flags
|= DelOnFail
;};
127 inline void OpFail() {Flags
|= Fail
;};
128 inline bool Eof() {return (Flags
& HitEof
) == HitEof
;};
129 inline bool IsCompressed() {return (Flags
& Compressed
) == Compressed
;};
130 inline std::string
&Name() {return FileName
;};
132 FileFd(std::string FileName
,unsigned int const Mode
,unsigned long Perms
= 0666) : iFd(-1), Flags(0), d(NULL
)
134 Open(FileName
,Mode
, None
, Perms
);
136 FileFd(std::string FileName
,unsigned int const Mode
, CompressMode Compress
, unsigned long Perms
= 0666) : iFd(-1), Flags(0), d(NULL
)
138 Open(FileName
,Mode
, Compress
, Perms
);
140 FileFd() : iFd(-1), Flags(AutoClose
), d(NULL
) {};
141 FileFd(int const Fd
, unsigned int const Mode
= ReadWrite
, CompressMode Compress
= None
) : iFd(-1), Flags(0), d(NULL
)
143 OpenDescriptor(Fd
, Mode
, Compress
);
145 FileFd(int const Fd
, bool const AutoClose
) : iFd(-1), Flags(0), d(NULL
)
147 OpenDescriptor(Fd
, ReadWrite
, None
, AutoClose
);
153 bool OpenInternDescriptor(unsigned int const Mode
, APT::Configuration::Compressor
const &compressor
);
156 bool RunScripts(const char *Cnf
);
157 bool CopyFile(FileFd
&From
,FileFd
&To
);
158 int GetLock(std::string File
,bool Errors
= true);
159 bool FileExists(std::string File
);
160 bool RealFileExists(std::string File
);
161 bool DirectoryExists(std::string
const &Path
) __attrib_const
;
162 bool CreateDirectory(std::string
const &Parent
, std::string
const &Path
);
163 time_t GetModificationTime(std::string
const &Path
);
165 /** \brief Ensure the existence of the given Path
167 * \param Parent directory of the Path directory - a trailing
168 * /apt/ will be removed before CreateDirectory call.
169 * \param Path which should exist after (successful) call
171 bool CreateAPTDirectoryIfNeeded(std::string
const &Parent
, std::string
const &Path
);
173 std::vector
<std::string
> GetListOfFilesInDir(std::string
const &Dir
, std::string
const &Ext
,
174 bool const &SortList
, bool const &AllowNoExt
=false);
175 std::vector
<std::string
> GetListOfFilesInDir(std::string
const &Dir
, std::vector
<std::string
> const &Ext
,
176 bool const &SortList
);
177 std::string
SafeGetCWD();
178 void SetCloseExec(int Fd
,bool Close
);
179 void SetNonBlock(int Fd
,bool Block
);
180 bool WaitFd(int Fd
,bool write
= false,unsigned long timeout
= 0);
182 bool ExecWait(pid_t Pid
,const char *Name
,bool Reap
= false);
184 // File string manipulators
185 std::string
flNotDir(std::string File
);
186 std::string
flNotFile(std::string File
);
187 std::string
flNoLink(std::string File
);
188 std::string
flExtension(std::string File
);
189 std::string
flCombine(std::string Dir
,std::string File
);