[BACK]Return to aitcli.h CVS log [TXT] [DIR] Up to [ELWIX - Embedded LightWeight unIX -] / libaitcli / inc

Diff for /libaitcli/inc/aitcli.h between versions 1.2.2.1 and 1.4

version 1.2.2.1, 2010/06/04 12:08:32 version 1.4, 2011/05/29 22:49:25
Line 5 Line 5
 * $Author$  * $Author$
 * $Id$  * $Id$
 *  *
*************************************************************************/**************************************************************************
 The ELWIX and AITNET software is distributed under the following
 terms:
 
 All of the documentation and software included in the ELWIX and AITNET
 Releases is copyrighted by ELWIX - Sofia/Bulgaria <info@elwix.org>
 
 Copyright 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011
         by Michael Pounov <misho@elwix.org>.  All rights reserved.
 
 Redistribution and use in source and binary forms, with or without
 modification, are permitted provided that the following conditions
 are met:
 1. Redistributions of source code must retain the above copyright
    notice, this list of conditions and the following disclaimer.
 2. Redistributions in binary form must reproduce the above copyright
    notice, this list of conditions and the following disclaimer in the
    documentation and/or other materials provided with the distribution.
 3. All advertising materials mentioning features or use of this software
    must display the following acknowledgement:
 This product includes software developed by Michael Pounov <misho@elwix.org>
 ELWIX - Embedded LightWeight unIX and its contributors.
 4. Neither the name of AITNET nor the names of its contributors
    may be used to endorse or promote products derived from this software
    without specific prior written permission.
 
 THIS SOFTWARE IS PROVIDED BY AITNET AND CONTRIBUTORS ``AS IS'' AND
 ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
 FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 SUCH DAMAGE.
 */
 #ifndef __AITCLI_H  #ifndef __AITCLI_H
 #define __AITCLI_H  #define __AITCLI_H
   
   
   #include <termios.h>
   #include <sys/queue.h>
   
   
   #define STRSIZ          256
   
 /* Key definitions */  /* Key definitions */
   
 #define K_F1            "\x1b\x4f\x50"  #define K_F1            "\x1b\x4f\x50"
