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

  
 
  

home | help
SWITCH-LINK(1)		     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 situ-
     ations, 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  subdi-
     rectories, 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.

FreeBSD ports 15.quarterly	December 26, 2010		  SWITCH-LINK(1)

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

home | help