src/session/session.h

   1 #ifndef EL__SESSION_SESSION_H
   2 #define EL__SESSION_SESSION_H
   3
   4 #include "bfu/dialog.h"
   5 #include "cache/cache.h"
   6 #include "main/timer.h" /* timer_id_T */
   7 #include "network/state.h"
   8 #include "session/download.h"
   9 #include "session/history.h"
  10 #include "util/lists.h"
  11 #include "viewer/text/vs.h"
  12
  13 struct document_view;
  14 struct link;
  15 struct location;
  16 struct session_status;
  17 struct term_event;
  18 struct terminal_info;
  19 struct terminal;
  20 struct uri;
  21 struct window;
  22
  23 /* Used by delayed_open and delayed_goto_uri_frame. */
  24 struct delayed_open {
  25         struct session *ses;
  26         struct uri *uri;
  27         unsigned char *target;
  28 };
  29
  30 enum remote_session_flags {
  31         SES_REMOTE_NEW_TAB = 1,
  32         SES_REMOTE_NEW_WINDOW = 2,
  33         SES_REMOTE_CURRENT_TAB = 4,
  34         SES_REMOTE_PROMPT_URL = 8,
  35         SES_REMOTE_PING = 16,
  36         SES_REMOTE_ADD_BOOKMARK = 32,
  37         SES_REMOTE_INFO_BOX = 64,
  38 };
  39
  40 /* This is generic frame descriptor, meaningful mainly for ses_*_frame*(). */
  41 struct frame {
  42         LIST_HEAD(struct frame);
  43
  44         unsigned char *name;
  45         int redirect_cnt;
  46
  47         struct view_state vs;
  48 };
  49
  50 /* Use for keyboard prefixes. */
  51 struct kbdprefix {
  52         /* This is the repeat count being inserted by user so far. It is stored
  53          * intermediately per-session. */
  54         int repeat_count;
  55
  56 #ifdef CONFIG_MARKS
  57         /* If the previous key was a mark prefix, this describes what kind of
  58          * action are we supposed to do when we receive the next key. */
  59         enum { KP_MARK_NOTHING, KP_MARK_SET, KP_MARK_GOTO } mark;
  60 #endif
  61 };
  62
  63 struct session;
  64
  65 /* This describes, what are we trying to do right now. We pass this around so
  66  * that we can use generic scheduler routines and when the control will get
  67  * back to our subsystem, we will know what are we up to. */
  68 enum task_type {
  69         TASK_NONE,
  70         TASK_FORWARD,
  71         TASK_IMGMAP,
  72         TASK_RELOAD,
  73         TASK_HISTORY,
  74 };
  75
  76 struct session_task {
  77         enum task_type type;
  78         /* TODO: union --pasky */
  79         struct {
  80                 unsigned char *frame;
  81                 struct location *location;
  82         } target;
  83 };
  84
  85 struct session_status {
  86         unsigned int show_tabs_bar:1;
  87         unsigned int show_status_bar:1;
  88         unsigned int show_title_bar:1;
  89
  90         int force_show_status_bar:2;
  91         int force_show_title_bar:2;
  92
  93         unsigned int set_window_title:1;
  94         unsigned char *last_title;
  95 #ifdef CONFIG_ECMASCRIPT
  96         unsigned char *window_status;
  97 #endif
  98
  99 #ifdef CONFIG_LEDS
 100         unsigned int show_leds:1;
 101         struct led_panel leds;
 102         struct led *ssl_led;
 103         struct led *insert_mode_led;
 104         struct led *ecmascript_led;
 105         struct led *popup_led;
 106 #endif
 107         /* Has the tab been visited yet. */
 108         unsigned int visited:1;
 109
 110         /* Is processing file requests. */
 111         unsigned int processing_file_requests:1;
 112         unsigned int show_tabs_bar_at_top:1;
 113 };
 114
 115 enum insert_mode {
 116         INSERT_MODE_LESS,
 117         INSERT_MODE_ON,
 118         INSERT_MODE_OFF,
 119 };
 120
 121 enum navigate_mode {
 122         NAVIGATE_LINKWISE,
 123         NAVIGATE_CURSOR_ROUTING,
 124 };
 125
 126 /* This is one of the building stones of ELinks architecture --- this structure
 127  * carries information about the specific ELinks session. Each tab (thus, at
 128  * least one per terminal, in the normal case) has its own session. Session
 129  * describes mainly the current browsing and control state, from the currently
 130  * viewed document through the browsing history of this session to the status
 131  * bar information. */
 132 struct session {
 133         LIST_HEAD(struct session);
 134
 135
 136         /* The vital session data */
 137
 138         struct window *tab;
 139
 140
 141         /* Browsing history */
 142
 143         struct ses_history history;
 144
 145
 146         /* The current document */
 147
 148         struct list_head more_files; /* -> struct file_to_load */
 149
 150         struct download loading;
 151         struct uri *loading_uri;
 152
 153         enum cache_mode reloadlevel;
 154         int redirect_cnt;
 155
 156         struct document_view *doc_view;
 157         struct list_head scrn_frames; /* -> struct document_view */
 158
 159         struct uri *download_uri;
 160
 161         /* The URI which is the referrer to the current loaded document or NULL
 162          * if there are no referrer. */
 163         /* The @referrer members sole purpose is to have the information handy
 164          * when loading URIs. It is not 'filtered' in anyway at this level only
 165          * at the lower ones. */
 166         struct uri *referrer;
 167
 168
 169         /* The current action-in-progress selector */
 170
 171         struct session_task task;
 172
 173
 174         /* The current browsing state */
 175
 176         int search_direction;
 177         struct kbdprefix kbdprefix;
 178         int exit_query;
 179         timer_id_T display_timer;
 180
 181         /* The text input form insert mode. It is a tristate controlled by the
 182          * boolean document.browse.forms.insert_mode option. When disabled we
 183          * use mode less insertion and we always insert stuff into the text
 184          * input field. When enabled it is possible to switch insertion on and
 185          * off using ACT_EDIT_ENTER and *_CANCEL. */
 186         enum insert_mode insert_mode;
 187
 188         enum navigate_mode navigate_mode;
 189
 190         unsigned char *search_word;
 191         unsigned char *last_search_word;
 192
 193
 194         /* The possibly running type queries (what-to-do-with-that-file?) */
 195         struct list_head type_queries; /* -> struct type_query */
 196
 197         /* The info for status displaying */
 198         struct session_status status;
 199 };
 200
 201 extern struct list_head sessions; /* -> struct session */
 202 extern enum remote_session_flags remote_session_flags;
 203
 204 /* This returns a pointer to the current location inside of the given session.
 205  * That's nice for encapsulation and alrady paid out once ;-). */
 206 #define cur_loc(x) ((x)->history.current)
 207
 208 /* Return if we have anything being loaded in this session already. */
 209 static inline int
 210 have_location(struct session *ses) {
 211         return !!cur_loc(ses);
 212 }
 213
 214 /* Swaps the current session referrer with the new one passed as @referrer */
 215 /* @referrer may be NULL */
 216 void set_session_referrer(struct session *ses, struct uri *referrer);
 217
 218 void
 219 print_error_dialog(struct session *ses, enum connection_state state,
 220                    struct uri *uri, enum connection_priority priority);
 221
 222 void process_file_requests(struct session *);
 223
 224 struct string *encode_session_info(struct string *info, struct list_head *url_list);
 225
 226 /* Returns zero if the info was remote sessions or if it failed to create any
 227  * sessions. */
 228 int decode_session_info(struct terminal *term, struct terminal_info *info);
 229
 230 /* Registers a base session and returns it's id. Value <= 0 means error. */
 231 int
 232 add_session_info(struct session *ses, struct uri *uri, struct uri *referrer,
 233                  enum cache_mode cache_mode, enum task_type task);
 234
 235 void done_saved_session_info(void);
 236
 237 struct session *init_session(struct session *ses, struct terminal *term,
 238              struct uri *uri, int in_background);
 239
 240 void doc_loading_callback(struct download *, struct session *);
 241
 242 void abort_loading(struct session *, int);
 243 void reload(struct session *, enum cache_mode);
 244 void load_frames(struct session *, struct document_view *);
 245
 246 struct frame *ses_find_frame(struct session *, unsigned char *);
 247
 248 void free_files(struct session *);
 249 void display_timer(struct session *ses);
 250
 251 /* session_is_loading() is like !!get_current_download() but doesn't take
 252  * @req_sent into account. */
 253 struct download *get_current_download(struct session *ses);
 254 int session_is_loading(struct session *ses);
 255
 256 /* Information about the current document */
 257 unsigned char *get_current_url(struct session *, unsigned char *, size_t);
 258 unsigned char *get_current_title(struct session *, unsigned char *, size_t);
 259
 260 struct link *get_current_session_link(struct session *ses);
 261 struct link *get_current_link_in_view(struct document_view *doc_view);
 262 unsigned char *get_current_link_url(struct session *, unsigned char *, size_t);
 263 unsigned char *get_current_link_name(struct session *, unsigned char *, size_t);
 264
 265 extern struct list_head questions_queue;
 266 void add_questions_entry(void (*callback)(struct session *, void *), void *data);
 267 void check_questions_queue(struct session *ses);
 268
 269 unsigned char *get_homepage_url(void);
 270
 271 /* Returns current keyboard repeat count and reset it. */
 272 int eat_kbd_repeat_count(struct session *ses);
 273
 274 #endif