DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

SSO_GetSegmentRootPath(TCL_ADM)


SSO_GetSegmentRootPath -- get the storage section root pathname

Syntax

SSO_GetSegmentRootPath SHARED|PRIVATE patchArea

Description

SSO_GetSegmentRootPath allows the caller to determine the location of its component within a storage section. It provides a full filesystem pathname leading to the root of the appropriate storage section which can then be used to locate additional executable files (such as ``backend'' programs) and private data files used for software configuration.

Arguments


SHARED|PRIVATE
specifies one of two regions of the storage section. Executable applications will themselves most likely be located in the SHARED region whereas private, modifiable data files, e.g. for configuration, will be located in the PRIVATE region.

patchArea
data structure in the executable application image that has been patched with the correct Storage Section name via ssoPatch(CDMT).

Return values

SSO_GetSegmentRootPath returns a string that represents the pathname of the storage section root where the calling application is located.

Examples

set patchArea {__SSO_ID_ST@SCO:Unix:5.0.0Cl    @SSO_ID_END__}
set SSORoot [SSO_GetSegmentRootPath SHARED $patchArea]

See also

ssoPatch(CDMT), SaGetSSOVersion(TCL_ADM), custom(ADM).
16 September 2002
© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003