From: Colin Walters <walters@verbum.org>
Date: Thu, 30 Sep 2021 15:38:10 +0000 (-0400)
Subject: sepolicy: Add deprecation comment for `_get_path()`
X-Git-Tag: archive/raspbian/2022.1-3+rpi1~1^2~4^2~1^2~4^2
X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=ddc0d54b784ca01a2d9a582fc9aa1f31dd57ed08;p=ostree.git

sepolicy: Add deprecation comment for `_get_path()`

Came up in review
https://github.com/ostreedev/ostree/pull/2447#issuecomment-931428312
---

diff --git a/src/libostree/ostree-sepolicy.c b/src/libostree/ostree-sepolicy.c
index 8aa1df96..9b2ce0ab 100644
--- a/src/libostree/ostree-sepolicy.c
+++ b/src/libostree/ostree-sepolicy.c
@@ -499,7 +499,11 @@ ostree_sepolicy_new_at (int         rootfs_dfd,
 
 /**
  * ostree_sepolicy_get_path:
- * @self:
+ * @self: A SePolicy object
+ *
+ * This API should be considered deprecated, because it's supported for
+ * policy objects to be created from file-descriptor relative paths, which
+ * may not be globally accessible.
  *
  * Returns: (transfer none): Path to rootfs
  */