--- libaitio/inc/aitio.h 2010/03/09 09:26:27 1.2 +++ libaitio/inc/aitio.h 2010/03/11 00:17:52 1.2.2.3 @@ -3,7 +3,7 @@ * by Michael Pounov * * $Author: misho $ -* $Id: aitio.h,v 1.2 2010/03/09 09:26:27 misho Exp $ +* $Id: aitio.h,v 1.2.2.3 2010/03/11 00:17:52 misho Exp $ * *************************************************************************/ #ifndef __AITIO_H @@ -29,6 +29,19 @@ struct tagIOURL { char *url_reserved; }; +struct tagIOCmd { + const char *cmd_name; + int (*cmd_func)(void *, FILE *, char **); + const char *cmd_doc; + const char *cmd_help; + char *(*cmd_comp)(const char *, int); +}; + +typedef struct tagIOCmd ioCommands_t; +typedef char *io_CompEntry_t(const char *, int); +typedef char **io_Completion_t(const char *, int, int); + + // io_GetErrno() Get error code of last operation inline int io_GetErrno(); // io_GetError() Get error text of last operation @@ -148,6 +161,55 @@ int ioURLGetValue(struct tagIOURL *url, const char *cs * return: -1 error:: can`t read; 0 ok */ int ioURLGetFile(struct tagIOURL *url, char * __restrict psValue, int valLen); + +/* + * ioCLIComp() Initialize completion CLI features + * @cmdComplete = Completion function + * @cmdEntry = Compentry function + * return: none +*/ +inline void ioCLIComp(io_Completion_t *cmdComplete, io_CompEntry_t *cmdEntry); +/* + * ioCLIExec() Execute CLI main loop + * @cmdList = Commands list + * @out = Output handle + * @csPrompt = Prompt text + * return: -1 error, 0 = exit w/^+D, 1 done. +*/ +int ioCLIExec(ioCommands_t *cmdList, FILE *out, const char *csPrompt); + +/* + * io_Cmd_Unsupported() Builtin helper function for unsupported commands + * @cmds = Commands list + * @out = Output handle + * @args = Parsed arguments array + * return: -1 error, 0 = ok, 1 exit from Cli! +*/ +int io_Cmd_Unsupported(void *cmds, FILE *out, char ** __restrict args); +/* + * io_Cmd_Help() Builtin helper function for Help screen + * @cmds = Commands list + * @out = Output handle + * @args = Parsed arguments array + * return: -1 error, 0 = ok +*/ +int io_Cmd_Help(void *cmds, FILE *out, char ** __restrict args); +/* + * io_Cmd_Exit() Builtin helper function for Exit from Cli + * @cmds = Commands list + * @out = Output handle + * @args = Parsed arguments array + * return: 1 exit from Cli! +*/ +int io_Cmd_Exit(void *cmds, FILE *out, char ** __restrict args); + +/* + * io_Comp_Filename() Builtin helper function for filename completion arguments + * @text = Text line + * @state = Position state + * return: NULL not found filename, != NULL filename +*/ +char *io_Comp_Filename(const char *text, int state); #endif