Sunday Protocol Error Code Specification

This document lists the set of errors that may be returned by a command in the Sunday Protocol. The error codes are indexed, which makes parsing simpler for clients.
Errors are broken up into categories that specify what the error is related to.

Error Categories
  • 100-199 Drop Error
    • 100-149 General Error/Failure
    • 150-174 Electronic Failure
    • 175-199 Mechanical Failure
  • 200-249 Authentication or Permission Error
  • 350-399 Subsystem Failure
  • 400-449 Parameter Error
  • 450-499 Miscellaneous Error or Failure
General Drop Errors:
>ERR 100 Slot empty.
>ERR 101 Drop failed, contact an admin.
>ERR 102 Slot disabled.
>ERR 103 Unknown Failure.
>ERR 104 No slots available.

Electronic Drop Failures:
>ERR 150 Unable to initialize hardware for drop.
>ERR 151 Unable to communicate with hardware. Contact an admin.
Mechanical Drop Failures
>ERR 175 Motor is jammed. Contact an admin immediately.
>ERR 176 Unable to start motor.
>ERR 177 Motor failure, can jam, or cutoff switch is off.

Authentication/Permission Errors:
>ERR 200 Access denied.
>ERR 201 USER command needs to be issued first.
>ERR 202 Invalid username or password.
>ERR 203 User is poor.
>ERR 204 You need to login.
>ERR 205 Maximum user count reached.
Subsystem Failures:
>ERR 350 Account server subsystem is not ready.
>ERR 351 Unable to determine temperature.
>ERR 352 Unable to create user.
>ERR 353 Could not remove user.
>ERR 354 Unable to set admin flag.
Parameter Errors:
>ERR 400 Invalid admin flag.
>ERR 401 Invalid cost.
>ERR 402 Invalid credits.
>ERR 403 Invalid delay.
>ERR 404 Invalid enable flag.
>ERR 405 Invalid num_dropped.
>ERR 406 Invalid parameters.
>ERR 407 Invalid password.
>ERR 408 Invalid quantity.
>ERR 409 Invalid slot.
>ERR 410 Invalid user.
>ERR 411 Invalid reboot flag.
>ERR 412 User already registered.

Miscellaneous Errors or Failures:
>ERR 450 Timeout, disconnecting.
>ERR 451 Not implemented.
>ERR 452 Invalid command.

This document is maintained by Kevin Thompson [antiduh@csh.rit.edu].
Last changed: $Date: 2003/08/19 $
Revision num: $Revision: #11 $