DragonFly On-Line Manual Pages

SWITCH-LINK(1)         DragonFly General Commands Manual        SWITCH-LINK(1)

NAME
     switch-link - retarget symlinks based on the extension of their targets

SYNOPSIS
     switch-link [Nv] oldext newext
     switch-link -h | -V

DESCRIPTION
     The switch-link utility examines all the symlinks in the current
     directory and its subdirectories, looking for those whose targets end in
     the .oldext extension as specified on the command line.  If any of those
     are found, they are changed to point to a target with the same base name
     and a .newext extension as specified on the command line.  This is useful
     in some setups when such symlinks are used to provide different images
     for different situations, e.g. holiday decoration.

     Options:

     -h      Display a usage message and exit.

     -N      No-operation mode; just display what would have been done.

     -V      Display program version information and exit.

     -v      Verbose operation; display diagnostic messages.

RETURN VALUES
     The switch-link utility exits 0 on success, and >0 if an error occurs.

ENVIRONMENT
     The switch-link utility's operation is currently not directly affected by
     its environment.

FILES
     The switch-link utility examines the current directory and all its
     subdirectories, and its operation is not further affected by any files.

EXAMPLES
     Change all the symlinks pointing to *.nonch to point to the same file,
     but with a .ch extension:

           switch-link nonch ch

     See what switch-link would do without actually changing any links:

           switch-link -N nonch ch

SEE ALSO
     ln(1)

HISTORY
     The switch-link utility was written by Peter Pentchev in 2010.

AUTHORS
     Peter Penchev <roam@ringlet.net>

TODO
     *       Create a temporary file containing the list of links to avoid
             weird security-like issues or plain old incorrect operation
             resulting from whitespace in the link's name.

DragonFly 6.5-DEVELOPMENT      December 26, 2010     DragonFly 6.5-DEVELOPMENT