Line 158  typedef struct { Line 201  typedef struct {
 } bindkey_t;  } bindkey_t;
   
   
   /* Commands structure for CLI */
   
   typedef int (*cmd_func_t)(/*linebuffer_t **/ void * __restrict buffer, int idx, char ** __restrict args);
   struct tagCommand {
           int                     cmd_level;
   
           int                     cmd_len;
           char                    cmd_name[STRSIZ];
   
           char                    cmd_info[STRSIZ];
           char                    cmd_help[STRSIZ];
   
           cmd_func_t              cmd_func;
   
           SLIST_ENTRY(tagCommand) cmd_next;
   };
   typedef SLIST_HEAD(slCommandHead, tagCommand) commands_t;
   
   
 /* Main structure, Buffer for CLI work with thread models ;-) special designed by M.Punov */  /* Main structure, Buffer for CLI work with thread models ;-) special designed by M.Punov */
   
 typedef struct {  typedef struct {
Line 175  typedef struct { Line 237  typedef struct {
   
         bindkey_t               *line_keys;          bindkey_t               *line_keys;
   
           int                     line_level;
           commands_t              line_cmds;
   
         int                     line_in;          int                     line_in;
         int                     line_out;          int                     line_out;
 } linebuffer_t;  } linebuffer_t;
   
 /* Commands structure for CLI */  
   
 typedef int (*cmd_func_t)(linebuffer_t * __restrict buffer, int argc, char ** __restrict argv);  
 typedef struct {  
         int                     cmd_level;  
   
         int                     cmd_min;  
         int                     cmd_len;  
         char                    cmd_name[STRSIZ];  
   
         char                    cmd_info[STRSIZ];  
         char                    cmd_help[STRSIZ];  
   
         cmd_func_t              *cmd_func;  
 } commands_t;  
   
   
 /* Error support functions */  /* Error support functions */
   
 // cli_GetErrno() Get error code of last operation  // cli_GetErrno() Get error code of last operation
Line 204  inline int cli_GetErrno(); Line 253  inline int cli_GetErrno();
 inline const char *cli_GetError();  inline const char *cli_GetError();
   
   
/* CLI Functions *//* TELNET support for CLI */
   
   #define MAX_SUB_LEN     255
   
   struct telnetAttrs {
           unsigned char ta_cmd;
           unsigned char ta_opt;
           unsigned char ta_sublen;
           unsigned char ta_sub[MAX_SUB_LEN];
   };
   
   
   #ifndef NDEBUG
 /*  /*
 * cliExec() Execute CLI main loop * cli_telnetDumpAttrs() Telnet debug attributes list, if NDEBUG defined not include
 * @cmdList = Commands list * @attr = attributes list
 * @csPrompt = Prompt text * @nAttr = attributes list size
 * return: -1 error, 0 = exit w/^+D, 1 done. * return: none
 */  */
int cliExec(cliCommands_t *cmdList, const char *csPrompt);void cli_telnetDumpAttrs(struct telnetAttrs *attr, int nAttr);
 #else
 extern void cli_telnetDumpAttrs(struct telnetAttrs *, int);
 #endif
 
 
 /*  /*
 * cliNetExec() Execute net CLI main loop * cli_telnetRecv() Telnet receive commands, negotiate with telnet peer
 * @cmdList = Commands list * @sock = socket for communication
 * @csPrompt = Prompt text * @attr = received attributes list, must be free after use, but if NULL receive in binary mode
 * @sock = client socket * @nAttr = received attributes list size, if is NULL receive in binary mode
 * @term = stdin termios * @pdata = received data in supplied buffer
 * @win = window size of tty * @datLen = buffer pdata size
 * return: -1 error, 0 = exit w/^+D, 1 done. * return: 0 not present data; -1 error:: can`t read; -2 timeout; -3 EOF; >0 number of received bytes
 */  */
int cliNetExec(cliCommands_t *cmdList, const char *csPrompt, int sock, struct termios *term, struct winsize *win);int cli_telnetRecv(int sock, struct telnetAttrs **attr, int *nAttr, void *data, int datLen);
 /*
  * cli_telnetSend() Telnet send commands, negotiate with telnet peer
  * @sock = socket for communication
  * @attr = send attributes list
  * @nAttr = send attributes list size
  * @data = data for send
  * @datLen = data size
  * @Term = Terminate with GA (Go Ahead), 1 send after data GA command
  * return: 0 not sended commands; -1 error:: can`t send; >0 number of sended bytes
 */
 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
    * @attr = input attribute
    * @code = sub-option code for opt
    * @data = sub-option data
    * @datLen = data size set max size in input, output return copy size
    * return: -1 can`t get option; !=-1 option code
   */
   inline int cli_telnet_Get_SubOpt(struct telnetAttrs *attr, unsigned char *code, 
                   void *data, unsigned char *datLen);
   /*
    * cli_telnet_Set_SubOpt() Telnet set sub option function
    * @attr = output attribute
    * @opt = attribute option
    * @code = sub-option code for opt, if 0xff not specified
    * @data = sub-option data, if NULL not specified
    * @datLen = data size, if 0 not specified
    * return: -1 can`t set sub-otion; 0 ok
   */
   inline int cli_telnet_Set_SubOpt(struct telnetAttrs *attr, unsigned char opt, unsigned char code, 
                   void *data, unsigned char datLen);
   
   /*
    * cli_telnet_GetCmd() Telnet get command
    * @attr = input attribute
    * 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);
   /*
    * cli_telnet_SetCmd() Telnet set command
    * @attr = input attribute
    * @cmd = command
    * @opt = option, if 0xff not specified
    * @arg1 = sub-option code, if 0xff not specified
    * @arg2 = sub-option data, if NULL not specified
    * @arg3 = sub-option data size, if 0 not specified data
    * return: -1 can`t set command; !=-1 ok
   */
   inline int cli_telnet_SetCmd(struct telnetAttrs *attr, unsigned char cmd, unsigned char opt, ...);
   
   /*
    * cli_telnet_Answer() Automatic generate commands answer to send from telnet
    * @caps = Array of capability options
    * @nCaps = number of capability options
    * @attr = input attribute
    * @nAttr = number of input attributes
    * @ans = output answered attributes, must be free() after use
    * @Ans = number of output answered attributes
    * return: -1 can`t answer; !=-1 ok
   */
   int cli_telnet_Answer(unsigned char *caps, int nCaps, struct telnetAttrs *attr, int nAttr, 
                   struct telnetAttrs **ans, int *Ans);
   
   
   // Add capability option, x = 0 false, 1 true
   #define ADD_CAPS(opt, x)        ((opt) | (x) ? 0x80 : 0)
   // Is supported this option ...
   #define SUP_CAPS(caps)          ((caps) & 0x80)
   // get capability option
   #define CAP(caps)               ((caps) & 0x7f)
   
   
 /* CLI Helper functions */  /* CLI Helper functions */
   
 /*  /*
  * cli_Cmd_Unsupported() Builtin helper function for unsupported commands   * cli_Cmd_Unsupported() Builtin helper function for unsupported commands
 * @cmds = Commands list * @buffer = CLI buffer
  * @idx = Selected command ID   * @idx = Selected command ID
  * @out = Output handle  
  * @args = Parsed arguments array   * @args = Parsed arguments array
 * return: -1 error, 0 = ok, 1 exit from Cli! * return: RETCODE_OK ok
 */  */
int cli_Cmd_Unsupported(void *cmds, int idx, FILE *out, char ** __restrict args);int cli_Cmd_Unsupported(void * __restrict buffer, int idx, char ** __restrict args);
 
 
 /* CLI Functions */
 
 /*  /*
 * cli_Cmd_Help() Builtin helper function for Help screen * cli_BindKey() Bind function to key
 * @cmds = Commands list * @key = key structure
 * @idx = Selected command ID * @buffer = CLI buffer
 * @out = Output handle * return: RETCODE_ERR error, RETCODE_OK ok, >0 bind at position
 * @args = Parsed arguments array 
 * return: -1 error, 0 = ok 
 */  */
int cli_Cmd_Help(void *cmds, int idx, FILE *out, char ** __restrict args);int cli_BindKey(bindkey_t * __restrict key, linebuffer_t * __restrict buffer);
 
 
 /*  /*
 * cli_Cmd_Exit() Builtin helper function for Exit from Cli * cli_addCommand() Add command to CLI session
 * @cmds = Commands list * @buffer = CLI buffer
 * @idx = Selected command ID * @csCmd = Command name
 * @out = Output handle * @cliLevel = Level in CLI, -1 unprivi(view from all), 0 main config, 1 sub config ...
 * @args = Parsed arguments array * @funcCmd = Callback function when user call command
 * return: 1 exit from Cli! * @csInfo = Inline information for command
  * @csHelp = Help line when call help
  * return: RETCODE_ERR error, RETCODE_OK ok
 */  */
int cli_Cmd_Exit(void *cmds, int idx, FILE *out, char ** __restrict args);int
 cli_addCommand(linebuffer_t * __restrict buffer, const char *csCmd, int cliLevel, cmd_func_t funcCmd, 
                 const char *csInfo, const char *csHelp);
 /*
  * cli_delCommand() Delete command from CLI session
  * @buffer = CLI buffer
  * @csCmd = Command name
  * @cliLevel = Level in CLI, -1 unprivi(view from all), 0 main config, 1 sub config ...
  * return: RETCODE_ERR error, RETCODE_OK ok
 */
 int
 cli_delCommand(linebuffer_t * __restrict buffer, const char *csCmd, int cliLevel);
 /*
  * cli_updCommand() Update command in CLI session
  * @buffer = CLI buffer
  * @csCmd = Command name
  * @cliLevel = Level in CLI, -1 unprivi(view from all), 0 main config, 1 sub config ...
  * @funcCmd = Callback function when user call command
  * @csInfo = Inline information for command
  * @csHelp = Help line when call help
  * return: RETCODE_ERR error, RETCODE_OK ok
 */
 int
 cli_updCommand(linebuffer_t * __restrict buffer, const char *csCmd, int cliLevel, cmd_func_t funcCmd, 
                 const char *csInfo, const char *csHelp);
   
   
 /*  /*
 * cli_Register_Commands - Declare helper function for register and export Commands variable * cli_addHistory() Add line to history
  * @buffer = CLI buffer
  * @str = Add custom text or if NULL use readed line from CLI buffer
  * return: RETCODE_ERR error, RETCODE_OK ok
 */  */
#define CLI_REGISTER_COMMANDS(CMDS)     \int cli_addHistory(linebuffer_t * __restrict buffer, const char * __restrict str);
        extern commands_t CMDS[]; 
 /*  /*
 * cli_Make_Comp_Commands - Declare helper function for Commands completion arguments * cli_saveHistory() Save history to file
  * @buffer = CLI buffer
  * @histfile = History filename, if NULL will be use default name
  * @lines = Maximum history lines to save
  * return: RETCODE_ERR error, RETCODE_OK ok
 */  */
#define CLI_MAKE_COMP_COMMANDS(FUNC, CMDS)      \int cli_saveHistory(linebuffer_t * __restrict buffer, const char *histfile, int lines);
        char *FUNC(const char *text, int state) \/*
        { \ * cli_loadHistory() Load history from file
                register int i; \ * @buffer = CLI buffer
                int len = strlen(text); \ * @histfile = History filename, if NULL will be use default name
                for (i = state; CMDS[i].cmd_name; i++) { \ * return: RETCODE_ERR error, RETCODE_OK ok
                        if (strncmp(CMDS[i].cmd_name, "---", 3) && \*/
                                        !strncmp(CMDS[i].cmd_name, text, len)) \int cli_loadHistory(linebuffer_t * __restrict buffer, const char *histfile);
                                return strdup(CMDS[i].cmd_name); \/*
                } \ * cli_resetHistory() Reset history search in CLI session
                return NULL; \ * @buffer = CLI buffer
        } * return: none
 */
 inline void cli_resetHistory(linebuffer_t * __restrict buffer);
   
 /*  /*
 * cli_Make_Comp_Args - Declare helper function for Arguments completion * cli_freeLine() Clear entire line
  * @buffer = CLI buffer
  * return: RETCODE_ERR error, RETCODE_OK ok
 */  */
#define CLI_MAKE_COMP_ARGS(FUNC, ARGS)  \inline int cli_freeLine(linebuffer_t * __restrict buffer);
        char *FUNC(const char *text __attribute__((unused)), int state) \/*
        { \ * cli_setPrompt() Set new prompt for CLI session
                while (ARGS[state]) \ * @buffer = CLI buffer
                        return strdup(ARGS[state]); \ * @prompt = new text for prompt or if NULL disable prompt
                return NULL; \ * return: none
        }*/
 inline void cli_setPrompt(linebuffer_t * __restrict buffer, const char *prompt);
 /*
  * cli_Printf() Send message to CLI session
  * @buffer = CLI buffer
  * @fmt = printf format string
  * @... = arguments defined in fmt
  * return: none
 */
 inline void cli_Printf(linebuffer_t * __restrict buffer, char *fmt, ...);
 /*
  * cli_PrintHelp() Print help screen
  * @buffer = CLI buffer
  * return: none
 */
 inline void cli_PrintHelp(linebuffer_t * __restrict buffer);
 
 /*
  * cliEnd() Clear data, Free resources and close CLI session
  * @buffer = CLI buffer
  * return: RETCODE_ERR error, RETCODE_OK ok
 */
 void cliEnd(linebuffer_t * __restrict buffer);
 /*
  * cliInit() Start CLI session, allocate memory for resources and bind keys
  * @fin = Input device handle
  * @fout = Output device handle
  * @prompt = text for prompt, if NULL disable prompt
  * return: NULL if error or !=NULL CLI buffer
 */
 linebuffer_t *cliInit(int fin, int fout, const char *prompt);
 
 /*
  * cliInitLine() Init CLI input line terminal
  * @buffer = CLI buffer
  * return: none
 */
 int cliInitLine(linebuffer_t * __restrict buffer);
 /*
  * cliReadLine() Read line from opened CLI session
  * @buffer = CLI buffer
  * return: NULL if error or !=NULL readed line, must be free after use!
 */
 char *cliReadLine(linebuffer_t * __restrict buffer);
 
 /*
  * cliLoop() CLI main loop
  * @buffer = CLI buffer
  * @csHistFile = History file name
  * return: RETCODE_ERR error, RETCODE_OK ok
 */
 int cliLoop(linebuffer_t * __restrict buffer, const char *csHistFile);
 /*
  * cliNetLoop() CLI network main loop binded to socket
  * @buffer = CLI buffer
  * @csHistFile = History file name
  * @sock = client socket
  * @term = stdin termios
  * @win = window size of tty
  * return: RETCODE_ERR error, RETCODE_OK ok
 */
 int cliNetLoop(linebuffer_t * __restrict buffer, const char *csHistFile, int sock);
   
   
 #endif  #endif
Removed from v.1.2.2.1  
changed lines
  Added in v.1.4

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>