+void ShowUsage(void)
+{
+ printf( "Usage:\n" );
+ if( giTextArgc == 0 )
+ printf(
+ " == Everyone ==\n"
+ " dispense\n"
+ " Show interactive list\n"
+ " dispense <name>|<index>|<itemid>\n"
+ " Dispense named item (<name> matches if it is a unique prefix)\n"
+ " dispense finger\n"
+ " Show the finger output\n"
+ );
+ if( giTextArgc == 0 || strcmp(gsTextArgs[0], "give") == 0 )
+ printf(
+ " dispense give <user> <amount> \"<reason>\"\n"
+ " Give money to another user\n"
+ );
+
+ if( giTextArgc == 0 || strcmp(gsTextArgs[0], "donate") == 0 )
+ printf(
+ " dispense donate <amount> \"<reason>\"\n"
+ " Donate to the club\n"
+ );
+ if( giTextArgc == 0 || strcmp(gsTextArgs[0], "iteminfo") == 0 )
+ printf(
+ " dispense iteminfo <itemid>\n"
+ " Get the name and price for an item\n"
+ );
+// if( giTextArgc == 0 || strcmp(gsTextArgs[0], "enumitems") == 0 )
+// printf(
+// " dispense enumitems\n"
+// " List avaliable items\n"
+// );
+ if( giTextArgc == 0 )
+ printf(" == Coke members == \n");
+ if( giTextArgc == 0 || strcmp(gsTextArgs[0], "acct") == 0 )
+ printf(
+ " dispense acct [<user>]\n"
+ " Show user balances\n"
+ " dispense acct <user> [+-]<amount> \"<reason>\"\n"
+ " Alter a account value\n"
+ " dispense acct <user> =<amount> \"<reason>\"\n"
+ " Set an account balance\n"
+ );
+ if( giTextArgc == 0 || strcmp(gsTextArgs[0], "refund") == 0 )
+ printf(
+ " dispense refund <user> <itemid> [<price>]\n"
+ " Refund an item to a user (with optional price override)\n"
+ " Item IDs can be seen in the cokelog (in the brackets after the item name)\n"
+ " e.g. coke:6 for a coke, snack:33 for slot 33 of the snack machine\n"
+ );
+ if( giTextArgc == 0 || strcmp(gsTextArgs[0], "slot") == 0 )
+ printf(
+ " dispense slot <itemid> <price> <name>\n"
+ " Rename/Re-price a slot\n"
+ );
+ if( giTextArgc == 0 )
+ printf(" == Dispense administrators ==\n");
+ if( giTextArgc == 0 || strcmp(gsTextArgs[0], "user") == 0 )
+ printf(
+ " dispense user add <user>\n"
+ " Create new account\n"
+ " dispense user type <user> <flags> <reason>\n"
+ " Alter a user's flags\n"
+ " <flags> is a comma-separated list of user, coke, admin, internal or disabled\n"
+ " Flags are removed by preceding the name with '-' or '!'\n"
+ );
+ if( giTextArgc == 0 )
+ printf( "\n"
+ "General Options:\n"
+ " -c <count>\n"
+ " Dispense multiple times\n"
+ " -u <username>\n"
+ " Set a different user (Coke members only)\n"
+ " -h / -?\n"
+ " Show help text\n"
+ " -G\n"
+ " Use simple textual interface (instead of ncurses)\n"
+ " -D\n"
+ " Drinks only in user interface\n"
+ " -n\n"
+ " Dry run - Do not actually do dispenses\n"
+ " -m <min balance>\n"
+ " -M <max balance>\n"
+ " Set the Maximum/Minimum balances shown in `dispense acct`\n"
+ " -f <configfile>\n"
+ " Set the config file path (default: `/etc/opendispense/client.conf'\n"
+ " -H <host>\n"
+ " Set a different dispense host\n"
+ " -P <port>\n"
+ " Set a different dispense port\n"
+ "Definitions:\n"
+ " <itemid>\n"
+ " Item ID of the form <type>:<num> where <type> is a non-empty string of alpha-numeric characters, and <num> is a non-negative integer\n"
+// " <user>\n"
+// " Account name\n"
+ );
+}
+
+//
+// `dispense finger`
+//
+int subcommand_finger(void)
+{
+ // Connect to server
+ int sock = OpenConnection(gsDispenseServer, giDispensePort);
+ if( sock < 0 ) return RV_SOCKET_ERROR;
+
+ // Get items
+ PopulateItemList(sock);
+
+ printf("The UCC Coke machine.\n\n");
+
+ // Only get coke slot statuses
+ for( int i = 0; i <= 6; i ++ )
+ {
+ const char *status;
+ switch(gaItems[i].Status)
+ {
+ case 0: status = "Avail"; break;
+ case 1: status = "Sold "; break;
+ default:
+ status = "Error";
+ break;
+ }
+ printf("%i - %s %3i %s\n", gaItems[i].ID, status, gaItems[i].Price, gaItems[i].Desc);
+ }
+
+ printf("\nMay your pink fish bing into the distance.\n");
+
+ return 0;
+}
+
+//
+// `dispense acct`
+// - Display/manipulate account balances
+//
+int subcommand_acct(void)
+{
+ int ret = 0;
+
+ // Connect to server
+ int sock = OpenConnection(gsDispenseServer, giDispensePort);
+ if( sock < 0 ) return RV_SOCKET_ERROR;
+ // List accounts?
+ if( giTextArgc == 1 ) {
+ ret = Dispense_EnumUsers(sock);
+ close(sock);
+ return ret;
+ }
+
+ // gsTextArgs[1]: Username
+
+ // Alter account?
+ if( giTextArgc != 2 )
+ {
+ if( giTextArgc != 4 ) {
+ fprintf(stderr, "`dispense acct` requires a reason\n");
+ ShowUsage();
+ return RV_ARGUMENTS;
+ }
+
+ // Authentication required
+ ret = Authenticate(sock);
+ if(ret) return ret;
+
+ // gsTextArgs[1]: Username
+ // gsTextArgs[2]: Ammount
+ // gsTextArgs[3]: Reason
+ char *tmp = NULL;
+ long int balance = strtol(gsTextArgs[2]+(gsTextArgs[2][0] == '='), &tmp, 10);
+ if(!tmp || *tmp != '\0') {
+ fprintf(stderr, "dispense acct: Value must be a decimal number of cents\n");
+ return RV_ARGUMENTS;
+ }
+
+ if( gsTextArgs[2][0] == '=' ) {
+ // Set balance
+ ret = Dispense_ShowUser(sock, gsTextArgs[1]);
+ ret = Dispense_SetBalance(sock, gsTextArgs[1], balance, gsTextArgs[3]);
+ }
+ else {
+ // Alter balance
+ ret = Dispense_AlterBalance(sock, gsTextArgs[1], balance, gsTextArgs[3]);
+ }
+ }
+ // On error, quit
+ if( ret ) {
+ close(sock);
+ return ret;
+ }
+
+ // Show user information
+ ret = Dispense_ShowUser(sock, gsTextArgs[1]);
+
+ close(sock);
+ return ret;
+}
+
+//
+// `dispense give`
+// - Transfer credit from the current user to another account
+//
+// "Here, have some money."
+//
+int subcommand_give(int argc, char *args[])
+{
+ int ret;
+
+ if( argc != 3 ) {
+ fprintf(stderr, "`dispense give` takes three arguments\n");
+ ShowUsage();
+ return RV_ARGUMENTS;
+ }
+
+ const char *dst_acct = args[0];
+ const char *amt_str = args[1];
+ const char *message = args[2];
+
+ // Connect to server
+ int sock = OpenConnection(gsDispenseServer, giDispensePort);
+ if( sock < 0 ) return RV_SOCKET_ERROR;
+
+ // Authenticate
+ ret = Authenticate(sock);
+ if(ret) return ret;
+
+ char *end = NULL;
+ long amt = strtol(amt_str, &end, 10);
+ if( !end || *end != '\0' ) {
+ fprintf(stderr, "dispense give: Balance is invalid, must be decimal number of cents");
+ return RV_ARGUMENTS;
+ }
+ ret = Dispense_Give(sock, dst_acct, amt, message);
+
+ close(sock);
+ return ret;
+}
+
+//
+// `dispense user`
+// - User administration (Admin Only)
+//
+int subcommand_user(int argc, char *args[])
+{
+ int ret;
+
+ // Check argument count
+ if( argc == 0 ) {
+ fprintf(stderr, "Error: `dispense user` requires arguments\n");
+ ShowUsage();
+ return RV_ARGUMENTS;
+ }
+
+ // Connect to server
+ int sock = OpenConnection(gsDispenseServer, giDispensePort);
+ if( sock < 0 ) return RV_SOCKET_ERROR;
+
+ // Attempt authentication
+ ret = Authenticate(sock);
+ if(ret) return ret;
+
+ // Add new user?
+ if( strcmp(args[0], "add") == 0 )
+ {
+ if( giTextArgc != 3 ) {
+ fprintf(stderr, "Error: `dispense user add` requires an argument\n");
+ ShowUsage();
+ return RV_ARGUMENTS;
+ }
+
+ ret = Dispense_AddUser(sock, args[1]);
+ }
+ // Update a user
+ else if( strcmp(args[0], "type") == 0 || strcmp(args[0], "flags") == 0 )
+ {
+ if( argc < 3 || argc > 4 ) {
+ fprintf(stderr, "Error: `dispense user type` requires two arguments\n");
+ ShowUsage();
+ return RV_ARGUMENTS;
+ }
+
+ ret = Dispense_SetUserType(sock, args[1], args[2], (argc == 3 ? "" : args[3]));
+ }
+ else
+ {
+ fprintf(stderr, "Error: Unknown sub-command for `dispense user`\n");
+ ShowUsage();
+ return RV_ARGUMENTS;
+ }
+ close(sock);
+ return ret;
+}
+
+//
+// `dispense donate`
+// - Donate money to the club
+//
+int subcommand_donate(int argc, char *args[])
+{
+ int ret;
+
+ // Check argument count
+ if( argc != 2 ) {
+ fprintf(stderr, "Error: `dispense donate` requires two arguments\n");
+ ShowUsage();
+ return RV_ARGUMENTS;
+ }
+
+ // Connect to server
+ int sock = OpenConnection(gsDispenseServer, giDispensePort);
+ if( sock < 0 ) return RV_SOCKET_ERROR;
+
+ // Attempt authentication
+ ret = Authenticate(sock);
+ if(ret) return ret;
+
+ // Do donation
+ ret = Dispense_Donate(sock, atoi(args[0]), args[1]);
+
+ close(sock);
+
+ return ret;
+}
+
+//
+// `dispense refund`
+// - Refund a purchased item
+//
+// "Well excuuuuse me, princess"
+//
+int subcommand_refund(int argc, char *args[])