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
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
|
#ifndef H_MISC
#define H_MISC
/**
* \file lib/misc.h
*
*/
#include <unistd.h>
#include <sys/types.h>
#include "header.h"
#include "ugid.h"
typedef int (*md5func)(const char * fn, /*@out@*/ unsigned char * digest);
#ifdef __cplusplus
extern "C" {
#endif
/**
* Calculate MD5 sum for file.
* @todo Eliminate, use beecrypt instead.
* @param fn file name
* @retval digest address of md5sum
* @param asAscii return md5sum as ascii string?
* @return 0 on success, 1 on error
*/
/*@-exportlocal@*/
int domd5(const char * fn, /*@out@*/ unsigned char * digest, int asAscii)
/*@modifies digest, fileSystem @*/;
/*@=exportlocal@*/
/**
* Return MD5 sum of file as ASCII string.
* @todo Eliminate, use beecrypt instead.
* @param fn file name
* @retval digest MD5 digest
* @return 0 on success, 1 on error
*/
/*@unused@*/ static inline
int mdfile(const char * fn, /*@out@*/ unsigned char * digest)
/*@modifies digest, fileSystem @*/
{
return domd5(fn, digest, 1);
}
/**
* Return MD5 sum of file as binary data.
* @todo Eliminate, use beecrypt instead.
* @param fn file name
* @retval bindigest MD5 digest
* @return 0 on success, 1 on error
*/
/*@unused@*/ static inline
int mdbinfile(const char * fn, /*@out@*/ unsigned char * bindigest)
/*@modifies bindigest, fileSystem @*/
{
return domd5(fn, bindigest, 0);
}
/**
* Split string into fields separated by a character.
* @param str string
* @param length length of string
* @param sep separator character
* @return (malloc'd) argv array
*/
/*@only@*/ char ** splitString(const char * str, int length, char sep)
/*@*/;
/**
* Free split string argv array.
* @param list argv array
*/
void freeSplitString( /*@only@*/ char ** list)
/*@modifies list @*/;
/**
* Remove occurences of trailing character from string.
* @param s string
* @param c character to strip
* @return string
*/
/*@unused@*/ static inline
/*@only@*/ char * stripTrailingChar(/*@only@*/ char * s, char c)
/*@modifies *s */
{
char * t;
for (t = s + strlen(s) - 1; *t == c && t >= s; t--)
*t = '\0';
return s;
}
/**
* Check if file esists using stat(2).
* @param urlfn file name (may be URL)
* @return 1 if file exists, 0 if not
*/
int rpmfileexists(const char * urlfn)
/*@modifies fileSystem @*/;
/**
* Like the libc function, but malloc()'s the space needed.
* @param name variable name
* @param value variable value
* @param overwrte should an existing variable be changed?
* @return 0 on success
*/
int dosetenv(const char * name, const char * value, int overwrite)
/*@modifies fileSystem @*/;
/**
* Like the libc function, but malloc()'s the space needed.
* @param str "name=value" string
* @return 0 on success
*/
int doputenv(const char * str)
/*@modifies fileSystem @*/;
/**
* Return file handle for a temporaray file.
* A unique temporaray file path will be generated using
* rpmGenPath(prefix, "%{_tmppath}/", "rpm-tmp.XXXXX")
* where "XXXXXX" is filled in using rand(3). The file is opened, and
* the link count and (dev,ino) location are verified after opening.
* The file name and the open file handle are returned.
*
* @param prefix leading part of temp file path
* @retval fnptr temp file name (or NULL)
* @retval fdptr temp file handle
* @return 0 on success
*/
int makeTempFile(/*@null@*/ const char * prefix,
/*@null@*/ /*@out@*/ const char ** fnptr,
/*@out@*/ FD_t * fdptr)
/*@modifies *fnptr, *fdptr, fileSystem @*/;
/**
* Return (malloc'd) current working directory.
* @return current working directory (malloc'ed)
*/
/*@only@*/ char * currentDirectory(void)
/*@modifies fileSystem @*/;
/**
* Convert absolute path tag to (dirname,basename,dirindex) tags.
* @param h header
*/
void compressFilelist(Header h)
/*@modifies h @*/;
/**
* Convert (dirname,basename,dirindex) tags to absolute path tag.
* @param h header
*/
void expandFilelist(Header h)
/*@modifies h @*/;
/**
* @param h header
*/
void buildOrigFileList(Header h, /*@out@*/ const char *** fileListPtr,
/*@out@*/ int * fileCountPtr)
/*@modifies *fileListPtr, *fileCountPtr @*/;
/**
*/
int myGlobPatternP (const char *patternURL) /*@*/;
/**
*/
int rpmGlob(const char * patterns, /*@out@*/ int * argcPtr,
/*@out@*/ const char *** argvPtr)
/*@modifies *argcPtr, *argvPtr, fileSystem @*/;
/**
* Retrofit a Provides: name = version-release dependency into legacy
* packages.
* @param h header
*/
void providePackageNVR(Header h)
/*@modifies h @*/;
#ifdef __cplusplus
}
#endif
#endif /* H_MISC */
|