2 * Registry processing routines. Routines, common for registry
3 * processing frontends.
5 * Copyright 1999 Sylvain St-Germain
6 * Copyright 2002 Andriy Palamarchuk
8 * This library is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU Lesser General Public
10 * License as published by the Free Software Foundation; either
11 * version 2.1 of the License, or (at your option) any later version.
13 * This library is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 * Lesser General Public License for more details.
18 * You should have received a copy of the GNU Lesser General Public
19 * License along with this library; if not, write to the Free Software
20 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
31 #define REG_VAL_BUF_SIZE 4096
33 /* Delimiters used to parse the "value" to query queryValue*/
34 #define QUERY_VALUE_MAX_ARGS 1
36 /* maximal number of characters in hexadecimal data line,
37 not including '\' character */
38 #define REG_FILE_HEX_LINE_LEN 76
40 /* Globals used by the api setValue, queryValue */
41 static LPSTR currentKeyName = NULL;
42 static HKEY currentKeyClass = 0;
43 static HKEY currentKeyHandle = 0;
44 static BOOL bTheKeyIsOpen = FALSE;
46 static CHAR *app_name = "UNKNOWN";
48 static CHAR *reg_class_names[] = {
49 "HKEY_LOCAL_MACHINE", "HKEY_USERS", "HKEY_CLASSES_ROOT",
50 "HKEY_CURRENT_CONFIG", "HKEY_CURRENT_USER", "HKEY_DYN_DATA"
53 #define REG_CLASS_NUMBER (sizeof(reg_class_names) / sizeof(reg_class_names[0]))
55 static HKEY reg_class_keys[REG_CLASS_NUMBER] = {
56 HKEY_LOCAL_MACHINE, HKEY_USERS, HKEY_CLASSES_ROOT,
57 HKEY_CURRENT_CONFIG, HKEY_CURRENT_USER, HKEY_DYN_DATA
61 #define NOT_ENOUGH_MEMORY 1
64 /* processing macros */
66 /* common check of memory allocation results */
67 #define CHECK_ENOUGH_MEMORY(p) \
70 fprintf(stderr,"%s: file %s, line %d: Not enough memory", \
71 getAppName(), __FILE__, __LINE__); \
72 exit(NOT_ENOUGH_MEMORY); \
75 /******************************************************************************
76 * This is a replacement for strsep which is not portable (missing on Solaris).
80 char* getToken(char** str, const char* delims)
91 if (strchr(delims,**str)!=NULL) {
98 /* There is no other token */
104 /******************************************************************************
105 * Copies file name from command line string to the buffer.
106 * Rewinds the command line string pointer to the next non-space character
107 * after the file name.
108 * Buffer contains an empty string if no filename was found;
111 * command_line - command line current position pointer
112 * where *s[0] is the first symbol of the file name.
113 * file_name - buffer to write the file name to.
115 void get_file_name(CHAR **command_line, CHAR *file_name)
117 CHAR *s = *command_line;
118 int pos = 0; /* position of pointer "s" in *command_line */
130 fprintf(stderr,"%s: Unexpected end of file name!\n",
138 while(s[0] && !isspace(s[0])) {
143 memcpy(file_name, *command_line, pos * sizeof((*command_line)[0]));
144 /* remove the last backslash */
145 if (file_name[pos - 1] == '\\') {
146 file_name[pos - 1] = '\0';
148 file_name[pos] = '\0';
155 while(s[0] && isspace(s[0])) {
159 (*command_line) += pos;
163 /******************************************************************************
164 * Converts a hex representation of a DWORD into a DWORD.
166 DWORD convertHexToDWord(char *str, BYTE *buf)
173 sscanf(xbuf,"%08lx",&dw);
174 memcpy(buf,&dw,sizeof(DWORD));
175 return sizeof(DWORD);
178 /******************************************************************************
179 * Converts a hex buffer into a hex comma separated values
181 char* convertHexToHexCSV(BYTE *buf, ULONG bufLen)
189 str = HeapAlloc(GetProcessHeap(), 0, (bufLen+1)*2);
190 memset(str, 0, (bufLen+1)*2);
191 ptrStr = str; /* Pointer to result */
192 ptrBuf = buf; /* Pointer to current */
194 while (current < bufLen) {
195 BYTE bCur = ptrBuf[current++];
198 sprintf(res, "%02x", (unsigned int)*&bCur);
203 /* Get rid of the last comma */
204 str[strlen(str)-1] = '\0';
208 /******************************************************************************
209 * Converts a hex buffer into a DWORD string
211 char* convertHexToDWORDStr(BYTE *buf, ULONG bufLen)
216 if ( bufLen != sizeof(DWORD) ) return NULL;
218 str = HeapAlloc(GetProcessHeap(), 0, (bufLen*2)+1);
220 memcpy(&dw,buf,sizeof(DWORD));
221 sprintf(str, "%08lx", dw);
223 /* Get rid of the last comma */
227 /******************************************************************************
228 * Converts a hex comma separated values list into a hex list.
229 * The Hex input string must be in exactly the correct form.
231 DWORD convertHexCSVToHex(char *str, BYTE *buf, ULONG bufLen)
233 char *s = str; /* Pointer to current */
234 char *b = buf; /* Pointer to result */
236 ULONG strLen = strlen(str);
240 memset(buf, 0, bufLen);
243 * warn the user if we are here with a string longer than 2 bytes that does
244 * not contains ",". It is more likely because the data is invalid.
246 if ( ( strLen > 2) && ( strchr(str, ',') == NULL) )
247 fprintf(stderr,"%s: WARNING converting CSV hex stream with no comma, "
248 "input data seems invalid.\n", getAppName());
249 if (strLen > 3*bufLen)
250 fprintf(stderr,"%s: ERROR converting CSV hex stream. Too long\n",
253 while (strPos < strLen) {
257 memcpy(xbuf,s,2); xbuf[2]='\0';
258 sscanf(xbuf,"%02x",&wc);
259 if (byteCount < bufLen)
260 *b++ =(unsigned char)wc;
270 /******************************************************************************
271 * This function returns the HKEY associated with the data type encoded in the
272 * value. It modifies the input parameter (key value) in order to skip this
273 * "now useless" data type information.
275 * Note: Updated based on the algorithm used in 'server/registry.c'
277 DWORD getDataType(LPSTR *lpValue, DWORD* parse_type)
279 struct data_type { const char *tag; int len; int type; int parse_type; };
281 static const struct data_type data_types[] = { /* actual type */ /* type to assume for parsing */
282 { "\"", 1, REG_SZ, REG_SZ },
283 { "str:\"", 5, REG_SZ, REG_SZ },
284 { "str(2):\"", 8, REG_EXPAND_SZ, REG_SZ },
285 { "hex:", 4, REG_BINARY, REG_BINARY },
286 { "dword:", 6, REG_DWORD, REG_DWORD },
287 { "hex(", 4, -1, REG_BINARY },
291 const struct data_type *ptr;
294 for (ptr = data_types; ptr->tag; ptr++) {
295 if (memcmp( ptr->tag, *lpValue, ptr->len ))
299 *parse_type = ptr->parse_type;
304 /* "hex(xx):" is special */
305 type = (int)strtoul( *lpValue , &end, 16 );
306 if (**lpValue=='\0' || *end!=')' || *(end+1)!=':') {
314 return (**lpValue=='\0'?REG_SZ:REG_NONE);
317 /******************************************************************************
318 * Returns an allocated buffer with a cleaned copy (removed the surrounding
319 * dbl quotes) of the passed value.
321 LPSTR getArg( LPSTR arg)
330 * Get rid of surrounding quotes
334 if( arg[len-1] == '\"' ) arg[len-1] = '\0';
335 if( arg[0] == '\"' ) arg++;
337 tmp = HeapAlloc(GetProcessHeap(), 0, strlen(arg)+1);
343 /******************************************************************************
344 * Replaces escape sequences with the characters.
346 void REGPROC_unescape_string(LPSTR str)
348 int str_idx = 0; /* current character under analysis */
349 int val_idx = 0; /* the last character of the unescaped string */
350 int len = strlen(str);
351 for (str_idx = 0; str_idx < len; str_idx++, val_idx++) {
352 if (str[str_idx] == '\\') {
354 switch (str[str_idx]) {
360 str[val_idx] = str[str_idx];
363 fprintf(stderr,"Warning! Unrecognized escape sequence: \\%c'\n",
365 str[val_idx] = str[str_idx];
369 str[val_idx] = str[str_idx];
375 /******************************************************************************
376 * Sets the value with name val_name to the data in val_data for the currently
380 * val_name - name of the registry value
381 * val_data - registry value data
383 HRESULT setValue(LPSTR val_name, LPSTR val_data)
386 DWORD dwDataType, dwParseType;
388 BYTE convert[KEY_MAX_LEN];
389 BYTE *bBigBuffer = 0;
392 if ( (val_name == NULL) || (val_data == NULL) )
393 return ERROR_INVALID_PARAMETER;
395 /* Get the data type stored into the value field */
396 dwDataType = getDataType(&val_data, &dwParseType);
398 if ( dwParseType == REG_SZ) /* no conversion for string */
400 REGPROC_unescape_string(val_data);
401 /* Compute dwLen after REGPROC_unescape_string because it may
402 * have changed the string length and we don't want to store
403 * the extra garbage in the registry.
405 dwLen = strlen(val_data);
406 if (dwLen>0 && val_data[dwLen-1]=='"')
409 val_data[dwLen]='\0';
412 } else if (dwParseType == REG_DWORD) /* Convert the dword types */
414 dwLen = convertHexToDWord(val_data, convert);
416 } else /* Convert the hexadecimal types */
418 int b_len = strlen (val_data)+2/3;
419 if (b_len > KEY_MAX_LEN) {
420 bBigBuffer = HeapAlloc (GetProcessHeap(), 0, b_len);
421 CHECK_ENOUGH_MEMORY(bBigBuffer);
422 dwLen = convertHexCSVToHex(val_data, bBigBuffer, b_len);
423 lpbData = bBigBuffer;
425 dwLen = convertHexCSVToHex(val_data, convert, KEY_MAX_LEN);
430 hRes = RegSetValueEx(
438 HeapFree (GetProcessHeap(), 0, bBigBuffer);
443 /******************************************************************************
446 HRESULT openKey( LPSTR stdInput)
452 if (stdInput == NULL)
453 return ERROR_INVALID_PARAMETER;
455 /* Get the registry class */
456 currentKeyClass = getRegClass(stdInput); /* Sets global variable */
457 if (currentKeyClass == (HKEY)ERROR_INVALID_PARAMETER)
458 return (HRESULT)ERROR_INVALID_PARAMETER;
460 /* Get the key name */
461 currentKeyName = getRegKeyName(stdInput); /* Sets global variable */
462 if (currentKeyName == NULL)
463 return ERROR_INVALID_PARAMETER;
465 hRes = RegCreateKeyEx(
466 currentKeyClass, /* Class */
467 currentKeyName, /* Sub Key */
469 NULL, /* object type */
470 REG_OPTION_NON_VOLATILE, /* option, REG_OPTION_NON_VOLATILE ... */
471 KEY_ALL_ACCESS, /* access mask, KEY_ALL_ACCESS */
472 NULL, /* security attribute */
473 ¤tKeyHandle, /* result */
474 &dwDisp); /* disposition, REG_CREATED_NEW_KEY or
475 REG_OPENED_EXISTING_KEY */
477 if (hRes == ERROR_SUCCESS)
478 bTheKeyIsOpen = TRUE;
484 /******************************************************************************
485 * Extracts from [HKEY\some\key\path] or HKEY\some\key\path types of line
486 * the key name (what starts after the first '\')
488 LPSTR getRegKeyName(LPSTR lpLine)
491 char lpLineCopy[KEY_MAX_LEN];
496 strcpy(lpLineCopy, lpLine);
498 keyNameBeg = strchr(lpLineCopy, '\\'); /* The key name start by '\' */
502 keyNameBeg++; /* is not part of the name */
503 keyNameEnd = strchr(lpLineCopy, ']');
505 *keyNameEnd = '\0'; /* remove ']' from the key name */
508 keyNameBeg = lpLineCopy + strlen(lpLineCopy); /* branch - empty string */
510 currentKeyName = HeapAlloc(GetProcessHeap(), 0, strlen(keyNameBeg) + 1);
511 CHECK_ENOUGH_MEMORY(currentKeyName);
512 strcpy(currentKeyName, keyNameBeg);
513 return currentKeyName;
516 /******************************************************************************
517 * Extracts from [HKEY\some\key\path] or HKEY\some\key\path types of line
518 * the key class (what ends before the first '\')
520 HKEY getRegClass(LPSTR lpClass)
526 char lpClassCopy[KEY_MAX_LEN];
529 return (HKEY)ERROR_INVALID_PARAMETER;
531 strncpy(lpClassCopy, lpClass, KEY_MAX_LEN);
533 classNameEnd = strchr(lpClassCopy, '\\'); /* The class name ends by '\' */
534 if (!classNameEnd) /* or the whole string */
536 classNameEnd = lpClassCopy + strlen(lpClassCopy);
537 if (classNameEnd[-1] == ']')
542 *classNameEnd = '\0'; /* Isolate the class name */
543 if (lpClassCopy[0] == '[') {
544 classNameBeg = lpClassCopy + 1;
546 classNameBeg = lpClassCopy;
549 for (i = 0; i < REG_CLASS_NUMBER; i++) {
550 if (!strcmp(classNameBeg, reg_class_names[i])) {
551 return reg_class_keys[i];
554 return (HKEY)ERROR_INVALID_PARAMETER;
557 /******************************************************************************
558 * Close the currently opened key.
562 RegCloseKey(currentKeyHandle);
564 HeapFree(GetProcessHeap(), 0, currentKeyName); /* Allocated by getKeyName */
566 bTheKeyIsOpen = FALSE;
568 currentKeyName = NULL;
570 currentKeyHandle = 0;
573 /******************************************************************************
574 * This function is the main entry point to the setValue type of action. It
575 * receives the currently read line and dispatch the work depending on the
578 void doSetValue(LPSTR stdInput)
581 * We encoutered the end of the file, make sure we
582 * close the opened key and exit
584 if (stdInput == NULL) {
585 if (bTheKeyIsOpen != FALSE)
591 if ( stdInput[0] == '[') /* We are reading a new key */
593 if ( bTheKeyIsOpen != FALSE )
594 closeKey(); /* Close the previous key before */
596 if ( openKey(stdInput) != ERROR_SUCCESS )
597 fprintf(stderr,"%s: setValue failed to open key %s\n",
598 getAppName(), stdInput);
599 } else if( ( bTheKeyIsOpen ) &&
600 (( stdInput[0] == '@') || /* reading a default @=data pair */
601 ( stdInput[0] == '\"'))) /* reading a new value=data pair */
603 processSetValue(stdInput);
604 } else /* since we are assuming that the */
605 { /* file format is valid we must */
606 if ( bTheKeyIsOpen ) /* be reading a blank line which */
607 closeKey(); /* indicate end of this key processing */
611 /******************************************************************************
612 * This funtion is the main entry point to the queryValue type of action. It
613 * receives the currently read line and dispatch the work depending on the
616 void doQueryValue(LPSTR stdInput)
619 * We encoutered the end of the file, make sure we
620 * close the opened key and exit
622 if (stdInput == NULL) {
623 if (bTheKeyIsOpen != FALSE)
629 if ( stdInput[0] == '[') /* We are reading a new key */
631 if ( bTheKeyIsOpen != FALSE )
632 closeKey(); /* Close the previous key before */
634 if ( openKey(stdInput) != ERROR_SUCCESS )
635 fprintf(stderr,"%s: queryValue failed to open key %s\n",
636 getAppName(), stdInput);
637 } else if( ( bTheKeyIsOpen ) &&
638 (( stdInput[0] == '@') || /* reading a default @=data pair */
639 ( stdInput[0] == '\"'))) /* reading a new value=data pair */
641 processQueryValue(stdInput);
642 } else /* since we are assuming that the */
643 { /* file format is valid we must */
644 if ( bTheKeyIsOpen ) /* be reading a blank line which */
645 closeKey(); /* indicate end of this key processing */
649 /******************************************************************************
650 * This funtion is the main entry point to the deletetValue type of action. It
651 * receives the currently read line and dispatch the work depending on the
654 void doDeleteValue(LPSTR line)
656 fprintf(stderr,"%s: deleteValue not yet implemented\n", getAppName());
659 /******************************************************************************
660 * This funtion is the main entry point to the deleteKey type of action. It
661 * receives the currently read line and dispatch the work depending on the
664 void doDeleteKey(LPSTR line)
666 fprintf(stderr,"%s: deleteKey not yet implemented\n", getAppName());
669 /******************************************************************************
670 * This funtion is the main entry point to the createKey type of action. It
671 * receives the currently read line and dispatch the work depending on the
674 void doCreateKey(LPSTR line)
676 fprintf(stderr,"%s: createKey not yet implemented\n", getAppName());
679 /******************************************************************************
680 * This function is a wrapper for the setValue function. It prepares the
681 * land and clean the area once completed.
682 * Note: this function modifies the line parameter.
684 * line - registry file unwrapped line. Should have the registry value name and
685 * complete registry value data.
687 void processSetValue(LPSTR line)
689 LPSTR val_name; /* registry value name */
690 LPSTR val_data; /* registry value data */
692 int line_idx = 0; /* current character under analysis */
696 if (line[line_idx] == '@' && line[line_idx + 1] == '=') {
697 line[line_idx] = '\0';
700 } else if (line[line_idx] == '\"') {
702 val_name = line + line_idx;
704 if (line[line_idx] == '\\') /* skip escaped character */
708 if (line[line_idx] == '\"') {
709 line[line_idx] = '\0';
717 if (line[line_idx] != '=') {
718 line[line_idx] = '\"';
719 fprintf(stderr,"Warning! unrecognized line:\n%s\n", line);
724 fprintf(stderr,"Warning! unrecognized line:\n%s\n", line);
727 line_idx++; /* skip the '=' character */
728 val_data = line + line_idx;
730 REGPROC_unescape_string(val_name);
731 hRes = setValue(val_name, val_data);
732 if ( hRes != ERROR_SUCCESS )
733 fprintf(stderr,"%s: ERROR Key %s not created. Value: %s, Data: %s\n",
740 /******************************************************************************
741 * This function is a wrapper for the queryValue function. It prepares the
742 * land and clean the area once completed.
744 void processQueryValue(LPSTR cmdline)
746 fprintf(stderr,"ERROR!!! - temporary disabled");
749 LPSTR argv[QUERY_VALUE_MAX_ARGS];/* args storage */
750 LPSTR token = NULL; /* current token analyzed */
751 ULONG argCounter = 0; /* counter of args */
754 LPSTR keyValue = NULL;
758 * Init storage and parse the line
760 for (counter=0; counter<QUERY_VALUE_MAX_ARGS; counter++)
763 while( (token = getToken(&cmdline, queryValueDelim[argCounter])) != NULL ) {
764 argv[argCounter++] = getArg(token);
766 if (argCounter == QUERY_VALUE_MAX_ARGS)
767 break; /* Stop processing args no matter what */
770 /* The value we look for is the first token on the line */
771 if ( argv[0] == NULL )
772 return; /* SHOULD NOT HAPPEN */
776 if( (keyValue[0] == '@') && (strlen(keyValue) == 1) ) {
777 LONG lLen = KEY_MAX_LEN;
778 CHAR* lpsData=HeapAlloc(GetProcessHeap(),HEAP_ZERO_MEMORY,KEY_MAX_LEN);
780 * We need to query the key default value
782 hRes = RegQueryValue(
788 if (hRes==ERROR_MORE_DATA) {
789 lpsData=HeapReAlloc(GetProcessHeap(),HEAP_ZERO_MEMORY,lpsData,lLen);
790 hRes = RegQueryValue(currentKeyHandle,currentKeyName,(LPBYTE)lpsData,&lLen);
793 if (hRes == ERROR_SUCCESS) {
794 lpsRes = HeapAlloc( GetProcessHeap(), 0, lLen);
795 strncpy(lpsRes, lpsData, lLen);
799 DWORD dwLen = KEY_MAX_LEN;
800 BYTE* lpbData=HeapAlloc(GetProcessHeap(),HEAP_ZERO_MEMORY,KEY_MAX_LEN);
803 * We need to query a specific value for the key
805 hRes = RegQueryValueEx(
813 if (hRes==ERROR_MORE_DATA) {
814 lpbData=HeapReAlloc(GetProcessHeap(),HEAP_ZERO_MEMORY,lpbData,dwLen);
815 hRes = RegQueryValueEx(currentKeyHandle,keyValue,NULL,&dwType,(LPBYTE)lpbData,&dwLen);
818 if (hRes == ERROR_SUCCESS) {
820 * Convert the returned data to a displayable format
824 case REG_EXPAND_SZ: {
825 lpsRes = HeapAlloc( GetProcessHeap(), 0, dwLen);
826 strncpy(lpsRes, lpbData, dwLen);
827 lpsRes[dwLen-1]='\0';
831 lpsRes = convertHexToDWORDStr(lpbData, dwLen);
835 lpsRes = convertHexToHexCSV(lpbData, dwLen);
841 HeapFree(GetProcessHeap(), 0, lpbData);
845 if ( hRes == ERROR_SUCCESS )
847 "%s: Value \"%s\" = \"%s\" in key [%s]\n",
854 fprintf(stderr,"%s: ERROR Value \"%s\" not found for key \"%s\".\n",
862 for (counter=0; counter<argCounter; counter++)
863 if (argv[counter] != NULL)
864 HeapFree(GetProcessHeap(), 0, argv[counter]);
867 HeapFree(GetProcessHeap(), 0, lpsRes);
871 /******************************************************************************
872 * Calls command for each line of a registry file.
873 * Correctly processes comments (in # form), line continuation.
876 * in - input stream to read from
877 * command - command to be called for each line
879 void processRegLines(FILE *in, CommandAPI command)
881 LPSTR line = NULL; /* line read from input stream */
882 ULONG lineSize = REG_VAL_BUF_SIZE;
884 line = HeapAlloc(GetProcessHeap(), 0, lineSize);
885 CHECK_ENOUGH_MEMORY(line);
888 LPSTR s; /* The pointer into line for where the current fgets should read */
891 size_t size_remaining;
893 char *s_eol; /* various local uses */
895 /* Do we need to expand the buffer ? */
896 assert (s >= line && s <= line + lineSize);
897 size_remaining = lineSize - (s-line);
898 if (size_remaining < 2) /* room for 1 character and the \0 */
901 size_t new_size = lineSize + REG_VAL_BUF_SIZE;
902 if (new_size > lineSize) /* no arithmetic overflow */
903 new_buffer = HeapReAlloc (GetProcessHeap(), 0, line, new_size);
906 CHECK_ENOUGH_MEMORY(new_buffer);
908 s = line + lineSize - size_remaining;
910 size_remaining = lineSize - (s-line);
913 /* Get as much as possible into the buffer, terminated either by
914 * eof, error, eol or getting the maximum amount. Abort on error.
916 size_to_get = (size_remaining > INT_MAX ? INT_MAX : size_remaining);
917 if (NULL == fgets (s, size_to_get, in)) {
919 perror ("While reading input");
924 /* It is not clear to me from the definition that the
925 * contents of the buffer are well defined on detecting
926 * an eof without managing to read anything.
931 /* If we didn't read the eol nor the eof go around for the rest */
932 s_eol = strchr (s, '\n');
933 if (!feof (in) && !s_eol) {
934 s = strchr (s, '\0');
935 /* It should be s + size_to_get - 1 but this is safer */
939 /* If it is a comment line then discard it and go around again */
940 if (line [0] == '#') {
945 /* Remove any line feed. Leave s_eol on the \0 */
948 if (s_eol > line && *(s_eol-1) == '\r')
951 s_eol = strchr (s, '\0');
953 /* If there is a concatenating \\ then go around again */
954 if (s_eol > line && *(s_eol-1) == '\\') {
957 /* The following error protection could be made more self-
958 * correcting but I thought it not worth trying.
960 if ((c = fgetc (in)) == EOF || c != ' ' ||
961 (c = fgetc (in)) == EOF || c != ' ')
962 fprintf(stderr,"%s: ERROR - invalid continuation.\n",
967 break; /* That is the full virtual line */
974 HeapFree(GetProcessHeap(), 0, line);
977 /******************************************************************************
978 * This funtion is the main entry point to the registerDLL action. It
979 * receives the currently read line, then loads and registers the requested DLLs
981 void doRegisterDLL(LPSTR stdInput)
986 /* Check for valid input */
987 if (stdInput == NULL)
990 /* Load and register the library, then free it */
991 theLib = LoadLibrary(stdInput);
993 FARPROC lpfnDLLRegProc = GetProcAddress(theLib, "DllRegisterServer");
995 retVal = (*lpfnDLLRegProc)();
997 fprintf(stderr,"%s: Couldn't find DllRegisterServer proc in '%s'.\n",
998 getAppName(), stdInput);
1001 fprintf(stderr,"%s: DLLRegisterServer error 0x%x in '%s'.\n",
1002 getAppName(), retVal, stdInput);
1004 FreeLibrary(theLib);
1006 fprintf(stderr,"%s: Could not load DLL '%s'.\n", getAppName(), stdInput);
1010 /******************************************************************************
1011 * This funtion is the main entry point to the unregisterDLL action. It
1012 * receives the currently read line, then loads and unregisters the requested DLLs
1014 void doUnregisterDLL(LPSTR stdInput)
1019 /* Check for valid input */
1020 if (stdInput == NULL)
1023 /* Load and unregister the library, then free it */
1024 theLib = LoadLibrary(stdInput);
1026 FARPROC lpfnDLLRegProc = GetProcAddress(theLib, "DllUnregisterServer");
1028 retVal = (*lpfnDLLRegProc)();
1030 fprintf(stderr,"%s: Couldn't find DllUnregisterServer proc in '%s'.\n",
1031 getAppName(), stdInput);
1034 fprintf(stderr,"%s: DLLUnregisterServer error 0x%x in '%s'.\n",
1035 getAppName(), retVal, stdInput);
1037 FreeLibrary(theLib);
1039 fprintf(stderr,"%s: Could not load DLL '%s'.\n", getAppName(), stdInput);
1043 /****************************************************************************
1044 * REGPROC_print_error
1046 * Print the message for GetLastError
1049 void REGPROC_print_error()
1055 error_code = GetLastError ();
1056 status = FormatMessage(FORMAT_MESSAGE_ALLOCATE_BUFFER | FORMAT_MESSAGE_FROM_SYSTEM,
1057 NULL, error_code, 0, (LPTSTR) &lpMsgBuf, 0, NULL);
1059 fprintf(stderr,"%s: Cannot display message for error %ld, status %ld\n",
1060 getAppName(), error_code, GetLastError());
1064 LocalFree((HLOCAL)lpMsgBuf);
1068 /******************************************************************************
1069 * Checks whether the buffer has enough room for the string or required size.
1070 * Resizes the buffer if necessary.
1073 * buffer - pointer to a buffer for string
1074 * len - current length of the buffer in characters.
1075 * required_len - length of the string to place to the buffer in characters.
1076 * The length does not include the terminating null character.
1078 void REGPROC_resize_char_buffer(CHAR **buffer, DWORD *len, DWORD required_len)
1081 if (required_len > *len) {
1082 *len = required_len;
1084 *buffer = HeapAlloc(GetProcessHeap(), 0, *len * sizeof(**buffer));
1086 *buffer = HeapReAlloc(GetProcessHeap(), 0, *buffer, *len * sizeof(**buffer));
1087 CHECK_ENOUGH_MEMORY(*buffer);
1091 /******************************************************************************
1092 * Prints string str to file
1094 void REGPROC_export_string(FILE *file, CHAR *str)
1096 size_t len = strlen(str);
1099 /* escaping characters */
1100 for (i = 0; i < len; i++) {
1104 fputs("\\\\", file);
1107 fputs("\\\"", file);
1110 fputs("\\\n", file);
1119 /******************************************************************************
1120 * Writes contents of the registry key to the specified file stream.
1123 * file - writable file stream to export registry branch to.
1124 * key - registry branch to export.
1125 * reg_key_name_buf - name of the key with registry class.
1126 * Is resized if necessary.
1127 * reg_key_name_len - length of the buffer for the registry class in characters.
1128 * val_name_buf - buffer for storing value name.
1129 * Is resized if necessary.
1130 * val_name_len - length of the buffer for storing value names in characters.
1131 * val_buf - buffer for storing values while extracting.
1132 * Is resized if necessary.
1133 * val_size - size of the buffer for storing values in bytes.
1135 void export_hkey(FILE *file, HKEY key,
1136 CHAR **reg_key_name_buf, DWORD *reg_key_name_len,
1137 CHAR **val_name_buf, DWORD *val_name_len,
1138 BYTE **val_buf, DWORD *val_size)
1140 DWORD max_sub_key_len;
1141 DWORD max_val_name_len;
1148 /* get size information and resize the buffers if necessary */
1149 if (RegQueryInfoKey(key, NULL, NULL, NULL, NULL,
1150 &max_sub_key_len, NULL,
1151 NULL, &max_val_name_len, &max_val_size, NULL, NULL
1152 ) != ERROR_SUCCESS) {
1153 REGPROC_print_error();
1155 curr_len = strlen(*reg_key_name_buf);
1156 REGPROC_resize_char_buffer(reg_key_name_buf, reg_key_name_len,
1157 max_sub_key_len + curr_len + 1);
1158 REGPROC_resize_char_buffer(val_name_buf, val_name_len,
1160 if (max_val_size > *val_size) {
1161 *val_size = max_val_size;
1162 if (!*val_buf) *val_buf = HeapAlloc(GetProcessHeap(), 0, *val_size);
1163 else *val_buf = HeapReAlloc(GetProcessHeap(), 0, *val_buf, *val_size);
1164 CHECK_ENOUGH_MEMORY(val_buf);
1167 /* output data for the current key */
1169 fputs(*reg_key_name_buf, file);
1171 /* print all the values */
1176 DWORD val_name_len1 = *val_name_len;
1177 DWORD val_size1 = *val_size;
1178 ret = RegEnumValue(key, i, *val_name_buf, &val_name_len1, NULL,
1179 &value_type, *val_buf, &val_size1);
1180 if (ret != ERROR_SUCCESS) {
1182 if (ret != ERROR_NO_MORE_ITEMS) {
1183 REGPROC_print_error();
1188 if ((*val_name_buf)[0]) {
1190 REGPROC_export_string(file, *val_name_buf);
1196 switch (value_type) {
1200 REGPROC_export_string(file, *val_buf);
1201 fputs("\"\n", file);
1205 fprintf(file, "dword:%08lx\n", *((DWORD *)*val_buf));
1209 fprintf(stderr,"%s: warning - unsupported registry format '%ld', "
1210 "treat as binary\n",
1211 getAppName(), value_type);
1212 fprintf(stderr,"key name: \"%s\"\n", *reg_key_name_buf);
1213 fprintf(stderr,"value name:\"%s\"\n\n", *val_name_buf);
1223 if (value_type == REG_BINARY) {
1224 hex_prefix = "hex:";
1227 sprintf(buf, "hex(%ld):", value_type);
1230 /* position of where the next character will be printed */
1231 /* NOTE: yes, strlen("hex:") is used even for hex(x): */
1232 cur_pos = strlen("\"\"=") + strlen("hex:") +
1233 strlen(*val_name_buf);
1235 fputs(hex_prefix, file);
1236 for (i1 = 0; i1 < val_size1; i1++) {
1237 fprintf(file, "%02x", (unsigned int)(*val_buf)[i1]);
1238 if (i1 + 1 < val_size1) {
1244 if (cur_pos > REG_FILE_HEX_LINE_LEN) {
1245 fputs("\\\n ", file);
1258 (*reg_key_name_buf)[curr_len] = '\\';
1260 DWORD buf_len = *reg_key_name_len - curr_len;
1262 ret = RegEnumKeyEx(key, i, *reg_key_name_buf + curr_len + 1, &buf_len,
1263 NULL, NULL, NULL, NULL);
1264 if (ret != ERROR_SUCCESS && ret != ERROR_MORE_DATA) {
1266 if (ret != ERROR_NO_MORE_ITEMS) {
1267 REGPROC_print_error();
1273 if (RegOpenKey(key, *reg_key_name_buf + curr_len + 1,
1274 &subkey) == ERROR_SUCCESS) {
1275 export_hkey(file, subkey, reg_key_name_buf, reg_key_name_len,
1276 val_name_buf, val_name_len, val_buf, val_size);
1277 RegCloseKey(subkey);
1279 REGPROC_print_error();
1283 (*reg_key_name_buf)[curr_len] = '\0';
1286 /******************************************************************************
1287 * Open file for export.
1289 FILE *REGPROC_open_export_file(CHAR *file_name)
1291 FILE *file = fopen(file_name, "w");
1294 fprintf(stderr,"%s: Can't open file \"%s\"\n", getAppName(), file_name);
1297 fputs("REGEDIT4\n", file);
1301 /******************************************************************************
1302 * Writes contents of the registry key to the specified file stream.
1305 * file_name - name of a file to export registry branch to.
1306 * reg_key_name - registry branch to export. The whole registry is exported if
1307 * reg_key_name is NULL or contains an empty string.
1309 BOOL export_registry_key(CHAR *file_name, CHAR *reg_key_name)
1313 CHAR *reg_key_name_buf;
1316 DWORD reg_key_name_len = KEY_MAX_LEN;
1317 DWORD val_name_len = KEY_MAX_LEN;
1318 DWORD val_size = REG_VAL_BUF_SIZE;
1321 reg_key_name_buf = HeapAlloc(GetProcessHeap(), 0,
1322 reg_key_name_len * sizeof(*reg_key_name_buf));
1323 val_name_buf = HeapAlloc(GetProcessHeap(), 0,
1324 val_name_len * sizeof(*val_name_buf));
1325 val_buf = HeapAlloc(GetProcessHeap(), 0, val_size);
1326 CHECK_ENOUGH_MEMORY(reg_key_name_buf && val_name_buf && val_buf);
1328 if (reg_key_name && reg_key_name[0]) {
1332 REGPROC_resize_char_buffer(®_key_name_buf, ®_key_name_len,
1333 strlen(reg_key_name));
1334 strcpy(reg_key_name_buf, reg_key_name);
1336 /* open the specified key */
1337 reg_key_class = getRegClass(reg_key_name);
1338 if (reg_key_class == (HKEY)ERROR_INVALID_PARAMETER) {
1339 fprintf(stderr,"%s: Incorrect registry class specification in '%s'\n",
1340 getAppName(), reg_key_name);
1343 branch_name = getRegKeyName(reg_key_name);
1344 CHECK_ENOUGH_MEMORY(branch_name);
1345 if (!branch_name[0]) {
1346 /* no branch - registry class is specified */
1347 file = REGPROC_open_export_file(file_name);
1348 export_hkey(file, reg_key_class,
1349 ®_key_name_buf, ®_key_name_len,
1350 &val_name_buf, &val_name_len,
1351 &val_buf, &val_size);
1352 } else if (RegOpenKey(reg_key_class, branch_name, &key) == ERROR_SUCCESS) {
1353 file = REGPROC_open_export_file(file_name);
1354 export_hkey(file, key,
1355 ®_key_name_buf, ®_key_name_len,
1356 &val_name_buf, &val_name_len,
1357 &val_buf, &val_size);
1360 fprintf(stderr,"%s: Can't export. Registry key '%s' does not exist!\n",
1361 getAppName(), reg_key_name);
1362 REGPROC_print_error();
1364 HeapFree(GetProcessHeap(), 0, branch_name);
1368 /* export all registry classes */
1369 file = REGPROC_open_export_file(file_name);
1370 for (i = 0; i < REG_CLASS_NUMBER; i++) {
1371 /* do not export HKEY_CLASSES_ROOT */
1372 if (reg_class_keys[i] != HKEY_CLASSES_ROOT &&
1373 reg_class_keys[i] != HKEY_CURRENT_USER &&
1374 reg_class_keys[i] != HKEY_CURRENT_CONFIG &&
1375 reg_class_keys[i] != HKEY_DYN_DATA) {
1376 strcpy(reg_key_name_buf, reg_class_names[i]);
1377 export_hkey(file, reg_class_keys[i],
1378 ®_key_name_buf, ®_key_name_len,
1379 &val_name_buf, &val_name_len,
1380 &val_buf, &val_size);
1388 HeapFree(GetProcessHeap(), 0, reg_key_name);
1389 HeapFree(GetProcessHeap(), 0, val_buf);
1393 /******************************************************************************
1394 * Reads contents of the specified file into the registry.
1396 BOOL import_registry_file(LPTSTR filename)
1398 FILE* reg_file = fopen(filename, "r");
1401 processRegLines(reg_file, doSetValue);
1407 /******************************************************************************
1408 * Recursive function which removes the registry key with all subkeys.
1410 void delete_branch(HKEY key,
1411 CHAR **reg_key_name_buf, DWORD *reg_key_name_len)
1414 DWORD max_sub_key_len;
1420 if (RegOpenKey(key, *reg_key_name_buf, &branch_key) != ERROR_SUCCESS) {
1421 REGPROC_print_error();
1424 /* get size information and resize the buffers if necessary */
1425 if (RegQueryInfoKey(branch_key, NULL, NULL, NULL,
1426 &subkeys, &max_sub_key_len,
1427 NULL, NULL, NULL, NULL, NULL, NULL
1428 ) != ERROR_SUCCESS) {
1429 REGPROC_print_error();
1431 curr_len = strlen(*reg_key_name_buf);
1432 REGPROC_resize_char_buffer(reg_key_name_buf, reg_key_name_len,
1433 max_sub_key_len + curr_len + 1);
1435 (*reg_key_name_buf)[curr_len] = '\\';
1436 for (i = subkeys - 1; i >= 0; i--) {
1437 DWORD buf_len = *reg_key_name_len - curr_len;
1439 ret = RegEnumKeyEx(branch_key, i, *reg_key_name_buf + curr_len + 1,
1440 &buf_len, NULL, NULL, NULL, NULL);
1441 if (ret != ERROR_SUCCESS &&
1442 ret != ERROR_MORE_DATA &&
1443 ret != ERROR_NO_MORE_ITEMS) {
1444 REGPROC_print_error();
1446 delete_branch(key, reg_key_name_buf, reg_key_name_len);
1449 (*reg_key_name_buf)[curr_len] = '\0';
1450 RegCloseKey(branch_key);
1451 RegDeleteKey(key, *reg_key_name_buf);
1454 /******************************************************************************
1455 * Removes the registry key with all subkeys. Parses full key name.
1458 * reg_key_name - full name of registry branch to delete. Ignored if is NULL,
1459 * empty, points to register key class, does not exist.
1461 void delete_registry_key(CHAR *reg_key_name)
1464 DWORD branch_name_len;
1468 if (!reg_key_name || !reg_key_name[0])
1470 /* open the specified key */
1471 reg_key_class = getRegClass(reg_key_name);
1472 if (reg_key_class == (HKEY)ERROR_INVALID_PARAMETER) {
1473 fprintf(stderr,"%s: Incorrect registry class specification in '%s'\n",
1474 getAppName(), reg_key_name);
1477 branch_name = getRegKeyName(reg_key_name);
1478 CHECK_ENOUGH_MEMORY(branch_name);
1479 branch_name_len = strlen(branch_name);
1480 if (!branch_name[0]) {
1481 fprintf(stderr,"%s: Can't delete registry class '%s'\n",
1482 getAppName(), reg_key_name);
1485 if (RegOpenKey(reg_key_class, branch_name, &branch_key) == ERROR_SUCCESS) {
1486 /* check whether the key exists */
1487 RegCloseKey(branch_key);
1488 delete_branch(reg_key_class, &branch_name, &branch_name_len);
1490 HeapFree(GetProcessHeap(), 0, branch_name);
1493 /******************************************************************************
1494 * Sets the application name. Then application name is used in the error
1497 void setAppName(CHAR *name)