1 .TH dispense 1 "June 17, 2011" "OpenDispense2" "USER COMMANDS"
3 dispense \- OpenDispense2 command line client
10 .RI "[\-u " "user" "]"
14 .RI "[\-u " "user" "]"
21 command provides access to the UCC's coke machine and other systems. It can be used to drop a drink, open the door, or pay for other items.
23 If called with no arguments,
25 displays an interactive list of avaliable items. This list can be navigated using the arrow keys, enter/return (for select) and q/ESC to quit.
27 If the first argument is not a recognised command (see below) then
29 attempts to interpret the argument as an item name, and if it matches, dispenses the item.
34 Display a list of commands and options
37 Use a non-interactive list instead of the ncurses interface.
42 .RI "give " "user ammount reason"
43 Give some money to another user (e.g. for pizza).
46 .RI "acct [" "user" "]"
47 List users (including balances and flags)
54 .SS "Coke Controllers"
57 .RI "acct " "user" " [+-]" "ammount" " '" "reason" "'"
58 Alter a user's balance by
60 cents, leaving a reason for the coke logs.
63 .RI "refund " "user item_id" " [" "price" "]"
64 Refund a bad dispense for a user (the item_id can be found in the coke log usually)
65 It is is of the form <type>:<slot>, for example coke:6 or snack:33
68 .RI "slot " "item_id price name"
69 Update a slot's contents (name and price)
74 .RI "acct " "user" " =" "ammount" " '" reason "'"
75 Set a user's balance to a number of cents
78 .RI "user add " "username"
79 Create a new account with the specified username.
82 .RI "user type " "username flags"
83 Alter the flags on a user. Valid flags are user, coke, admin, internal and disabled.
84 Flags can be removed by prepending the flag with a '-'
105 You are not permitted to perform that action
109 Invalid arguments passed
113 Insufficient balance avaliable
121 Socket/connection error of some form
125 Unknown response from the server