Skip to content

Commit 5a3ecd5

Browse files
authored
Rollup merge of #127462 - Ayush1325:uefi-env, r=joboet
std: uefi: Add basic Env variables - Implement environment variable functions - Using EFI Shell protocol.
2 parents c926476 + 753536a commit 5a3ecd5

2 files changed

Lines changed: 125 additions & 42 deletions

File tree

‎library/std/src/sys/pal/uefi/helpers.rs‎

Lines changed: 22 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@
1010
//! - More information about protocols can be found [here](https://edk2-docs.gitbook.io/edk-ii-uefi-driver-writer-s-guide/3_foundation/36_protocols_and_handles)
1111
1212
use r_efi::efi::{self,Guid};
13-
use r_efi::protocols::{device_path, device_path_to_text};
13+
use r_efi::protocols::{device_path, device_path_to_text, shell};
1414

1515
usecrate::ffi::{OsStr,OsString};
1616
usecrate::io::{self, const_io_error};
@@ -424,3 +424,24 @@ pub(crate) fn os_string_to_raw(s: &OsStr) -> Option<Box<[r_efi::efi::Char16]>> {
424424
let temp = s.encode_wide().chain(Some(0)).collect::<Box<[r_efi::efi::Char16]>>();
425425
if temp[..temp.len() - 1].contains(&0){None}else{Some(temp)}
426426
}
427+
428+
pub(crate)fnopen_shell() -> Option<NonNull<shell::Protocol>>{
429+
staticLAST_VALID_HANDLE:AtomicPtr<crate::ffi::c_void> =
430+
AtomicPtr::new(crate::ptr::null_mut());
431+
432+
ifletSome(handle) = NonNull::new(LAST_VALID_HANDLE.load(Ordering::Acquire)){
433+
ifletOk(protocol) = open_protocol::<shell::Protocol>(handle, shell::PROTOCOL_GUID){
434+
returnSome(protocol);
435+
}
436+
}
437+
438+
let handles = locate_handles(shell::PROTOCOL_GUID).ok()?;
439+
for handle in handles {
440+
ifletOk(protocol) = open_protocol::<shell::Protocol>(handle, shell::PROTOCOL_GUID){
441+
LAST_VALID_HANDLE.store(handle.as_ptr(),Ordering::Release);
442+
returnSome(protocol);
443+
}
444+
}
445+
446+
None
447+
}

‎library/std/src/sys/pal/uefi/os.rs‎

Lines changed: 103 additions & 41 deletions
Original file line numberDiff line numberDiff line change
@@ -125,7 +125,7 @@ pub fn error_string(errno: RawOsError) -> String {
125125
}
126126

