Sean Middleditch | b9e4864 | 2009-03-12 23:33:27 -0400 | [diff] [blame] | 1 | ===================================================================== |
| 2 | libtelnet - TELNET protocol handling library |
| 3 | ===================================================================== |
| 4 | |
| 5 | Sean Middleditch |
| 6 | sean@sourcemud.org |
| 7 | |
| 8 | --------------------------------------------------------------------- |
| 9 | The author or authors of this code dedicate any and all copyright |
| 10 | interest in this code to the public domain. We make this dedication |
| 11 | for the benefit of the public at large and to the detriment of our |
| 12 | heirs and successors. We intend this dedication to be an overt act of |
| 13 | relinquishment in perpetuity of all present and future rights to this |
| 14 | code under copyright law. |
| 15 | --------------------------------------------------------------------- |
| 16 | |
| 17 | I. INTRODUCTION |
| 18 | ===================================================================== |
| 19 | |
| 20 | libtelnet provides safe and correct handling of the core TELNET |
| 21 | protocol. It does not include any "smarts," and all use of the |
| 22 | protocol (such as deciding which options to support, enabling |
| 23 | and disabling options, or processing subrequests) must be implemented |
| 24 | by the application author. |
| 25 | |
| 26 | II. LIBTELNET API |
| 27 | ===================================================================== |
| 28 | |
| 29 | FIXME: fill in notes about user-facing API |
| 30 | |
| 31 | III. INTEGRATING LIBTELNET |
| 32 | ===================================================================== |
| 33 | |
| 34 | FIXME: fill in notes about implementing the libtelnet_*_cb functions |
| 35 | |
| 36 | IV. OUTPUT PROCESSING |
| 37 | ===================================================================== |
| 38 | |
| 39 | FIXME: fill in notes about output buffering recommendations |
| 40 | |
| 41 | V. SAFETY AND CORRECTNESS CONSIDERATIONS |
| 42 | ===================================================================== |
| 43 | |
| 44 | FIXME: fill in notes about recommending the user of libtelnet over |
| 45 | all output functions for ensuring safety |