1
0

private.h 4.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143
  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. typedef struct {
  49. char *line;
  50. clish_view_t *view;
  51. char *viewid;
  52. } clish_shell_pwd_t;
  53. struct clish_shell_s {
  54. lub_bintree_t view_tree; /* Maintain a tree of views */
  55. lub_bintree_t ptype_tree; /* Maintain a tree of ptypes */
  56. const clish_shell_hooks_t *client_hooks; /* Client callback hooks */
  57. void *client_cookie; /* Client callback cookie */
  58. clish_view_t *global; /* Reference to the global view. */
  59. clish_view_t *view; /* Reference to the current view. */
  60. clish_command_t *startup; /* This is the startup command */
  61. clish_shell_iterator_t iter; /* used for iterating commands */
  62. shell_state_t state; /* The current state */
  63. char *overview; /* Overview text for this shell. */
  64. char *viewid; /* The current view ID string */
  65. tinyrl_t *tinyrl; /* Tiny readline instance */
  66. clish_shell_file_t *current_file; /* file currently in use for input */
  67. clish_shell_pwd_t **cfg_pwdv; /* Levels for the config file structure */
  68. unsigned cfg_pwdc;
  69. konf_client_t *client;
  70. clish_pargv_t *completion_pargv;
  71. unsigned completion_index;
  72. unsigned completion_pindex;
  73. };
  74. /**
  75. * Initialise a command iterator structure
  76. */
  77. void
  78. clish_shell_iterator_init(clish_shell_iterator_t * iter,
  79. clish_nspace_visibility_t field);
  80. /**
  81. * get the next command which is an extension of the specified line
  82. */
  83. const clish_command_t *clish_shell_find_next_completion(const clish_shell_t *
  84. instance,
  85. const char *line,
  86. clish_shell_iterator_t *
  87. iter);
  88. /**
  89. * Push the specified file handle on to the stack of file handles
  90. * for this shell. The specified file will become the source of
  91. * commands, until it is exhausted.
  92. *
  93. * \return
  94. * BOOL_TRUE - the file was successfully associated with the shell.
  95. * BOOL_FALSE - there was insufficient resource to associate this file.
  96. */
  97. bool_t
  98. clish_shell_push_file(clish_shell_t * instance,
  99. FILE * file, bool_t stop_on_error);
  100. /**
  101. * Pop the current file handle from the stack of file handles, shutting
  102. * the file down and freeing any associated memory. The next file handle
  103. * in the stack becomes associated with the input stream for this shell.
  104. *
  105. * \return
  106. * BOOL_TRUE - the current file handle has been replaced.
  107. * BOOL_FALSE - there is only one handle on the stack which cannot be replaced.
  108. */
  109. bool_t clish_shell_pop_file(clish_shell_t * instance);
  110. clish_view_t *clish_shell_find_view(clish_shell_t * instance, const char *name);
  111. void clish_shell_insert_view(clish_shell_t * instance, clish_view_t * view);
  112. clish_pargv_status_t
  113. clish_shell_parse(const clish_shell_t * instance,
  114. const char *line,
  115. const clish_command_t ** cmd, clish_pargv_t ** pargv);
  116. char *clish_shell_word_generator(clish_shell_t * instance,
  117. const char *line,
  118. unsigned offset, unsigned state);
  119. const clish_command_t *clish_shell_resolve_command(const clish_shell_t *
  120. instance, const char *line);
  121. const clish_command_t *clish_shell_resolve_prefix(const clish_shell_t *
  122. instance, const char *line);
  123. const clish_command_t *clish_shell_getfirst_command(clish_shell_t * instance,
  124. const char *line,
  125. clish_nspace_visibility_t
  126. field);
  127. const clish_command_t *clish_shell_getnext_command(clish_shell_t * instance,
  128. const char *line);
  129. void clish_shell_insert_ptype(clish_shell_t * instance, clish_ptype_t * ptype);
  130. void clish_shell_tinyrl_history(clish_shell_t * instance, unsigned int *limit);
  131. tinyrl_t *clish_shell_tinyrl_new(FILE * instream,
  132. FILE * outstream, unsigned stifle);
  133. void clish_shell_tinyrl_delete(tinyrl_t * instance);