186d7f5d3SJohn Marino.\"- 286d7f5d3SJohn Marino.\" Copyright (c) 1999 Robert N. M. Watson 386d7f5d3SJohn Marino.\" All rights reserved. 486d7f5d3SJohn Marino.\" 586d7f5d3SJohn Marino.\" Redistribution and use in source and binary forms, with or without 686d7f5d3SJohn Marino.\" modification, are permitted provided that the following conditions 786d7f5d3SJohn Marino.\" are met: 886d7f5d3SJohn Marino.\" 1. Redistributions of source code must retain the above copyright 986d7f5d3SJohn Marino.\" notice, this list of conditions and the following disclaimer. 1086d7f5d3SJohn Marino.\" 2. Redistributions in binary form must reproduce the above copyright 1186d7f5d3SJohn Marino.\" notice, this list of conditions and the following disclaimer in the 1286d7f5d3SJohn Marino.\" documentation and/or other materials provided with the distribution. 1386d7f5d3SJohn Marino.\" 1486d7f5d3SJohn Marino.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 1586d7f5d3SJohn Marino.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 1686d7f5d3SJohn Marino.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 1786d7f5d3SJohn Marino.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 1886d7f5d3SJohn Marino.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 1986d7f5d3SJohn Marino.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 2086d7f5d3SJohn Marino.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 2186d7f5d3SJohn Marino.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 2286d7f5d3SJohn Marino.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 2386d7f5d3SJohn Marino.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 2486d7f5d3SJohn Marino.\" SUCH DAMAGE. 2586d7f5d3SJohn Marino.\" 2686d7f5d3SJohn Marino.\" $FreeBSD: src/share/man/man9/extattr.9,v 1.1.2.4 2001/12/17 11:30:18 ru Exp $ 2786d7f5d3SJohn Marino.\" 2886d7f5d3SJohn Marino.Dd May 8, 2010 2986d7f5d3SJohn Marino.Dt EXTATTR 9 3086d7f5d3SJohn Marino.Os 3186d7f5d3SJohn Marino.Sh NAME 3286d7f5d3SJohn Marino.Nm extattr 3386d7f5d3SJohn Marino.Nd virtual file system named extended attributes 3486d7f5d3SJohn Marino.Sh SYNOPSIS 3586d7f5d3SJohn Marino.In sys/param.h 3686d7f5d3SJohn Marino.In sys/vnode.h 3786d7f5d3SJohn Marino.In sys/extattr.h 3886d7f5d3SJohn Marino.Sh DESCRIPTION 3986d7f5d3SJohn MarinoNamed extended attributes allow additional meta-data to be associated 4086d7f5d3SJohn Marinowith vnodes representing files and directories. 4186d7f5d3SJohn MarinoThe semantics of this additional data is that of a "name=value" pair, where 4286d7f5d3SJohn Marinoa name may be defined or undefined, and if defined, associated with zero or 4386d7f5d3SJohn Marinomore bytes of arbitrary binary data. 4486d7f5d3SJohn Marino.Pp 4586d7f5d3SJohn MarinoReads of extended attribute data may return specific contiguous regions of 4686d7f5d3SJohn Marinothe meta-data, in the style of 4786d7f5d3SJohn Marino.Xr VOP_READ 9 , 4886d7f5d3SJohn Marinobut writes will replace the entire current "value" associated with 4986d7f5d3SJohn Marinoa given name. 5086d7f5d3SJohn MarinoAs there are a plethora of file systems with differing extended attributes, 5186d7f5d3SJohn Marinoavailability and functionality of these functions may be limited, and they 5286d7f5d3SJohn Marinoshould be used with awareness of the underlying semantics of the supporting 5386d7f5d3SJohn Marinofile system. 5486d7f5d3SJohn MarinoAuthorization schemes for extended attribute data may also vary by file 5586d7f5d3SJohn Marinosystem, as well as maximum attribute size, and whether or not any or 5686d7f5d3SJohn Marinospecific new attributes may be defined. 5786d7f5d3SJohn Marino.Pp 5886d7f5d3SJohn MarinoExtended attributes are named using a null-terminated character string. 5986d7f5d3SJohn MarinoDepending on underlying file system semantics, this name may or may not be 6086d7f5d3SJohn Marinocase-sensitive. 6186d7f5d3SJohn MarinoAppropriate vnode extended attribute calls are: 6286d7f5d3SJohn Marino.Xr VOP_GETEXTATTR 9 6386d7f5d3SJohn Marinoand 6486d7f5d3SJohn Marino.Xr VOP_SETEXTATTR 9 . 6586d7f5d3SJohn Marino.Sh SEE ALSO 6686d7f5d3SJohn Marino.Xr VFS 9 , 6786d7f5d3SJohn Marino.Xr VOP_GETEXTATTR 9 , 6886d7f5d3SJohn Marino.Xr VOP_SETEXTATTR 9 6986d7f5d3SJohn Marino.Sh AUTHORS 7086d7f5d3SJohn MarinoThis manual page was written by 7186d7f5d3SJohn Marino.An Robert Watson . 72