Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
DRELN(1)			  mpiFileUtils				DRELN(1)

NAME
     dreln - distributed relink

SYNOPSIS
     dreln [OPTION] OLDPATH NEWPATH PATH ...

DESCRIPTION
     Parallel MPI application to recursively update symlinks within a directory.

     dreln  walks  the	specified  PATH and updates any symlink whose target in-
     cludes an absolute path to OLDPATH and replaces that  symlink  with  a  new
     link whose target points to NEWPATH instead.

     This  is  useful  to update symlinks after migrating a large directory from
     one file system to another, whose links specify absolute paths to the orig-
     inal file system.

OPTIONS
     -i, --input FILE
	    Read source list from FILE. FILE must be generated by  another  tool
	    from the mpiFileUtils suite.

     -p, --preserve
	    Preserve existing modification times on links.

     -r, --relative
	    Replace links using target paths that are relative to NEWPATH.

     --progress N
	    Print progress message to stdout approximately every N seconds.  The
	    number of seconds must be a non-negative integer.  A value of 0 dis-
	    ables progress messages.

     -v, --verbose
	    Run in verbose mode.

     -q, --quiet
	    Run tool silently. No output is printed.

     -h, --help
	    Print a brief message listing the drm(1) options and usage.

EXAMPLES
     1.  To  update all links under /walk/path whose targets point to /orig/path
     and replace them with targets that point to /new/path:

     mpirun -np 128 dreln -v /orig/path /new/path /walk/path

     2. Same as above, but replace each link target with a  relative  path  from
     the link to its new target under /new/path:

     mpirun -np 128 dreln -v --relative /orig/path /new/path /walk/path

     3. One can preserve existing modification times on links:

     mpirun -np 128 dreln -v --preserve /orig/path /new/path /walk/path

     4. One can specifiy multiple paths to walk:

     mpirun -np 128 dreln -v /orig/path /new/path /walk/path1 /walk/path2

SEE ALSO
     The  mpiFileUtils	source code and all documentation may be downloaded from
     <https://github.com/hpc/mpifileutils>

AUTHOR
     HPC

COPYRIGHT
     2022, LLNL/LANL/UT-Battelle/DDN

0.12				  Jan 29, 2025				DRELN(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=dreln&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help