almisc.c File Reference

#include "precomp.h"

Go to the source code of this file.

Classes
struct	_tagMENUITEM
struct	_tagMENUCOOKIE
Defines
#define	KEY_UP   1
#define	KEY_DOWN   2
Typedefs
typedef _tagMENUITEM	MENUITEM
typedef _tagMENUITEM *	PMENUITEM
typedef _tagMENUCOOKIE	MENUCOOKIE
typedef _tagMENUCOOKIE *	PMENUCOOKIE
Functions
ARC_STATUS	AlpFreeComponents (IN PCHAR *EnvVarComponents)
BOOLEAN	AlpMatchComponent (IN PCHAR Value1, IN PCHAR Value2)
ARC_STATUS	AlGetEnvVarComponents (IN PCHAR EnvValue, OUT PCHAR **EnvVarComponents, OUT PULONG PNumComponents)
ARC_STATUS	AlFreeEnvVarComponents (IN PCHAR *EnvVarComponents)
BOOLEAN	AlFindNextMatchComponent (IN PCHAR EnvValue, IN PCHAR MatchValue, IN ULONG StartComponent, OUT PULONG MatchComponent OPTIONAL)
ARC_STATUS	AlAddSystemPartition (IN PCHAR NewSystemPartition)
VOID	MarkLine (ULONG Line, BOOLEAN Selected, PCHAR String)
BOOLEAN	CommonMenuDisplay (PMENUCOOKIE Menu, BOOLEAN StaticMenu, PCHAR Items[], ULONG ItemCount, BOOLEAN PrintOnly, ULONG AssociatedDataOfDefaultChoice, ULONG *AssociatedDataOfChoice, PCHAR MenuName, ULONG Row)
char	GetChar (VOID)
BOOLEAN	AlInitializeMenuPackage (VOID)
ULONG	AlGetMenuNumberItems (PVOID MenuID)
ULONG	AlGetMenuAssociatedData (PVOID MenuID, ULONG n)
BOOLEAN	AlNewMenu (PVOID *MenuID)
VOID	AlFreeMenu (PVOID MenuID)
BOOLEAN	AlAddMenuItem (PVOID MenuID, PCHAR Text, ULONG AssociatedData, ULONG Attributes)
BOOLEAN	AlAddMenuItems (PVOID MenuID, PCHAR Text[], ULONG ItemCount)
BOOLEAN	AlDisplayMenu (PVOID MenuID, BOOLEAN PrintOnly, ULONG AssociatedDataOfDefaultChoice, ULONG *AssociatedDataOfChoice, ULONG Row, PCHAR MenuName)
BOOLEAN	AlDisplayStaticMenu (PCHAR Items[], ULONG ItemCount, ULONG DefaultChoice, ULONG Row, ULONG *IndexOfChoice)
VOID	AlWaitKey (PCHAR Prompt)
VOID	vAlStatusMsg (IN ULONG Row, IN BOOLEAN Error, IN PCHAR FormatString, IN va_list ArgumentList)
VOID	AlStatusMsg (IN ULONG TopRow, IN ULONG BottomRow, IN BOOLEAN Error, IN PCHAR FormatString,...)
VOID	AlStatusMsgNoWait (IN ULONG TopRow, IN ULONG BottomRow, IN BOOLEAN Error, IN PCHAR FormatString,...)
VOID	AlClearStatusArea (IN ULONG TopRow, IN ULONG BottomRow)
ARC_STATUS	AlGetMenuSelection (IN PCHAR szTitle, IN PCHAR *rgszSelections, IN ULONG crgsz, IN ULONG crow, IN ULONG irgszDefault, OUT PULONG pirgsz, OUT PCHAR *pszSelection)
PCHAR	AlStrDup (IN PCHAR szString)
PCHAR	AlCombinePaths (IN PCHAR szPath1, IN PCHAR szPath2)
VOID	AlFreeArray (IN BOOLEAN fFreeArray, IN PCHAR *rgsz, IN ULONG csz)
ARC_STATUS	AlGetBase (IN PCHAR szPath, OUT PCHAR *pszBase)
PCHAR	AlGetNextArcNamToken (IN PCHAR TokenString, OUT PCHAR OutputToken, OUT PULONG UnitNumber)
ULONG	AlMatchArcNamToken (IN PCHAR TokenValue, IN TOKEN_TYPE TokenType)
ULONG	AlPrint (PCHAR Format,...)
BOOLEAN	AlGetString (OUT PCHAR String, IN ULONG StringLength)
Variables
char	MARGIN [] = " "
char	MSGMARGIN [] = " "
PCHAR	AdapterTypes [AdapterMaximum+1] = {"eisa","scsi", "multi", NULL}
PCHAR	ControllerTypes [ControllerMaximum+1] = {"cdrom", "disk", NULL}
PCHAR	PeripheralTypes [PeripheralMaximum+1] = {"rdisk", "fdisk", NULL}

---

Define Documentation

#define KEY_DOWN   2

Definition at line 590 of file almisc.c. Referenced by CommonMenuDisplay(), and GetChar().

#define KEY_UP   1

Definition at line 589 of file almisc.c. Referenced by CommonMenuDisplay(), and GetChar().

---

Typedef Documentation

typedef struct _tagMENUCOOKIE MENUCOOKIE

typedef struct _tagMENUITEM MENUITEM

typedef struct _tagMENUCOOKIE* PMENUCOOKIE

