Date: Tue, 31 May 2005 22:22:16 +0200 (CEST) From: Rene Ladan <r.c.ladan@student.tue.nl> To: FreeBSD-gnats-submit@FreeBSD.org Subject: docs/81738: Update tar usage in chapter 16.11.2 of the Handbook Message-ID: <200505312022.j4VKMFuG027096@82-168-79-254-bbxl.xdsl.tiscali.nl> Resent-Message-ID: <200505312030.j4VKU2AS077772@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
>Number: 81738
>Category: docs
>Synopsis: Update tar usage in chapter 16.11.2 of the Handbook
>Confidential: no
>Severity: non-critical
>Priority: low
>Responsible: freebsd-doc
>State: open
>Quarter:
>Keywords:
>Date-Required:
>Class: doc-bug
>Submitter-Id: current-users
>Arrival-Date: Tue May 31 20:30:01 GMT 2005
>Closed-Date:
>Last-Modified:
>Originator: Rene Ladan
>Release: FreeBSD 5.4-STABLE i386
>Organization:
>Environment:
System: FreeBSD 82-168-79-254-bbxl.xdsl.tiscali.nl 5.4-STABLE FreeBSD 5.4-STABLE #5: Wed May 25 05:41:14 CEST 2005 root@82-168-79-254-bbxl.xdsl.tiscali.nl:/usr/obj/usr/src/sys/RENE i386
>Description:
Although mentioned in the 5.3R release notes, the text in chapter
16.11.2 of the Handbook still refers to GNU tar as the (only) tar to use:
" ... The GNU version of tar, which FreeBSD utilizes, supports remote
devices using the same syntax as rdump ... "
<sidenote>
This doesn't seem to apply to bsdtar:
$ bsdtar cf localhost:/usr/home/rene/test.tar localfile
tar: Failed to open 'localhost:/usr/home/rene/test.tar': No such file or directory
</sidenote>
>How-To-Repeat:
>Fix:
--- /usr/doc/en_US.ISO8859-1/books/handbook/disks/chapter.sgml Sat May 21 20:08:22 2005
+++ chapter.sgml Tue May 31 22:04:29 2005
@@ -2373,8 +2373,12 @@
<indexterm><primary><command>tar</command></primary></indexterm>
<para>Most versions of <command>tar</command> do not support
backups across the network. The GNU version of
- <command>tar</command>, which FreeBSD utilizes, supports remote
- devices using the same syntax as <command>rdump</command>. To
+ <command>tar</command>, which FreeBSD utilizes on 4.X, supports
+ remote devices using the same syntax as <command>rdump</command>.
+ On 5.3 and later, <command>tar</command> is a symbolic link to
+ <command>bsdtar</command>, a native version of
+ <command>tar</command>. To use the GNU version on these
+ systems, use <command>gtar</command> instead. To
<command>tar</command> to an Exabyte tape drive connected to a
Sun called <hostid>komodo</hostid>, use:</para>
>Release-Note:
>Audit-Trail:
>Unformatted:
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200505312022.j4VKMFuG027096>