cmd: Avoid duplication of commonly used strings.
[wine] / programs / cmd / wcmd.h
1 /*
2  * CMD - Wine-compatible command line interface.
3  *
4  * Copyright (C) 1999 D A Pickles
5  * Copyright (C) 2007 J Edmeades
6  *
7  * This library is free software; you can redistribute it and/or
8  * modify it under the terms of the GNU Lesser General Public
9  * License as published by the Free Software Foundation; either
10  * version 2.1 of the License, or (at your option) any later version.
11  *
12  * This library is distributed in the hope that it will be useful,
13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
15  * Lesser General Public License for more details.
16  *
17  * You should have received a copy of the GNU Lesser General Public
18  * License along with this library; if not, write to the Free Software
19  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
20  */
21
22 #define IDI_ICON1       1
23 #include <windows.h>
24 #include <windef.h>
25 #ifndef RC_INVOKED
26 #include <string.h>
27 #include <stdlib.h>
28 #include <stdarg.h>
29 #include <stdio.h>
30 #include <ctype.h>
31 #include <wine/unicode.h>
32
33 /* Data structure to hold commands delimitors/separators */
34
35 typedef enum _CMDdelimiters {
36   CMD_NONE,        /* End of line or single & */
37   CMD_ONFAILURE,   /* ||                      */
38   CMD_ONSUCCESS,   /* &&                      */
39   CMD_PIPE         /* Single |                */
40 } CMD_DELIMITERS;
41
42 /* Data structure to hold commands to be processed */
43
44 typedef struct _CMD_LIST {
45   WCHAR              *command;     /* Command string to execute                */
46   WCHAR              *redirects;   /* Redirects in place                       */
47   struct _CMD_LIST   *nextcommand; /* Next command string to execute           */
48   CMD_DELIMITERS      prevDelim;   /* Previous delimiter                       */
49   int                 bracketDepth;/* How deep bracketing have we got to       */
50   WCHAR               pipeFile[MAX_PATH]; /* Where to get input from for pipes */
51 } CMD_LIST;
52
53 void WCMD_assoc (const WCHAR *, BOOL);
54 void WCMD_batch (WCHAR *, WCHAR *, int, WCHAR *, HANDLE);
55 void WCMD_call (WCHAR *command);
56 void WCMD_change_tty (void);
57 void WCMD_choice (const WCHAR *);
58 void WCMD_clear_screen (void);
59 void WCMD_color (void);
60 void WCMD_copy (void);
61 void WCMD_create_dir (WCHAR *);
62 BOOL WCMD_delete (WCHAR *);
63 void WCMD_directory (WCHAR *);
64 void WCMD_echo (const WCHAR *);
65 void WCMD_endlocal (void);
66 void WCMD_enter_paged_mode(const WCHAR *);
67 void WCMD_exit (CMD_LIST **cmdList);
68 void WCMD_for (WCHAR *, CMD_LIST **cmdList);
69 void WCMD_give_help (const WCHAR *command);
70 void WCMD_goto (CMD_LIST **cmdList);
71 void WCMD_if (WCHAR *, CMD_LIST **cmdList);
72 void WCMD_leave_paged_mode(void);
73 void WCMD_more (WCHAR *);
74 void WCMD_move (void);
75 void WCMD_output (const WCHAR *format, ...);
76 void WCMD_output_stderr (const WCHAR *format, ...);
77 void WCMD_output_asis (const WCHAR *message);
78 void WCMD_output_asis_stderr (const WCHAR *message);
79 void WCMD_pause (void);
80 void WCMD_popd (void);
81 void WCMD_print_error (void);
82 void WCMD_pushd (const WCHAR *command);
83 void WCMD_remove_dir (WCHAR *command);
84 void WCMD_rename (void);
85 void WCMD_run_program (WCHAR *command, int called);
86 void WCMD_setlocal (const WCHAR *command);
87 void WCMD_setshow_date (void);
88 void WCMD_setshow_default (const WCHAR *command);
89 void WCMD_setshow_env (WCHAR *command);
90 void WCMD_setshow_path (const WCHAR *command);
91 void WCMD_setshow_prompt (void);
92 void WCMD_setshow_time (void);
93 void WCMD_shift (const WCHAR *command);
94 void WCMD_title (const WCHAR *);
95 void WCMD_type (WCHAR *);
96 void WCMD_verify (const WCHAR *command);
97 void WCMD_version (void);
98 int  WCMD_volume (BOOL set_label, const WCHAR *command);
99
100 static inline BOOL WCMD_is_console_handle(HANDLE h)
101 {
102     return (((DWORD_PTR)h) & 3) == 3;
103 }
104 WCHAR *WCMD_fgets (WCHAR *buf, DWORD n, HANDLE stream);
105 WCHAR *WCMD_parameter (WCHAR *s, int n, WCHAR **start, WCHAR **end);
106 WCHAR *WCMD_skip_leading_spaces (WCHAR *string);
107 BOOL WCMD_keyword_ws_found(const WCHAR *keyword, int len, const WCHAR *ptr);
108 void WCMD_HandleTildaModifiers(WCHAR **start, const WCHAR *forVariable, const WCHAR *forValue, BOOL justFors);
109
110 void WCMD_splitpath(const WCHAR* path, WCHAR* drv, WCHAR* dir, WCHAR* name, WCHAR* ext);
111 void WCMD_strip_quotes(WCHAR *cmd);
112 WCHAR *WCMD_LoadMessage(UINT id);
113 WCHAR *WCMD_strdupW(const WCHAR *input);
114 void WCMD_strsubstW(WCHAR *start, const WCHAR* next, const WCHAR* insert, int len);
115 BOOL WCMD_ReadFile(const HANDLE hIn, WCHAR *intoBuf, const DWORD maxChars, LPDWORD charsRead);
116
117 WCHAR    *WCMD_ReadAndParseLine(const WCHAR *initialcmd, CMD_LIST **output, HANDLE readFrom);
118 CMD_LIST *WCMD_process_commands(CMD_LIST *thisCmd, BOOL oneBracket,
119                                 const WCHAR *var, const WCHAR *val);
120 void      WCMD_free_commands(CMD_LIST *cmds);
121 void      WCMD_execute (const WCHAR *orig_command, const WCHAR *redirects,
122                         const WCHAR *parameter, const WCHAR *substitution,
123                         CMD_LIST **cmdList);
124
125 /* Data structure to hold context when executing batch files */
126
127 typedef struct _BATCH_CONTEXT {
128   WCHAR *command;       /* The command which invoked the batch file */
129   HANDLE h;             /* Handle to the open batch file */
130   WCHAR *batchfileW;    /* Name of same */
131   int shift_count[10];  /* Offset in terms of shifts for %0 - %9 */
132   struct _BATCH_CONTEXT *prev_context; /* Pointer to the previous context block */
133   BOOL  skip_rest;      /* Skip the rest of the batch program and exit */
134   CMD_LIST *toExecute;  /* Commands left to be executed */
135 } BATCH_CONTEXT;
136
137 /* Data structure to handle building lists during recursive calls */
138
139 struct env_stack
140 {
141   struct env_stack *next;
142   union {
143     int    stackdepth;       /* Only used for pushd and popd */
144     WCHAR   cwd;              /* Only used for set/endlocal   */
145   } u;
146   WCHAR *strings;
147 };
148
149 /* Data structure to save setlocal and pushd information */
150
151 typedef struct _DIRECTORY_STACK
152 {
153   struct _DIRECTORY_STACK *next;
154   WCHAR  *dirName;
155   WCHAR  *fileName;
156 } DIRECTORY_STACK;
157
158 #endif /* !RC_INVOKED */
159
160 /*
161  *      Serial nos of builtin commands. These constants must be in step with
162  *      the list of strings defined in wcmd.rc, and WCMD_EXIT *must* always be
163  *      the last one.
164  *
165  *      Yes it *would* be nice to use an enumeration here, but the Resource
166  *      Compiler won't accept resource IDs from enumerations :-(
167  */
168
169 #define WCMD_CALL      0
170 #define WCMD_CD        1
171 #define WCMD_CHDIR     2
172 #define WCMD_CLS       3
173 #define WCMD_COPY      4
174 #define WCMD_CTTY      5
175 #define WCMD_DATE      6
176 #define WCMD_DEL       7
177 #define WCMD_DIR       8
178 #define WCMD_ECHO      9
179 #define WCMD_ERASE    10
180 #define WCMD_FOR      11
181 #define WCMD_GOTO     12
182 #define WCMD_HELP     13
183 #define WCMD_IF       14
184 #define WCMD_LABEL    15
185 #define WCMD_MD       16
186 #define WCMD_MKDIR    17
187 #define WCMD_MOVE     18
188 #define WCMD_PATH     19
189 #define WCMD_PAUSE    20
190 #define WCMD_PROMPT   21
191 #define WCMD_REM      22
192 #define WCMD_REN      23
193 #define WCMD_RENAME   24
194 #define WCMD_RD       25
195 #define WCMD_RMDIR    26
196 #define WCMD_SET      27
197 #define WCMD_SHIFT    28
198 #define WCMD_TIME     29
199 #define WCMD_TITLE    30
200 #define WCMD_TYPE     31
201 #define WCMD_VERIFY   32
202 #define WCMD_VER      33
203 #define WCMD_VOL      34
204
205 #define WCMD_ENDLOCAL 35
206 #define WCMD_SETLOCAL 36
207 #define WCMD_PUSHD    37
208 #define WCMD_POPD     38
209 #define WCMD_ASSOC    39
210 #define WCMD_COLOR    40
211 #define WCMD_FTYPE    41
212 #define WCMD_MORE     42
213 #define WCMD_CHOICE   43
214
215 /* Must be last in list */
216 #define WCMD_EXIT     44
217
218 #define NUM_EXTERNALS 2
219 extern const WCHAR externals[NUM_EXTERNALS][10];
220
221 /* Some standard messages */
222 extern const WCHAR newline[];
223 extern const WCHAR space[];
224 extern const WCHAR nullW[];
225 extern const WCHAR dotW[];
226 extern const WCHAR dotdotW[];
227 extern const WCHAR starW[];
228 extern const WCHAR slashW[];
229 extern const WCHAR equalW[];
230 extern WCHAR anykey[];
231 extern WCHAR version_string[];
232
233 /* Translated messages */
234 #define WCMD_ALLHELP          1000
235 #define WCMD_CONFIRM          1001
236 #define WCMD_YES              1002
237 #define WCMD_NO               1003
238 #define WCMD_NOASSOC          1004
239 #define WCMD_NOFTYPE          1005
240 #define WCMD_OVERWRITE        1006
241 #define WCMD_MORESTR          1007
242 #define WCMD_TRUNCATEDLINE    1008
243 #define WCMD_NYI              1009
244 #define WCMD_NOARG            1010
245 #define WCMD_SYNTAXERR        1011
246 #define WCMD_FILENOTFOUND     1012
247 #define WCMD_NOCMDHELP        1013
248 #define WCMD_NOTARGET         1014
249 #define WCMD_CURRENTDATE      1015
250 #define WCMD_CURRENTTIME      1016
251 #define WCMD_NEWDATE          1017
252 #define WCMD_NEWTIME          1018
253 #define WCMD_MISSINGENV       1019
254 #define WCMD_READFAIL         1020
255 #define WCMD_CALLINSCRIPT     1021
256 #define WCMD_ALL              1022
257 #define WCMD_DELPROMPT        1023
258 #define WCMD_ECHOPROMPT       1024
259 #define WCMD_VERIFYPROMPT     1025
260 #define WCMD_VERIFYERR        1026
261 #define WCMD_ARGERR           1027
262 #define WCMD_VOLUMEDETAIL     1028
263 #define WCMD_VOLUMEPROMPT     1029
264 #define WCMD_NOPATH           1030
265 #define WCMD_ANYKEY           1031
266 #define WCMD_CONSTITLE        1032
267 #define WCMD_VERSION          1033
268 #define WCMD_MOREPROMPT       1034
269 #define WCMD_LINETOOLONG      1035
270
271 /* msdn specified max for Win XP */
272 #define MAXSTRING 8192