gromox-dbop

Name

gromox-mbop — Mailbox operations utility

Synopsis

gromox-mbop {-d mbox|-u u@d.de} command [command-args...]

Global options

-d /var/lib/gromox/user/1/2

Lookup the mailbox parameters from the associated filesystem location.

-u u@d.de

Lookup the mailbox parameters from the associated username.

Commands

  • delmsg: issue "delete_message" RPCs for a mailbox

  • unload: issue the "unload_store" RPC for a mailbox

  • vacuum: issue the "vacuum" RPC for a mailbox

delmsg

Synopsis

gromox-mbop -u a@b.de delmsg -f folder_id [msgid...]

Description

This command hard-deletes messages from a store, including issuing proper PR_CHANGE_KEY metadata updates for the sake of Cached Mode clients.

The folder and message IDs taken as arguments on the command-line should be of the GC-value form, i.e. as they appear in the the SQLite database.

Subcommand options

-f folder_id

The folder from which to delete the messages. (If a msgid is specified which is not located in the particular folder, that message will not be deleted.)

--soft

Perform a soft deletion.

emptyfld

Synopsis

gromox-mbop -u a@b.de emptyfld [-R] [--soft] folder_id...

Description

This command deletes messages from a folder.

Subcommand options

-R

Besides messages, also delete subfolders.

--soft

Perform a soft deletion. (This feature is experimental.) Default is hard.

unload

Normally, exmdb_provider(4gx) keeps stores open for up to exmdb_provider.cfg:cache_interval. The "unload_store" RPC to exmdb_provider(4gx) causes the sqlite database (in /var/lib/gromox/.../exmdb/exchange.sqlite3) to be closed. Any subsequent RPC may reopen it, though. The unload RPC is useful after a mailbox was deleted and/or reinitialized with grommunio-admin-api or tools like gromox-mkprivate(8)/gromox-mkpublic(8). [zcore also has store state in memory. This would also need to be purged — but there is no RPC for such action at this time.]

vacuum

The "vacuum" RPC makes exmdb_provider issue the SQLite "vacuum" command on exchange.sqlite3, which rebuilds and compacts the database file.

See also

gromox(7)