From owner-svn-src-head@freebsd.org Sat Dec 29 23:09:00 2018 Return-Path: Delivered-To: svn-src-head@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 78F7914300A2; Sat, 29 Dec 2018 23:09:00 +0000 (UTC) (envelope-from crees@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) server-signature RSA-PSS (4096 bits) client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "Let's Encrypt Authority X3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 1CC168955E; Sat, 29 Dec 2018 23:09:00 +0000 (UTC) (envelope-from crees@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 00D0D19D4D; Sat, 29 Dec 2018 23:08:59 +0000 (UTC) (envelope-from crees@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id wBTN8xg2020915; Sat, 29 Dec 2018 23:08:59 GMT (envelope-from crees@FreeBSD.org) Received: (from crees@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id wBTN8xHL020914; Sat, 29 Dec 2018 23:08:59 GMT (envelope-from crees@FreeBSD.org) Message-Id: <201812292308.wBTN8xHL020914@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: crees set sender to crees@FreeBSD.org using -f From: Chris Rees Date: Sat, 29 Dec 2018 23:08:59 +0000 (UTC) To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Subject: svn commit: r342601 - head/bin/pax X-SVN-Group: head X-SVN-Commit-Author: crees X-SVN-Commit-Paths: head/bin/pax X-SVN-Commit-Revision: 342601 X-SVN-Commit-Repository: base MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-Rspamd-Queue-Id: 1CC168955E X-Spamd-Bar: -- Authentication-Results: mx1.freebsd.org X-Spamd-Result: default: False [-2.95 / 15.00]; local_wl_from(0.00)[FreeBSD.org]; NEURAL_HAM_MEDIUM(-1.00)[-0.999,0]; NEURAL_HAM_LONG(-1.00)[-0.998,0]; NEURAL_HAM_SHORT(-0.95)[-0.955,0]; ASN(0.00)[asn:11403, ipnet:2610:1c1:1::/48, country:US] X-BeenThere: svn-src-head@freebsd.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: SVN commit messages for the src tree for head/-current List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 29 Dec 2018 23:09:00 -0000 Author: crees (doc,ports committer) Date: Sat Dec 29 23:08:59 2018 New Revision: 342601 URL: https://svnweb.freebsd.org/changeset/base/342601 Log: Add a note that the use of -B option does not guarantee a size of fragment if -z option also used. Recommend the use of zip(1) if compressed files of predictable size needed. PR: docs/41089 Submitted by: Sevan Janiyan Reported by: areilly@bigpond.net.au While here, pet igor Reviewed by: bcr Differential Revision: https://reviews.freebsd.org/D18686 Modified: head/bin/pax/pax.1 Modified: head/bin/pax/pax.1 ============================================================================== --- head/bin/pax/pax.1 Sat Dec 29 23:00:20 2018 (r342600) +++ head/bin/pax/pax.1 Sat Dec 29 23:08:59 2018 (r342601) @@ -33,7 +33,7 @@ .\" @(#)pax.1 8.4 (Berkeley) 4/18/94 .\" $FreeBSD$ .\" -.Dd March 17, 2015 +.Dd December 29, 2018 .Dt PAX 1 .Os .Sh NAME @@ -793,6 +793,16 @@ limits can be separated by .Li x to indicate a product. .Pp +Note that the specified size is for the uncompressed 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. +See +.Xr zip 1 +if compressed volumes of predictable size are required. +.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 @@ -804,7 +814,7 @@ This option is the same as the option, except that the file inode change time is checked instead of the file modification time. The file inode change time can be used to select files whose inode information -(e.g.\& uid, gid, etc.) is newer than a copy of the file in the destination +(e.g., uid, gid, etc.) is newer than a copy of the file in the destination .Ar directory . .It Fl E Ar limit Limit the number of consecutive read faults while trying to read a flawed @@ -903,7 +913,7 @@ the file was last written). The .Ar c specifies the comparison of inode change time (the time when the file -inode was last changed; e.g.\& a change of owner, group, mode, etc). +inode was last changed; e.g., a change of owner, group, mode, etc). When .Ar c and