CC-tea/coreutils
1
0
Fork 0
mirror of git://git.sv.gnu.org/coreutils.git synced 2026-04-09 21:53:55 +02:00
Code Issues Projects Releases Wiki Activity

Improve a warning about non-portable "mv" usage.

Browse Source 
* doc/coreutils.texi (mv invocation): Adjust the warning: moving a
dir-symlink-specified-with-a-trailing-slash works in a surprising
manner only on some systems.  Reported by Tomas Pospisek in
http://bugs.debian.org/343652.
This commit is contained in:
Jim Meyering
2008-01-26 12:29:41 +01:00
parent 2c6754363f
commit c0c8685d46
2 changed files with 16 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
ChangeLog
View File

@@ -1,3 +1,11 @@
2008-01-26 Jim Meyering <meyering@redhat.com>
Improve a warning about non-portable "mv" usage.
* doc/coreutils.texi (mv invocation): Adjust the warning: moving a
dir-symlink-specified-with-a-trailing-slash works in a surprising
manner only on some systems. Reported by Tomas Pospisek in
http://bugs.debian.org/343652.
2008-01-26 Mike Frysinger <vapier@gentoo.org>
* src/dircolors.hin (TERM): Add jfbterm.

12
doc/coreutils.texi
View File

@@ -7773,10 +7773,14 @@ is a terminal, and the @option{-f} or @option{--force} option is not given,
own the file, or have write permission on its directory.) If the
response is not affirmative, the file is skipped.
@emph{Warning}: If you try to move a symlink that points to a directory,
and you specify the symlink with a trailing slash, then @command{mv}
doesn't move the symlink but instead moves the directory referenced
by the symlink. @xref{Trailing slashes}.
@emph{Warning}: Avoid specifying a source name with a trailing slash,
when it might be a symlink to a directory.
Otherwise, @command{mv} may do something very surprising, since
its behavior depends on the underlying rename system call.
On modern Linux systems, it fails with @code{errno=ENOTDIR}.
However, on other systems (at least FreeBSD 6.1 and Solaris 10) it silently
renames not the symlink but rather the directory referenced by the symlink.
@xref{Trailing slashes}.
The program accepts the following options. Also see @ref{Common options}.