X-Git-Url: https://git.saurik.com/apple/xnu.git/blobdiff_plain/9bccf70c0258c7cac2dcb80011b2a964d884c552..2a1bd2d3eef5c7a7bb14f4bb9fdbca9a96ee4752:/osfmk/man/host_security_set_task_token.html
diff --git a/osfmk/man/host_security_set_task_token.html b/osfmk/man/host_security_set_task_token.html
new file mode 100644
index 000000000..0c58dcd06
--- /dev/null
+++ b/osfmk/man/host_security_set_task_token.html
@@ -0,0 +1,60 @@
+host_security_set_task_token
+
+
+Function - Change the target task's security token.
+
SYNOPSIS
+
+kern_return_t host_security_set_task_token
+ (host_security_t host_security,
+ task_t task,
+ security_token_t security_token,
+ audit_token_t audit_token,
+ host_t host);
+
+PARAMETERS
+
+
+
- host_security
+
-
+[in security send right] The host's security port.
+
+
- task
+
-
+[in task send right] The port for the task for which the token is to be set.
+
+
- security_token
+
-
+[in scalar] The new security token.
+
+
- audit_token
+
-
+[in scalar] The new audit token.
+
+
- host
+
-
+[in host send right] The task's new host-self port.
+
+DESCRIPTION
+
+The host_security_set_task_token function changes the
+specified task's security and audit tokens; the new tokens will be
+included in all subsequent messages sent from the task. The
+initial value of a task's security and audit tokens is that of its
+parent.
+
NOTES
+
+The host security port is a privileged port given to the system
+bootstrap task for the use of this call.
+
RETURN VALUES
+
+
+
- KERN_INVALID_SECURITY
+
-
+The value of host_security does not specify the security port for the host on which task lies.
+
+RELATED INFORMATION
+
+Functions:
+task_create,
+task_info,
+mach_msg.