version 1.5, 2012/07/22 22:37:08
|
version 1.6, 2013/05/30 09:16:42
|
Line 12 terms:
|
Line 12 terms:
|
All of the documentation and software included in the ELWIX and AITNET |
All of the documentation and software included in the ELWIX and AITNET |
Releases is copyrighted by ELWIX - Sofia/Bulgaria <info@elwix.org> |
Releases is copyrighted by ELWIX - Sofia/Bulgaria <info@elwix.org> |
|
|
Copyright 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012 | Copyright 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013 |
by Michael Pounov <misho@elwix.org>. All rights reserved. |
by Michael Pounov <misho@elwix.org>. All rights reserved. |
|
|
Redistribution and use in source and binary forms, with or without |
Redistribution and use in source and binary forms, with or without |
Line 186 SUCH DAMAGE.
|
Line 186 SUCH DAMAGE.
|
/* History types */ |
/* History types */ |
|
|
struct tagHistory { |
struct tagHistory { |
int hist_len; | int hist_len; |
char hist_line[BUFSIZ]; | char hist_line[BUFSIZ]; |
|
|
TAILQ_ENTRY(tagHistory) hist_next; |
TAILQ_ENTRY(tagHistory) hist_next; |
}; |
}; |
Line 250 typedef struct {
|
Line 250 typedef struct {
|
/* Error support functions */ |
/* Error support functions */ |
|
|
// cli_GetErrno() Get error code of last operation |
// cli_GetErrno() Get error code of last operation |
inline int cli_GetErrno(); | int cli_GetErrno(); |
// cli_GetError() Get error text of last operation |
// cli_GetError() Get error text of last operation |
inline const char *cli_GetError(); | const char *cli_GetError(); |
|
|
|
|
/* TELNET support for CLI */ |
/* TELNET support for CLI */ |
Line 269 struct telnetAttrs {
|
Line 269 struct telnetAttrs {
|
|
|
#ifndef NDEBUG |
#ifndef NDEBUG |
/* |
/* |
* cli_telnetDumpAttrs() Telnet debug attributes list, if NDEBUG defined not include | * cli_telnetDumpAttrs() - Telnet debug attributes list, if NDEBUG defined not include |
| * |
* @attr = attributes list |
* @attr = attributes list |
* @nAttr = attributes list size |
* @nAttr = attributes list size |
* return: none |
* return: none |
Line 281 extern void cli_telnetDumpAttrs(struct telnetAttrs *,
|
Line 282 extern void cli_telnetDumpAttrs(struct telnetAttrs *,
|
|
|
|
|
/* |
/* |
* cli_telnetRecv() Telnet receive commands, negotiate with telnet peer | * cli_telnetRecv() - Telnet receive commands, negotiate with telnet peer |
| * |
* @sock = socket for communication |
* @sock = socket for communication |
* @attr = received attributes list, must be free after use, but if NULL receive in binary mode |
* @attr = received attributes list, must be free after use, but if NULL receive in binary mode |
* @nAttr = received attributes list size, if is NULL receive in binary mode |
* @nAttr = received attributes list size, if is NULL receive in binary mode |
Line 291 extern void cli_telnetDumpAttrs(struct telnetAttrs *,
|
Line 293 extern void cli_telnetDumpAttrs(struct telnetAttrs *,
|
*/ |
*/ |
int cli_telnetRecv(int sock, struct telnetAttrs **attr, int *nAttr, void *data, int datLen); |
int cli_telnetRecv(int sock, struct telnetAttrs **attr, int *nAttr, void *data, int datLen); |
/* |
/* |
* cli_telnetSend() Telnet send commands, negotiate with telnet peer | * cli_telnetSend() - Telnet send commands, negotiate with telnet peer |
| * |
* @sock = socket for communication |
* @sock = socket for communication |
* @attr = send attributes list |
* @attr = send attributes list |
* @nAttr = send attributes list size |
* @nAttr = send attributes list size |
Line 303 int cli_telnetRecv(int sock, struct telnetAttrs **attr
|
Line 306 int cli_telnetRecv(int sock, struct telnetAttrs **attr
|
int cli_telnetSend(int sock, struct telnetAttrs *attr, int nAttr, void *data, int datLen, int Term); |
int cli_telnetSend(int sock, struct telnetAttrs *attr, int nAttr, void *data, int datLen, int Term); |
|
|
/* |
/* |
* cli_telnet_Get_SubOpt() Telnet get sub option function | * cli_telnet_Get_SubOpt() - Telnet get sub option function |
| * |
* @attr = input attribute |
* @attr = input attribute |
* @code = sub-option code for opt |
* @code = sub-option code for opt |
* @data = sub-option data |
* @data = sub-option data |
* @datLen = data size set max size in input, output return copy size |
* @datLen = data size set max size in input, output return copy size |
* return: -1 can`t get option; !=-1 option code |
* return: -1 can`t get option; !=-1 option code |
*/ |
*/ |
inline int cli_telnet_Get_SubOpt(struct telnetAttrs *attr, unsigned char *code, | int cli_telnet_Get_SubOpt(struct telnetAttrs *attr, unsigned char *code, |
void *data, unsigned char *datLen); |
void *data, unsigned char *datLen); |
/* |
/* |
* cli_telnet_Set_SubOpt() Telnet set sub option function | * cli_telnet_Set_SubOpt() - Telnet set sub option function |
| * |
* @attr = output attribute |
* @attr = output attribute |
* @opt = attribute option |
* @opt = attribute option |
* @code = sub-option code for opt, if 0xff not specified |
* @code = sub-option code for opt, if 0xff not specified |
Line 321 inline int cli_telnet_Get_SubOpt(struct telnetAttrs *a
|
Line 326 inline int cli_telnet_Get_SubOpt(struct telnetAttrs *a
|
* @datLen = data size, if 0 not specified |
* @datLen = data size, if 0 not specified |
* return: -1 can`t set sub-otion; 0 ok |
* return: -1 can`t set sub-otion; 0 ok |
*/ |
*/ |
inline int cli_telnet_Set_SubOpt(struct telnetAttrs *attr, unsigned char opt, unsigned char code, | int cli_telnet_Set_SubOpt(struct telnetAttrs *attr, unsigned char opt, unsigned char code, |
void *data, unsigned char datLen); |
void *data, unsigned char datLen); |
|
|
/* |
/* |
* cli_telnet_GetCmd() Telnet get command | * cli_telnet_GetCmd() - Telnet get command |
| * |
* @attr = input attribute |
* @attr = input attribute |
* return: -1 can`t get command; !=-1 command <<24 return sublen, <<8 return option, <<0 command |
* return: -1 can`t get command; !=-1 command <<24 return sublen, <<8 return option, <<0 command |
*/ |
*/ |
inline unsigned int cli_telnet_GetCmd(struct telnetAttrs *attr); | unsigned int cli_telnet_GetCmd(struct telnetAttrs *attr); |
/* |
/* |
* cli_telnet_SetCmd() Telnet set command | * cli_telnet_SetCmd() - Telnet set command |
| * |
* @attr = input attribute |
* @attr = input attribute |
* @cmd = command |
* @cmd = command |
* @opt = option, if 0xff not specified |
* @opt = option, if 0xff not specified |
Line 340 inline unsigned int cli_telnet_GetCmd(struct telnetAtt
|
Line 347 inline unsigned int cli_telnet_GetCmd(struct telnetAtt
|
* @arg3 = sub-option data size, if 0 not specified data |
* @arg3 = sub-option data size, if 0 not specified data |
* return: -1 can`t set command; !=-1 ok |
* return: -1 can`t set command; !=-1 ok |
*/ |
*/ |
inline int cli_telnet_SetCmd(struct telnetAttrs *attr, unsigned char cmd, unsigned char opt, ...); | int cli_telnet_SetCmd(struct telnetAttrs *attr, unsigned char cmd, unsigned char opt, ...); |
|
|
/* |
/* |
* cli_telnet_Answer() Automatic generate commands answer to send from telnet | * cli_telnet_Answer() - Automatic generate commands answer to send from telnet |
| * |
* @caps = Array of capability options |
* @caps = Array of capability options |
* @nCaps = number of capability options |
* @nCaps = number of capability options |
* @attr = input attribute |
* @attr = input attribute |
* @nAttr = number of input attributes |
* @nAttr = number of input attributes |
* @ans = output answered attributes, must be io_free() after use | * @ans = output answered attributes, must be e_free() after use |
* @Ans = number of output answered attributes |
* @Ans = number of output answered attributes |
* return: -1 can`t answer; !=-1 ok |
* return: -1 can`t answer; !=-1 ok |
*/ |
*/ |
Line 367 int cli_telnet_Answer(unsigned char *caps, int nCaps,
|
Line 375 int cli_telnet_Answer(unsigned char *caps, int nCaps,
|
/* CLI Helper functions */ |
/* CLI Helper functions */ |
|
|
/* |
/* |
* cli_Cmd_Unsupported() Builtin helper function for unsupported commands | * cli_Cmd_Unsupported() - Builtin helper function for unsupported commands |
| * |
* @buffer = CLI buffer |
* @buffer = CLI buffer |
* @idx = Selected command ID |
* @idx = Selected command ID |
* @args = Parsed arguments array |
* @args = Parsed arguments array |
Line 379 int cli_Cmd_Unsupported(void * __restrict buffer, int
|
Line 388 int cli_Cmd_Unsupported(void * __restrict buffer, int
|
/* CLI Functions */ |
/* CLI Functions */ |
|
|
/* |
/* |
* cli_BindKey() Bind function to key | * cli_BindKey() - Bind function to key |
| * |
* @key = key structure |
* @key = key structure |
* @buffer = CLI buffer |
* @buffer = CLI buffer |
* return: RETCODE_ERR error, RETCODE_OK ok, >0 bind at position |
* return: RETCODE_ERR error, RETCODE_OK ok, >0 bind at position |
Line 388 int cli_BindKey(bindkey_t * __restrict key, linebuffer
|
Line 398 int cli_BindKey(bindkey_t * __restrict key, linebuffer
|
|
|
|
|
/* |
/* |
* cli_addCommand() Add command to CLI session | * cli_addCommand() - Add command to CLI session |
| * |
* @buffer = CLI buffer |
* @buffer = CLI buffer |
* @csCmd = Command name |
* @csCmd = Command name |
* @cliLevel = Level in CLI, -1 unprivi(view from all), 0 main config, 1 sub config ... |
* @cliLevel = Level in CLI, -1 unprivi(view from all), 0 main config, 1 sub config ... |
Line 401 int
|
Line 412 int
|
cli_addCommand(linebuffer_t * __restrict buffer, const char *csCmd, int cliLevel, cmd_func_t funcCmd, |
cli_addCommand(linebuffer_t * __restrict buffer, const char *csCmd, int cliLevel, cmd_func_t funcCmd, |
const char *csInfo, const char *csHelp); |
const char *csInfo, const char *csHelp); |
/* |
/* |
* cli_delCommand() Delete command from CLI session | * cli_delCommand() - Delete command from CLI session |
| * |
* @buffer = CLI buffer |
* @buffer = CLI buffer |
* @csCmd = Command name |
* @csCmd = Command name |
* @cliLevel = Level in CLI, -1 unprivi(view from all), 0 main config, 1 sub config ... |
* @cliLevel = Level in CLI, -1 unprivi(view from all), 0 main config, 1 sub config ... |
Line 410 cli_addCommand(linebuffer_t * __restrict buffer, const
|
Line 422 cli_addCommand(linebuffer_t * __restrict buffer, const
|
int |
int |
cli_delCommand(linebuffer_t * __restrict buffer, const char *csCmd, int cliLevel); |
cli_delCommand(linebuffer_t * __restrict buffer, const char *csCmd, int cliLevel); |
/* |
/* |
* cli_updCommand() Update command in CLI session | * cli_updCommand() - Update command in CLI session |
| * |
* @buffer = CLI buffer |
* @buffer = CLI buffer |
* @csCmd = Command name |
* @csCmd = Command name |
* @cliLevel = Level in CLI, -1 unprivi(view from all), 0 main config, 1 sub config ... |
* @cliLevel = Level in CLI, -1 unprivi(view from all), 0 main config, 1 sub config ... |
Line 425 cli_updCommand(linebuffer_t * __restrict buffer, const
|
Line 438 cli_updCommand(linebuffer_t * __restrict buffer, const
|
|
|
|
|
/* |
/* |
* cli_addHistory() Add line to history | * cli_addHistory() - Add line to history |
| * |
* @buffer = CLI buffer |
* @buffer = CLI buffer |
* @str = Add custom text or if NULL use readed line from CLI buffer |
* @str = Add custom text or if NULL use readed line from CLI buffer |
* return: RETCODE_ERR error, RETCODE_OK ok |
* return: RETCODE_ERR error, RETCODE_OK ok |
*/ |
*/ |
int cli_addHistory(linebuffer_t * __restrict buffer, const char * __restrict str); |
int cli_addHistory(linebuffer_t * __restrict buffer, const char * __restrict str); |
/* |
/* |
* cli_saveHistory() Save history to file | * cli_saveHistory() - Save history to file |
| * |
* @buffer = CLI buffer |
* @buffer = CLI buffer |
* @histfile = History filename, if NULL will be use default name |
* @histfile = History filename, if NULL will be use default name |
* @lines = Maximum history lines to save |
* @lines = Maximum history lines to save |
Line 440 int cli_addHistory(linebuffer_t * __restrict buffer, c
|
Line 455 int cli_addHistory(linebuffer_t * __restrict buffer, c
|
*/ |
*/ |
int cli_saveHistory(linebuffer_t * __restrict buffer, const char *histfile, int lines); |
int cli_saveHistory(linebuffer_t * __restrict buffer, const char *histfile, int lines); |
/* |
/* |
* cli_loadHistory() Load history from file | * cli_loadHistory() - Load history from file |
| * |
* @buffer = CLI buffer |
* @buffer = CLI buffer |
* @histfile = History filename, if NULL will be use default name |
* @histfile = History filename, if NULL will be use default name |
* return: RETCODE_ERR error, RETCODE_OK ok |
* return: RETCODE_ERR error, RETCODE_OK ok |
*/ |
*/ |
int cli_loadHistory(linebuffer_t * __restrict buffer, const char *histfile); |
int cli_loadHistory(linebuffer_t * __restrict buffer, const char *histfile); |
/* |
/* |
* cli_resetHistory() Reset history search in CLI session | * cli_resetHistory() - Reset history search in CLI session |
| * |
* @buffer = CLI buffer |
* @buffer = CLI buffer |
* return: none |
* return: none |
*/ |
*/ |
inline void cli_resetHistory(linebuffer_t * __restrict buffer); | void cli_resetHistory(linebuffer_t * __restrict buffer); |
|
|
/* |
/* |
* cli_freeLine() Clear entire line | * cli_freeLine() - Clear entire line |
| * |
* @buffer = CLI buffer |
* @buffer = CLI buffer |
* return: RETCODE_ERR error, RETCODE_OK ok |
* return: RETCODE_ERR error, RETCODE_OK ok |
*/ |
*/ |
inline int cli_freeLine(linebuffer_t * __restrict buffer); | int cli_freeLine(linebuffer_t * __restrict buffer); |
/* |
/* |
* cli_setPrompt() Set new prompt for CLI session | * cli_setPrompt() - Set new prompt for CLI session |
| * |
* @buffer = CLI buffer |
* @buffer = CLI buffer |
* @prompt = new text for prompt or if NULL disable prompt |
* @prompt = new text for prompt or if NULL disable prompt |
* return: none |
* return: none |
*/ |
*/ |
inline void cli_setPrompt(linebuffer_t * __restrict buffer, const char *prompt); | void cli_setPrompt(linebuffer_t * __restrict buffer, const char *prompt); |
/* |
/* |
* cli_Printf() Send message to CLI session | * cli_Printf() - Send message to CLI session |
| * |
* @buffer = CLI buffer |
* @buffer = CLI buffer |
* @fmt = printf format string |
* @fmt = printf format string |
* @... = arguments defined in fmt |
* @... = arguments defined in fmt |
* return: none |
* return: none |
*/ |
*/ |
inline void cli_Printf(linebuffer_t * __restrict buffer, char *fmt, ...); | void cli_Printf(linebuffer_t * __restrict buffer, char *fmt, ...); |
/* |
/* |
* cli_PrintHelp() Print help screen | * cli_PrintHelp() - Print help screen |
| * |
* @buffer = CLI buffer |
* @buffer = CLI buffer |
* return: none |
* return: none |
*/ |
*/ |
inline void cli_PrintHelp(linebuffer_t * __restrict buffer); | void cli_PrintHelp(linebuffer_t * __restrict buffer); |
|
|
/* |
/* |
* cliEnd() Clear data, Free resources and close CLI session | * cliEnd() - Clear data, Free resources and close CLI session |
| * |
* @buffer = CLI buffer |
* @buffer = CLI buffer |
* return: RETCODE_ERR error, RETCODE_OK ok |
* return: RETCODE_ERR error, RETCODE_OK ok |
*/ |
*/ |
void cliEnd(linebuffer_t * __restrict buffer); |
void cliEnd(linebuffer_t * __restrict buffer); |
/* |
/* |
* cliInit() Start CLI session, allocate memory for resources and bind keys | * cliInit() - Start CLI session, allocate memory for resources and bind keys |
| * |
* @fin = Input device handle |
* @fin = Input device handle |
* @fout = Output device handle |
* @fout = Output device handle |
* @prompt = text for prompt, if NULL disable prompt |
* @prompt = text for prompt, if NULL disable prompt |
Line 497 void cliEnd(linebuffer_t * __restrict buffer);
|
Line 520 void cliEnd(linebuffer_t * __restrict buffer);
|
linebuffer_t *cliInit(int fin, int fout, const char *prompt); |
linebuffer_t *cliInit(int fin, int fout, const char *prompt); |
|
|
/* |
/* |
* cliInitLine() Init CLI input line terminal | * cliInitLine() - Init CLI input line terminal |
| * |
* @buffer = CLI buffer |
* @buffer = CLI buffer |
* return: none |
* return: none |
*/ |
*/ |
int cliInitLine(linebuffer_t * __restrict buffer); |
int cliInitLine(linebuffer_t * __restrict buffer); |
/* |
/* |
* cliReadLine() Read line from opened CLI session | * cliReadLine() - Read line from opened CLI session |
| * |
* @buffer = CLI buffer |
* @buffer = CLI buffer |
* return: NULL if error or !=NULL readed line, must be io_free after use! | * return: NULL if error or !=NULL readed line, must be e_free after use! |
*/ |
*/ |
char *cliReadLine(linebuffer_t * __restrict buffer); |
char *cliReadLine(linebuffer_t * __restrict buffer); |
|
|
/* |
/* |
* cliLoop() CLI main loop | * cliLoop() - CLI main loop |
| * |
* @buffer = CLI buffer |
* @buffer = CLI buffer |
* @csHistFile = History file name |
* @csHistFile = History file name |
* return: RETCODE_ERR error, RETCODE_OK ok |
* return: RETCODE_ERR error, RETCODE_OK ok |
*/ |
*/ |
int cliLoop(linebuffer_t * __restrict buffer, const char *csHistFile); |
int cliLoop(linebuffer_t * __restrict buffer, const char *csHistFile); |
/* |
/* |
* cliNetLoop() CLI network main loop binded to socket | * cliNetLoop() - CLI network main loop binded to socket |
| * |
* @buffer = CLI buffer |
* @buffer = CLI buffer |
* @csHistFile = History file name |
* @csHistFile = History file name |
* @sock = client socket |
* @sock = client socket |