pvfs2-ln man page

pvfs2-ln – create a soft link in an OrangeFS volume

Synopsis

pvfs2-ln -s [-Vvh] target link_name

Description

The pvfs2-ln utility creates a soft link (symlink) at link_name which points to target where target will be in an OrangeFS volume.  The link_name may refer to files across file systems and even non-existent files.

The options are as follows:

-V

Display verbose messages.

-v

Print version number and exit.

-h

Display synopsis.

Environment

PVFS2_DEBUGFILE

If set to the path of a local file, redirect debug output to it.

PVFS2_DEBUGMASK

Set the OrangeFS debug mask.  Possible masks are documented in pvfs2-set-debugmask(1).

PVFS2TAB_FILE

If set, the full pathname for an alternate pvfs2tab file

Files

/etc/pvfs2tab

Examples

Create a link at /mnt/bar referring to the file /mnt/foo referring to it by a relative path.

pvfs2-ln -s foo /mnt/bar

Create a link at /mnt/bar referring to the file /etc/motd which is not in the OrangeFS volume.

pvfs2-ln -s /etc/motd /mnt/bar

Caveats

A link to a file outside of the OrangeFS volume will refer to a different file if the file system is mounted at different mount points or on different machines.

Bugs

Please submit bug reports to pvfs2-developers@beowulf-underground.org

See Also

ln(1), pvfs2-cp(1), pvfs2tab(5)

Info

2017-06-30