| Index: third_party/crashpad/crashpad/util/posix/scoped_mmap.h
|
| diff --git a/third_party/crashpad/crashpad/util/posix/scoped_mmap.h b/third_party/crashpad/crashpad/util/posix/scoped_mmap.h
|
| new file mode 100644
|
| index 0000000000000000000000000000000000000000..5b216dee2405517e3c37e3ecc0208281662e16cf
|
| --- /dev/null
|
| +++ b/third_party/crashpad/crashpad/util/posix/scoped_mmap.h
|
| @@ -0,0 +1,103 @@
|
| +// Copyright 2017 The Crashpad Authors. All rights reserved.
|
| +//
|
| +// Licensed under the Apache License, Version 2.0 (the "License");
|
| +// you may not use this file except in compliance with the License.
|
| +// You may obtain a copy of the License at
|
| +//
|
| +// http://www.apache.org/licenses/LICENSE-2.0
|
| +//
|
| +// Unless required by applicable law or agreed to in writing, software
|
| +// distributed under the License is distributed on an "AS IS" BASIS,
|
| +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
| +// See the License for the specific language governing permissions and
|
| +// limitations under the License.
|
| +
|
| +#ifndef CRASHPAD_UTIL_POSIX_SCOPED_MMAP_H_
|
| +#define CRASHPAD_UTIL_POSIX_SCOPED_MMAP_H_
|
| +
|
| +#include "base/macros.h"
|
| +
|
| +#include <sys/mman.h>
|
| +#include <sys/types.h>
|
| +
|
| +namespace crashpad {
|
| +
|
| +//! \brief Maintains a memory-mapped region created by `mmap()`.
|
| +//!
|
| +//! On destruction, any memory-mapped region managed by an object of this class
|
| +//! will be released by calling `munmap()`.
|
| +class ScopedMmap {
|
| + public:
|
| + ScopedMmap();
|
| + ~ScopedMmap();
|
| +
|
| + //! \brief Releases the memory-mapped region by calling `munmap()`.
|
| + //!
|
| + //! \return `true` on success. `false` on failure, with a message logged.
|
| + bool Reset();
|
| +
|
| + //! \brief Releases any existing memory-mapped region and sets the object to
|
| + //! maintain an already-established mapping.
|
| + //!
|
| + //! If \a addr and \a len indicate a region that overlaps with the existing
|
| + //! memory-mapped region, only the portion of the existing memory-mapped
|
| + //! region that does not overlap the new region, if any, will be released.
|
| + //!
|
| + //! \param[in] addr The base address of the existing memory-mapped region to
|
| + //! maintain.
|
| + //! \param[in] len The size of the existing memory-mapped region to maintain.
|
| + //!
|
| + //! \return `true` on success. `false` on failure, with a message logged.
|
| + bool ResetAddrLen(void* addr, size_t len);
|
| +
|
| + //! \brief Releases any existing memory-mapped region and establishes a new
|
| + //! one by calling `mmap()`.
|
| + //!
|
| + //! The parameters to this method are passed directly to `mmap()`.
|
| + //!
|
| + //! \return `true` on success. `false` on failure, with a message logged. A
|
| + //! message will also be logged on failure to release any existing
|
| + //! memory-mapped region, but this will not preclude `mmap()` from being
|
| + //! called or a new mapping from being established, and if such a call to
|
| + //! `mmap()` is successful, this method will return `true`.
|
| + bool ResetMmap(void* addr,
|
| + size_t len,
|
| + int prot,
|
| + int flags,
|
| + int fd,
|
| + off_t offset);
|
| +
|
| + //! \brief Sets the protection of the memory-mapped region by calling
|
| + //! `mprotect()`.
|
| + //!
|
| + //! \a prot is passed directly to `mprotect()`.
|
| + //!
|
| + //! \return `true` on success. `false` on failure, with a message logged.
|
| + bool Mprotect(int prot);
|
| +
|
| + //! \return Whether this object is managing a valid memory-mapped region.
|
| + bool is_valid() const { return addr_ != MAP_FAILED; }
|
| +
|
| + //! \brief Returns the base address of the memory-mapped region.
|
| + void* addr() const { return addr_; }
|
| +
|
| + //! \brief Returns the base address of the memory-mapped region, casted to
|
| + //! a type of the caller’s choosing.
|
| + template <typename T>
|
| + T addr_as() const {
|
| + return reinterpret_cast<T>(addr_);
|
| + }
|
| +
|
| + //! \brief Returns the size of the memory-mapped region.
|
| + size_t len() const { return len_; }
|
| +
|
| + private:
|
| + void* addr_ = MAP_FAILED;
|
| + size_t len_ = 0;
|
| +
|
| + DISALLOW_COPY_AND_ASSIGN(ScopedMmap);
|
| +};
|
| +
|
| +} // namespace crashpad
|
| +
|
| +#endif // CRASHPAD_UTIL_POSIX_SCOPED_MMAP_H_
|
|
|