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 amount reason"
43 Give some money to another user (e.g. for pizza).
46 .RI "acct [" "user" "]"
47 List users (including balances and flags).
50 .RI "donate " "amount reason"
51 Give money to the club (for whatever reason)
58 .SS "Coke Controllers"
61 .RI "acct " "user" " [+-]" "amount" " '" "reason" "'"
62 Alter a user's balance by
64 cents, leaving a reason for the coke logs. Implemented as a transfer of
66 cents from '>additions' to the user.
69 .RI "refund " "user item_id" " [" "price" "]"
70 Refund a bad dispense for a user (the item_id can be found in the coke log usually).
71 It is is of the form <type>:<slot>, for example coke:6 or snack:33.
74 .RI "slot " "item_id price name"
75 Update a slot's contents (name and price).
80 .RI "acct " "user" " =" "amount" " '" reason "'"
81 Set a user's balance to a number of cents.
83 This function will use the '>countersum' account as the source/sink for money to make the users
87 .RI "user add " "username"
88 Create a new account with the specified username.
91 .RI "user type " "username flags"
92 Alter the flags on a user. Valid flags are user, coke, admin, internal and disabled.
93 Flags can be removed by prepending the flag with a '-'.
103 Invalid item selected
114 You are not permitted to perform that action
118 Invalid arguments passed
122 Insufficient balance avaliable
130 Socket/connection error of some form
134 Unknown response from the server