X-Git-Url: https://git.saurik.com/apple/xnu.git/blobdiff_plain/55e303ae13a4cf49d70f2294092726f2fffb9ef2..HEAD:/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 old mode 100755 new mode 100644 index 052694e55..0c58dcd06 --- a/osfmk/man/host_security_set_task_token.html +++ b/osfmk/man/host_security_set_task_token.html @@ -1 +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. \ No newline at end of file +

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.