1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
|
/*
Copyright (C) CFEngine AS
This file is part of CFEngine 3 - written and maintained by CFEngine AS.
This program is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation; version 3.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
To the extent this program is licensed as part of the Enterprise
versions of CFEngine, the applicable Commercial Open Source License
(COSL) may apply to this file if you as a licensee so wish it. See
included file COSL.txt.
*/
#ifndef CFENGINE_FILE_LIB_H
#define CFENGINE_FILE_LIB_H
#include <platform.h>
#include <writer.h>
typedef enum
{
NewLineMode_Unix, // LF everywhere
NewLineMode_Native // CRLF on Windows, LF elsewhere
} NewLineMode;
/**
* Reads up to size_max bytes from filename and returns a Writer.
*/
Writer *FileRead(const char *filename, size_t size_max, bool *truncated);
/**
* Reads up to size_max bytes from fd and returns a Writer.
*/
Writer *FileReadFromFd(int fd, size_t size_max, bool *truncated);
bool FileCanOpen(const char *path, const char *modes);
/* Write LEN bytes at PTR to descriptor DESC, retrying if interrupted.
Return LEN upon success, write's (negative) error code otherwise. */
int FullWrite(int desc, const char *ptr, size_t len);
/* Read up to LEN bytes (or EOF) to PTR from descriptor DESC, retrying if interrupted.
Return amount of bytes read upon success, -1 otherwise */
int FullRead(int desc, char *ptr, size_t len);
int IsDirReal(const char *path);
/**
* Returns what type of line endings the file is using.
*
* @param file File to check.
* @return Always returns NewLineMode_Unix on Unix. On Windows it may return
* NewLineMode_Native if the file has CRLF line endings.
* If the file cannot be opened, or the line endings are mixed it will
* return NewLineMode_Native. Note that only the first CF_BUFSIZE bytes
* are checked.
*/
NewLineMode FileNewLineMode(const char *file);
/* File node separator (cygwin can use \ or / but prefer \ for communicating
* with native windows commands). */
#ifdef _WIN32
# define IsFileSep(c) ((c) == '\\' || (c) == '/')
# define FILE_SEPARATOR '\\'
# define FILE_SEPARATOR_STR "\\"
#else
# define IsFileSep(c) ((c) == '/')
# define FILE_SEPARATOR '/'
# define FILE_SEPARATOR_STR "/"
#endif
bool IsAbsoluteFileName(const char *f);
char *MapName(char *s);
char *MapNameCopy(const char *s);
char *MapNameForward(char *s);
int safe_open(const char *pathname, int flags, ...);
FILE *safe_fopen(const char *path, const char *mode);
int safe_chdir(const char *path);
int safe_chown(const char *path, uid_t owner, gid_t group);
int safe_chmod(const char *path, mode_t mode);
#ifndef __MINGW32__
int safe_lchown(const char *path, uid_t owner, gid_t group);
#endif
int safe_creat(const char *pathname, mode_t mode);
/**
* @brief Deletes directory path recursively. Symlinks are not followed.
* Note that this function only deletes the contents of the directory, not the directory itself.
* @param path
* @return true if directory was deleted successfully, false if one or more files were not deleted.
*/
bool DeleteDirectoryTree(const char *path);
#endif
|
