mach_ipc_mac.h - mozsearch

Enable keyboard shortcuts

/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */

/* vim: set ts=8 sts=2 et sw=2 tw=80: */

// Copyright (c) 2006-2008 The Chromium Authors. All rights reserved.

// Use of this source code is governed by a BSD-style license that can be

// found in the LICENSE file.

#ifndef BASE_MACH_IPC_MAC_H_

#define BASE_MACH_IPC_MAC_H_

#include <mach/mach.h>

#include <mach/message.h>

#include <sys/types.h>

#include "mozilla/Maybe.h"

#include "mozilla/Result.h"

#include "mozilla/UniquePtrExtensions.h"

//==============================================================================

// Helper function for sending a minimal mach IPC messages with a single send

// right attached. The endpoint will not be consumed unless the

// `endpoint_disposition` argument is set to a consuming disposition, and

// `KERN_SUCCESS` is returned.

kern_return_t MachSendPortSendRight(

    mach_port_t endpoint, mach_port_t attachment,

    mozilla::Maybe<mach_msg_timeout_t> opt_timeout,

    mach_msg_type_name_t endpoint_disposition = MACH_MSG_TYPE_COPY_SEND);

//==============================================================================

// Helper function for receiving a minimal mach IPC message with a single send

// right attached.

// If the `audit_token` parameter is provided, it will be populated with the

// sender's audit token, which can be used to verify the identity of the sender.

kern_return_t MachReceivePortSendRight(

    const mozilla::UniqueMachReceiveRight& endpoint,

    mozilla::Maybe<mach_msg_timeout_t> opt_timeout,

    mozilla::UniqueMachSendRight* attachment,

    audit_token_t* audit_token = nullptr);

#endif  // BASE_MACH_IPC_MAC_H_