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 static void export_print_name(const struct upkg_export *e)
187 export_print_name(e->parent);
188 printf(".%s", e->name);
193 export_print_fullname(GTypeModule *pkg, const struct upkg_export *export)
195 printf("%s", pkg->name);
196 export_print_name(export);
199 static void import_print_fullname(const struct upkg_import *import)
202 import_print_fullname(import->parent);
205 printf("%s", import->name);
209 void print_upkg_exports(struct upkg *pkg)
211 for (unsigned i = 0; i < pkg->export_count; i++) {
212 const struct upkg_export *export = upkg_get_export(pkg, i);
213 const char *package, *class;
215 class = upkg_export_class(pkg, i, &package);
220 printf("%u - %s (%s.%s)\n", i+1, export->name, package, class);
221 printf(" Flags: %lx\n", export->flags);
223 print_upkg_object_flags(" ", export->flags);
228 void print_upkg_imports(struct upkg *pkg)
230 for (unsigned i = 0; i < pkg->import_count; i++) {
231 const struct upkg_import *import = upkg_get_import(pkg, i);
234 import_print_fullname(import);
235 printf(" (%s.%s)\n", import->class_package, import->class_name);
239 int package_info(struct upkg *pkg)
241 printf("Version: %u\n", pkg->version);
242 printf("License: %u\n", pkg->license);
244 print_guid(pkg->guid);
246 printf("Flags: %lx\n", pkg->flags);
248 print_upkg_flags(" ", pkg->flags);
251 printf("Names: %lu\n", pkg->name_count);
253 for (unsigned long i = 0; i < pkg->name_count; i++) {
254 printf("%lu - %s\n", i, upkg_get_name(pkg, i));
258 printf("Exports: %lu\n", pkg->export_count);
259 if (verbose >= 1) print_upkg_exports(pkg);
260 printf("Imports: %lu\n", pkg->import_count);
261 if (verbose >= 1) print_upkg_imports(pkg);
266 static int package_list(GTypeModule *pkg, long current)
268 struct upkg *upkg = U_PKG(pkg)->pkg;
269 const struct upkg_export *parent = NULL;
272 parent = upkg_get_export(upkg, current);
273 assert(parent != NULL);
276 for (unsigned i = 0; i < upkg->export_count; i++) {
277 const struct upkg_export *export = upkg_get_export(upkg, i);
279 if (export->parent != parent)
282 export_print_fullname(pkg, export);
285 const char *class, *package;
287 class = upkg_export_class(upkg, i, &package);
288 printf(" (%s.%s)", package, class);
297 static int object_dump_properties(GTypeModule *pkg, unsigned long idx)
303 obj = u_object_new_from_package(pkg, idx);
305 fprintf(stderr, "%s: failed to load object.\n", progname);
309 props = g_object_class_list_properties(G_OBJECT_GET_CLASS(obj), &n);
310 for (unsigned i = 0; i < n; i++) {
314 printf(" property %s:", props[i]->name);
317 g_value_init(&val, props[i]->value_type);
318 g_object_get_property(obj, props[i]->name, &val);
320 if (G_VALUE_HOLDS(&val, U_TYPE_OBJECT)) {
321 UObject *obj = g_value_get_object(&val);
323 if (obj && obj->pkg_name) {
324 printf(" %s", obj->pkg_name);
328 valstr = g_strdup_value_contents(&val);
329 printf(" %s\n", valstr);
339 static int object_dump_offsets(GTypeModule *pkg, unsigned long idx)
343 f = upkg_export_open(U_PKG(pkg)->pkg, idx);
345 fprintf(stderr, "%s: failed to open export.\n", progname);
349 printf(" file size: %lu\n", f->len);
350 printf(" file start: %#lx\n", f->base);
351 printf(" file end: %#lx\n", f->base + f->len);
353 upkg_export_close(f);
358 static int object_info(GTypeModule *pkg, unsigned long idx)
360 struct upkg *upkg = U_PKG(pkg)->pkg;
361 const struct upkg_export *export;
362 const char *class, *package;
365 export = upkg_get_export(upkg, idx);
366 export_print_fullname(pkg, export);
368 class = upkg_export_class(upkg, idx, &package);
369 printf(" (%s.%s)\n", package, class);
371 if (verbose >= 1 && object_dump_properties(pkg, idx) != 0)
374 if (verbose >= 3 && object_dump_offsets(pkg, idx))
380 static int export(GTypeModule *pkg, GObject *obj, unsigned idx)
382 struct upkg *upkg = U_PKG(pkg)->pkg;
387 if (U_OBJECT_IS_LOADABLE(obj) && u_object_load(obj) != 0) {
388 fprintf(stderr, "%s: failed to load export data.\n", progname);
392 rc = u_object_export_name(obj, name, sizeof name);
394 /* XXX: We could use a default name here. */
395 fprintf(stderr, "%s: failed to determine export filename.\n",
400 printf("exporting ");
401 export_print_fullname(pkg, upkg_get_export(upkg, idx));
402 printf(" to %s\n", name);
404 of = fopen(name, "wb");
410 u_object_export(obj, of);
412 if (fclose(of) != 0) {
417 if (U_OBJECT_IS_LOADABLE(obj)) {
418 u_object_unload(obj);
424 static int object_export(GTypeModule *pkg, unsigned long idx)
429 obj = u_object_new_from_package(pkg, idx);
431 fprintf(stderr, "%s: failed to load object.\n", progname);
435 if (!U_OBJECT_IS_EXPORTABLE(obj)) {
436 fprintf(stderr, "%s: object is not exportable.\n", progname);
440 ret = export(pkg, obj, idx);
446 int package_export(GTypeModule *pkg)
448 struct upkg *upkg = U_PKG(pkg)->pkg;
452 for (unsigned i = 0; i < upkg->export_count; i++) {
453 obj = u_object_new_from_package(pkg, i);
454 if (U_OBJECT_IS_EXPORTABLE(obj) && export(pkg, obj, i) != 0) {
463 static int process_object(int mode, const char *objname)
465 char work[strlen(objname)+1], *p = work, *c;
470 strcpy(work, objname);
472 /* First, find and open the actual package. */
477 if (!pkg || !g_type_module_use(pkg)) {
478 fprintf(stderr, "%s: %s: failed to open package.\n",
483 if (!U_PKG(pkg)->pkg) {
484 if (u_pkg_is_native(pkg)) {
485 fprintf(stderr, "%s: %s: not a UObject package.\n",
488 fprintf(stderr, "%s: %s: package not found.\n",
495 /* Resolve the hierarchical reference. */
501 current = upkg_export_find(U_PKG(pkg)->pkg, current, p);
503 /* We want to print the full name up to this point. */
504 strcpy(work, objname);
507 fprintf(stderr, "%s: %s: object not found.\n",
516 ret = package_info(U_PKG(pkg)->pkg);
518 ret = object_info(pkg, current);
521 ret = package_list(pkg, current);
525 ret = package_export(pkg);
527 ret = object_export(pkg, current);
534 g_type_module_unuse(pkg);
539 int main(int argc, char **argv)
541 const char *pkgname = NULL;
542 unsigned mode = MODE_INFO;
545 if (argc > 0) progname = argv[0];
547 if (u_pkg_vfs_init() != 0)
549 if (u_object_module_init() != 0)
552 while ((opt = getopt_long(argc, argv, sopts, lopts, NULL)) != -1) {
555 pkgname = u_pkg_vfs_add_local(NULL, optarg);
557 fprintf(stderr, "failed to add package `%s'.\n", optarg);
585 if (!pkgname && !argv[optind]) {
592 for (int i = optind; i < argc; i++) {
593 if (process_object(mode, argv[i]) != 0)
597 if (process_object(mode, pkgname) != 0)
601 u_object_module_exit();