Struct x86_64::structures::gdt::GlobalDescriptorTable [−][src]
pub struct GlobalDescriptorTable { /* fields omitted */ }
Expand description
A 64-bit mode global descriptor table (GDT).
In 64-bit mode, segmentation is not supported. The GDT is used nonetheless, for example for switching between user and kernel mode or for loading a TSS.
The GDT has a fixed size of 8 entries, trying to add more entries will panic.
You do not need to add a null segment descriptor yourself - this is already done internally.
Data segment registers in ring 0 can be loaded with the null segment selector. When running in
ring 3, the ss
register must point to a valid data segment which can be obtained through the
Descriptor::user_data_segment()
function. Code segments must
be valid and non-null at all times and can be obtained through the
Descriptor::kernel_code_segment()
and
Descriptor::user_code_segment()
in rings 0 and 3
respectively.
For more info, see:
x86 Instruction Reference for mov
,
Intel Manual,
AMD Manual
Example
use x86_64::structures::gdt::{GlobalDescriptorTable, Descriptor}; let mut gdt = GlobalDescriptorTable::new(); gdt.add_entry(Descriptor::kernel_code_segment()); gdt.add_entry(Descriptor::user_code_segment()); gdt.add_entry(Descriptor::user_data_segment()); // Add entry for TSS, call gdt.load() then update segment registers
Implementations
impl GlobalDescriptorTable
[src]
impl GlobalDescriptorTable
[src]pub const fn new() -> GlobalDescriptorTable
[src]
pub const fn new() -> GlobalDescriptorTable
[src]Creates an empty GDT.
pub const unsafe fn from_raw_slice(slice: &[u64]) -> GlobalDescriptorTable
[src]
pub const unsafe fn from_raw_slice(slice: &[u64]) -> GlobalDescriptorTable
[src]Forms a GDT from a slice of u64
.
Safety
- The user must make sure that the entries are well formed
- The provided slice must not be larger than 8 items (only up to the first 8 will be observed.)
pub fn as_raw_slice(&self) -> &[u64]
[src]
pub fn as_raw_slice(&self) -> &[u64]
[src]Get a reference to the internal table.
The resulting slice may contain system descriptors, which span two u64
s.
pub const fn add_entry(&mut self, entry: Descriptor) -> SegmentSelector
[src]
pub const fn add_entry(&mut self, entry: Descriptor) -> SegmentSelector
[src]Adds the given segment descriptor to the GDT, returning the segment selector.
Panics if the GDT has no free entries left.
pub fn load(&'static self)
[src]
pub fn load(&'static self)
[src]Loads the GDT in the CPU using the lgdt
instruction. This does not alter any of the
segment registers; you must (re)load them yourself using the appropriate
functions:
load_ss,
set_cs.
pub unsafe fn load_unsafe(&self)
[src]
pub unsafe fn load_unsafe(&self)
[src]Loads the GDT in the CPU using the lgdt
instruction. This does not alter any of the
segment registers; you must (re)load them yourself using the appropriate
functions:
load_ss,
set_cs.
Safety
Unlike load
this function will not impose a static lifetime constraint
this means its up to the user to ensure that there will be no modifications
after loading and that the GDT will live for as long as it’s loaded.
Trait Implementations
impl Clone for GlobalDescriptorTable
[src]
impl Clone for GlobalDescriptorTable
[src]fn clone(&self) -> GlobalDescriptorTable
[src]
fn clone(&self) -> GlobalDescriptorTable
[src]Returns a copy of the value. Read more
fn clone_from(&mut self, source: &Self)
1.0.0[src]
fn clone_from(&mut self, source: &Self)
1.0.0[src]Performs copy-assignment from source
. Read more