Bug 135516

Summary: [patch] pax(1) manual not mentioning chflags unawareness
Product: Documentation Reporter: Alexander Best <alexbestms>
Component: Books & ArticlesAssignee: Chris Rees <crees>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
pax.1.patch.txt none

Description Alexander Best 2009-06-12 18:40:01 UTC 
the pax manual page doesn't mention that pax is unaware of chflags. in fact it describes the switch `-p e` as `Preserve everything'. the manual page should explicitly mention paxes unawareness of chflags and the description 'Preserve everything' shouldn't be used since pax only preserves user ID, group ID, file mode bits, file access time, and file modification time.

cheers.
Comment 1 Alexander Best 2010-02-13 01:18:13 UTC 
this patch adds a note to pax(1) mentioning pax'es chflags unawareness.

cheers.
alex
Comment 2 Alexander Best 2010-02-13 01:26:53 UTC 
oops. forgot to attach it. well it's late. ;)

alex
Comment 3 Eitan Adler freebsd_committer freebsd_triage 2012-02-23 02:54:17 UTC 
Responsible Changed
From-To: freebsd-doc->eadler

I'll take it.
Comment 4 Eitan Adler freebsd_committer freebsd_triage 2012-09-02 17:52:28 UTC 
Responsible Changed
From-To: eadler->freebsd-doc

I won't be looking at this PR for a while and I need to clear some out 
of my queue
Comment 5 Chris Rees freebsd_committer freebsd_triage 2013-12-21 18:51:27 UTC 
Responsible Changed
From-To: freebsd-doc->crees

I'll take it.
Comment 6 Chris Rees freebsd_committer freebsd_triage 2013-12-21 19:29:15 UTC 
State Changed
From-To: open->closed

Committed. Thanks!
Comment 7 dfilter service freebsd_committer freebsd_triage 2013-12-21 19:29:16 UTC 
Author: crees (doc,ports committer)
Date: Sat Dec 21 19:29:08 2013
New Revision: 259695
URL: http://svnweb.freebsd.org/changeset/base/259695

Log:
  Document the lack of chflags support in pax(1)
  
  PR:		docs/135516
  Submitted by:	arundel (based on)
  Approved by:	gjb (mentor)

Modified:
  head/bin/pax/pax.1

Modified: head/bin/pax/pax.1
==============================================================================
--- head/bin/pax/pax.1	Sat Dec 21 18:47:00 2013	(r259694)
+++ head/bin/pax/pax.1	Sat Dec 21 19:29:08 2013	(r259695)
@@ -33,7 +33,7 @@
 .\"	@(#)pax.1	8.4 (Berkeley) 4/18/94
 .\" $FreeBSD$
 .\"
-.Dd August 29, 2010
+.Dd December 21, 2013
 .Dt PAX 1
 .Os
 .Sh NAME
@@ -587,6 +587,16 @@ precedence.
 For example, if
 .Dl Fl p Ar eme
 is specified, file modification times are still preserved.
+.Pp
+File flags set by
+.Xr chflags 1
+are not understood by
+.Nm ,
+however
+.Xr tar 1
+and
+.Xr dump 1
+will preserve these.
 .It Fl s Ar replstr
 Modify the file or archive member names specified by the
 .Ar pattern
@@ -1195,3 +1205,11 @@ at the University of California, San Die
 The
 .Nm
 utility does not recognize multibyte characters.
+.Pp
+File flags set by
+.Xr chflags 1
+are not preserved by
+.Nm .
+The BUGS section of
+.Xr chflags 1
+has a list of utilities that are unaware of flags.
_______________________________________________
svn-src-all@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/svn-src-all
To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"