Runs an executable tool with root privileges.
- macOS 10.1–10.7Deprecated
An authorization reference referring to the authorization session.
The full POSIX pathname of the tool to execute.
Reserved options. Pass the
Authorization Flag Defaults
An argv-style vector of strings (array of null-terminated
char *pointers ending with a NULL pointer) to send to the tool. (You do not need to pass the name of the command as the first argument.)
A pointer to a file structure. The Security Server creates the file, opens it for reading and writing, and connects it to the tool’s standard input and output. On return, you must close and dispose of this file using
fclosewhen your communication is complete. Pass
NULLif you do not need a communications channel.
A result code. See Result Codes.
This function enables you to execute the tool you specify in the
path parameter as a separate, privileged process. The new process will run with root privileges regardless of the privileges of the invoking process. The new process can retrieve the authorization reference by calling the function
Authorization. The arguments you pass in the
arguments parameter are relayed to the new process’s
argv parameter. A set of file descriptors is linked to the new process’s standard input and output so that your process may communicate with the new process.
To check if the user is authorized to perform this operation, you should preauthorize the
k right. See
Authorization for a description of what information is included in the authorization item for this right.
You should use this function only to allow installers to run as root and to allow a
setuid tool to repair its
setuid bit if lost. This function works only if the Security Server establishes proper authorization.
This function poses a security concern because it will indiscriminately run any tool or application, severely increasing the security risk. You should avoid the use of this function if possible. One alternative is to split your code into two parts—the application and a setuid tool. The application invokes the setuid tool using standard methods. The setuid tool can then perform the privileged operations. If the tool loses its setuid bit, use the
Authorization function to repair it. Factoring your program minimizes the use of this function and reduces the risk of harm. Read Inside macOS: Performing Privileged Operations With Authorization Services.
Note that this function respects the setuid bit, if it is set. That is, if the tool you are executing has its setuid bit set and its owner set to foo, the tool will be executed with the user foo’s privileges, not root privileges. To ensure that your call to the
Authorization function works as intended, make sure the setuid bit of the tool you wish to execute is cleared before calling
Authorization to execute the tool.