The klish is a framework for implementing a CISCO-like CLI on a UNIX systems. It is configurable by XML files.
https://src.libcode.org/download/klish/

Serj Kalichev e2341f701f Fix mtime. Don't use 14 anos atrás
aux_scripts dbea28c8c6 Support make with parallel building. Update configure infrastructure 14 anos atrás
bin dbea28c8c6 Support make with parallel building. Update configure infrastructure 14 anos atrás
clish 4b7fdc4d58 Fix unneeded crlf while reading commands from stream. Issue #50. 14 anos atrás
konf 2b8b3f67a5 The script callback can return the output of the executed action. The konf_buf class now use fd instead sock and can return the whole readed line. 14 anos atrás
lub 398ff11b77 Fix enum 14 anos atrás
lubheap c30fc7a7e8 The first klish tree. 14 anos atrás
test c30fc7a7e8 The first klish tree. 14 anos atrás
tinyrl 4b7fdc4d58 Fix unneeded crlf while reading commands from stream. Issue #50. 14 anos atrás
tinyxml c30fc7a7e8 The first klish tree. 14 anos atrás
xml-examples 59c2a15862 Fix IP_ADDR_ANY PTYPE 14 anos atrás
CHANGES 9fa463bd0c Remove CONFIG 'copy' operation. Bugfix release version 1.2.1. 14 anos atrás
ISSUES c30fc7a7e8 The first klish tree. 14 anos atrás
LICENCE 1a9cf520ef Fix many warnings. 14 anos atrás
Makefile.am 1a9cf520ef Fix many warnings. 14 anos atrás
Makefile.in e2341f701f Fix mtime. Don't use 14 anos atrás
README c30fc7a7e8 The first klish tree. 14 anos atrás
aclocal.m4 e2341f701f Fix mtime. Don't use 14 anos atrás
clish.xsd a13d8fe74d Unfinished implementation of the command aliases. 14 anos atrás
config.h.in e2341f701f Fix mtime. Don't use 14 anos atrás
configure e2341f701f Fix mtime. Don't use 14 anos atrás
configure.ac 9a06f2a4a4 Version klish-1.3.1 14 anos atrás
doxygen.config c30fc7a7e8 The first klish tree. 14 anos atrás

README

/**
\mainpage

\section abstract Abstract
A modular framework for implementing a CISCO-like CLI on a *NIX system.
Arbitary command menus and actions can be defined using XML files.
This software handles the user interaction, and forks the appropriate system
commands to perform any actions.

- \ref _licence_page
- \ref _changes_page
- \ref _issues_page

\section downloads Downloads
This project is hosted on
sourceforge. from where
the source-code can be downloaded.

\section background Background
The CISCO-like CLI has become a de-facto standard in the domain of network
devices. It is a much more restricted interface than traditional *NIX shells,
hence is simpler to use and inherently more secure. As more devices move to
using an embedded *NIX operating systems, a simple, scalable means of producing
such a CLI becomes valuable.

\section existing Existing Solutions

\subsection Libcli
Libcli
provides a similar facility but has the following main limitations:-

1) In order to add new commands a monolithic executable (which uses the
library) needs to be recompiled, after editing the source code to add the
newly required commands and actions.

2) libcli takes responsiblity for attaching to a socket (telnet-like). This
limits the usage of the CLI; difficult to use over SSH for example, similarly
cannot get the menus directly from an existing shell.

3) The implementation of the command actions is hard-linked into the monolithic
executable, this can cause licence concerns/issues when a commercial company
wishes to control proprietry software from within the CLI.

4) libcli takes responsiblity for the authentication of the user. This is
different from other "shells" which do not deal with authentication, but are
simply spawned as the required user.

\subsection GNU-zebra
Zebra
is a routing package, and comes with it's own integrated CLI, to handle its
configuration (VTYSH).

\section project CLISH Project
The project is written (mostly) in ANSI-C and provides two example executables
which can be used as a drop-in replacement for a more conventional "shell".

The software was initially developed as part of some internal work at 3Com and
due to the dependancy on 3rd party open-source packages, and it's self contained
nature, it is being released into the public domain.

It is designed to run on any *NIX system e.g. Linux, BSD, Cygwin and makes use
of the following other opensource packages (glibc,tinyxml,doxygen)

\subsection clish clish (pronounced see-lish)
This application is a standard UNIX shell replacement. The ACTION tags in the XML
specification are mapped to the system() call and hence will be interpreted as
a Bourne-shell script.

\subsection tclish tclish (pronounced tickle-ish)
This application is built if the TCL libraries are present on the build system.
The name of the executable produced will reflect the version of TCL used. e.g.
tclish8.4 will be generated if TCL8.4 is present on the system.

This application will spawn a TCL interpreter when started, and the contents of
the ACTION tags will be interpreted as TCL scripts within that interpreter for
the duration of the shell.

\subsection Features
The "clish" shell has the following features:-

- Provides CLI tree handling facilities
- Tree built from multiple XML encoded files. (uses tinyxml)
This means that XML configuration files can be be made part of
3rd party packages and simply installing them integrates
commands into the CLI.

- Access permissions are defined as part of the CLI tree definition; a CLI
node/branch may be limited to a specific *NIX group.

- Provides interface to user
- Handles auto-completion of commands
- Only appropriate commands for the current user's "group" will be
available.
- Provides parameter type verification facility
* Each parameter may be of a specific type, which the
framework will ensure is correctly entered by the user.
- Provides key-handling for the interface (uses tinyrl)
* Provides command line editing facilities
* up/down arrow keys
* [TAB] command completion
* [CTRL-A] move to start of command line
* [?] provides context sensitive help.

- Able to be launched non-interactively
- textual scripts can be written to drive the CLI

- Executes a specified CLI command by launching the appropriate
(as defined in the CLI tree) system command line to perform the
required action
- Only commands permitted for the current user are available.
- During execution the I/O streams are handed over to the new
program.
- Able to spawn a 3rd party shell, where necessary
This will take over control of the I/O channel until that
sub-shell exits.


"clish" makes use of multiple XML files to define it's behaviour these...

- Identify scope of the commands (global or specific view(s))

- Include access permissions. By default a command will be
accessible to all users, but the schema will provide
the ability to limit the command based on UNIX group membership.

- Includes help text for menus

- Includes parameter definitions (with types where appropriate)

- Includes prompt modifications (different views)

- Includes full command line which each leaf node should execute
to achieve result.

- Separate set of files for each localization (language) can be
provided and determined by the user logging in.

- "packages" can contribute files to define their facilities
within the CLI; this makes augmentation of the CLI as simple
as including/excluding a particular package.

\section example xml-example directory

\include README

Some of the example files are put here for reference:

\subsection global_xml global-command.xml
\include global-commands.xml

\subsection startup_xml startup.xml
\include startup.xml

\subsection types_xml types.xml
\include types.xml

\subsection debug_xml debug-view.xml
\include debug-view.xml

*/