pathmap

Pathmap command.

pathmap [SUBCOMMAND] [ARGS]

  • SUBCOMMAND – The pathmap subcommand to call.
  • ARGS – Arguments to give to pathmap subcommand.

List of pathmap subcommands:

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