table of contents
| Z-PUSH-ADMIN(1) | General Commands Manual | Z-PUSH-ADMIN(1) |
NAME¶
z-push-admin — device and user administration for Z-push
SYNOPSIS¶
z-push-admin -a list [-u USER | -d DEVICE]
z-push-admin -a lastsync
z-push-admin -a wipe -u USER | -d DEVICE|-u USER -d DEVICE
z-push-admin -a remove -u USER | -d DEVICE | -u USER -d DEVICE
z-push-admin -a resync -t TYPE | -t TYPE -u USER | -t TYPE -u USER -d DEVICE
z-push-admin -a resync -t FOLDERID -u USER
z-push-admin -a resync -t hierarchy -u USER -d DEVICE
z-push-admin -a clearloop [-d DEVICE | -d DEVICE -u USER]
z-push-admin -a fixstates
DESCRIPTION¶
z-push-admin can be used to manage the users and devices that sync their email, contacts and calendar items with Z-push.
OPTIONS¶
list¶
The list action lists synchronized devices. When no extra options are given, the command returns a listing of all synchronized devices. If the selection is narrowed by specifying a username (-u USER) or a device id (-d DEVICE) or both, the command lists extended information about the selected device(s).
lastsync¶
The lastsync action lists all devices and synchronized users and the time that the last synchronization took place.
wipe¶
The wipe action sends the wipe command to the selected device. The device decides how to handle this command: some devices only remove the account from the device, other devices do a factory reset, or even empty the complete storage. Use with caution.
remove¶
The remove action removes state data. When a username is specified (-u USER), the state data of all devices of that user is removed. When a device id is specified (-d DEVICE), the state data of all users for that device is removed. When both are specified, the state data is removed for a specific user on a specific device.
resync¶
The resync action triggers a resynchronization of specific data. With the options, it is possible to select which data exactly is synchronized. When a username (-u USER) and device id (-d DEVICE) are specified, all data of this user on this device is resynchronized. By specifying a folder type (-t TYPE), only folders of this type are synchronized. Valid types are email, calendar, contact, task, note and gab.
The -t option can also be used to specify a folder id to resynchronize only a specific folder, or hierarchy to resynchronize the folder list.
clearloop¶
The clearloop action clears the loop detection data, either for all users and devices, or (with -d DEVICE and -u USER) for a specific user on a specific device. Loop detection is Z-push's automatic mechanism for avoiding problems where a device requests the same item over and over again. With the clearloop action this mechanism is reset.
fixstates¶
The fixstates action checks the state of all users and devices and fixes potential problems.