Referenced by AlAddMenuItem(), AlDisplayMenu(), AlFreeMenu(), AlGetMenuAssociatedData(), AlGetMenuNumberItems(), and AlNewMenu().

typedef struct _tagMENUITEM* PMENUITEM

Referenced by AlAddMenuItem().

---

Function Documentation

BOOLEAN AlAddMenuItem (  PVOID  MenuID, PCHAR  Text, ULONG  AssociatedData, ULONG  Attributes )

Definition at line 684 of file almisc.c. References AlAllocateHeap(), AlReallocateHeap(), _tagMENUITEM::AssociatedData, FALSE, _tagMENUCOOKIE::ItemCount, _tagMENUCOOKIE::Items, NULL, PMENUCOOKIE, PMENUITEM, strlen(), _tagMENUITEM::Text, and TRUE. Referenced by AlAddMenuItems(), ChooseDisk(), DoMakePartitionSystemPartition(), DoPartitionCreate(), and DoPartitionDelete(). { PMENUCOOKIE Menu = MenuID; PMENUITEM p; DBG_UNREFERENCED_PARAMETER(Attributes); if(!Menu->ItemCount) { if((Menu->Items = AlAllocateHeap(sizeof(MENUITEM))) == NULL) { return(FALSE); } Menu->ItemCount = 1; p = Menu->Items; } else { if((p = AlReallocateHeap(Menu->Items,sizeof(MENUITEM)*(Menu->ItemCount+1))) == NULL) { return(FALSE); } Menu->Items = p; p = &Menu->Items[Menu->ItemCount++]; } if((p->Text = AlAllocateHeap(strlen(Text)+1)) == NULL) { return(FALSE); } strcpy(p->Text,Text); p->AssociatedData = AssociatedData; return(TRUE); }

BOOLEAN AlAddMenuItems (  PVOID  MenuID, PCHAR  Text[], ULONG  ItemCount )

Definition at line 720 of file almisc.c. References AlAddMenuItem(), AlGetMenuNumberItems(), FALSE, and TRUE. Referenced by AlGetMenuSelection(), ConfigureSystemPartitions(), and main(). { ULONG base,i; base = AlGetMenuNumberItems(MenuID); for(i=0; i<ItemCount; i++) { if(!AlAddMenuItem(MenuID,Text[i],i+base,0)) { return(FALSE); } } return(TRUE); }

ARC_STATUS AlAddSystemPartition (  IN PCHAR  NewSystemPartition  )

