tree exported from hnb

- the commandline interpreter (cli) used was developed specifically for this application, but it is made not in any way dependant on any other thing than c.
- programming with libcli

- adding commands and variables

- adding a command to the interpreter is done by issuing the macro
- cli_add_command("commandname", callback, "description");
- where callback is a function of the form
- int callback(char *params);
- the string passed to the callback is the string remaining when the command is chopped of the commandline
- variables can be added with either
- cli_add_int("variablename", &integer_variable, "description");
- cli_add_string("variablename", &string_variable, "description");
- or by calling the real add function
- cli_add_item("variablename", &integerdata, &stringdata, callback, "description");
- the callback will be issued whenever the variable is set, a variable can have both integer and string attached at the same time

- running commands

- when issuing cli_docmd("commandline") the interpreter will run the commandline and return with the value given to the callback function assosicated
- this function is usually wrapped up in a macro making it possible to use printf style formatting
- #define docmdf(args...) \

- do{ char buf[100];\
- snprintf (buf, 99, args);\
- cli_docmd(buf);\
- }while(0)

- commandline completion

- char *cli_complete(const char *commandline);
- returns a completion fo the given commandline.
- the string returned is statically allocated
- if there is no match a message is printed on the output
- if there is multiple matches the matches are listed on the output, and the commandline is expanded in such a manner that it rquals the first characters

- customisation

- by default cli outputs to standard output, when embedding it in an application this is often not what you want.
- cli_outfun can be assigned a void functino that takes a string as parameter
- cli_width should be assigned the width in characters of the output device
- cli_precmd can be assigned a void function taking the commandline as a parameter to be executed before each command
- cli_postcmd can be assigned a void function taking the commandline as a parameter to be executed after each command

- history

- libcli also provides a simple history facility
- if you call cli_history_add("commandline"); for every function you execute,
- char *cli_historyprev();
- and
- char *cli_historynext();
- will allow you to page back and forward in the history