1 #ifndef ACTIONS_H_INCLUDED
2 #define ACTIONS_H_INCLUDED
3 #define ACTIONS_H_VERSION "$Id: actions.h,v 1.12 2002/05/06 07:56:50 oes Exp $"
4 /*********************************************************************
6 * File : $Source: /cvsroot/ijbswa/current/Attic/actions.h,v $
8 * Purpose : Declares functions to work with actions files
9 * Functions declared include: FIXME
11 * Copyright : Written by and Copyright (C) 2001 the SourceForge
12 * Privoxy team. http://www.privoxy.org/
14 * Based on the Internet Junkbuster originally written
15 * by and Copyright (C) 1997 Anonymous Coders and
16 * Junkbusters Corporation. http://www.junkbusters.com
18 * This program is free software; you can redistribute it
19 * and/or modify it under the terms of the GNU General
20 * Public License as published by the Free Software
21 * Foundation; either version 2 of the License, or (at
22 * your option) any later version.
24 * This program is distributed in the hope that it will
25 * be useful, but WITHOUT ANY WARRANTY; without even the
26 * implied warranty of MERCHANTABILITY or FITNESS FOR A
27 * PARTICULAR PURPOSE. See the GNU General Public
28 * License for more details.
30 * The GNU General Public License should be included with
31 * this file. If not, you can view it at
32 * http://www.gnu.org/copyleft/gpl.html
33 * or write to the Free Software Foundation, Inc., 59
34 * Temple Place - Suite 330, Boston, MA 02111-1307, USA.
38 * Revision 1.12 2002/05/06 07:56:50 oes
39 * Made actions_to_html independent of FEATURE_CGI_EDIT_ACTIONS
41 * Revision 1.11 2002/04/30 11:14:52 oes
42 * Made csp the first parameter in *action_to_html
44 * Revision 1.10 2002/04/26 12:53:33 oes
45 * - actions_to_html signature change
46 * - current_action_to_text: renamed to current_action_to_html
47 * and signature change
49 * Revision 1.9 2002/03/26 22:29:54 swa
50 * we have a new homepage!
52 * Revision 1.8 2002/03/24 13:25:43 swa
53 * name change related issues
55 * Revision 1.7 2002/03/16 23:54:06 jongfoster
56 * Adding graceful termination feature, to help look for memory leaks.
57 * If you enable this (which, by design, has to be done by hand
58 * editing config.h) and then go to http://i.j.b/die, then the program
59 * will exit cleanly after the *next* request. It should free all the
60 * memory that was used.
62 * Revision 1.6 2001/10/23 21:30:30 jongfoster
63 * Adding error-checking to selected functions.
65 * Revision 1.5 2001/10/14 21:58:22 jongfoster
66 * Adding support for the CGI-based editor:
67 * - Exported get_actions()
68 * - Added new function free_alias_list()
69 * - Added support for {{settings}} and {{description}} blocks
70 * in the actions file. They are currently ignored.
71 * - Added restriction to only one {{alias}} block which must appear
72 * first in the file, to simplify the editor's rewriting rules.
73 * - Note that load_actions_file() is no longer used by the CGI-based
74 * editor, but some of the other routines in this file are.
76 * Revision 1.4 2001/09/16 15:47:37 jongfoster
77 * First version of CGI-based edit interface. This is very much a
78 * work-in-progress, and you can't actually use it to edit anything
79 * yet. You must #define FEATURE_CGI_EDIT_ACTIONS for these changes
82 * Revision 1.3 2001/09/14 00:17:32 jongfoster
83 * Tidying up memory allocation. New function init_action().
85 * Revision 1.2 2001/07/29 19:01:11 jongfoster
86 * Changed _FILENAME_H to FILENAME_H_INCLUDED.
87 * Added forward declarations for needed structures.
89 * Revision 1.1 2001/05/31 21:16:46 jongfoster
90 * Moved functions to process the action list into this new file.
93 *********************************************************************/
102 struct current_action_spec;
107 /* This structure is used to hold user-defined aliases */
111 struct action_spec action[1];
112 struct action_alias * next;
116 extern jb_err get_actions (char *line,
117 struct action_alias * alias_list,
118 struct action_spec *cur_action);
119 extern void free_alias_list(struct action_alias *alias_list);
121 extern void init_action(struct action_spec *dest);
122 extern void free_action(struct action_spec *src);
123 extern jb_err merge_actions (struct action_spec *dest,
124 const struct action_spec *src);
125 extern jb_err copy_action (struct action_spec *dest,
126 const struct action_spec *src);
127 extern char * actions_to_text (struct action_spec *action);
128 extern char * actions_to_html (struct client_state *csp,
129 struct action_spec *action);
130 extern void init_current_action (struct current_action_spec *dest);
131 extern void free_current_action (struct current_action_spec *src);
132 extern jb_err merge_current_action (struct current_action_spec *dest,
133 const struct action_spec *src);
134 extern char * current_action_to_html(struct client_state *csp,
135 struct current_action_spec *action);
137 extern jb_err get_action_token(char **line, char **name, char **value);
138 extern void unload_actions_file(void *file_data);
139 extern int load_actions_file(struct client_state *csp);
141 #ifdef FEATURE_GRACEFUL_TERMINATION
142 void unload_current_actions_file(void);
146 /* Revision control strings from this header and associated .c file */
147 extern const char actions_rcs[];
148 extern const char actions_h_rcs[];
154 #endif /* ndef ACTIONS_H_INCLUDED */