From 6e074b9b20d0d47dafa7d2cb3ea318325a8e4e6c Mon Sep 17 00:00:00 2001
From: Colin Walters <walters@verbum.org>
Date: Thu, 19 Dec 2024 08:44:02 -0500
Subject: [PATCH] open_tree: Note EPERM

This came up in https://github.com/containers/bootc/pull/983 and it's actually *really* cool honestly that one can do a non-cloning (detached) `open_tree` without privileges. Let's note that implicitly by documenting that this can return `EPERM`.
---
 open_tree.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/open_tree.md b/open_tree.md
index 8f76c4c..420af20 100644
--- a/open_tree.md
+++ b/open_tree.md
@@ -118,6 +118,10 @@ returned, and *errno* is set appropriately.
 Search permission is denied for one of the directories in the path
 prefix of *pathname*. (See also **path_resolution**(7).)
 
+**EPERM**
+The **OPEN_TREE_CLONE** flag was specified and the caller does not
+have the required privileges.
+
 **EBADF**  
 *dirfd* is not a valid open file descriptor.