/* vim: set ts=4 sw=4 tw=99 et:

 *

 * Copyright (C) 2012 David Anderson

 *

 * This file is part of JITCraft.

 *

 * JITCraft is free software: you can redistribute it and/or modify it under

 * the terms of the GNU General Public License as published by the Free

 * Software Foundation, either version 3 of the License, or (at your option)

 * any later version.

 * 

 * Foobar is distributed in the hope that it will be useful, but WITHOUT ANY

 * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS

 * FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

 *

 * You should have received a copy of the GNU General Public License along with

 * JITCraft. If not, see http://www.gnu.org/licenses/.

 */

#ifndef _include_jitcraft_platform_h_

#define _include_jitcraft_platform_h_

#include "Utility.h"

namespace ke {

namespace OS {

    enum Protection {

        Prot_ReadWrite,         // rw-, for the heap

        Prot_ReadExecute,       // r-x, for code

        Prot_ReadWriteExecute   // rwx, if disabling r-x for code.

    };

    enum MapMode {

        Map_Reserve,            // don't ask for actual pages yet

        Map_Commit              // ask for pages right away

    };

    Address MapMemory(size_t amount, MapMode mode, Protection prot);

    bool CommitMemory(Address address, size_t amount, Protection prot);

    void UnmapMemory(Address address, size_t size);

    class AlignableMapping {

        Address base_;

        Address aligned_;

        size_t size_;

      public:

        AlignableMapping(Address ptr, size_t alignment, size_t size)

          : base_(ptr),

            size_(size)

        {

            aligned_ = base_;

            if (!IsAligned(aligned_, alignment))

                aligned_ = AlignedBase(aligned_, alignment) + alignment;

        }

        AlignableMapping() : base_(NULL), aligned_(NULL), size_(0)

        {

        }

        Address base() const {

            return base_;

        }

        bool isValid() const {

            return !!base_;

        }

        size_t size() const {

            return size_;

        }

        Address aligned() const {

            return aligned_;

        }

    };

    // MapAlignedMemory is guaranteed to return zeroed memory.

    AlignableMapping MapAlignedMemory(size_t amount, size_t alignment, MapMode mode);

    void UnmapAlignedMemory(Address address, size_t size);

    // The default alignment of memory returned via MapMemory().

    // :TODO: better ifdefs

#ifdef _MSC_VER

    static const size_t kPageAlignment = 64 * kKB;

#else

    static const size_t kPageAlignment = 4 * kKB;

#endif

}

}

#endif // _include_jitcraft_platform_h_