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.
Source Files