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
190
191
192
193
194
195
196
197
198
199
200
|
/* createrepo_c - Library of routines for manipulation with repodata
* Copyright (C) 2012 Tomas Mlcoch
*
* 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; either version 2
* of the License, or (at your option) any later version.
*
* 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., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301,
* USA.
*/
#ifndef __C_CREATEREPOLIB_XML_DUMP_H__
#define __C_CREATEREPOLIB_XML_DUMP_H__
#ifdef __cplusplus
extern "C" {
#endif
#include <glib.h>
#include "deltarpms.h"
#include "package.h"
#include "repomd.h"
#include "updateinfo.h"
/** \defgroup xml_dump XML dump API.
*
* Example:
* \code
* cr_Package *pkg;
* struct cr_XmlStruct xml;
*
* cr_xml_dump_init();
* cr_package_parser_init();
*
* pkg = cr_package_from_rpm_base("path/to/rpm.rpm", 5, CR_HDRR_NONE, NULL);
*
* xml = cr_xml_dump(pkg, NULL);
*
* cr_package_free(pkg);
*
* printf("Primary XML chunk:\n%s\n", xml.primary);
* printf("Filelists XML chunk:\n%s\n", xml.filelists);
* printf("Other XML chunk:\n%s\n", xml.other);
*
* free(xml.primary);
* free(xml.filelists);
* free(xml.other);
*
* cr_package_parser_cleanup();
* cr_xml_dump_cleanup();
* \endcode
*
* \addtogroup xml_dump
* @{
*/
/** Default namespace for primary.xml */
#define CR_XML_COMMON_NS "http://linux.duke.edu/metadata/common"
/** Default namespace for filelists.xml */
#define CR_XML_FILELISTS_NS "http://linux.duke.edu/metadata/filelists"
/** Default namespace for other.xml */
#define CR_XML_OTHER_NS "http://linux.duke.edu/metadata/other"
/** Default namespace for repomd.xml */
#define CR_XML_REPOMD_NS "http://linux.duke.edu/metadata/repo"
/** Namespace for rpm (used in primary.xml and repomd.xml) */
#define CR_XML_RPM_NS "http://linux.duke.edu/metadata/rpm"
/** Xml chunks for primary.xml, filelists.xml and other.xml.
*/
struct cr_XmlStruct {
char *primary; /*!< XML chunk for primary.xml */
char *filelists; /*!< XML chunk for filelists.xml */
char *other; /*!< XML chunk for other.xml */
};
/** Initialize dumping part of library (Initialize libxml2).
*/
void cr_xml_dump_init();
/** Cleanup initialized dumping part of library
*/
void cr_xml_dump_cleanup();
/** Generate primary xml chunk from cr_Package.
* @param package cr_Package
* @param err **GError
* @return xml chunk string or NULL on error
*/
char *cr_xml_dump_primary(cr_Package *package, GError **err);
/** Generate filelists xml chunk from cr_Package.
* @param package cr_Package
* @param err **GError
* @return xml chunk string or NULL on error
*/
char *cr_xml_dump_filelists(cr_Package *package, GError **err);
/** Generate other xml chunk from cr_Package.
* @param package cr_Package
* @param err **GError
* @return xml chunk string or NULL on error
*/
char *cr_xml_dump_other(cr_Package *package, GError **err);
/** Generate all three xml chunks (primary, filelists, other) from cr_Package.
* @param package cr_Package
* @param err **GError
* @return cr_XmlStruct
*/
struct cr_XmlStruct cr_xml_dump(cr_Package *package, GError **err);
/** Generate xml representation of cr_Repomd.
* @param repomd cr_Repomd
* @param err **GError
* @return repomd.xml content
*/
char *cr_xml_dump_repomd(cr_Repomd *repomd, GError **err);
/** Generate xml representation of cr_UpdateInfo.
* @param updateinfo cr_UpdateInfo
* @param err **GError
* @return repomd.xml content
*/
char *cr_xml_dump_updateinfo(cr_UpdateInfo *updateinfo, GError **err);
/** Generate xml representation of cr_UpdateRecord
* @param rec cr_UpdateRecord
* @param err **GError
* @return xml chunk string or NULL on error
*/
char *cr_xml_dump_updaterecord(cr_UpdateRecord *rec, GError **err);
/** Generate xml representation of cr_DeltaPackage
* @param dpkg cr_DeltaPackage
* @param err **GError
* @return xml chunk string or NULL on error
*/
char *cr_xml_dump_deltapackage(cr_DeltaPackage *dpkg, GError **err);
/** Prepare string to xml dump.
* If string is not utf8 it is converted (source encoding is supposed to be
* iso-8859-1).
* Control chars (chars with value <32 except 9, 10 and 13) are excluded.
*
* @param in input string.
* @param out output string. space of output string must be
* at least (strlen(in) * 2 + 1) * sizeof(char)
*/
void cr_latin1_to_utf8(const unsigned char *in,
unsigned char *out) __attribute__ ((hot));
/**
* Check if string contains chars with value <32 (except 9, 10 and 13).
*
* @param str String (NOT NULL!!!!)
* @return TRUE if at leas one char with value <32 (except the
* 9, 10, 13) is present in the string.
*/
gboolean cr_hascontrollchars(const unsigned char *str);
/**
* Prepend protocol if necessary
*
* @param url input url
* @return output string, must be freed
*/
gchar *cr_prepend_protocol(const gchar *url);
/** Check if package contains any strings with chars
* with value <32 (except 9, 10 and 13), using cr_hascontrollchars
*
* @param pkg the cr_Package in question
* @return boolean value
*/
gboolean cr_Package_contains_forbidden_control_chars(cr_Package *pkg);
/** Check if list of cr_Dependency stucts contains any strings with chars
* with value <32 (except 9, 10 and 13), using cr_hascontrollchars
*
* @param deps the GSList of cr_Dependencies in question
* @return boolean value
*/
gboolean cr_GSList_of_cr_Dependency_contains_forbidden_control_chars(GSList *deps);
/** @} */
#ifdef __cplusplus
}
#endif
#endif /* __C_CREATEREPOLIB_XML_DUMP_H__ */
|
