NAME

VobPathConv.pod -- Convert VOB tags and paths from unix to the local region

This module is needed especially to convert to Windows, paths defined in the reference unix region (this of the registry server).

SYNOPSYS

Only three functions are exported:

uxtag2local

This function assumes a registered vob tag, and returns the equivalent tag in the local region. In case the input parameter is not a vob tag, it returns an empty string. Note however that all processing is skipped if the local region matches the reference unix region: in that case, the input path is returned as such with no check whatsoever.

uxpath2local

This function assumes a path within a vob. It extracts the vob tag, converts it, and based on this, reconstructs the equivalent path in the local region. Note that it doesn't attempt to add a view prefix, or to check in any way that either of the paths actually exists or is reachable. The function returns an empty string in the case the path could not be found to be in any registered vob (with the same restriction as above)

uxpath2localtag

This function takes a path, and returns the vob tag in the local region. Contrarily to the other two, this one actually works even in the reference unix region, even if it acts there as a suboptimal replacement for ct des -s vob:path.

DETAILS

The module is designed to be independent from any local configuration. It relies upon the following assumptions:

The local registry server runs a variant of unix -- i.e. uses a path separator of /.
The vob tags offered as input parameters are registered in the region of the registry server. This may not be true is there are several unix regions.

The implementation relies only on lsvob and vob uuids.