source: mainline/generic/include/mm/frame.h@ 34722ee

lfn serial ticket/834-toolchain-update topic/msim-upgrade topic/simplify-dev-export
Last change on this file since 34722ee was eef75f6, checked in by Jakub Jermar <jakub@…>, 20 years ago

Buddy allocator cleanup and fixes.

  • Add some comments.
  • Update zone information on frames allocation/deallocation.
  • Property mode set to 100644
File size: 4.2 KB
Line 
1/*
2 * Copyright (C) 2005 Jakub Jermar
3 * Copyright (C) 2005 Sergey Bondari
4 * All rights reserved.
5 *
6 * Redistribution and use in source and binary forms, with or without
7 * modification, are permitted provided that the following conditions
8 * are met:
9 *
10 * - Redistributions of source code must retain the above copyright
11 * notice, this list of conditions and the following disclaimer.
12 * - Redistributions in binary form must reproduce the above copyright
13 * notice, this list of conditions and the following disclaimer in the
14 * documentation and/or other materials provided with the distribution.
15 * - The name of the author may not be used to endorse or promote products
16 * derived from this software without specific prior written permission.
17 *
18 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
19 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
20 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
21 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
22 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
23 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
24 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
25 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
26 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
27 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
28 */
29
30#ifndef __FRAME_H__
31#define __FRAME_H__
32
33#include <arch/types.h>
34#include <typedefs.h>
35#include <list.h>
36#include <synch/spinlock.h>
37#include <mm/buddy.h>
38
39#define FRAME_KA 1 /* skip frames conflicting with user address space */
40#define FRAME_PANIC 2 /* panic on failure */
41
42#define FRAME2ADDR(zone, frame) ((zone)->base + ((frame) - (zone)->frames) * FRAME_SIZE)
43#define ADDR2FRAME(zone, addr) (&((zone)->frames[((addr) - (zone)->base) / FRAME_SIZE]))
44#define FRAME_INDEX(zone, frame) ((index_t)((frame) - (zone)->frames))
45#define FRAME_INDEX_VALID(zone, index) (((index) >= 0) && ((index) < ((zone)->free_count + (zone)->busy_count)))
46#define IS_BUDDY_LEFT_BLOCK(zone, frame) ((FRAME_INDEX((zone), (frame)) & ~(((__native) -1)<<((frame)->buddy_order + 1))) == 0)
47
48#define ZONE_BLACKLIST_SIZE 3
49
50struct zone {
51 link_t link; /**< link to previous and next zone */
52
53 spinlock_t lock; /**< this lock protects everything below */
54 __address base; /**< physical address of the first frame in the frames array */
55 frame_t *frames; /**< array of frame_t structures in this zone */
56 count_t free_count; /**< number of free frame_t structures */
57 count_t busy_count; /**< number of busy frame_t structures */
58
59 buddy_system_t * buddy_system; /**< buddy system for the zone */
60 int flags;
61};
62
63struct frame {
64 count_t refcount; /**< tracking of shared frames */
65 __u8 buddy_order; /**< buddy system block order */
66 link_t buddy_link; /**< link to the next free block inside one order */
67};
68
69struct region {
70 __address base;
71 size_t size;
72};
73
74extern region_t zone_blacklist[];
75extern count_t zone_blacklist_count;
76extern void frame_region_not_free(__address base, size_t size);
77extern void zone_create_in_region(__address base, size_t size);
78
79extern spinlock_t zone_head_lock; /**< this lock protects zone_head list */
80extern link_t zone_head; /**< list of all zones in the system */
81
82extern void zone_init(void);
83extern zone_t *zone_create(__address start, size_t size, int flags);
84extern void zone_attach(zone_t *zone);
85
86extern void frame_init(void);
87extern void frame_initialize(frame_t *frame, zone_t *zone);
88__address frame_alloc(int flags, __u8 order);
89extern void frame_free(__address addr);
90zone_t * get_zone_by_frame(frame_t * frame);
91
92/*
93 * Buddy system operations
94 */
95link_t * zone_buddy_find_buddy(buddy_system_t *b, link_t * buddy);
96link_t * zone_buddy_bisect(buddy_system_t *b, link_t * block);
97link_t * zone_buddy_coalesce(buddy_system_t *b, link_t * buddy_l, link_t * buddy_r);
98void zone_buddy_set_order(buddy_system_t *b, link_t * block, __u8 order);
99__u8 zone_buddy_get_order(buddy_system_t *b, link_t * block);
100void zone_buddy_mark_busy(buddy_system_t *b, link_t * block);
101
102/*
103 * TODO: Implement the following functions.
104 */
105extern frame_t *frame_reference(frame_t *frame);
106extern void frame_release(frame_t *frame);
107
108#endif
Note: See TracBrowser for help on using the repository browser.