char * tt_netfile_file( const char * netfilename );
The tt_netfile_file function maps between canonical and local path names. It converts the file specified netfilename to a path name that is valid on the local host. The netfilename is a copy of a null-terminated string returned by tt_netfile_file.
You do not need to call the tt_open function before you use this function.
If the specified file is not currently mounted on the local host, a path name in the form of
/DTMOUNTPOINT/host/filepath
is constructed, where:
is the intended mount point for the automounter's host map. You can also specify this mount point with the environment variable DTMOUNTPOINT.
This function returns either an error pointer or, if successful, a newly-allocated null-terminated local file name.
Use tt_ptr_error to extract a status from an error pointer. Possible errors are described in Table C-4.
Table C-4 Possible Errors Returned by tt_netfile_file
Error |
Description |
---|---|
netfilename is not a valid netfilename |
|
rpc.ttdbserverd could not be reached on host |
|
rpc.ttdbserverd does not appear to be properly installed on host |
To free allocated strings, use either the tt_free or tt_release call.
To convert the file back to a net file name for the same file, use the tt_file_netfile() function.