sepolicy: Add deprecation comment for `_get_path()`
authorColin Walters <walters@verbum.org>
Thu, 30 Sep 2021 15:38:10 +0000 (11:38 -0400)
committerColin Walters <walters@verbum.org>
Thu, 30 Sep 2021 19:54:48 +0000 (15:54 -0400)
Came up in review
https://github.com/ostreedev/ostree/pull/2447#issuecomment-931428312

src/libostree/ostree-sepolicy.c

index 8aa1df96f7416bb603e3dcf92a07fc468e49bebb..9b2ce0ab5f8af8216f186c5a123ff82575519255 100644 (file)
@@ -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
  */