Documentation ¶
Overview ¶
Image-audit is run on a system which hosts both a GMA server and the web server which offers the map image tiles to mapper clients (or at least has filesystem access to those files).
It checks for any files in the server's database (which means they will be offered by the server to any clients asking about those images) which do not have actual image files being served for them.
SYNOPSIS ¶
(If using the full GMA core tool suite)
gma go image-audit ...
(Otherwise)
image-audit -help image-audit [-delete] [-list] -sqlite dbfile -webroot gma_web_dir
OPTIONS ¶
The command-line options described below may be introduced with either one or two hyphens (e.g., -delete or --delete).
Options which take parameter values may have the value separated from the option name by a space or an equals sign (e.g., -sqlite=game.db or -sqlite game.db), except for boolean flags which may be given alone (e.g., -delete) to indicate that the option is set to “true” or may be given an explicit value which must be attached to the option with an equals sign (e.g., -delete=true or -delete=false).
-delete Delete images from the server's database which do not actually appear in the database -help Print a command summary and exit. -list Print a list of images listed in the database and whether or not they correspond to web server files. Also lists files in the web directory which are not mentioned in the database. -sqlite dbfile Read dbfile as the game server's database file (as specified to the server program's -sqlite option) Image-audit may be run while the server is also accessing this file, but note that updating the database by either program may briefly lock the other out from accessing it. Therefore, it is best to run image-audit when the server is shut down or at least quiescent. -webroot dir Consider all the files from dir down to be the directory structure behind what the GMA mapper client knows as the "image base URL". Thus, a server image ID of "abcdef" corresponds to disk file <dir>/a/ab/abcdef.png, et al.