From areilly@bigpond.net.au  Sun Jul 28 15:32:05 2002
Return-Path: <areilly@bigpond.net.au>
Received: from mx1.FreeBSD.org (mx1.FreeBSD.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id DAFDC37B400
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 28 Jul 2002 15:32:05 -0700 (PDT)
Received: from mta01ps.bigpond.com (mta01ps.bigpond.com [144.135.25.133])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 98E3343E31
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 28 Jul 2002 15:32:04 -0700 (PDT)
	(envelope-from areilly@bigpond.net.au)
Received: from areilly.bpc-users.org ([144.135.25.72]) by
          mta01ps.bigpond.com (Netscape Messaging Server 4.15 mta01ps May
          23 2002 23:53:28) with SMTP id GZZD7M00.1WT for
          <FreeBSD-gnats-submit@freebsd.org>; Mon, 29 Jul 2002 08:30:58 +1000 
Received: from CPE-144-132-188-183.nsw.bigpond.net.au ([144.132.188.183]) by PSMAM02.mailsvc.email.bigpond.com(MailRouter V3.0n 74/21326987); 29 Jul 2002 08:30:58
Received: (qmail 10889 invoked by uid 1000); 28 Jul 2002 22:30:58 -0000
Message-Id: <20020728223058.10888.qmail@areilly.bpc-users.org>
Date: 28 Jul 2002 22:30:58 -0000
From: "Andrew Reilly" <areilly@bigpond.net.au>
Reply-To: Andrew Reilly <areilly@bigpond.net.au>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: pax -B option does not mention interaction with -z option
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         41089
>Category:       docs
>Synopsis:       [patch] pax(1) -B option does not mention interaction with -z option
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Sun Jul 28 15:40:01 PDT 2002
>Closed-Date:    
>Last-Modified:  Mon May 26 03:11:23 UTC 2014
>Originator:     Andrew Reilly
>Release:        FreeBSD 4.6-STABLE i386
>Organization:
>Environment:
System: FreeBSD gurney.reilly.home 4.6-STABLE FreeBSD 4.6-STABLE #1: Sat Jul 27 10:14:36 EST 2002 root@gurney.reilly.home:/usr_plus/obj/usr_plus/src/sys/GURNEY i386


	P3-500, FreeBSD as above, target same, standard
	libraries.

>Description:
	
	-B option of pax says that it limits the number of bytes
	written to a volume, but when the -z option is also used
	the number of bytes written is less than that specified,
	by the compression ratio.  For example, see
	How-To-Repeat.
>How-To-Repeat:
	You won't get the same result, because you don't have my
	file system contents, but any file tree should do (other
	than one full of MP3 files or the like...)
	pax -w -t -z -f /backup/full-${today_d}.pax -B667m $dirs
	resulted in the warning message
	"pax: User specified archive volume byte limit reached."
	but a subsequent listing of the /backup directory shows:
	-rw-r--r--  1 root  wheel  352215042 Jul 29 03:11 full-020729.pax

>Fix:

	Add a sentence or two to the description of the -B option
	along the lines of:
	"Note that the specified size is for the pax image
	itself.  If the -z option is also used, the resulting
	file may contain fewer bytes, according to the
	compressability of the archive contents."

	Alternatively, perhaps the pax author could be persuaded
	to run the archive size counter on the _output_ of the
	gzip pipe?  That would certainly be more useful.


>Release-Note:
>Audit-Trail:

From: venture37 <venture37@geeklan.co.uk>
To: bug-followup@FreeBSD.org, areilly@bigpond.net.au
Cc:  
Subject: Re: docs/41089: pax(1) -B option does not mention interaction with
 -z option
Date: Mon, 26 May 2014 02:12:11 +0100

 This is a multi-part message in MIME format.
 --------------010202030606080206000603
 Content-Type: text/plain; charset=ISO-8859-1; format=flowed
 Content-Transfer-Encoding: 7bit
 
 Attached diff adds proposed fix to pax(1).
 
 --------------010202030606080206000603
 Content-Type: text/plain; charset=UTF-8;
  name="pax.txt"
 Content-Transfer-Encoding: 7bit
 Content-Disposition: attachment;
  filename="pax.txt"
 
 Index: bin/pax/pax.1
 ===================================================================
 --- bin/pax/pax.1	(revision 266021)
 +++ bin/pax/pax.1	(working copy)
 @@ -793,6 +793,12 @@
  .Li x
  to indicate a product.
  .Pp
 +Note that the specified size is for the pax image itself. If the 
 +.Fl z
 +option is also used, the resulting file may contain fewer 
 +.Ar bytes ,
 +according to the compressibility of the archive contents.
 +.Pp
  .Em Warning :
  Only use this option when writing an archive to a device which supports
  an end of file read condition based on last (or largest) write offset
 
 --------------010202030606080206000603--
>Unformatted:
