src/WINNT/afssvrcfg/help.cpp

   1 /*
   2  * Copyright 2000, International Business Machines Corporation and others.
   3  * All Rights Reserved.
   4  *
   5  * This software has been released under the terms of the IBM Public
   6  * License.  For details, see the LICENSE file in the top-level source
   7  * directory or online at http://www.openafs.org/dl/license10.html
   8  */
   9
  10 /*
  11  * INCLUDES ___________________________________________________________________
  12  *
  13  */
  14 #include <winsock2.h>
  15 #include <ws2tcpip.h>
  16
  17 extern "C" {
  18 #include <afs/param.h>
  19 #include <afs/stds.h>
  20 }
  21
  22 #include "resource.h"
  23 #include <WINNT\afsapplib.h>
  24
  25
  26 /*
  27  * DEFINITIONS _________________________________________________________________
  28  *
  29  */
  30
  31 /*
  32  * Wizard Help _________________________________________________________________
  33  *
  34  */
  35
  36 // Intro page
  37 static UINT IDH_INTRO_PAGE = 101;
  38
  39 // Config server page
  40 static UINT IDH_CONFIG_SERVER_PAGE = 102;
  41
  42 // Backup server page
  43 static UINT IDH_BACKUP_SERVER_PAGE                      = 0;
  44 static UINT IDH_CONFIG_BACKUP_SERVER            = 1;
  45 static UINT IDH_DONT_CONFIG_BACKUP_SERVER       = 2;
  46
  47 // File server page
  48 static UINT IDH_FILE_SERVER_PAGE                        = 3;
  49 static UINT IDH_SHOULD_CONFIG_FILE_SERVER       = 4;
  50 static UINT IDH_DONT_CONFIG_FILE_SERVER         = 5;
  51
  52 // Cell and Server info page
  53 static UINT IDH_INFO_PAGE                       = 6;
  54 static UINT IDH_JOIN_EXISTING_CELL      = 7;
  55 static UINT IDH_FIRST_SERVER            = 8;
  56 static UINT IDH_CELL_NAME                       = 9;
  57 static UINT IDH_PRINCIPAL                       = 10;
  58 static UINT IDH_SERVER_PW                       = 11;
  59 static UINT IDH_VERIFY_PW                       = 12;
  60
  61 // Administrative info page (when configuring first server)
  62 static UINT IDH_FIRST_SERVER_PAGE       = 13;
  63 static UINT IDH_ADMIN_NAME                      = 14;
  64 static UINT IDH_ADMIN_PW                        = 15;
  65 static UINT IDH_VERIFY_ADMIN_PW         = 16;
  66 static UINT IDH_USE_NEXT_UID            = 17;
  67 static UINT IDH_USE_THIS_UID            = 18;
  68 static UINT IDH_AFS_UID                         = 19;
  69 static UINT IDH_AFS_UID_SPINNER         = 20;
  70
  71 // Administrative info page (when configuring into an existing cell)
  72 static UINT IDH_EXISTING_CELL_PAGE      = 21;
  73 static UINT IDH_ADMIN_NAME2                     = 22;
  74 static UINT IDH_ADMIN_PW2                       = 23;
  75 static UINT IDH_HOSTNAME                        = 24;
  76
  77 // Database server page
  78 static UINT IDH_DB_SERVER_PAGE          = 100;
  79 static UINT IDH_CONFIG_DB_SERVER                = 25;
  80 static UINT IDH_DONT_CONFIG_DB_SERVER   = 26;
  81 static UINT IDH_SYS_CONTROL_MACHINE             = 27;
  82
  83 // Partition page
  84 static UINT IDH_PARTITION_PAGE                  = 28;
  85 static UINT IDH_CREATE_PARTITION                = 29;
  86 static UINT IDH_DRIVE_LIST                              = 30;
  87 static UINT IDH_PARTITION_NAME                  = 31;
  88 static UINT IDH_DONT_CREATE_PARTITION   = 32;
  89
  90 // Root volumes page
  91 static UINT IDH_ROOT_VOLUMES_PAGE                       = 33;
  92 static UINT IDH_CREATE_VOLUME                           = 34;
  93 static UINT IDH_DONT_CREATE_ROOT_VOLUMES        = 35;
  94
  95 // Replication page
  96 static UINT IDH_REPLICATION_PAGE        = 36;
  97 static UINT IDH_REPLICATE                       = 37;
  98 static UINT IDH_DONT_REPLICATE          = 38;
  99
 100 // System control page
 101 static UINT IDH_SYS_CONTROL_PAGE                = 39;
 102 static UINT IDH_SYS_CONTROL_SERVER              = 40;
 103 static UINT IDH_SYS_CONTROL_CLIENT              = 41;
 104 static UINT IDH_SYS_CONTROL_MACHINE2    = 42;
 105 static UINT IDH_DONT_CONFIGURE                  = 43;
 106
 107
 108
 109 /*
 110  *
 111  *      Arrays that map help topics to the appropriate controls___________________
 112  *
 113  */
 114
 115 static DWORD IDH_INTRO_CTX_HELP[] = {
 116     0,  0
 117 };
 118
 119 static DWORD IDH_CONFIG_SERVER_CTX_HELP[] = {
 120     0,  0
 121 };
 122
 123 static DWORD IDH_BACKUP_SERVER_CTX_HELP[] = {
 124     IDC_CONFIG_BACKUP_SERVER,           IDH_CONFIG_BACKUP_SERVER,
 125     IDC_DONT_CONFIG_BACKUP_SERVER,      IDH_DONT_CONFIG_BACKUP_SERVER,
 126     0,                              0
 127 };
 128
 129 static DWORD IDH_FILE_SERVER_CTX_HELP[] = {
 130     IDC_SHOULD_CONFIG_FILE_SERVER,              IDH_SHOULD_CONFIG_FILE_SERVER,
 131     IDC_DONT_CONFIG_FILE_SERVER,                IDH_DONT_CONFIG_FILE_SERVER,
 132     0,                                  0
 133 };
 134
 135 static DWORD IDH_CELL_AND_SERVER_INFO_CTX_HELP[] = {
 136     IDC_JOIN_EXISTING_CELL,     IDH_JOIN_EXISTING_CELL,
 137     IDC_FIRST_SERVER,           IDH_FIRST_SERVER,
 138     IDC_CELL_NAME,                      IDH_CELL_NAME,
 139     IDC_PRINCIPAL,                      IDH_PRINCIPAL,
 140     IDC_SERVER_PW,                      IDH_SERVER_PW,
 141     IDC_VERIFY_PW,                      IDH_VERIFY_PW,
 142     0,                      0
 143 };
 144
 145 static DWORD IDH_FIRST_SERVER_CTX_HELP[] = {
 146     IDC_ADMIN_NAME,                     IDH_ADMIN_NAME,
 147     IDC_ADMIN_PW,                       IDH_ADMIN_PW,
 148     IDC_VERIFY_ADMIN_PW,        IDH_VERIFY_ADMIN_PW,
 149     IDC_USE_NEXT_UID,           IDH_USE_NEXT_UID,
 150     IDC_USE_THIS_UID,           IDH_USE_THIS_UID,
 151     IDC_AFS_UID,                        IDH_AFS_UID,
 152     IDC_AFS_UID_SPINNER,        IDH_AFS_UID_SPINNER,
 153     0,                      0
 154 };
 155
 156 static DWORD IDH_EXISTING_CELL_CTX_HELP[] = {
 157     IDC_ADMIN_NAME,             IDH_ADMIN_NAME2,
 158     IDC_ADMIN_PW,               IDH_ADMIN_PW2,
 159     IDC_HOSTNAME,               IDH_HOSTNAME,
 160     0,                  0
 161 };
 162
 163 static DWORD IDH_DB_SERVER_CTX_HELP[] = {
 164     IDC_CONFIG_DB_SERVER,               IDH_CONFIG_DB_SERVER,
 165     IDC_DONT_CONFIG_DB_SERVER,  IDH_DONT_CONFIG_DB_SERVER,
 166     IDC_SYS_CONTROL_MACHINE,    IDH_SYS_CONTROL_MACHINE,
 167     0,                          0
 168 };
 169
 170 static DWORD IDH_PARTITION_CTX_HELP[] = {
 171     IDC_CREATE_PARTITION,               IDH_CREATE_PARTITION,
 172     IDC_DRIVE_LIST,                             IDH_DRIVE_LIST,
 173     IDC_PARTITION_NAME,                 IDH_PARTITION_NAME,
 174     IDC_DONT_CREATE_PARTITION,  IDH_DONT_CREATE_PARTITION,
 175     0,                          0
 176 };
 177
 178 static DWORD IDH_ROOT_VOLUMES_CTX_HELP[] = {
 179     IDC_CREATE_ROOT_VOLUMES,            IDH_CREATE_VOLUME,
 180     IDC_DONT_CREATE_ROOT_VOLUMES,       IDH_DONT_CREATE_ROOT_VOLUMES,
 181     0,                              0
 182 };
 183
 184 static DWORD IDH_REPLICATION_CTX_HELP[] = {
 185     IDC_REPLICATE,              IDH_REPLICATE,
 186     IDC_DONT_REPLICATE, IDH_DONT_REPLICATE,
 187     0,                  0
 188 };
 189
 190 static DWORD IDH_SYS_CONTROL_CTX_HELP[] = {
 191     IDC_SYS_CONTROL_SERVER,             IDH_SYS_CONTROL_SERVER,
 192     IDC_SYS_CONTROL_CLIENT,             IDH_SYS_CONTROL_CLIENT,
 193     IDC_SYS_CONTROL_MACHINE,    IDH_SYS_CONTROL_MACHINE2,
 194     IDC_DONT_CONFIGURE,                 IDH_DONT_CONFIGURE,
 195     0,                          0
 196 };
 197
 198
 199 /*
 200  *
 201  *      Config tool help__________________________________________________________
 202  *
 203  */
 204
 205 // Create partition dialog
 206 static UINT IDH_CREATE_PARTITION_DLG    = 44;
 207 static UINT IDH_CT_DRIVE_LIST                   = 45;
 208 static UINT IDH_CT_PARTITION_NAME               = 46;
 209 static UINT IDH_CREATE                                  = 47;
 210 static UINT IDH_CLOSE                                   = 48;
 211
 212 // Partitions property page
 213 static UINT IDH_PARTITIONS_PAGE         = 49;
 214 static UINT IDH_PARTITIONS_LIST         = 50;
 215 static UINT IDH_CREATE_PARTITIONS       = 51;
 216 static UINT IDH_SALVAGE                         = 52;
 217 static UINT IDH_REFORMAT                        = 53;
 218 static UINT IDH_REMOVE                          = 54;
 219
 220 // Services page
 221 static UINT IDH_SERVICES_PAGE   = 55;
 222 static UINT IDH_FS_SERVICE              = 56;
 223 static UINT IDH_DB_SERVICE              = 57;
 224 static UINT IDH_DB_DETAILS              = 58;
 225 static UINT IDH_BK_SERVICE              = 59;
 226 static UINT IDH_SCS                             = 60;
 227 static UINT IDH_SCC                             = 61;
 228 static UINT IDH_SC_MACHINE              = 62;
 229
 230 // Admin info (and other server) page
 231 static UINT IDH_ADMIN_INFO_DLG  = 63;
 232 static UINT IDH_CT_ADMIN_NAME   = 64;
 233 static UINT IDH_CT_ADMIN_PW             = 65;
 234 static UINT IDH_CT_HOSTNAME             = 66;
 235 static UINT IDH_CONFIG                  = 67;
 236
 237 // Salvage dialog
 238 static UINT IDH_SALVAGE_DLG             = 68;
 239 static UINT IDH_SERVER                  = 69;
 240 static UINT IDH_PARTITION               = 70;
 241 static UINT IDH_VOLUME                  = 71;
 242 static UINT IDH_VOLUME_NAME             = 72;
 243 static UINT IDH_ADVANCED                = 73;
 244 static UINT IDH_LOG_FILE                = 74;
 245 static UINT IDH_NUM_PROCESSES           = 75;
 246 static UINT IDH_TEMP_DIR                = 76;
 247 static UINT IDH_NUM_PROCESSES_CHECKBOX  = 77;
 248
 249 // Salvage results dialog
 250 static UINT IDH_SALVAGE_RESULTS_DLG     = 80;
 251 static UINT IDH_LOG                     = 81;
 252 static UINT IDH_CLOSE_LOG               = 82;
 253
 254
 255 /*
 256  *
 257  *      Arrays that map help topics to the appropriate controls___________________
 258  *
 259 */
 260
 261 static DWORD IDH_CREATE_PARTITION_CTX_HELP[] = {
 262     IDC_DRIVE_LIST,                     IDH_DRIVE_LIST,
 263     IDC_PARTITION_NAME,         IDH_CT_PARTITION_NAME,
 264     IDC_CREATE,                         IDH_CREATE,
 265     IDC_CLOSE,                          IDH_CLOSE,
 266     0,                      0
 267 };
 268
 269 static DWORD IDH_PARTITIONS_CTX_HELP[] = {
 270     IDC_PARTITION_LIST,         IDH_PARTITIONS_LIST,
 271     IDC_CREATE_PARTITIONS,      IDH_CREATE_PARTITIONS,
 272     IDC_SALVAGE,                        IDH_SALVAGE,
 273     IDC_REFORMAT,                       IDH_REFORMAT,
 274     IDC_REMOVE,                         IDH_REMOVE,
 275     0,                      0
 276 };
 277
 278 static DWORD IDH_SERVICES_CTX_HELP[] = {
 279     IDC_FS_SERVICE,             IDH_FS_SERVICE,
 280     IDC_DB_SERVICE,             IDH_DB_SERVICE,
 281     IDC_DB_DETAILS,             IDH_DB_DETAILS,
 282     IDC_BK_SERVICE,             IDH_BK_SERVICE,
 283     IDC_SCS,                    IDH_SCS,
 284     IDC_SCC,                    IDH_SCC,
 285     IDC_SC_MACHINE,             IDH_SC_MACHINE,
 286     0,                  0
 287 };
 288
 289 static DWORD IDH_ADMIN_INFO_CTX_HELP[] = {
 290     IDC_ADMIN_NAME,             IDH_CT_ADMIN_NAME,
 291     IDC_ADMIN_PW,               IDH_CT_ADMIN_PW,
 292     IDC_HOSTNAME,               IDH_CT_HOSTNAME,
 293     IDOK,                               IDH_CONFIG,
 294     0,                  0
 295 };
 296
 297 static DWORD IDH_SALVAGE_CTX_HELP[] = {
 298     IDC_SERVER,                 IDH_SERVER,
 299     IDC_PARTITION,              IDH_PARTITION,
 300     IDC_VOLUME,                 IDH_VOLUME,
 301     IDC_VOLUME_NAME,            IDH_VOLUME_NAME,
 302     IDC_ADVANCED,               IDH_ADVANCED,
 303     IDC_LOG_FILE,               IDH_LOG_FILE,
 304     IDC_NUM_PROCESSES,          IDH_NUM_PROCESSES,
 305     IDC_TEMP_DIR,               IDH_TEMP_DIR,
 306     IDC_NUM_PROCESSES_CHECKBOX, IDH_NUM_PROCESSES_CHECKBOX,
 307     0,                          0
 308 };
 309
 310 static DWORD IDH_SALVAGE_RESULTS_CTX_HELP[] = {
 311     IDC_LOG,                    IDH_LOG,
 312     IDC_CLOSE,                  IDH_CLOSE_LOG,
 313     0,                          0
 314 };
 315
 316
 317 /*
 318  *
 319  *      Help for both__________________________________________________________
 320  *
 321  */
 322
 323 // Get 3.4 server afs principal password dialog
 324 static UINT IDH_GET_PW_DLG      = 78;
 325 static UINT IDH_PW              = 79;
 326
 327
 328 /*
 329  *
 330  *      Arrays that map help topics to the appropriate controls___________________
 331  *
 332 */
 333
 334 static DWORD IDH_GET_PW_CTX_HELP[] = {
 335     IDC_PW,     IDH_PW,
 336     0,          0
 337 };
 338
 339
 340
 341
 342 /*
 343  * EXPORTED FUNCTIONS _________________________________________________________
 344  *
 345  */
 346 void RegisterConfigToolHelp()
 347 {
 348     AfsAppLib_RegisterHelp(IDD_CREATE_PARTITION, IDH_CREATE_PARTITION_CTX_HELP, IDH_CREATE_PARTITION_DLG);
 349     AfsAppLib_RegisterHelp(IDD_PARTITIONS_PAGE, IDH_PARTITIONS_CTX_HELP, IDH_PARTITIONS_PAGE);
 350     AfsAppLib_RegisterHelp(IDD_SERVICES_PAGE, IDH_SERVICES_CTX_HELP, IDH_SERVICES_PAGE);
 351     AfsAppLib_RegisterHelp(IDD_ADMIN_INFO, IDH_ADMIN_INFO_CTX_HELP, IDH_ADMIN_INFO_DLG);
 352     AfsAppLib_RegisterHelp(IDD_GET_PW, IDH_GET_PW_CTX_HELP, IDH_GET_PW_DLG);
 353     AfsAppLib_RegisterHelp(IDD_SALVAGE, IDH_SALVAGE_CTX_HELP, IDH_SALVAGE_DLG);
 354     AfsAppLib_RegisterHelp(IDD_SALVAGE_RESULTS, IDH_SALVAGE_RESULTS_CTX_HELP, IDH_SALVAGE_RESULTS_DLG);
 355 }
 356
 357 void RegisterWizardHelp()
 358 {
 359     AfsAppLib_RegisterHelp(IDD_INTRO_PAGE, IDH_INTRO_CTX_HELP, IDH_INTRO_PAGE);
 360     AfsAppLib_RegisterHelp(IDD_INFO_PAGE, IDH_CELL_AND_SERVER_INFO_CTX_HELP, IDH_INFO_PAGE);
 361     AfsAppLib_RegisterHelp(IDD_INFO_PAGE2_FIRST_SERVER, IDH_FIRST_SERVER_CTX_HELP, IDH_FIRST_SERVER_PAGE);
 362     AfsAppLib_RegisterHelp(IDD_INFO_PAGE2_NOT_FIRST_SERVER, IDH_EXISTING_CELL_CTX_HELP, IDH_EXISTING_CELL_PAGE);
 363     AfsAppLib_RegisterHelp(IDD_FILE_SERVER_PAGE, IDH_FILE_SERVER_CTX_HELP, IDH_FILE_SERVER_PAGE);
 364     AfsAppLib_RegisterHelp(IDD_DB_SERVER_PAGE, IDH_DB_SERVER_CTX_HELP, IDH_DB_SERVER_PAGE);
 365     AfsAppLib_RegisterHelp(IDD_BACKUP_SERVER_PAGE, IDH_BACKUP_SERVER_CTX_HELP, IDH_BACKUP_SERVER_PAGE);
 366     AfsAppLib_RegisterHelp(IDD_PARTITION_PAGE, IDH_PARTITION_CTX_HELP, IDH_PARTITION_PAGE);
 367     AfsAppLib_RegisterHelp(IDD_ROOT_VOLUMES_PAGE, IDH_ROOT_VOLUMES_CTX_HELP, IDH_ROOT_VOLUMES_PAGE);
 368     AfsAppLib_RegisterHelp(IDD_REPLICATION_PAGE, IDH_REPLICATION_CTX_HELP, IDH_REPLICATION_PAGE);
 369     AfsAppLib_RegisterHelp(IDD_SYS_CONTROL_PAGE, IDH_SYS_CONTROL_CTX_HELP, IDH_SYS_CONTROL_PAGE);
 370     AfsAppLib_RegisterHelp(IDD_GET_PW, IDH_GET_PW_CTX_HELP, IDH_GET_PW_DLG);
 371     AfsAppLib_RegisterHelp(IDD_CONFIG_SERVER_PAGE, IDH_CONFIG_SERVER_CTX_HELP, IDH_CONFIG_SERVER_PAGE);
 372 }
 373