Skip to content
BSD syscall#236

svc · unix #236

setxattr

Creates, replaces or modifies an extended attribute on a path.

Prototype

int setxattr(user_addr_t path, user_addr_t attrname, user_addr_t value, size_t size, uint32_t position, int options);

Returns: int

Arguments

NameTypeDirDescription
pathuser_addr_t-
attrnameuser_addr_t-
valueuser_addr_t-
sizesize_t-
positionuint32_t-
optionsint-

Version history

XNU tagmacOS#
xnu-1456.1.26macOS 10.6 Snow Leopard236
xnu-1699.24.8macOS 10.7 Lion236
xnu-2050.18.24macOS 10.8 Mountain Lion236
xnu-2422.115.4macOS 10.9 Mavericks236
xnu-2782.40.9macOS 10.10 Yosemite236
xnu-3247.1.106macOS 10.11 El Capitan236
xnu-3789.1.32macOS 10.12 Sierra236
xnu-4570.1.46macOS 10.13 High Sierra236
xnu-4903.221.2macOS 10.14 Mojave236
xnu-6153.11.26macOS 10.15 Catalina236
xnu-7195.50.7.100.1macOS 11.0 Big Sur236
xnu-8019.41.5macOS 12.0 Monterey236
xnu-8792.41.9macOS 13.0 Ventura236
xnu-10002.1.13macOS 14.0 Sonoma236
xnu-11215.1.10macOS 15.0 Sequoia236
xnu-11417.101.15macOS 15.4 Sequoia236
xnu-12377.1.9macOS 26.0 Tahoe236
xnu-10002.41.9—236
xnu-10002.61.3—236
xnu-10002.81.5—236
xnu-10063.101.15—236
xnu-10063.121.3—236
xnu-10063.141.1—236
xnu-11215.41.3—236
xnu-11215.61.5—236
xnu-11215.81.4—236
xnu-11417.121.6—236
xnu-11417.140.69—236
xnu-12377.101.15—236
xnu-12377.41.6—236
xnu-12377.61.12—236
xnu-12377.81.4—236
xnu-1486.2.11—236
xnu-1504.15.3—236
xnu-1504.3.12—236
xnu-1504.7.4—236
xnu-1504.9.17—236
xnu-1504.9.26—236
xnu-1504.9.37—236
xnu-1699.22.73—236
xnu-1699.22.81—236
xnu-1699.24.23—236
xnu-1699.26.8—236
xnu-1699.32.7—236
xnu-2050.22.13—236
xnu-2050.24.15—236
xnu-2050.48.11—236
xnu-2050.7.9—236
xnu-2050.9.2—236
xnu-2422.1.72—236
xnu-2422.100.13—236
xnu-2422.110.17—236
xnu-2422.90.20—236
xnu-2782.1.97—236
xnu-2782.10.72—236
xnu-2782.20.48—236
xnu-2782.30.5—236
xnu-3247.10.11—236
xnu-3248.20.55—236
xnu-3248.30.4—236
xnu-3248.40.184—236
xnu-3248.50.21—236
xnu-3248.60.10—236
xnu-3789.21.4—236
xnu-3789.31.2—236
xnu-3789.41.3—236
xnu-3789.51.2—236
xnu-3789.60.24—236
xnu-3789.70.16—236
xnu-4570.20.62—236
xnu-4570.31.3—236
xnu-4570.41.2—236
xnu-4570.51.1—236
xnu-4570.61.1—236
xnu-4570.71.2—236
xnu-4903.231.4—236
xnu-4903.241.1—236
xnu-4903.270.47—236
xnu-6153.101.6—236
xnu-6153.121.1—236
xnu-6153.141.1—236
xnu-6153.41.3—236
xnu-6153.61.1—236
xnu-6153.81.5—236
xnu-7195.101.1—236
xnu-7195.121.3—236
xnu-7195.141.2—236
xnu-7195.60.75—236
xnu-7195.81.3—236
xnu-8019.61.5—236
xnu-8019.80.24—236
xnu-8020.101.4—236
xnu-8020.121.3—236
xnu-8020.140.41—236
xnu-8792.61.2—236
xnu-8792.81.2—236
xnu-8796.101.5—236
xnu-8796.121.2—236
xnu-8796.141.3—236

Notes

options accepts XATTR_CREATE to fail if the attribute already exists or XATTR_REPLACE to require it. Modifying com.apple.quarantine on a downloaded file changes Gatekeeper behaviour; com.apple.rootless can only be set by Apple-signed installers under SIP.

Detection

ES emits ES_EVENT_TYPE_NOTIFY_SETEXTATTR with attribute name and target vnode.

Related APIs

fsetxattrgetxattrlistxattrremovexattr