Definition at line 424 of file almisc.c. References ARC_STATUS, ArcGetEnvironmentVariable, ArcSetEnvironmentVariable, CHAR, E2BIG, ESUCCESS, MAXIMUM_ENVIRONMENT_VALUE, NULL, Status, and strlen(). Referenced by DoMakePartitionSystemPartition(), and DoSystemPartitionCreate(). : This routine adds a system partition to the SystemPartition environment variable, and updates the Osloader, OsloadPartition, OsloadFilename, and OsloadOptions variables. Arguments: SystemPartition - Supplies a pointer to the pathname of the system partition to add. Return Value: If the system partition was successfully added, ESUCCESS is returned, otherwise an error code is returned. BUGBUG - This program is simplistic and doesn't attempt to make sure all the variables are consistent. It also doesn't fail gracefully. --*/ { ARC_STATUS Status; PCHAR SystemPartition; CHAR TempValue[MAXIMUM_ENVIRONMENT_VALUE]; //PCHAR Osloader; //PCHAR OsloadPartition; //PCHAR OsloadFilename; //PCHAR OsloadOptions; // // Get the system partition environment variable. // SystemPartition = ArcGetEnvironmentVariable("SystemPartition"); // // If the variable doesn't exist, add it and exit. // if (SystemPartition == NULL) { if(strlen(NewSystemPartition) < MAXIMUM_ENVIRONMENT_VALUE) { Status = ArcSetEnvironmentVariable("SystemPartition", NewSystemPartition); } else { Status = E2BIG; } return Status; } // // If the variable exists, add the new partition to the end. // if(strlen(SystemPartition)+strlen(NewSystemPartition)+2 > MAXIMUM_ENVIRONMENT_VALUE) { return(E2BIG); } strcpy(TempValue, SystemPartition); strcat(TempValue, ";"); strcat(TempValue, NewSystemPartition); Status = ArcSetEnvironmentVariable("SystemPartition", TempValue); if (Status != ESUCCESS) { return Status; } #if 0 // // Add semicolons to the end of each of the associated variables. // If they don't exist add them. // // // Get the Osloader environment variable and add a semicolon to the end. // Osloader = ArcGetEnvironmentVariable("Osloader"); if (Osloader == NULL) { *TempValue = 0; } else { strcpy(TempValue, Osloader); } strcat(TempValue, ";"); Status = ArcSetEnvironmentVariable("Osloader",TempValue); if (Status != ESUCCESS) { return Status; } // // Get the OsloadPartition environment variable and add a semicolon to the end. // OsloadPartition = ArcGetEnvironmentVariable("OsloadPartition"); if (OsloadPartition == NULL) { *TempValue = 0; } else { strcpy(TempValue, OsloadPartition); } strcat(TempValue, ";"); Status = ArcSetEnvironmentVariable("OsloadPartition",TempValue); if (Status != ESUCCESS) { return Status; } // // Get the OsloadFilename environment variable and add a semicolon to the end. // OsloadFilename = ArcGetEnvironmentVariable("OsloadFilename"); if (OsloadFilename == NULL) { *TempValue = 0; } else { strcpy(TempValue, OsloadFilename); } strcat(TempValue, ";"); Status = ArcSetEnvironmentVariable("OsloadFilename",TempValue); if (Status != ESUCCESS) { return Status; } // // Get the OsloadOptions environment variable and add a semicolon to the end. // OsloadOptions = ArcGetEnvironmentVariable("OsloadOptions"); if (OsloadOptions == NULL) { *TempValue = 0; } else { strcpy(TempValue, OsloadOptions); } strcat(TempValue, ";"); Status = ArcSetEnvironmentVariable("OsloadOptions",TempValue); #endif return Status; }

VOID AlClearStatusArea (  IN ULONG  TopRow, IN ULONG  BottomRow )

Definition at line 1010 of file almisc.c. References AlClearLine, and AlSetPosition. Referenced by AlStatusMsg(), AlStatusMsgNoWait(), Confirm(), DoPartitionCreate(), PrintError(), PrintErrorMsg(), and PrintMsg(). { ULONG i; for(i=BottomRow; i>=TopRow; --i) { AlSetPosition(i,0); AlClearLine(); } }

PCHAR AlCombinePaths (  IN PCHAR  szPath1, IN PCHAR  szPath2 )

Definition at line 1150 of file almisc.c. References AlAllocateHeap(), NULL, and strlen(). : This routine combines to strings. It allocate a new string to hold both strings. Arguments: pointer to combined path. NULL if failed to allocate. Return Value: --*/ { PCHAR szT; if (szT = AlAllocateHeap(strlen(szPath1) + strlen(szPath2) + 1)) { strcpy(szT, szPath1); strcat(szT, szPath2); return( szT ); } else { return ( NULL ); } }

BOOLEAN AlDisplayMenu (  PVOID  MenuID, BOOLEAN  PrintOnly, ULONG  AssociatedDataOfDefaultChoice, ULONG *  AssociatedDataOfChoice, ULONG  Row, PCHAR  MenuName )

Definition at line 740 of file almisc.c. References CommonMenuDisplay(), FALSE, NULL, and PMENUCOOKIE. Referenced by AlGetMenuSelection(), ChooseDisk(), ConfigureSystemPartitions(), DoMakePartitionSystemPartition(), DoPartitionCreate(), DoPartitionDelete(), and main(). { return(CommonMenuDisplay((PMENUCOOKIE)MenuID, FALSE, NULL, ((PMENUCOOKIE)MenuID)->ItemCount, PrintOnly, AssociatedDataOfDefaultChoice, AssociatedDataOfChoice, MenuName, Row ) ); }

BOOLEAN AlDisplayStaticMenu (  PCHAR  Items[], ULONG  ItemCount, ULONG  DefaultChoice, ULONG  Row, ULONG *  IndexOfChoice )

Definition at line 764 of file almisc.c. References CommonMenuDisplay(), FALSE, NULL, and TRUE. { return(CommonMenuDisplay(NULL, TRUE, Items, ItemCount, FALSE, DefaultChoice, IndexOfChoice, NULL, Row ) ); }

BOOLEAN AlFindNextMatchComponent (  IN PCHAR  EnvValue, IN PCHAR  MatchValue, IN ULONG  StartComponent, OUT PULONG MatchComponent  OPTIONAL )

Definition at line 361 of file almisc.c. References AlFreeEnvVarComponents(), AlGetEnvVarComponents(), AlpMatchComponent(), ARC_STATUS, ESUCCESS, FALSE, Index, Status, and TRUE. Referenced by IsBootSelectionPartition(). : This routine compares each component of EnvValue, starting with StartComponent, until a match is found or there are no more components. Arguments: EnvValue - Supplies a pointer to the environment variable value. MatchValue - Supplies a pointer to the value to match. StartComponent - Supplies the component number to start the match. MatchComponent - Supplies an optional pointer to a variable to receive the number of the component that matched. Return Value: If a match is found, TRUE is returned, otherwise FALSE is returned. --*/ { ARC_STATUS Status; PCHAR *EnvVarComponents; ULONG NumComponents; ULONG Index; BOOLEAN Match; Status = AlGetEnvVarComponents(EnvValue, &EnvVarComponents, &NumComponents); if (Status != ESUCCESS) { return FALSE; } Match = FALSE; for (Index = StartComponent ; Index < NumComponents ; Index++ ) { if (AlpMatchComponent(EnvVarComponents[Index], MatchValue)) { Match = TRUE; break; } } if (ARGUMENT_PRESENT(MatchComponent)) { *MatchComponent = Index; } AlFreeEnvVarComponents(EnvVarComponents); return Match; }

VOID AlFreeArray (  IN BOOLEAN  fFreeArray, IN PCHAR *  rgsz, IN ULONG  csz )

Definition at line 1190 of file almisc.c. References AlDeallocateHeap(). : This routine iterates through an array of pointers to strings freeing each string and finally the array itself. Arguments: fFreeArray - flag wither to free the array itself. rgsz - pointer to array of strings. csz - size of array. Return Value: --*/ { ULONG irgsz; if (!csz) { return; } for( irgsz = 0; irgsz < csz; irgsz++ ) { if (rgsz[irgsz]) { AlDeallocateHeap(rgsz[irgsz]); } else { break; } } if (fFreeArray) { AlDeallocateHeap( rgsz ); } }

ARC_STATUS AlFreeEnvVarComponents (  IN PCHAR *  EnvVarComponents  )

Definition at line 209 of file almisc.c. References AlDeallocateHeap(), AlpFreeComponents(), ARC_STATUS, EACCES, ESUCCESS, NULL, and Status. Referenced by AlFindNextMatchComponent(). : This routine frees up all the components in the ptr array and frees up the storage for the ptr array itself too Arguments: EnvVarComponents: the ptr to the PCHAR * Buffer Return Value: ESUCCESS if freeing successful EACCES if memory ptr invalid --*/ { ARC_STATUS Status; // // if the pointer is NULL just return success // if (EnvVarComponents == NULL) { return (ESUCCESS); } // // free all the components first, if error in freeing return // Status = AlpFreeComponents(EnvVarComponents); if (Status != ESUCCESS) { return Status; } // // free the component holder too // if( AlDeallocateHeap(EnvVarComponents) != NULL) { return (EACCES); } else { return (ESUCCESS); } }

VOID AlFreeMenu (  PVOID  MenuID  )

Definition at line 664 of file almisc.c. References AlDeallocateHeap(), _tagMENUCOOKIE::ItemCount, _tagMENUCOOKIE::Items, NULL, PMENUCOOKIE, and _tagMENUITEM::Text. Referenced by AlGetMenuSelection(), ConfigureSystemPartitions(), DoMakePartitionSystemPartition(), DoPartitionCreate(), and DoPartitionDelete(). { PMENUCOOKIE p = MenuID; ULONG i; for(i=0; i<p->ItemCount; i++) { if(p->Items[i].Text != NULL) { AlDeallocateHeap(p->Items[i].Text); } } if(p->Items) { AlDeallocateHeap(p->Items); } AlDeallocateHeap(p); }

ARC_STATUS AlGetBase (  IN PCHAR  szPath, OUT PCHAR *  pszBase )

Definition at line 1244 of file almisc.c. References AlDeallocateHeap(), AlStrDup(), EBADSYNTAX, ENOMEM, ESUCCESS, and NULL. : This routine strips the filename off a path. Arguments: szPath - path to strip. Return Value: pszBaseh - pointer to buffer holding new base. (this is a copy) --*/ { PCHAR szPathT; // // Make local copy of szArcInstPath so we can alter it // *pszBase = AlStrDup(szPath); if ( *pszBase == NULL ) { return( ENOMEM ); } // // The start of the path part should be either a \ or a ) where // ) is the end of the arc name // if ((szPathT = strrchr(*pszBase,'\\')) == 0) { if ((szPathT = strrchr(*pszBase, ')')) == 0) { AlDeallocateHeap(*pszBase); return( EBADSYNTAX ); } } // // Cut filename out // // szPath points to either ')' or '\' so need to move over that // onto actual name // *(szPathT + 1) = 0; return( ESUCCESS ); }

ARC_STATUS AlGetEnvVarComponents (  IN PCHAR  EnvValue, OUT PCHAR **  EnvVarComponents, OUT PULONG  PNumComponents )

Definition at line 26 of file almisc.c. References AlAllocateHeap(), AlpFreeComponents(), EACCES, ENOMEM, ESUCCESS, MAX_COMPONENTS, and NULL. Referenced by AlFindNextMatchComponent(). : This routine takes an environment variable string and turns it into the constituent value strings: Example EnvValue = "Value1;Value2;Value3" is turned into: "Value1", "Value2", "Value3" The following are valid value strings: 1. " " :one null value is found 2. ";;;; " :five null values are found 3. " ;Value1 ; Value2;Value3;;;;;;; ;" :12 value strings are found, :9 of which are null If an invalid component (contains embedded white space) is found in the string then this routine attempts to resynch to the next value, no error is returned, and a the first part of the invalid value is returned for the bad component. 1. " Value1;Bad Value2; Value3" : 2 value strings are found The value strings returned suppress all whitespace before and after the value. Arguments: EnvValue: ptr to zero terminated environment value string EnvVarComponents: ptr to a PCHAR * variable to receive the buffer of ptrs to the constituent value strings. PNumComponents: ptr to a ULONG to receive the number of value strings found Return Value: The function returns the following error codes: EACCES if EnvValue is NULL ENOMEM if the memory allocation fails The function returns the following success codes: ESUCCESS. When the function returns ESUCCESS: - *PNumComponent field gets the number of value strings found - if the number is non zero the *EnvVarComponents field gets the ptr to the buffer containing ptrs to value strings --*/ { PCHAR pchStart, pchEnd, pchNext; PCHAR pchComponents[MAX_COMPONENTS + 1]; ULONG NumComponents, i; PCHAR pch; ULONG size; // // Validate the EnvValue // if (EnvValue == NULL) { return (EACCES); } // // Initialise the ptr array with nulls // for (i = 0; i < (MAX_COMPONENTS+1); i++) { pchComponents[i] = NULL; } // // Initialise ptrs to search components // pchStart = EnvValue; NumComponents = 0; // // search till either pchStart reaches the end or till max components // is reached, the below has been programmed from a dfsa. // while (*pchStart && NumComponents < MAX_COMPONENTS) { // // STATE 1: find the beginning of next variable value // while (*pchStart!=0 && isspace(*pchStart)) { pchStart++; } if (*pchStart == 0) { break; } // // STATE 2: In the midst of a value // pchEnd = pchStart; while (*pchEnd!=0 && !isspace(*pchEnd) && *pchEnd!=';') { pchEnd++; } // // STATE 3: spit out the value found // size = pchEnd - pchStart; if ((pch = AlAllocateHeap(size+1)) == NULL) { AlpFreeComponents(pchComponents); return (ENOMEM); } strncpy (pch, pchStart, size); pch[size]=0; pchComponents[NumComponents++]=pch; // // STATE 4: variable value end has been reached, find the beginning // of the next value // if ((pchNext = strchr(pchEnd, ';')) == NULL) { break; // out of the big while loop because we are done } // // Advance beyond the semicolon. // pchNext++; // // reinitialise to begin STATE 1 // pchStart = pchNext; } // end while. // // Get memory to hold an environment pointer and return that // if ( NumComponents!=0 ) { PCHAR *pch; if ((pch = (PCHAR *)AlAllocateHeap((NumComponents+1)*sizeof(PCHAR))) == NULL) { AlpFreeComponents(pchComponents); return (ENOMEM); } // // the last one is NULL because we initialised the array with NULLs // for ( i = 0; i <= NumComponents; i++) { pch[i] = pchComponents[i]; } *EnvVarComponents = pch; } // // Update the number of elements field and return success // *PNumComponents = NumComponents; return (ESUCCESS); }

ULONG AlGetMenuAssociatedData (  PVOID  MenuID, ULONG  n )

Definition at line 638 of file almisc.c. References n, and PMENUCOOKIE. { return(((PMENUCOOKIE)MenuID)->Items[n].AssociatedData); }

ULONG AlGetMenuNumberItems (  PVOID  MenuID  )

Definition at line 629 of file almisc.c. References PMENUCOOKIE. Referenced by AlAddMenuItems(). { return(((PMENUCOOKIE)MenuID)->ItemCount); }

ARC_STATUS AlGetMenuSelection (  IN PCHAR  szTitle, IN PCHAR *  rgszSelections, IN ULONG  crgsz, IN ULONG  crow, IN ULONG  irgszDefault, OUT PULONG  pirgsz, OUT PCHAR *  pszSelection )

Definition at line 1025 of file almisc.c. References AlAddMenuItems(), AlDisplayMenu(), AlFreeMenu(), AlNewMenu(), ENOMEM, ESUCCESS, FALSE, NULL, and szTitle. : This routine takes an array of strings, turns them into a menu and gets a selection. If ESC hit then ESUCCESS is returned with the *pszSelection NULL. crgsz is assume to be 1 or greater. Arguments: szTitle - Pointer to menu title to pass to AlDisplayMenu prgszSelection - pointer to an array of strings for menu crgsz - count of strings irgszDefault - index in rgszSelection to use as default selection Return Value: irgsz - index to selection pszSelection - pointer int rgszSelection for selection. Note that this is not a dup and should not be freed seperately then rgszSelections. Note: if ARC_STATUS == ESUCCESS and pszSelection == NULL then the menu was successfully displayed but the user hit ESC to select nothing from the menu. --*/ { PVOID hdMenuId; *pszSelection = NULL; if (!AlNewMenu(&hdMenuId)) { return( ENOMEM ); } // // BUGBUG for now 1 selection will also build a menu, in the // future once this is working we should just return that selection // if (!AlAddMenuItems(hdMenuId, rgszSelections, crgsz)) { AlFreeMenu(hdMenuId); return( ENOMEM ); } if (!AlDisplayMenu(hdMenuId, FALSE, irgszDefault, pirgsz, crow, szTitle)) { // // User did not pick a system partition. return NULL // can caller should abort // AlFreeMenu(hdMenuId); return( ESUCCESS ); } AlFreeMenu(hdMenuId); *pszSelection = rgszSelections[*pirgsz]; return( ESUCCESS ); }

PCHAR AlGetNextArcNamToken (  IN PCHAR  TokenString, OUT PCHAR  OutputToken, OUT PULONG  UnitNumber )

Definition at line 1318 of file almisc.c. References NULL. Referenced by ChooseDisk(). : This routine scans the specified token string for the next token and unit number. The token format is: name[(unit)] Arguments: TokenString - Supplies a pointer to a zero terminated token string. OutputToken - Supplies a pointer to a variable that receives the next token. UnitNumber - Supplies a pointer to a variable that receives the unit number. Return Value: If another token exists in the token string, then a pointer to the start of the next token is returned. Otherwise, a value of NULL is returned. --*/ { // // If there are more characters in the token string, then parse the // next token. Otherwise, return a value of NULL. // if (*TokenString == '\0') { return NULL; } else { while ((*TokenString != '\0') && (*TokenString != '(')) { *OutputToken++ = *TokenString++; } *OutputToken = '\0'; // // If a unit number is specified, then convert it to binary. // Otherwise, default the unit number to zero. // *UnitNumber = 0; if (*TokenString == '(') { TokenString += 1; while ((*TokenString != '\0') && (*TokenString != ')')) { *UnitNumber = (*UnitNumber * 10) + (*TokenString++ - '0'); } if (*TokenString == ')') { TokenString += 1; } } } return TokenString; }

BOOLEAN AlGetString (  OUT PCHAR  String, IN ULONG  StringLength )

Definition at line 1508 of file almisc.c. References ARC_CONSOLE_INPUT, ARC_CONSOLE_OUTPUT, ArcRead, ArcWrite, ASCI_ESC, Buffer, c, CHAR, Count, ESUCCESS, FALSE, String, StringLength(), and TRUE. Referenced by AlWaitKey(), CommonMenuDisplay(), and DoPartitionCreate(). 01515 : 01516 01517 This routine reads a string from standardin until a 01518 carriage return or escape is found or StringLength is reached. 01519 01520 Arguments: 01521 01522 String - Supplies a pointer to where the string will be stored. 01523 01524 StringLength - Supplies the Max Length to read. 01525 01526 Return Value: 01527 01528 FALSE if user pressed esc, TRUE otherwise. 01529 01530 --*/ 01531 01532 { 01533 CHAR c; 01534 ULONG Count; 01535 PCHAR Buffer; 01536 01537 Buffer = String; 01538 while (ArcRead(ARC_CONSOLE_INPUT,&c,1,&Count)==ESUCCESS) { 01539 if(c == ASCI_ESC) { 01540 return(FALSE); 01541 } 01542 if ((c=='\r') || (c=='\n') || ((ULONG)(Buffer-String) == StringLength)) { 01543 *Buffer='\0'; 01544 ArcWrite(ARC_CONSOLE_OUTPUT,"\r\n",2,&Count); 01545 return(TRUE); 01546 } 01547 // 01548 // Check for backspace; 01549 // 01550 if (c=='\b') { 01551 if (((ULONG)Buffer > (ULONG)String)) { 01552 Buffer--; 01553 ArcWrite(ARC_CONSOLE_OUTPUT,"\b \b",3,&Count); 01554 } 01555 } else { 01556 // 01557 // If it's a printable char store it and display it. 01558 // 01559 if (isprint(c)) { 01560 *Buffer++ = c; 01561 ArcWrite(ARC_CONSOLE_OUTPUT,&c,1,&Count); 01562 } 01563 } 01564 } 01565 } }

BOOLEAN AlInitializeMenuPackage (  VOID   )

Definition at line 620 of file almisc.c. References TRUE. Referenced by main(). { return(TRUE); }

ULONG AlMatchArcNamToken (  IN PCHAR  TokenValue, IN TOKEN_TYPE  TokenType )

Definition at line 1391 of file almisc.c. References AdapterTypes, ControllerType, ControllerTypes, FALSE, Index, INVALID_TOKEN_TYPE, INVALID_TOKEN_VALUE, NULL, PeripheralType, PeripheralTypes, and TRUE. : This routine attempts to match a token with an array of possible values. Arguments: TokenValue - Supplies a pointer to a zero terminated token value. TokenType - Indicates which type of token we are dealing with (AdapterType/ControllerType/PeripheralType) Return Value: If the token type is invalid, INVALID_TOKEN_TYPE is returned. If a token match is not located, then a value INVALID_TOKEN_VALUE is returned. If a token match is located, then the ENUM value of the token is returned. --*/ { ULONG Index; PCHAR MatchString; PCHAR TokenString; PCHAR *TokenArray; BOOLEAN Found; // // Depending on token type choose the appropriate token string array // switch (TokenType) { case AdapterType: TokenArray = AdapterTypes; break; case ControllerType: TokenArray = ControllerTypes; break; case PeripheralType: TokenArray = PeripheralTypes; break; default: return ((ULONG)INVALID_TOKEN_TYPE); } // // Scan the match array until either a match is found or all of // the match strings have been scanned. // // BUGBUG** The code below can be easily implemented using _strcmpi. // Index = 0; Found = FALSE; while (TokenArray[Index] != NULL) { MatchString = TokenArray[Index]; TokenString = TokenValue; while ((*MatchString != '\0') && (*TokenString != '\0')) { if (toupper(*MatchString) != toupper(*TokenString)) { break; } MatchString += 1; TokenString += 1; } if ((*MatchString == '\0') && (*TokenString == '\0')) { Found = TRUE; break; } Index += 1; } return (Found ? Index : INVALID_TOKEN_VALUE); }

BOOLEAN AlNewMenu (  PVOID *  MenuID  )

Definition at line 647 of file almisc.c. References AlAllocateHeap(), FALSE, _tagMENUCOOKIE::ItemCount, _tagMENUCOOKIE::Items, NULL, PMENUCOOKIE, and TRUE. Referenced by AlGetMenuSelection(), ChooseDisk(), ConfigureSystemPartitions(), DoMakePartitionSystemPartition(), DoPartitionCreate(), DoPartitionDelete(), and main(). { PMENUCOOKIE p; if(!(p = AlAllocateHeap(sizeof(MENUCOOKIE)))) { return(FALSE); } p->ItemCount = 0; p->Items = NULL; *MenuID = p; return(TRUE); }

ARC_STATUS AlpFreeComponents (  IN PCHAR *  EnvVarComponents  )

Definition at line 265 of file almisc.c. References AlDeallocateHeap(), EACCES, ESUCCESS, and NULL. Referenced by AlFreeEnvVarComponents(), and AlGetEnvVarComponents(). : This routine frees up only the components in the ptr array, but doesn't free the ptr array storage itself. Arguments: EnvVarComponents: the ptr to the PCHAR * Buffer Return Value: ESUCCESS if freeing successful EACCES if memory ptr invalid --*/ { // // get all the components and free them // while (*EnvVarComponents != NULL) { if(AlDeallocateHeap(*EnvVarComponents++) != NULL) { return(EACCES); } } return(ESUCCESS); }

BOOLEAN AlpMatchComponent (  IN PCHAR  Value1, IN PCHAR  Value2 )

Definition at line 303 of file almisc.c. References FALSE, and TRUE. Referenced by AlFindNextMatchComponent(). : This routine compares two components to see if they are equal. This is essentially comparing strings except that leading zeros are stripped from key values. Arguments: Value1 - Supplies a pointer to the first value to match. Value2 - Supplies a pointer to the second value to match. Return Value: If the components match, TRUE is returned, otherwise FALSE is returned. --*/ { while ((*Value1 != 0) && (*Value2 != 0)) { if (tolower(*Value1) != tolower(*Value2)) { return FALSE; } if (*Value1 == '(') { do { *Value1++; } while (*Value1 == '0'); } else { *Value1++; } if (*Value2 == '(') { do { *Value2++; } while (*Value2 == '0'); } else { *Value2++; } } if ((*Value1 == 0) && (*Value2 == 0)) { return TRUE; } return FALSE; }

ULONG AlPrint (  PCHAR  Format,   ... )

Definition at line 1483 of file almisc.c. References ARC_CONSOLE_OUTPUT, ArcWrite, Buffer, and Count. Referenced by AlRtAllocateHeap(), AlRtFreeHeap(), AlRtReAllocateHeap(), AlWaitKey(), CommonMenuDisplay(), Confirm(), DoPartitionCreate(), FdiskInitialize(), FmtVerifySectors(), main(), MarkLine(), and vAlStatusMsg(). { va_list arglist; UCHAR Buffer[256]; ULONG Count; ULONG Length; // // Format the output into a buffer and then print it. // va_start(arglist, Format); Length = vsprintf(Buffer, Format, arglist); ArcWrite( ARC_CONSOLE_OUTPUT, Buffer, Length, &Count); va_end(arglist); return 0; }

VOID AlStatusMsg (  IN ULONG  TopRow, IN ULONG  BottomRow, IN BOOLEAN  Error, IN PCHAR  FormatString,   ... )

Definition at line 974 of file almisc.c. References AlClearStatusArea(), AlWaitKey(), Error, NULL, and vAlStatusMsg(). { va_list ArgList; va_start(ArgList,FormatString); vAlStatusMsg(TopRow,Error,FormatString,ArgList); AlWaitKey(NULL); AlClearStatusArea(TopRow,BottomRow); }

VOID AlStatusMsgNoWait (  IN ULONG  TopRow, IN ULONG  BottomRow, IN BOOLEAN  Error, IN PCHAR  FormatString,   ... )

Definition at line 993 of file almisc.c. References AlClearStatusArea(), Error, and vAlStatusMsg(). Referenced by DoSystemPartitionCreate(). { va_list ArgList; AlClearStatusArea(TopRow,BottomRow); va_start(ArgList,FormatString); vAlStatusMsg(TopRow,Error,FormatString,ArgList); }

PCHAR AlStrDup (  IN PCHAR  szString  )

Definition at line 1113 of file almisc.c. References AlAllocateHeap(), NULL, and strlen(). Referenced by AlGetBase(). : This routine makes a copy of the passed in string. I do not use the CRT strdup since it uses malloc. Arguments: szString - pointer of string to dup. Return Value: pointer to dup'd string. NULL if could not allocate --*/ { PCHAR szT; if (szT = AlAllocateHeap(strlen(szString) + 1)) { strcpy(szT, szString); return(szT); } return( NULL ); }

VOID AlWaitKey (  PCHAR  Prompt  )

Definition at line 934 of file almisc.c. References AlGetString(), AlPrint(), and MSGMARGIN. Referenced by AlStatusMsg(), PrintError(), PrintErrorMsg(), and PrintMsg(). { char buff[1]; AlPrint(MSGMARGIN); AlPrint(Prompt ? Prompt : "Press any key to continue..."); AlGetString(buff,0); }

BOOLEAN CommonMenuDisplay (  PMENUCOOKIE  Menu, BOOLEAN  StaticMenu, PCHAR  Items[], ULONG  ItemCount, BOOLEAN  PrintOnly, ULONG  AssociatedDataOfDefaultChoice, ULONG *  AssociatedDataOfChoice, PCHAR  MenuName, ULONG  Row )

Definition at line 788 of file almisc.c. References AlGetString(), AlPrint(), AlSetPosition, AlSetScreenAttributes, AlSetScreenColor, ASCI_CR, ASCI_CSI, ASCI_ESC, ASCI_LF, _tagMENUITEM::AssociatedData, c, dummy(), FALSE, GetChar(), _tagMENUCOOKIE::Items, KEY_DOWN, KEY_UP, MARGIN, MarkLine(), String, _tagMENUITEM::Text, and TRUE. Referenced by AlDisplayMenu(), and AlDisplayStaticMenu(). { // ULONG x; ULONG i,MenuBaseLine,Selection; char c; PCHAR String; AlSetPosition(Row,0); AlPrint("%cJ",ASCI_CSI); // clear to end of screen. MenuBaseLine = Row; AlSetScreenColor(7,4); // white on blue // if(MenuName) { // AlPrint("%s%s\r\n%s",MARGIN,MenuName,MARGIN); // x = strlen(MenuName); // for(i=0; i<x; i++) { // AlPrint("-"); // } // AlPrint("\r\n\r\n"); // MenuBaseLine += 3; // } for(i=0; i<ItemCount; i++) { AlSetScreenAttributes(1,0,0); // hi intensity AlPrint("%s%s\r\n",MARGIN,StaticMenu ? Items[i] : Menu->Items[i].Text); } if(PrintOnly) { char dummy; AlPrint("\r\nPress any key to continue."); AlGetString(&dummy,0); } else { // AlPrint("\r\n%sMake Selection using arrow keys and return,\r\n%sor escape to cancel",MARGIN,MARGIN); Selection = 0; if(StaticMenu) { Selection = AssociatedDataOfDefaultChoice; } else { for(i=0; i<ItemCount; i++) { if(Menu->Items[i].AssociatedData == AssociatedDataOfDefaultChoice) { Selection = i; break; } } } String = StaticMenu ? Items[Selection] : Menu->Items[Selection].Text; MarkLine(MenuBaseLine+Selection,TRUE, String); while(((c = GetChar()) != ASCI_ESC) && (c != ASCI_LF) && (c != ASCI_CR)) { String = StaticMenu ? Items[Selection] : Menu->Items[Selection].Text; MarkLine(MenuBaseLine+Selection,FALSE,String); if(c == KEY_UP) { if(!Selection--) { Selection = ItemCount - 1; } } else if(c == KEY_DOWN) { if(++Selection == ItemCount) { Selection = 0; } } String = StaticMenu ? Items[Selection] : Menu->Items[Selection].Text; MarkLine(MenuBaseLine+Selection,TRUE,String); } // set cursor to a free place on the screen. AlSetPosition(MenuBaseLine + ItemCount + 4,0); if(c == ASCI_ESC) { return(FALSE); } *AssociatedDataOfChoice = StaticMenu ? Selection : Menu->Items[Selection].AssociatedData; } return(TRUE); }

char GetChar (  VOID   )

Definition at line 902 of file almisc.c. References ARC_CONSOLE_INPUT, ArcRead, ASCI_CSI, c, KEY_DOWN, and KEY_UP. { UCHAR c; ULONG count; ArcRead(ARC_CONSOLE_INPUT,&c,1,&count); switch(c) { // case ASCI_ESC: // ArcRead(ARC_CONSOLE_INPUT,&c,1,&count); // if(c != '[') { // break; // } case ASCI_CSI: ArcRead(ARC_CONSOLE_INPUT,&c,1,&count); switch(c) { case 'A': case 'D': return(KEY_UP); case 'B': case 'C': return(KEY_DOWN); } default: return(c); } }

VOID MarkLine (  ULONG  Line, BOOLEAN  Selected, PCHAR  String )

Definition at line 885 of file almisc.c. References AlPrint(), AlSetPosition, AlSetScreenAttributes, MARGIN, and String. Referenced by CommonMenuDisplay(). { AlSetPosition(Line,sizeof(MARGIN)); if (Selected) { AlSetScreenAttributes(1,0,1); // hi intensity, Reverse Video } AlPrint("%s\r\n", String); AlSetScreenAttributes(1,0,0); // hi intensity }

VOID vAlStatusMsg (  IN ULONG  Row, IN BOOLEAN  Error, IN PCHAR  FormatString, IN va_list  ArgumentList )

Definition at line 947 of file almisc.c. References AlPrint(), AlSetPosition, AlSetScreenAttributes, AlSetScreenColor, ARC_CONSOLE_OUTPUT, ArcWrite, Count, Error, MSGMARGIN, and text. Referenced by AlStatusMsg(), AlStatusMsgNoWait(), PrintError(), PrintErrorMsg(), and PrintMsg(). { char text[256]; ULONG Length,Count; AlSetPosition(Row,0); AlPrint(MSGMARGIN); Length = vsprintf(text,FormatString,ArgumentList); if(Error) { AlSetScreenColor(1,4); // red on blue } else { AlSetScreenColor(3,4); // yellow on blue } AlSetScreenAttributes(1,0,0); // hi intensity ArcWrite(ARC_CONSOLE_OUTPUT,text,Length,&Count); AlPrint("\r\n"); AlSetScreenColor(7,4); // white on blue AlSetScreenAttributes(1,0,0); // hi intensity }

---

Variable Documentation

PCHAR AdapterTypes[AdapterMaximum+1] = {"eisa","scsi", "multi", NULL}

Definition at line 1309 of file almisc.c. Referenced by AlMatchArcNamToken().

PCHAR ControllerTypes[ControllerMaximum+1] = {"cdrom", "disk", NULL}

Definition at line 1311 of file almisc.c. Referenced by AlMatchArcNamToken().

char MARGIN[] = " "

Definition at line 584 of file almisc.c. Referenced by CommonMenuDisplay(), and MarkLine().

char MSGMARGIN[] = " "

Definition at line 585 of file almisc.c. Referenced by AlWaitKey(), Confirm(), DoPartitionCreate(), FmtVerifySectors(), and vAlStatusMsg().

PCHAR PeripheralTypes[PeripheralMaximum+1] = {"rdisk", "fdisk", NULL}

Definition at line 1313 of file almisc.c. Referenced by AlMatchArcNamToken().

---