lws-plugin-ssh.h

/*
 * libwebsockets - lws-plugin-ssh-base
 *
 * Copyright (C) 2017 Andy Green <andy@warmcat.com>
 *
 *  This library is free software; you can redistribute it and/or
 *  modify it under the terms of the GNU Lesser General Public
 *  License as published by the Free Software Foundation:
 *  version 2.1 of the License.
 *
 *  This library is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 *  Lesser General Public License for more details.
 *
 *  You should have received a copy of the GNU Lesser General Public
 *  License along with this library; if not, write to the Free Software
 *  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
 *  MA  02110-1301  USA
 */

#if !defined(__LWS_PLUGIN_SSH_H__)
#define __LWS_PLUGIN_SSH_H__

#define LWS_CALLBACK_SSH_UART_SET_RXFLOW (LWS_CALLBACK_USER + 800)

#define LWS_SSH_OPS_VERSION 1

struct lws_ssh_pty {
        char term[16];
        char *modes;
        uint32_t width_ch;
        uint32_t height_ch;
        uint32_t width_px;
        uint32_t height_px;
        uint32_t modes_len;
};

#define SSHMO_TTY_OP_END 0 /* Indicates end of options. */
#define SSHMO_VINTR      1 /* Interrupt character; 255 if none.  Similarly
                            * for the other characters.  Not all of these
                            * characters are supported on all systems. */
#define SSHMO_VQUIT      2 /* The quit character (sends SIGQUIT signal on
                            * POSIX systems). */
#define SSHMO_VERASE     3 /* Erase the character to left of the cursor. */
#define SSHMO_VKILL      4 /* Kill the current input line. */
#define SSHMO_VEOF       5 /* End-of-file character (sends EOF from the
                            * terminal). */
#define SSHMO_VEOL       6 /* End-of-line character in addition to
                            * carriage return and/or linefeed. */
#define SSHMO_VEOL2      7 /* Additional end-of-line character. */
#define SSHMO_VSTART     8 /* Continues paused output (normally
                            * control-Q). */
#define SSHMO_VSTOP      9 /* Pauses output (normally control-S). */
#define SSHMO_VSUSP     10 /* Suspends the current program. */
#define SSHMO_VDSUSP    11 /* Another suspend character. */
#define SSHMO_VREPRINT  12 /* Reprints the current input line. */
#define SSHMO_VWERASE   13 /* Erases a word left of cursor. */
#define SSHMO_VLNEXT    14 /* Enter the next character typed literally,
                            * even if it is a special character */
#define SSHMO_VFLUSH    15 /* Character to flush output. */
#define SSHMO_VSWTCH    16 /* Switch to a different shell layer. */
#define SSHMO_VSTATUS   17 /* Prints system status line (load, command,
                            * pid, etc). */
#define SSHMO_VDISCARD  18 /* Toggles the flushing of terminal output. */
#define SSHMO_IGNPAR    30 /* The ignore parity flag.  The parameter
                            * SHOULD be 0 if this flag is FALSE,
                            * and 1 if it is TRUE. */
#define SSHMO_PARMRK    31 /* Mark parity and framing errors. */
#define SSHMO_INPCK     32 /* Enable checking of parity errors. */
#define SSHMO_ISTRIP    33 /* Strip 8th bit off characters. */
#define SSHMO_INLCR     34 /* Map NL into CR on input. */
#define SSHMO_IGNCR     35 /* Ignore CR on input. */
#define SSHMO_ICRNL     36 /* Map CR to NL on input. */
#define SSHMO_IUCLC     37 /* Translate uppercase characters to lowercase. */
#define SSHMO_IXON      38 /* Enable output flow control. */
#define SSHMO_IXANY     39 /* Any char will restart after stop. */
#define SSHMO_IXOFF     40 /* Enable input flow control. */
#define SSHMO_IMAXBEL   41 /* Ring bell on input queue full. */
#define SSHMO_ISIG      50 /* Enable signals INTR, QUIT, [D]SUSP. */
#define SSHMO_ICANON    51 /* Canonicalize input lines. */
#define SSHMO_XCASE     52 /* Enable input and output of uppercase
                            * characters by preceding their lowercase
                            * equivalents with "\". */
#define SSHMO_ECHO      53 /* Enable echoing. */
#define SSHMO_ECHOE     54 /* Visually erase chars. */
#define SSHMO_ECHOK     55 /* Kill character discards current line. */
#define SSHMO_ECHONL    56 /* Echo NL even if ECHO is off. */
#define SSHMO_NOFLSH    57 /* Don't flush after interrupt. */
#define SSHMO_TOSTOP    58 /* Stop background jobs from output. */
#define SSHMO_IEXTEN    59 /* Enable extensions. */
#define SSHMO_ECHOCTL   60 /* Echo control characters as ^(Char). */
#define SSHMO_ECHOKE    61 /* Visual erase for line kill. */
#define SSHMO_PENDIN    62 /* Retype pending input. */
#define SSHMO_OPOST     70 /* Enable output processing. */
#define SSHMO_OLCUC     71 /* Convert lowercase to uppercase. */
#define SSHMO_ONLCR     72 /* Map NL to CR-NL. */
#define SSHMO_OCRNL     73 /* Translate carriage return to newline (out). */
#define SSHMO_ONOCR     74 /* Translate newline to CR-newline (out). */
#define SSHMO_ONLRET    75 /* Newline performs a carriage return (out). */
#define SSHMO_CS7       90 /* 7 bit mode. */
#define SSHMO_CS8       91 /* 8 bit mode. */
#define SSHMO_PARENB    92 /* Parity enable. */
#define SSHMO_PARODD    93 /* Odd parity, else even. */
#define SSHMO_TTY_OP_ISPEED     128 /* Specifies the input baud rate in
                                     * bits per second. */
#define SSHMO_TTY_OP_OSPEED     129 /* Specifies the output baud rate in
                                     * bits per second. */


struct lws_ssh_ops {
        int (*channel_create)(struct lws *wsi, void **priv);

        int (*channel_destroy)(void *priv);

        int (*rx)(void *priv, struct lws *wsi, const uint8_t *buf, uint32_t len);

        int (*tx_waiting)(void *priv);

        size_t (*tx)(void *priv, int stdch, uint8_t *buf, size_t len);

        size_t (*get_server_key)(struct lws *wsi, uint8_t *buf, size_t len);

        size_t (*set_server_key)(struct lws *wsi, uint8_t *buf, size_t len);

        int (*set_env)(void *priv, const char *name, const char *value);

        int (*exec)(void *priv, struct lws *wsi, const char *command);

        int (*shell)(void *priv, struct lws *wsi);

        int (*pty_req)(void *priv, struct lws_ssh_pty *pty);

        int (*child_process_io)(void *priv, struct lws *wsi,
                                struct lws_cgi_args *args);

        int (*child_process_terminated)(void *priv, struct lws *wsi);

        void (*disconnect_reason)(uint32_t reason, const char *desc,
                                  const char *desc_lang);

        int (*is_pubkey_authorized)(const char *username,
                        const char *type, const uint8_t *peer, int peer_len);

        size_t (*banner)(char *buf, size_t max_len, char *lang,
                         size_t max_lang_len);

        const char *server_string;

        char api_version;
};

#endif