Document the named attribute interface
Needs ReviewPublic
Actions

Authored by rmacklem on Apr 16 2025, 1:44 PM.

Details

Reviewers

emaste
ziaee

Group Reviewers

manpages

Summary

The named attribute interface is an alternate way
to manipulate extended attributes, based on the
interface provided by Solaris.

This man page documents this interface.

I put it in section 7, since that seemed the best fit?

Diff Detail

Repository

rG FreeBSD src repository

Lint

Lint Skipped

Unit

Tests Skipped

Event Timeline

rmacklem created this revision.Apr 16 2025, 1:44 PM

Herald added subscribers: ziaee, imp. · View Herald TranscriptApr 16 2025, 1:44 PM

rmacklem requested review of this revision.Apr 16 2025, 1:44 PM

rmacklem added a reviewer: ziaee.

guest-patmaddox added a subscriber: guest-patmaddox.Apr 16 2025, 3:28 PM

rmacklem mentioned this in D49691: open.2: Document the O_NAMEDATTR flag added recently.Apr 18 2025, 12:32 AM

Re-written to conform to the more Solaris-like
semantics of O_NAMEDATTR that is now implemented
in main.

Replaced the copyright notice with the new recommended
short one, as suggested by ziaee@.

Clarified when named attributes and named attribute
directories are created.

I also added a paragraph related to use of pathconf(2)
names.

emaste added inline comments.Wed, Jun 25, 9:47 PM

share/man/man7/named_attribute.7
14–15	@ziaee this seems more verbose than typical; you've been looking at all kinds of man pages so would like your advice/commentary on guidelines

ziaee added inline comments.Wed, Jun 25, 10:25 PM

share/man/man7/named_attribute.7
14–15	I'm sorry for the delay, I have seen this but I am chewing on it because I agree. Simplifying language to make it easier to read, especially on topics you're not so familiar with, is hard. We probably shouldn't hold this up though.

Revision Contents
Changeset List

Path

Size

share/

man/

man7/

	Makefile
	Makefile.xattr

1 line

	named_attribute.7
	named_attribute.7.xattr

236 lines

Diff 154061

View Options

share/man/man7/Makefile