// Copyright 2012-2015 The Rust Project Developers. See the COPYRIGHT // file at the top-level directory of this distribution and at // http://rust-lang.org/COPYRIGHT. // // Licensed under the Apache License, Version 2.0 or the MIT license // , at your // option. This file may not be copied, modified, or distributed // except according to those terms. //! Global storage for command line arguments //! //! The current incarnation of the Rust runtime expects for //! the processes `argc` and `argv` arguments to be stored //! in a globally-accessible location for use by the `os` module. //! //! Only valid to call on Linux. Mac and Windows use syscalls to //! discover the command line arguments. //! //! FIXME #7756: Would be nice for this to not exist. use core::prelude::*; use vec::Vec; /// One-time global initialization. pub unsafe fn init(argc: isize, argv: *const *const u8) { imp::init(argc, argv) } /// One-time global cleanup. pub unsafe fn cleanup() { imp::cleanup() } /// Take the global arguments from global storage. pub fn take() -> Option>> { imp::take() } /// Give the global arguments to global storage. /// /// It is an error if the arguments already exist. pub fn put(args: Vec>) { imp::put(args) } /// Make a clone of the global arguments. pub fn clone() -> Option>> { imp::clone() } #[cfg(any(target_os = "linux", target_os = "android", target_os = "freebsd", target_os = "dragonfly", target_os = "bitrig", target_os = "openbsd"))] mod imp { use prelude::v1::*; use libc; use mem; use ffi::CStr; use sync::StaticMutex; static mut GLOBAL_ARGS_PTR: usize = 0; static LOCK: StaticMutex = StaticMutex::new(); pub unsafe fn init(argc: isize, argv: *const *const u8) { let args = load_argc_and_argv(argc, argv); put(args); } pub unsafe fn cleanup() { take(); LOCK.destroy(); } pub fn take() -> Option>> { let _guard = LOCK.lock(); unsafe { let ptr = get_global_ptr(); let val = mem::replace(&mut *ptr, None); val.as_ref().map(|s: &Box>>| (**s).clone()) } } pub fn put(args: Vec>) { let _guard = LOCK.lock(); unsafe { let ptr = get_global_ptr(); rtassert!((*ptr).is_none()); (*ptr) = Some(box args.clone()); } } pub fn clone() -> Option>> { let _guard = LOCK.lock(); unsafe { let ptr = get_global_ptr(); (*ptr).as_ref().map(|s: &Box>>| (**s).clone()) } } fn get_global_ptr() -> *mut Option>>> { unsafe { mem::transmute(&GLOBAL_ARGS_PTR) } } unsafe fn load_argc_and_argv(argc: isize, argv: *const *const u8) -> Vec> { let argv = argv as *const *const libc::c_char; (0..argc).map(|i| { CStr::from_ptr(*argv.offset(i)).to_bytes().to_vec() }).collect() } #[cfg(test)] mod tests { use prelude::v1::*; use super::*; #[test] fn smoke_test() { // Preserve the actual global state. let saved_value = take(); let expected = vec![ b"happy".to_vec(), b"today?".to_vec(), ]; put(expected.clone()); assert!(clone() == Some(expected.clone())); assert!(take() == Some(expected.clone())); assert!(take() == None); // Restore the actual global state. match saved_value { Some(ref args) => put(args.clone()), None => () } } } } #[cfg(any(target_os = "macos", target_os = "ios", target_os = "windows"))] mod imp { use core::prelude::*; use vec::Vec; pub unsafe fn init(_argc: isize, _argv: *const *const u8) { } pub fn cleanup() { } pub fn take() -> Option>> { panic!() } pub fn put(_args: Vec>) { panic!() } pub fn clone() -> Option>> { panic!() } }