xref: /reactos/base/setup/lib/setuplib.h (revision 682f85ad)
1 /*
2  * PROJECT:     ReactOS Setup Library
3  * LICENSE:     GPL-2.0+ (https://spdx.org/licenses/GPL-2.0+)
4  * PURPOSE:     Public header
5  * COPYRIGHT:   Copyright 2017-2018 Hermes Belusca-Maito
6  */
7 
8 #pragma once
9 
10 /* INCLUDES *****************************************************************/
11 
12 /* Needed PSDK headers when using this library */
13 #if 0
14 
15 #define WIN32_NO_STATUS
16 #define _INC_WINDOWS
17 #define COM_NO_WINDOWS_H
18 
19 #include <winxxx.h>
20 
21 #endif
22 
23 /* NOTE: Please keep the header inclusion order! */
24 
25 extern HANDLE ProcessHeap;
26 
27 #include "errorcode.h"
28 #include "spapisup/fileqsup.h"
29 #include "spapisup/infsupp.h"
30 #include "utils/linklist.h"
31 #include "utils/ntverrsrc.h"
32 // #include "utils/arcname.h"
33 #include "utils/bldrsup.h"
34 #include "utils/filesup.h"
35 #include "utils/fsrec.h"
36 #include "utils/genlist.h"
37 #include "utils/inicache.h"
38 #include "utils/partinfo.h"
39 #include "utils/partlist.h"
40 #include "utils/arcname.h"
41 #include "utils/osdetect.h"
42 #include "utils/regutil.h"
43 #include "bootcode.h"
44 #include "fsutil.h"
45 #include "bootsup.h"
46 #include "registry.h"
47 #include "mui.h"
48 #include "settings.h"
49 
50 // #include "install.h" // See at the end...
51 
52 
53 /* DEFINES ******************************************************************/
54 
55 #define KB ((ULONGLONG)1024)
56 #define MB (KB*KB)
57 #define GB (KB*KB*KB)
58 // #define TB (KB*KB*KB*KB)
59 // #define PB (KB*KB*KB*KB*KB)
60 
61 
62 /* TYPEDEFS *****************************************************************/
63 
64 struct _USETUP_DATA;
65 
66 typedef VOID
67 (__cdecl *PSETUP_ERROR_ROUTINE)(IN struct _USETUP_DATA*, ...);
68 
69 typedef struct _USETUP_DATA
70 {
71 /* Error handling *****/
72     ERROR_NUMBER LastErrorNumber;
73     PSETUP_ERROR_ROUTINE ErrorRoutine;
74 
75 /* Setup INFs *****/
76     HINF SetupInf;
77 
78 /* Installation *****/
79     PVOID SetupFileQueue; // HSPFILEQ
80 
81 /* SOURCE Paths *****/
82     UNICODE_STRING SourceRootPath;
83     UNICODE_STRING SourceRootDir;
84     UNICODE_STRING SourcePath;
85 
86 /* DESTINATION Paths *****/
87     /*
88      * Path to the system partition, where the boot manager resides.
89      * On x86 PCs, this is usually the active partition.
90      * On ARC, (u)EFI, ... platforms, this is a dedicated partition.
91      *
92      * For more information, see:
93      * https://en.wikipedia.org/wiki/System_partition_and_boot_partition
94      * http://homepage.ntlworld.com/jonathan.deboynepollard/FGA/boot-and-system-volumes.html
95      * http://homepage.ntlworld.com/jonathan.deboynepollard/FGA/arc-boot-process.html
96      * http://homepage.ntlworld.com/jonathan.deboynepollard/FGA/efi-boot-process.html
97      * http://homepage.ntlworld.com/jonathan.deboynepollard/FGA/determining-system-volume.html
98      * http://homepage.ntlworld.com/jonathan.deboynepollard/FGA/determining-boot-volume.html
99      */
100     UNICODE_STRING SystemRootPath;
101 
102     /* Path to the installation directory inside the ReactOS boot partition */
103     UNICODE_STRING DestinationArcPath;  /** Equivalent of 'NTOS_INSTALLATION::SystemArcPath' **/
104     UNICODE_STRING DestinationPath;     /** Equivalent of 'NTOS_INSTALLATION::SystemNtPath' **/
105     UNICODE_STRING DestinationRootPath;
106 
107     // FIXME: This is only temporary!! Must be removed later!
108     UNICODE_STRING InstallPath;
109 
110     LONG DestinationDiskNumber;
111     LONG DestinationPartitionNumber;
112 
113     LONG MBRInstallType;
114     LONG FormatPartition;
115     LONG AutoPartition;
116     LONG FsType;
117 
118 /* Settings lists *****/
119     PGENERIC_LIST ComputerList;
120     PGENERIC_LIST DisplayList;
121     PGENERIC_LIST KeyboardList;
122     PGENERIC_LIST LayoutList;
123     PGENERIC_LIST LanguageList;
124 
125 /* Other stuff *****/
126     WCHAR LocaleID[9];
127     LANGID LanguageId;
128 
129     ULONG RequiredPartitionDiskSpace;
130     WCHAR InstallationDirectory[MAX_PATH];
131 } USETUP_DATA, *PUSETUP_DATA;
132 
133 
134 #include "install.h"
135 
136 
137 // HACK!!
138 extern BOOLEAN IsUnattendedSetup;
139 
140 
141 /* FUNCTIONS ****************************************************************/
142 
143 #include "substset.h"
144 
145 VOID
146 CheckUnattendedSetup(
147     IN OUT PUSETUP_DATA pSetupData);
148 
149 VOID
150 InstallSetupInfFile(
151     IN OUT PUSETUP_DATA pSetupData);
152 
153 NTSTATUS
154 GetSourcePaths(
155     OUT PUNICODE_STRING SourcePath,
156     OUT PUNICODE_STRING SourceRootPath,
157     OUT PUNICODE_STRING SourceRootDir);
158 
159 ERROR_NUMBER
160 LoadSetupInf(
161     IN OUT PUSETUP_DATA pSetupData);
162 
163 NTSTATUS
164 InitDestinationPaths(
165     IN OUT PUSETUP_DATA pSetupData,
166     IN PCWSTR InstallationDir,
167     IN PPARTENTRY PartEntry);   // FIXME: HACK!
168 
169 // NTSTATUS
170 ERROR_NUMBER
171 InitializeSetup(
172     IN OUT PUSETUP_DATA pSetupData,
173     IN ULONG InitPhase);
174 
175 VOID
176 FinishSetup(
177     IN OUT PUSETUP_DATA pSetupData);
178 
179 
180 typedef enum _REGISTRY_STATUS
181 {
182     Success = 0,
183     RegHiveUpdate,
184     ImportRegHive,
185     DisplaySettingsUpdate,
186     LocaleSettingsUpdate,
187     KeybLayouts,
188     KeybSettingsUpdate,
189     CodePageInfoUpdate,
190 } REGISTRY_STATUS;
191 
192 typedef VOID
193 (__cdecl *PREGISTRY_STATUS_ROUTINE)(IN REGISTRY_STATUS, ...);
194 
195 ERROR_NUMBER
196 UpdateRegistry(
197     IN OUT PUSETUP_DATA pSetupData,
198     /**/IN BOOLEAN RepairUpdateFlag,     /* HACK HACK! */
199     /**/IN PPARTLIST PartitionList,      /* HACK HACK! */
200     /**/IN WCHAR DestinationDriveLetter, /* HACK HACK! */
201     /**/IN PCWSTR SelectedLanguageId,    /* HACK HACK! */
202     IN PREGISTRY_STATUS_ROUTINE StatusRoutine OPTIONAL,
203     IN PFONTSUBSTSETTINGS SubstSettings OPTIONAL);
204 
205 /* EOF */
206