2 * upkg: tool for manipulating Unreal Tournament packages.
3 * Copyright © 2009-2011 Nick Bowler
5 * This program is free software: you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation, either version 3 of the License, or
8 * (at your option) any later version.
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
15 * You should have received a copy of the GNU General Public License
16 * along with this program. If not, see <http://www.gnu.org/licenses/>.
27 #include <glib-object.h>
30 #include <uobject/uobject.h>
31 #include <uobject/exportable.h>
32 #include <uobject/loadable.h>
33 #include <uobject/module.h>
34 #include <uobject/package.h>
35 #include <uobject/vfs.h>
46 static const char *progname = "upkg";
47 static const char *sopts = "ilxvf:VH";
48 static const struct option lopts[] = {
49 { "info", 0, NULL, 'i' },
50 { "list", 0, NULL, 'l' },
51 { "export", 0, NULL, 'x' },
52 { "file", 1, NULL, 'f' },
53 { "verbose", 0, NULL, 'v' },
54 { "version", 0, NULL, 'V' },
55 { "help", 0, NULL, 'H' },
59 void print_version(void)
61 printf("%s\n", PACKAGE_STRING);
63 Copyright (C) 2009 Nick Bowler.\n\
64 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.\n\
65 This is free software: you are free to change and redistribute it.\n\
66 There is NO WARRANTY, to the extent permitted by law."
70 void print_usage(FILE *f)
72 fprintf(f, "Usage: %s [options] [object ...]\n", progname);
78 puts("Detailed help coming soon. Until then, I'll just list my options.");
79 for (unsigned i = 0; lopts[i].name; i++) {
80 const struct option *o = &lopts[i];
81 printf("\t--%s", o->name);
83 if (o->has_arg == 1) {
85 } else if (o->has_arg == 2) {
89 printf(" (-%c)\n", o->val);
93 static void print_upkg_flags(const char *prefix, unsigned long flags)
95 if (flags & UPKG_FLAG_ALLOW_DOWNLOAD)
96 printf("%sAllowDownload\n", prefix);
97 if (flags & UPKG_FLAG_CLIENT_OPTIONAL)
98 printf("%sClientOptional\n", prefix);
99 if (flags & UPKG_FLAG_SERVER_ONLY)
100 printf("%sServerOnly\n", prefix);
101 if (flags & UPKG_FLAG_BROKEN_LINKS)
102 printf("%sBrokenLinks\n", prefix);
103 if (flags & UPKG_FLAG_INSECURE)
104 printf("%sInsecure\n", prefix);
105 if (flags & UPKG_FLAG_REQUIRED)
106 printf("%sRequired\n", prefix);
109 static void print_upkg_object_flags(const char *prefix, unsigned long flags)
111 if (flags & UPKG_OBJ_FLAG_TRANSACTIONAL)
112 printf("%sTransactional\n", prefix);
113 if (flags & UPKG_OBJ_FLAG_UNREACHABLE)
114 printf("%sUnreachable\n", prefix);
115 if (flags & UPKG_OBJ_FLAG_PUBLIC)
116 printf("%sPublic\n", prefix);
117 if (flags & UPKG_OBJ_FLAG_TAG_IMPORT)
118 printf("%sImport\n", prefix);
119 if (flags & UPKG_OBJ_FLAG_TAG_EXPORT)
120 printf("%sTagExport\n", prefix);
121 if (flags & UPKG_OBJ_FLAG_SOURCE_MODIFIED)
122 printf("%sSourceModified\n", prefix);
123 if (flags & UPKG_OBJ_FLAG_TAG_GARBAGE)
124 printf("%sTagGarbage\n", prefix);
125 if (flags & UPKG_OBJ_FLAG_NEED_LOAD)
126 printf("%sNeedLoad\n", prefix);
127 if (flags & UPKG_OBJ_FLAG_HIGHLIGHT_NAME)
128 printf("%sHighlightName\n", prefix);
129 if (flags & UPKG_OBJ_FLAG_IN_SINGULAR_FUNC)
130 printf("%sInSingularFunc\n", prefix);
131 if (flags & UPKG_OBJ_FLAG_SUPPRESSED)
132 printf("%sSuppressed\n", prefix);
133 if (flags & UPKG_OBJ_FLAG_IN_END_STATE)
134 printf("%sInEndState\n", prefix);
135 if (flags & UPKG_OBJ_FLAG_TRANSIENT)
136 printf("%sTransient\n", prefix);
137 if (flags & UPKG_OBJ_FLAG_PRELOADING)
138 printf("%sPreloading\n", prefix);
139 if (flags & UPKG_OBJ_FLAG_LOAD_FOR_CLIENT)
140 printf("%sLoadForClient\n", prefix);
141 if (flags & UPKG_OBJ_FLAG_LOAD_FOR_SERVER)
142 printf("%sLoadForServer\n", prefix);
143 if (flags & UPKG_OBJ_FLAG_LOAD_FOR_EDIT)
144 printf("%sLoadForEdit\n", prefix);
145 if (flags & UPKG_OBJ_FLAG_STANDALONE)
146 printf("%sStandalone\n", prefix);
147 if (flags & UPKG_OBJ_FLAG_NOT_FOR_CLIENT)
148 printf("%sNotForClient\n", prefix);
149 if (flags & UPKG_OBJ_FLAG_NOT_FOR_SERVER)
150 printf("%sNotForServer\n", prefix);
151 if (flags & UPKG_OBJ_FLAG_NOT_FOR_EDIT)
152 printf("%sNotForEdit\n", prefix);
153 if (flags & UPKG_OBJ_FLAG_DESTROYED)
154 printf("%sDestroyed\n", prefix);
155 if (flags & UPKG_OBJ_FLAG_NEED_POST_LOAD)
156 printf("%sNeedPostLoad\n", prefix);
157 if (flags & UPKG_OBJ_FLAG_HAS_STACK)
158 printf("%sHasStack\n", prefix);
159 if (flags & UPKG_OBJ_FLAG_NATIVE)
160 printf("%sNative\n", prefix);
161 if (flags & UPKG_OBJ_FLAG_MARKED)
162 printf("%sMarked\n", prefix);
163 if (flags & UPKG_OBJ_FLAG_ERROR_SHUTDOWN)
164 printf("%sErrorShutdown\n", prefix);
165 if (flags & UPKG_OBJ_FLAG_DEBUG_POST_LOAD)
166 printf("%sDebugPostLoad\n", prefix);
167 if (flags & UPKG_OBJ_FLAG_DEBUG_SERIALIZE)
168 printf("%sDebugSerialize\n", prefix);
169 if (flags & UPKG_OBJ_FLAG_DEBUG_DESTROY)
170 printf("%sDebugDestroy\n", prefix);
173 void print_guid(unsigned char guid[static 16])
175 for (unsigned i = 0; i < 16; i++) {
176 printf("%02hhx", guid[i]);
184 void print_upkg_exports(struct upkg *pkg)
186 for (unsigned i = 0; i < pkg->export_count; i++) {
187 const struct upkg_export *export = upkg_get_export(pkg, i);
188 const char *package, *class;
190 class = upkg_export_class(pkg, i, &package);
195 printf("%u - %s (%s.%s)\n", i+1, export->name, package, class);
196 printf(" Flags: %lx\n", export->flags);
198 print_upkg_object_flags(" ", export->flags);
203 int package_info(struct upkg *pkg)
205 printf("Version: %u\n", pkg->version);
206 printf("License: %u\n", pkg->license);
208 print_guid(pkg->guid);
210 printf("Flags: %lx\n", pkg->flags);
212 print_upkg_flags(" ", pkg->flags);
215 printf("Names: %lu\n", pkg->name_count);
217 for (unsigned long i = 0; i < pkg->name_count; i++) {
218 printf("%lu - %s\n", i, upkg_get_name(pkg, i));
222 printf("Exports: %lu\n", pkg->export_count);
223 if (verbose >= 1) print_upkg_exports(pkg);
224 printf("Imports: %lu\n", pkg->import_count);
229 static void export_print_name(struct upkg *upkg, const struct upkg_export *e)
232 export_print_name(upkg, e->parent);
233 printf(".%s", e->name);
238 export_print_fullname(GTypeModule *pkg, const struct upkg_export *export)
240 printf("%s", pkg->name);
241 export_print_name(U_PKG(pkg)->pkg, export);
244 static int package_list(GTypeModule *pkg, long current)
246 struct upkg *upkg = U_PKG(pkg)->pkg;
247 const struct upkg_export *parent = NULL;
250 parent = upkg_get_export(upkg, current);
251 assert(parent != NULL);
254 for (unsigned i = 0; i < upkg->export_count; i++) {
255 const struct upkg_export *export = upkg_get_export(upkg, i);
257 if (export->parent != parent)
260 export_print_fullname(pkg, export);
263 const char *class, *package;
265 class = upkg_export_class(upkg, i, &package);
266 printf(" (%s.%s)", package, class);
275 static int object_info(GTypeModule *pkg, unsigned long idx)
277 struct upkg *upkg = U_PKG(pkg)->pkg;
278 const struct upkg_export *export;
279 const char *class, *package;
281 export = upkg_get_export(upkg, idx);
282 export_print_fullname(pkg, export);
284 class = upkg_export_class(upkg, idx, &package);
285 printf(" (%s.%s)\n", package, class);
287 /* Print out object properties. */
293 obj = u_object_new_from_package(upkg, idx);
295 fprintf(stderr, "%s: failed to load object.\n",
300 props = g_object_class_list_properties(G_OBJECT_GET_CLASS(obj), &n);
301 for (unsigned i = 0; i < n; i++) {
305 printf(" property %s:", props[i]->name);
308 g_value_init(&val, props[i]->value_type);
309 g_object_get_property(obj, props[i]->name, &val);
311 if (G_VALUE_HOLDS(&val, U_TYPE_OBJECT)) {
312 UObject *obj = g_value_get_object(&val);
314 /* TODO: Display full object names here. */
316 printf(" %s", obj->pkg_file->name);
320 valstr = g_strdup_value_contents(&val);
321 printf(" %s\n", valstr);
329 /* Print raw file info. */
331 struct upkg_file *f = upkg_export_open(upkg, idx);
333 fprintf(stderr, "%s: failed to open export.\n",
338 printf(" file size: %lu\n", f->len);
339 printf(" file start: %#lx\n", f->base);
340 printf(" file end: %#lx\n", f->base + f->len);
342 upkg_export_close(f);
348 static int export(GTypeModule *pkg, GObject *obj, unsigned idx)
350 struct upkg *upkg = U_PKG(pkg)->pkg;
355 if (U_OBJECT_IS_LOADABLE(obj) && u_object_load(obj) != 0) {
356 fprintf(stderr, "%s: failed to load export data.\n", progname);
360 rc = u_object_export_name(obj, name, sizeof name);
362 /* XXX: We could use a default name here. */
363 fprintf(stderr, "%s: failed to determine export filename.\n",
368 printf("exporting ");
369 export_print_fullname(pkg, upkg_get_export(upkg, idx));
370 printf(" to %s\n", name);
372 of = fopen(name, "wb");
378 u_object_export(obj, of);
380 if (fclose(of) != 0) {
385 if (U_OBJECT_IS_LOADABLE(obj)) {
386 u_object_unload(obj);
392 static int object_export(GTypeModule *pkg, unsigned long idx)
394 struct upkg *upkg = U_PKG(pkg)->pkg;
398 obj = u_object_new_from_package(upkg, idx);
400 fprintf(stderr, "%s: failed to load object.\n", progname);
404 if (!U_OBJECT_IS_EXPORTABLE(obj)) {
405 fprintf(stderr, "%s: object is not exportable.\n", progname);
409 ret = export(pkg, obj, idx);
415 int package_export(GTypeModule *pkg)
417 struct upkg *upkg = U_PKG(pkg)->pkg;
418 const char *class, *package;
423 for (unsigned i = 0; i < upkg->export_count; i++) {
424 class = upkg_export_class(upkg, i, &package);
426 fprintf(stderr, "error getting class information.\n");
430 type = u_object_module_get_class(package, class);
434 obj = g_object_new(type, NULL);
435 if (U_OBJECT_IS_EXPORTABLE(obj)) {
436 if (u_object_deserialize(obj, upkg, i) != 0
437 || export(pkg, obj, i) != 0) {
447 static int process_object(int mode, const char *objname)
449 char work[strlen(objname)+1], *p = work, *c;
454 strcpy(work, objname);
456 /* First, find and open the actual package. */
461 if (!pkg || !g_type_module_use(pkg)) {
462 fprintf(stderr, "%s: %s: failed to open package.\n",
467 if (!U_PKG(pkg)->pkg) {
468 if (u_pkg_is_native(pkg)) {
469 fprintf(stderr, "%s: %s: not a UObject package.\n",
472 fprintf(stderr, "%s: %s: package not found.\n",
479 /* Resolve the hierarchical reference. */
485 current = upkg_export_find(U_PKG(pkg)->pkg, current, p);
487 /* We want to print the full name up to this point. */
488 strcpy(work, objname);
491 fprintf(stderr, "%s: %s: object not found.\n",
500 ret = package_info(U_PKG(pkg)->pkg);
502 ret = object_info(pkg, current);
505 ret = package_list(pkg, current);
509 ret = package_export(pkg);
511 ret = object_export(pkg, current);
518 g_type_module_unuse(pkg);
523 int main(int argc, char **argv)
525 const char *pkgname = NULL;
526 unsigned mode = MODE_INFO;
529 if (argc > 0) progname = argv[0];
531 if (u_pkg_vfs_init() != 0)
533 if (u_object_module_init() != 0)
536 while ((opt = getopt_long(argc, argv, sopts, lopts, NULL)) != -1) {
539 pkgname = u_pkg_vfs_add_local(NULL, optarg);
541 fprintf(stderr, "failed to add package `%s'.\n", optarg);
569 if (!pkgname && !argv[optind]) {
576 for (int i = optind; i < argc; i++) {
577 if (process_object(mode, argv[i]) != 0)
581 if (process_object(mode, pkgname) != 0)
585 u_object_module_exit();