iPXE
efi_umalloc.c
Go to the documentation of this file.
1 /*
2  * Copyright (C) 2008 Michael Brown <mbrown@fensystems.co.uk>.
3  *
4  * This program is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU General Public License as
6  * published by the Free Software Foundation; either version 2 of the
7  * License, or any later version.
8  *
9  * This program is distributed in the hope that it will be useful, but
10  * WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12  * General Public License for more details.
13  *
14  * You should have received a copy of the GNU General Public License
15  * along with this program; if not, write to the Free Software
16  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
17  * 02110-1301, USA.
18  *
19  * You can also choose to distribute this program under the terms of
20  * the Unmodified Binary Distribution Licence (as given in the file
21  * COPYING.UBDL), provided that you have satisfied its requirements.
22  */
23 
24 FILE_LICENCE ( GPL2_OR_LATER_OR_UBDL );
25 
26 #include <string.h>
27 #include <errno.h>
28 #include <assert.h>
29 #include <ipxe/umalloc.h>
30 #include <ipxe/efi/efi.h>
31 
32 /** @file
33  *
34  * iPXE user memory allocation API for EFI
35  *
36  */
37 
38 /** Equivalent of NOWHERE for user pointers */
39 #define UNOWHERE ( ~UNULL )
40 
41 /**
42  * Reallocate external memory
43  *
44  * @v old_ptr Memory previously allocated by umalloc(), or UNULL
45  * @v new_size Requested size
46  * @ret new_ptr Allocated memory, or UNULL
47  *
48  * Calling realloc() with a new size of zero is a valid way to free a
49  * memory block.
50  */
51 static userptr_t efi_urealloc ( userptr_t old_ptr, size_t new_size ) {
53  EFI_PHYSICAL_ADDRESS phys_addr;
54  unsigned int new_pages, old_pages;
55  userptr_t new_ptr = UNOWHERE;
56  size_t old_size;
57  EFI_STATUS efirc;
58  int rc;
59 
60  /* Allocate new memory if necessary. If allocation fails,
61  * return without touching the old block.
62  */
63  if ( new_size ) {
64  new_pages = ( EFI_SIZE_TO_PAGES ( new_size ) + 1 );
65  if ( ( efirc = bs->AllocatePages ( AllocateAnyPages,
67  new_pages,
68  &phys_addr ) ) != 0 ) {
69  rc = -EEFI ( efirc );
70  DBG ( "EFI could not allocate %d pages: %s\n",
71  new_pages, strerror ( rc ) );
72  return UNULL;
73  }
74  assert ( phys_addr != 0 );
75  new_ptr = phys_to_user ( phys_addr + EFI_PAGE_SIZE );
76  copy_to_user ( new_ptr, -EFI_PAGE_SIZE,
77  &new_size, sizeof ( new_size ) );
78  DBG ( "EFI allocated %d pages at %llx\n",
79  new_pages, phys_addr );
80  }
81 
82  /* Copy across relevant part of the old data region (if any),
83  * then free it. Note that at this point either (a) new_ptr
84  * is valid, or (b) new_size is 0; either way, the memcpy() is
85  * valid.
86  */
87  if ( old_ptr && ( old_ptr != UNOWHERE ) ) {
88  copy_from_user ( &old_size, old_ptr, -EFI_PAGE_SIZE,
89  sizeof ( old_size ) );
90  memcpy_user ( new_ptr, 0, old_ptr, 0,
91  ( (old_size < new_size) ? old_size : new_size ));
92  old_pages = ( EFI_SIZE_TO_PAGES ( old_size ) + 1 );
93  phys_addr = user_to_phys ( old_ptr, -EFI_PAGE_SIZE );
94  if ( ( efirc = bs->FreePages ( phys_addr, old_pages ) ) != 0 ){
95  rc = -EEFI ( efirc );
96  DBG ( "EFI could not free %d pages at %llx: %s\n",
97  old_pages, phys_addr, strerror ( rc ) );
98  /* Not fatal; we have leaked memory but successfully
99  * allocated (if asked to do so).
100  */
101  }
102  DBG ( "EFI freed %d pages at %llx\n", old_pages, phys_addr );
103  }
104 
105  return new_ptr;
106 }
107 
#define UNOWHERE
Equivalent of NOWHERE for user pointers.
Definition: efi_umalloc.c:39
EFI_BOOT_SERVICES * BootServices
A pointer to the EFI Boot Services Table.
Definition: UefiSpec.h:2081
#define EFI_PAGE_SIZE
Definition: UefiBaseType.h:187
struct arbelprm_rc_send_wqe rc
Definition: arbel.h:14
#define EEFI(efirc)
Convert an EFI status code to an iPXE status code.
Definition: efi.h:171
Error codes.
static __always_inline void copy_from_user(void *dest, userptr_t src, off_t src_off, size_t len)
Copy data from user buffer.
Definition: uaccess.h:337
unsigned long user_to_phys(userptr_t userptr, off_t offset)
Convert user pointer to physical address.
userptr_t phys_to_user(unsigned long phys_addr)
Convert physical address to user pointer.
UINT64 EFI_PHYSICAL_ADDRESS
64-bit physical memory address.
Definition: UefiBaseType.h:52
PROVIDE_UMALLOC(efi, urealloc, efi_urealloc)
Assertions.
assert((readw(&hdr->flags) &(GTF_reading|GTF_writing))==0)
userptr_t urealloc(userptr_t userptr, size_t new_size)
Reallocate external memory.
char * strerror(int errno)
Retrieve string representation of error number.
Definition: strerror.c:78
EFI Boot Services Table.
Definition: UefiSpec.h:1917
static __always_inline void copy_to_user(userptr_t dest, off_t dest_off, const void *src, size_t len)
Copy data to user buffer.
Definition: uaccess.h:324
User memory allocation.
#define EFI_SIZE_TO_PAGES(Size)
Macro that converts a size, in bytes, to a number of EFI_PAGESs.
Definition: UefiBaseType.h:202
EFI API.
static userptr_t efi_urealloc(userptr_t old_ptr, size_t new_size)
Reallocate external memory.
Definition: efi_umalloc.c:51
EFI_ALLOCATE_PAGES AllocatePages
Definition: UefiSpec.h:1932
#define UNULL
Equivalent of NULL for user pointers.
Definition: uaccess.h:36
RETURN_STATUS EFI_STATUS
Function return status for EFI API.
Definition: UefiBaseType.h:31
FILE_LICENCE(GPL2_OR_LATER_OR_UBDL)
Allocate any available range of pages that satisfies the request.
Definition: UefiSpec.h:35
EFI_SYSTEM_TABLE * efi_systab
The data portions of a loaded Boot Serves Driver, and the default data allocation type used by a Boot...
#define DBG(...)
Print a debugging message.
Definition: compiler.h:498
EFI_FREE_PAGES FreePages
Definition: UefiSpec.h:1933
String functions.
void memcpy_user(userptr_t dest, off_t dest_off, userptr_t src, off_t src_off, size_t len)
Copy data between user buffers.
unsigned long userptr_t
A pointer to a user buffer.
Definition: uaccess.h:33