#ifndef _I386_PAGE_H
#define _I386_PAGE_H

/* PAGE_SHIFT determines the page size */

//==========================================================================
//   Tutaj właśnie ustawiana jest wielkość ramki.
//    1UL << PAGE_SHIFT oznacza że jedynkę potraktowaną jako Unsigned Long
//    przesuwamy 12 miejsc w lewo czyli mnożymy przez 2^12 co daje nam
//    właśnie 4KB.
//==========================================================================

#define PAGE_SHIFT      12
#define PAGE_SIZE       (1UL << PAGE_SHIFT)
#define PAGE_MASK       (~(PAGE_SIZE-1))

#ifdef __KERNEL__


//===========================================================================
//  Od pozostawienia będąŸ wykasowania poniższej linijki zależy czy
//  wszechobecne np. w memory.c i pgtable.h struktury ptm_t, pmd_t, pgd_t, 
//  pgprot_t   będš zwykłymi 'unsigned long' czy  strukturami z jednym elementem
//  'unsigned long'.
//  Jak zauważono pierwsze z tych rozwiązań ułatwia zadanie kompilatorowi,
//  zaœto drugie pozwala korzystać z kontroli typów w C
//===========================================================================

#define STRICT_MM_TYPECHECKS

#ifdef STRICT_MM_TYPECHECKS
/*
 * These are used to make use of C type-checking..
 */
typedef struct { unsigned long pte; } pte_t;
typedef struct { unsigned long pmd; } pmd_t;
typedef struct { unsigned long pgd; } pgd_t;
typedef struct { unsigned long pgprot; } pgprot_t;

#define pte_val(x)      ((x).pte)
#define pmd_val(x)      ((x).pmd)
#define pgd_val(x)      ((x).pgd)
#define pgprot_val(x)   ((x).pgprot)

#define __pte(x)        ((pte_t) { (x) } )
#define __pmd(x)        ((pmd_t) { (x) } )
#define __pgd(x)        ((pgd_t) { (x) } )
#define __pgprot(x)     ((pgprot_t) { (x) } )

#else
/*
 * .. while these make it easier on the compiler
 */
typedef unsigned long pte_t;
typedef unsigned long pmd_t;
typedef unsigned long pgd_t;
typedef unsigned long pgprot_t;

#define pte_val(x)      (x)
#define pmd_val(x)      (x)
#define pgd_val(x)      (x)
#define pgprot_val(x)   (x)

#define __pte(x)        (x)
#define __pmd(x)        (x)
#define __pgd(x)        (x)
#define __pgprot(x)     (x)

#endif

/* to align the pointer to the (next) page boundary */
//===========================================================================
// Funkcja PAGE_ALIGN zwraca adres początku ramki na wskazywanej przez addr
//===========================================================================
#define PAGE_ALIGN(addr)        (((addr)+PAGE_SIZE-1)&PAGE_MASK)

/* This handles the memory map.. */
#define PAGE_OFFSET             0
#define MAP_NR(addr)            (((unsigned long)(addr)) >> PAGE_SHIFT)

#endif /* __KERNEL__ */

#endif /* _I386_PAGE_H */