127127
pubfngetcwd() -> io::Result<PathBuf>{
128-
matchuefi_shell::open_shell(){
128+
matchhelpers::open_shell(){
129129
Some(shell) => {
130130
// SAFETY: path_ptr is managed by UEFI shell and should not be deallocated
131131
let path_ptr = unsafe{((*shell.as_ptr()).get_cur_dir)(crate::ptr::null_mut())};
@@ -144,7 +144,7 @@ pub fn getcwd() -> io::Result<PathBuf> {
144144
}
145145

146146
pubfnchdir(p:&path::Path) -> io::Result<()>{
147-
let shell = uefi_shell::open_shell().ok_or(unsupported_err())?;
147+
let shell = helpers::open_shell().ok_or(unsupported_err())?;
148148

149149
letmut p = helpers::os_string_to_raw(p.as_os_str())
150150
.ok_or(io::const_io_error!(io::ErrorKind::InvalidData,"Invalid path"))?;
@@ -192,44 +192,58 @@ pub fn current_exe() -> io::Result<PathBuf> {
192192
helpers::device_path_to_text(protocol).map(PathBuf::from)
193193
}
194194

195-
pubstructEnv(!);
195+
pubstructEnvStrDebug<'a>{
196+
iter:&'a[(OsString,OsString)],
197+
}
198+
199+
impl fmt::DebugforEnvStrDebug<'_>{
200+
fnfmt(&self,f:&mut fmt::Formatter<'_>) -> fmt::Result{
201+
letmut list = f.debug_list();
202+
for(a, b)inself.iter{
203+
list.entry(&(a.to_str().unwrap(), b.to_str().unwrap()));
204+
}
205+
list.finish()
206+
}
207+
}
208+
209+
pubstructEnv(crate::vec::IntoIter<(OsString,OsString)>);
196210

197211
implEnv{
198212
// FIXME(https://github.com/rust-lang/rust/issues/114583): Remove this when <OsStr as Debug>::fmt matches <str as Debug>::fmt.
199213
pubfnstr_debug(&self) -> impl fmt::Debug + '_{
200-
letSelf(inner) = self;
201-
match*inner {}
214+
EnvStrDebug{iter:self.0.as_slice()}
202215
}
203216
}
204217

205218
implIteratorforEnv{
206219
typeItem = (OsString,OsString);
220+
207221
fnnext(&mutself) -> Option<(OsString,OsString)>{
208-
self.0
222+
self.0.next()
209223
}
210224
}
211225

212226
impl fmt::DebugforEnv{
213-
fnfmt(&self, _:&mut fmt::Formatter<'_>) -> fmt::Result{
214-
letSelf(inner) = self;
215-
match*inner {}
227+
fnfmt(&self,f:&mut fmt::Formatter<'_>) -> fmt::Result{
228+
self.0.fmt(f)
216229
}
217230
}
218231

219232
pubfnenv() -> Env{
220-
panic!("not supported on this platform")
233+
let env = uefi_env::get_all().expect("not supported on this platform");
234+
Env(env.into_iter())
221235
}
222236

223-
pubfngetenv(_:&OsStr) -> Option<OsString>{
224-
None
237+
pubfngetenv(key:&OsStr) -> Option<OsString>{
238+
uefi_env::get(key)
225239
}
226240

227-
pubunsafefnsetenv(_:&OsStr,_:&OsStr) -> io::Result<()>{
228-
Err(io::const_io_error!(io::ErrorKind::Unsupported,"cannot set env vars on this platform"))
241+
pubunsafefnsetenv(key:&OsStr,val:&OsStr) -> io::Result<()>{
242+
uefi_env::set(key, val)
229243
}
230244

231-
pubunsafefnunsetenv(_:&OsStr) -> io::Result<()>{
232-
Err(io::const_io_error!(io::ErrorKind::Unsupported,"cannot unset env vars on this platform"))
245+
pubunsafefnunsetenv(key:&OsStr) -> io::Result<()>{
246+
uefi_env::unset(key)
233247
}
234248

235249
pubfntemp_dir() -> PathBuf{
@@ -261,36 +275,84 @@ pub fn getpid() -> u32 {
261275
panic!("no pids on this platform")
262276
}
263277

264-
moduefi_shell{
265-
user_efi::protocols::shell;
266-
267-
usesuper::super::helpers;
278+
moduefi_env{
279+
usecrate::ffi::{OsStr,OsString};
280+
usecrate::io;
281+
usecrate::os::uefi::ffi::OsStringExt;
268282
usecrate::ptr::NonNull;
269-
usecrate::sync::atomic::{AtomicPtr,Ordering};
270-
271-
pubfnopen_shell() -> Option<NonNull<shell::Protocol>>{
272-
staticLAST_VALID_HANDLE:AtomicPtr<crate::ffi::c_void> =
273-
AtomicPtr::new(crate::ptr::null_mut());
274-
275-
ifletSome(handle) = NonNull::new(LAST_VALID_HANDLE.load(Ordering::Acquire)){
276-
ifletOk(protocol) = helpers::open_protocol::<shell::Protocol>(
277-
handle,
278-
r_efi::protocols::shell::PROTOCOL_GUID,
279-
){
280-
returnSome(protocol);
281-
}
283+
usecrate::sys::{helpers, unsupported_err};
284+
285+
pub(crate)fnget(key:&OsStr) -> Option<OsString>{
286+
let shell = helpers::open_shell()?;
287+
letmut key_ptr = helpers::os_string_to_raw(key)?;
288+
unsafe{get_raw(shell, key_ptr.as_mut_ptr())}
289+
}
290+
291+
pub(crate)fnset(key:&OsStr,val:&OsStr) -> io::Result<()>{
292+
letmut key_ptr = helpers::os_string_to_raw(key)
293+
.ok_or(io::const_io_error!(io::ErrorKind::InvalidInput,"Invalid Key"))?;
294+
letmut val_ptr = helpers::os_string_to_raw(val)
295+
.ok_or(io::const_io_error!(io::ErrorKind::InvalidInput,"Invalid Value"))?;
296+
unsafe{set_raw(key_ptr.as_mut_ptr(), val_ptr.as_mut_ptr())}
297+
}
298+
299+
pub(crate)fnunset(key:&OsStr) -> io::Result<()>{
300+
letmut key_ptr = helpers::os_string_to_raw(key)
301+
.ok_or(io::const_io_error!(io::ErrorKind::InvalidInput,"Invalid Key"))?;
302+
unsafe{set_raw(key_ptr.as_mut_ptr(),crate::ptr::null_mut())}
303+
}
304+
305+
pub(crate)fnget_all() -> io::Result<Vec<(OsString,OsString)>>{
306+
let shell = helpers::open_shell().ok_or(unsupported_err())?;
307+
308+
letmut vars = Vec::new();
309+
let val = unsafe{((*shell.as_ptr()).get_env)(crate::ptr::null_mut())};
310+
311+
if val.is_null(){
312+
returnOk(vars);
282313
}
283314

284-
let handles = helpers::locate_handles(shell::PROTOCOL_GUID).ok()?;
285-
for handle in handles {
286-
ifletOk(protocol) =
287-
helpers::open_protocol::<shell::Protocol>(handle, shell::PROTOCOL_GUID)
288-
{
289-
LAST_VALID_HANDLE.store(handle.as_ptr(),Ordering::Release);
290-
returnSome(protocol);
315+
letmut start = 0;
316+
317+
// UEFI Shell returns all keys seperated by NULL.
318+
// End of string is denoted by two NULLs
319+
for i in0.. {
320+
ifunsafe{*val.add(i)} == 0{
321+
// Two NULL signal end of string
322+
if i == start {
323+
break;
324+
}
325+
326+
let key = OsString::from_wide(unsafe{
327+
crate::slice::from_raw_parts(val.add(start), i - start)
328+
});
329+
// SAFETY: val.add(start) is always NULL terminated
330+
let val = unsafe{get_raw(shell, val.add(start))}
331+
.ok_or(io::const_io_error!(io::ErrorKind::InvalidInput,"Invalid Value"))?;
332+
333+
vars.push((key, val));
334+
start = i + 1;
291335
}
292336
}
293337

294-
None
338+
Ok(vars)
339+
}
340+
341+
unsafefnget_raw(
342+
shell:NonNull<r_efi::efi::protocols::shell::Protocol>,
343+
key_ptr:*mut r_efi::efi::Char16,
344+
) -> Option<OsString>{
345+
let val = unsafe{((*shell.as_ptr()).get_env)(key_ptr)};
346+
helpers::os_string_from_raw(val)
347+
}
348+
349+
unsafefnset_raw(
350+
key_ptr:*mut r_efi::efi::Char16,
351+
val_ptr:*mut r_efi::efi::Char16,
352+
) -> io::Result<()>{
353+
let shell = helpers::open_shell().ok_or(unsupported_err())?;
354+
let r =
355+
unsafe{((*shell.as_ptr()).set_env)(key_ptr, val_ptr, r_efi::efi::Boolean::FALSE)};
356+
if r.is_error(){Err(io::Error::from_raw_os_error(r.as_usize()))}else{Ok(())}
295357
}
296358
}

0 commit comments

Comments
 (0)