OS/2 Miscellaneous API Differences

The following describes the implementation differences between the OS2Linux library and the real OS/2 miscellaneous APIs.

These APIs are included in your application by including the following definition in your application source file.

#define INCL_DOSMISC

DosGetMessage

APIRET APIENTRY DosGetMessage(PCHAR* pTable, ULONG cTable, PCHAR pBuf,
                              ULONG cbBuf, ULONG msgnumber, PSZ pszFile,
                              PULONG pcbMsg);

• The argument pszFile must have been generated using the Linux gencat utility.

DosErrClass

APIRET APIENTRY DosErrClass(ULONG code, PULONG pClass, PULONG pAction,
                            PULONG pLocus);

• This function is not supported and always returns ERROR_ACCESS_DENIED.

DosInsertMessage

APIRET APIENTRY DosInsertMessage(PCHAR* pTable, ULONG cTable, PSZ pszMsg,
                                 ULONG cbMsg, PCHAR pBuf, ULONG cbBuf,
                                 PULONG pcbMsg);

• This function is not supported and always returns ERROR_ACCESS_DENIED.

DosPutMessage

APIRET APIENTRY DosPutMessage(HFILE hfile, ULONG cbMsg, PCHAR pBuf);

• This function only outputs messages to stdout, stderr and the Linux system log.
• The message is NOT formated as per the OS/2 specification.

DosQuerySysInfo

APIRET APIENTRY DosQuerySysInfo(ULONG iStart, ULONG iLast, PVOID pBuf,
                                ULONG cbBuf);

• This function returns appropriate values for Linux.
• Some values are returned with static values.

DosScanEnv

APIRET APIENTRY DosScanEnv(PSZ pszName, PSZ *ppszValue);

• None.

DosSearchPath

APIRET APIENTRY DosSearchPath(ULONG flag, PSZ pszPathOrName, PSZ pszFilename,
                              PBYTE pBuf, ULONG cbBuf);

• This function is not supported and always returns ERROR_ACCESS_DENIED.

DosQueryMessageCP

APIRET APIENTRY DosQueryMessageCP(PCHAR pb, ULONG cb, PSZ pszFilename,
                                  PULONG cbBuf);

• This function is not supported and always returns ERROR_ACCESS_DENIED.

DosQueryRASInfo

APIRET APIENTRY DosQueryRASInfo(ULONG Index, PPVOID Addr);

• This function is not supported and always returns ERROR_ACCESS_DENIED.

DosSetExtLIBPATH

APIRET APIENTRY DosSetExtLIBPATH(PSZ pszExtLIBPATH, ULONG flags);

• This function modifies the Linux LD_LIBRARY_PATH.
• The flags argument is ignored.

DosQueryExtLIBPATH

APIRET APIENTRY DosQueryExtLIBPATH(PSZ pszExtLIBPATH, ULONG flags);

• This function returns the Linux LD_LIBRARY_PATH.
• The flags argument is ignored.