Bug 474098

Summary:	man, immutable+append not documented
Product:	Red Hat Enterprise Linux 5	Reporter:	Petr Sklenar <psklenar>
Component:	e2fsprogs	Assignee:	Eric Sandeen <esandeen>
Status:	CLOSED NOTABUG	QA Contact:	BaseOS QE <qe-baseos-auto>
Severity:	medium	Docs Contact:
Priority:	medium
Version:	5.2	CC:	rbiba, sct
Target Milestone:	rc
Target Release:	---
Hardware:	All
OS:	Linux
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2008-12-02 11:52:19 UTC	Type:	---
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:

Description Petr Sklenar 2008-12-02 08:19:36 UTC

Description of problem:
most used function of chattr is +i and its not documented neither in man chattr nor man lsattr. 
"+a" is not documented as well.

chattr +i immutable.file 
[root@xen47 chattr]# lsattr 
----i-------- ./immutable.file


Version-Release number of selected component (if applicable):
e2fsprogs-1.39-15.el5

How reproducible:
alwways

Steps to Reproduce:
1.man chattr, search "i" or "a"
2.man lsattr, search "i" or "a"
3.
  
Actual results:
not in man

Expected results:
describtion in man

Additional info:
[root@xen47 chattr]# chattr +i immutable.file 
[root@xen47 chattr]# lsattr 
----i-------- ./immutable.file

Comment 1 Radek Bíba 2008-12-02 09:10:34 UTC

man chattr:
ATTRIBUTES
A file with the ‘a’ attribute set can only be open in append mode for writing.  Only the superuser or a  process  possessing the CAP_LINUX_IMMUTABLE capability can set or clear this attribute.
...
A file with the ‘i’ attribute cannot be modified: it cannot be deleted or renamed, no link can be created to this file and no data can be written to the file.  Only the superuser or a process possessing the CAP_LINUX_IMMUTABLE capability can set or clear this attribute.

man lsattr:
DESCRIPTION
...See chattr(1) for a description of the attributes and what they mean.


If you think it's not enough, please propose a change.

Comment 2 Petr Sklenar 2008-12-02 11:52:19 UTC

OK i am sorry I didn't see it among highlighted options,
its not a bug