private.h 4.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137
  1. /*
  2. * shell.h - private interface to the shell class
  3. */
  4. #include "clish/shell.h"
  5. #include "clish/pargv.h"
  6. #include "clish/variable.h"
  7. #include "lub/bintree.h"
  8. #include "tinyrl/tinyrl.h"
  9. /*-------------------------------------
  10. * PRIVATE TYPES
  11. *------------------------------------- */
  12. /*-------------------------------------------------------- */
  13. /*
  14. * The context structure is used to simplify the cleanup of
  15. * a CLI session when a thread is cancelled.
  16. */
  17. struct clish_context_s {
  18. pthread_t pthread;
  19. const clish_shell_hooks_t *hooks;
  20. void *cookie;
  21. FILE *istream;
  22. FILE *ostream;
  23. clish_shell_t *shell;
  24. clish_pargv_t *pargv;
  25. char *prompt;
  26. };
  27. typedef enum {
  28. SHELL_STATE_INITIALISING,
  29. SHELL_STATE_READY,
  30. SHELL_STATE_HELPING,
  31. SHELL_STATE_SCRIPT_ERROR,
  32. SHELL_STATE_CLOSING
  33. } shell_state_t;
  34. /*
  35. * iterate around commands
  36. */
  37. typedef struct {
  38. const char *last_cmd;
  39. clish_nspace_visibility_t field;
  40. } clish_shell_iterator_t;
  41. /* this is used to maintain a stack of file handles */
  42. typedef struct clish_shell_file_s clish_shell_file_t;
  43. struct clish_shell_file_s {
  44. clish_shell_file_t *next;
  45. FILE *file;
  46. bool_t stop_on_error; /* stop on error for file input */
  47. };
  48. struct clish_shell_s {
  49. lub_bintree_t view_tree; /* Maintain a tree of views */
  50. lub_bintree_t ptype_tree; /* Maintain a tree of ptypes */
  51. const clish_shell_hooks_t *client_hooks; /* Client callback hooks */
  52. void *client_cookie; /* Client callback cookie */
  53. clish_view_t *global; /* Reference to the global view. */
  54. clish_view_t *view; /* Reference to the current view. */
  55. clish_command_t *startup; /* This is the startup command */
  56. clish_shell_iterator_t iter; /* used for iterating commands */
  57. shell_state_t state; /* The current state */
  58. char *overview; /* Overview text for this shell. */
  59. char *viewid; /* The current view ID string */
  60. tinyrl_t *tinyrl; /* Tiny readline instance */
  61. clish_shell_file_t *current_file; /* file currently in use for input */
  62. char **cfg_pwdv; /* Levels for the config file structure */
  63. unsigned cfg_pwdc;
  64. konf_client_t *client;
  65. clish_pargv_t *completion_pargv;
  66. unsigned completion_index;
  67. unsigned completion_pindex;
  68. };
  69. /**
  70. * Initialise a command iterator structure
  71. */
  72. void
  73. clish_shell_iterator_init(clish_shell_iterator_t * iter,
  74. clish_nspace_visibility_t field);
  75. /**
  76. * get the next command which is an extension of the specified line
  77. */
  78. const clish_command_t *clish_shell_find_next_completion(const clish_shell_t *
  79. instance,
  80. const char *line,
  81. clish_shell_iterator_t *
  82. iter);
  83. /**
  84. * Push the specified file handle on to the stack of file handles
  85. * for this shell. The specified file will become the source of
  86. * commands, until it is exhausted.
  87. *
  88. * \return
  89. * BOOL_TRUE - the file was successfully associated with the shell.
  90. * BOOL_FALSE - there was insufficient resource to associate this file.
  91. */
  92. bool_t
  93. clish_shell_push_file(clish_shell_t * instance,
  94. FILE * file, bool_t stop_on_error);
  95. /**
  96. * Pop the current file handle from the stack of file handles, shutting
  97. * the file down and freeing any associated memory. The next file handle
  98. * in the stack becomes associated with the input stream for this shell.
  99. *
  100. * \return
  101. * BOOL_TRUE - the current file handle has been replaced.
  102. * BOOL_FALSE - there is only one handle on the stack which cannot be replaced.
  103. */
  104. bool_t clish_shell_pop_file(clish_shell_t * instance);
  105. clish_view_t *clish_shell_find_view(clish_shell_t * instance, const char *name);
  106. void clish_shell_insert_view(clish_shell_t * instance, clish_view_t * view);
  107. clish_pargv_status_t
  108. clish_shell_parse(const clish_shell_t * instance,
  109. const char *line,
  110. const clish_command_t ** cmd, clish_pargv_t ** pargv);
  111. char *clish_shell_word_generator(clish_shell_t * instance,
  112. const char *line,
  113. unsigned offset, unsigned state);
  114. const clish_command_t *clish_shell_resolve_command(const clish_shell_t *
  115. instance, const char *line);
  116. const clish_command_t *clish_shell_resolve_prefix(const clish_shell_t *
  117. instance, const char *line);
  118. const clish_command_t *clish_shell_getfirst_command(clish_shell_t * instance,
  119. const char *line,
  120. clish_nspace_visibility_t
  121. field);
  122. const clish_command_t *clish_shell_getnext_command(clish_shell_t * instance,
  123. const char *line);
  124. void clish_shell_insert_ptype(clish_shell_t * instance, clish_ptype_t * ptype);
  125. void clish_shell_tinyrl_history(clish_shell_t * instance, unsigned int *limit);
  126. tinyrl_t *clish_shell_tinyrl_new(FILE * instream,
  127. FILE * outstream, unsigned stifle);
  128. void clish_shell_tinyrl_delete(tinyrl_t * instance);