pathmap¶
Pathmap command.
pathmap [SUBCOMMAND] [ARGS]
- SUBCOMMAND – The pathmap subcommand to call.
- ARGS – Arguments to give to pathmap subcommand.
List of pathmap subcommands:
- pathmap add – Add a path-mapping
- pathmap clear – Remove all path-mapping
- pathmap remove – Remove a path-mapping
Type “help pathmap” followed by pathmap subcommand name for full documentation. Command name abbreviations are allowed if unambiguous.
pathmap add – Add a path-mapping¶
Add a path-mapping to current path-mapping rules.
pathmap add [-shared] [-index INDEX] SOURCE DESTINATION [PROTOCOL]
- SOURCE – Path to replace with DESTINATION.
- DESTINATION – Path to replace SOURCE with.
- PROTOCOL - Path-mapping protocol. May be one of “File”, “Host” or “Target”.
- -shared – Specifies that the path-mapping may be shared with other connections.
- INDEX – Together with the -index option, specifies the index the pathmap should be set at.
Path-mapping are used to replace SOURCE with DESTINATION if a file cannot be found. For example if a file was in “/tmp” when compiled, but is now in “/home/tmp”, but the object source path refers to its old path, it is then required to do something like :
- pathmap add /tmp /home/tmp
The value of INDEX may be negative, zero or positive.
- A value of 0 means “always first”.
- A value of i indicates that the pathmap should appear at rank i (after the 0 path-mappings if any).
- A value of -i means ranked “i” starting from the end of the list. For example, an index of -1 means “last”.
Examples:
- pathmap add /tmp /home/tmp
- pathmap add / /home/target/fs
- pathmap add /me /you File
- pathmap add -shared /shared /home/shared
- pathmap add -shared -index 0 /top C:\temp\root
- pathmap add -index -1 /last C:\temp\root
pathmap clear – Remove all path-mapping¶
Remove all path-mapping from current path-mapping rules.
pathmap clear
All the path-mappings shown by the “info pathmap” commands are removed from the current path-mappings.
Example
- pathmap clear
pathmap remove – Remove a path-mapping¶
Remove a path-mapping from current path-mapping rules.
pathmap remove ID
- ID - Path-mapping ID to remove from path-mappings.
The ID is one of the IDs displayed by an “info pathmap” command.
Example
- pathmap remove 2