Blob Blame History Raw
--- libselinux-1.17.2/man/man3/matchpathcon.3.rhat	2004-08-26 08:37:17.533537517 -0400
+++ libselinux-1.17.2/man/man3/matchpathcon.3	2004-08-26 08:36:21.061471154 -0400
@@ -0,0 +1,26 @@
+.TH "matchpathcon" "3" "1 August 2004" "dwalsh@redhat.com" "SE Linux API documentation"
+.SH "NAME"
+matchpathcon \- get the default security context for the specified file from the policy.
+
+.SH "SYNOPSIS"
+.B #include <selinux/selinux.h>
+.sp
+.BI "int matchpathcon(const char *" path ", mode_t " mode ", security_context_t *" con);"
+.br 
+
+.SH "DESCRIPTION"
+.br
+.B matchpathcon 
+matches the specified pathname and mode against the file contexts configuration and set the security context "con" to refer to the resulting context. "mode" can be 0 to disable mode matching.
+.sp
+.br
+.B Note: 
+   Caller must free returned security context "con" using freecon.
+.SH "RETURN VALUE"
+On error -1 is returned.
+
+On success matchpathcon returns the length of the context (not including
+the trailing zero byte).  
+
+.SH "SEE ALSO"
+.BR freecon "(3), " setfilecon "(3), " setfscreatecon "(3)"