pub struct Cap<P: Permission> { /* private fields */ }Expand description
A zero-sized capability token proving the holder has permission P.
Cannot be constructed outside of capsec-core — only
CapRoot::grant can create one.
!Send and !Sync by default to scope capabilities to the granting thread.
§Example
ⓘ
let root = test_root();
let cap = root.grant::<FsRead>();
// cap is a proof token — zero bytes at runtime
assert_eq!(std::mem::size_of_val(&cap), 0);Implementations§
Source§impl<P: Permission> Cap<P>
impl<P: Permission> Cap<P>
Sourcepub fn attenuate<S: Scope>(self, scope: S) -> Attenuated<P, S>
pub fn attenuate<S: Scope>(self, scope: S) -> Attenuated<P, S>
Narrows this capability to a specific scope.
Consumes the original Cap<P> and returns an Attenuated<P, S> that
can only act on targets within the scope.
Trait Implementations§
Source§impl<P: Permission> Clone for Cap<P>
impl<P: Permission> Clone for Cap<P>
Source§impl Has<NetConnect> for Cap<(Ambient, NetConnect)>
impl Has<NetConnect> for Cap<(Ambient, NetConnect)>
Source§fn cap_ref(&self) -> Cap<NetConnect>
fn cap_ref(&self) -> Cap<NetConnect>
Returns a new
Cap<P> proving the permission is available.Source§impl Has<NetConnect> for Cap<(EnvRead, NetConnect)>
impl Has<NetConnect> for Cap<(EnvRead, NetConnect)>
Source§fn cap_ref(&self) -> Cap<NetConnect>
fn cap_ref(&self) -> Cap<NetConnect>
Returns a new
Cap<P> proving the permission is available.Source§impl Has<NetConnect> for Cap<(EnvWrite, NetConnect)>
impl Has<NetConnect> for Cap<(EnvWrite, NetConnect)>
Source§fn cap_ref(&self) -> Cap<NetConnect>
fn cap_ref(&self) -> Cap<NetConnect>
Returns a new
Cap<P> proving the permission is available.Source§impl Has<NetConnect> for Cap<(FsAll, NetConnect)>
impl Has<NetConnect> for Cap<(FsAll, NetConnect)>
Source§fn cap_ref(&self) -> Cap<NetConnect>
fn cap_ref(&self) -> Cap<NetConnect>
Returns a new
Cap<P> proving the permission is available.Source§impl Has<NetConnect> for Cap<(FsRead, NetConnect)>
impl Has<NetConnect> for Cap<(FsRead, NetConnect)>
Source§fn cap_ref(&self) -> Cap<NetConnect>
fn cap_ref(&self) -> Cap<NetConnect>
Returns a new
Cap<P> proving the permission is available.Source§impl Has<NetConnect> for Cap<(FsWrite, NetConnect)>
impl Has<NetConnect> for Cap<(FsWrite, NetConnect)>
Source§fn cap_ref(&self) -> Cap<NetConnect>
fn cap_ref(&self) -> Cap<NetConnect>
Returns a new
Cap<P> proving the permission is available.Source§impl Has<NetConnect> for Cap<(NetAll, NetConnect)>
impl Has<NetConnect> for Cap<(NetAll, NetConnect)>
Source§fn cap_ref(&self) -> Cap<NetConnect>
fn cap_ref(&self) -> Cap<NetConnect>
Returns a new
Cap<P> proving the permission is available.Source§impl Has<NetConnect> for Cap<(NetBind, NetConnect)>
impl Has<NetConnect> for Cap<(NetBind, NetConnect)>
Source§fn cap_ref(&self) -> Cap<NetConnect>
fn cap_ref(&self) -> Cap<NetConnect>
Returns a new
Cap<P> proving the permission is available.Source§impl Has<NetConnect> for Cap<(NetConnect, Ambient)>
impl Has<NetConnect> for Cap<(NetConnect, Ambient)>
Source§fn cap_ref(&self) -> Cap<NetConnect>
fn cap_ref(&self) -> Cap<NetConnect>
Returns a new
Cap<P> proving the permission is available.Source§impl Has<NetConnect> for Cap<(NetConnect, EnvRead)>
impl Has<NetConnect> for Cap<(NetConnect, EnvRead)>
Source§fn cap_ref(&self) -> Cap<NetConnect>
fn cap_ref(&self) -> Cap<NetConnect>
Returns a new
Cap<P> proving the permission is available.Source§impl Has<NetConnect> for Cap<(NetConnect, EnvWrite)>
impl Has<NetConnect> for Cap<(NetConnect, EnvWrite)>
Source§fn cap_ref(&self) -> Cap<NetConnect>
fn cap_ref(&self) -> Cap<NetConnect>
Returns a new
Cap<P> proving the permission is available.Source§impl Has<NetConnect> for Cap<(NetConnect, FsAll)>
impl Has<NetConnect> for Cap<(NetConnect, FsAll)>
Source§fn cap_ref(&self) -> Cap<NetConnect>
fn cap_ref(&self) -> Cap<NetConnect>
Returns a new
Cap<P> proving the permission is available.Source§impl Has<NetConnect> for Cap<(NetConnect, FsRead)>
impl Has<NetConnect> for Cap<(NetConnect, FsRead)>
Source§fn cap_ref(&self) -> Cap<NetConnect>
fn cap_ref(&self) -> Cap<NetConnect>
Returns a new
Cap<P> proving the permission is available.Source§impl Has<NetConnect> for Cap<(NetConnect, FsWrite)>
impl Has<NetConnect> for Cap<(NetConnect, FsWrite)>
Source§fn cap_ref(&self) -> Cap<NetConnect>
fn cap_ref(&self) -> Cap<NetConnect>
Returns a new
Cap<P> proving the permission is available.Source§impl Has<NetConnect> for Cap<(NetConnect, NetAll)>
impl Has<NetConnect> for Cap<(NetConnect, NetAll)>
Source§fn cap_ref(&self) -> Cap<NetConnect>
fn cap_ref(&self) -> Cap<NetConnect>
Returns a new
Cap<P> proving the permission is available.Source§impl Has<NetConnect> for Cap<(NetConnect, NetBind)>
impl Has<NetConnect> for Cap<(NetConnect, NetBind)>
Source§fn cap_ref(&self) -> Cap<NetConnect>
fn cap_ref(&self) -> Cap<NetConnect>
Returns a new
Cap<P> proving the permission is available.Source§impl Has<NetConnect> for Cap<(NetConnect, NetConnect)>
impl Has<NetConnect> for Cap<(NetConnect, NetConnect)>
Source§fn cap_ref(&self) -> Cap<NetConnect>
fn cap_ref(&self) -> Cap<NetConnect>
Returns a new
Cap<P> proving the permission is available.Source§impl Has<NetConnect> for Cap<(NetConnect, Spawn)>
impl Has<NetConnect> for Cap<(NetConnect, Spawn)>
Source§fn cap_ref(&self) -> Cap<NetConnect>
fn cap_ref(&self) -> Cap<NetConnect>
Returns a new
Cap<P> proving the permission is available.Source§impl Has<NetConnect> for Cap<(Spawn, NetConnect)>
impl Has<NetConnect> for Cap<(Spawn, NetConnect)>
Source§fn cap_ref(&self) -> Cap<NetConnect>
fn cap_ref(&self) -> Cap<NetConnect>
Returns a new
Cap<P> proving the permission is available.Source§impl Has<NetConnect> for Cap<Ambient>
impl Has<NetConnect> for Cap<Ambient>
Source§fn cap_ref(&self) -> Cap<NetConnect>
fn cap_ref(&self) -> Cap<NetConnect>
Returns a new
Cap<P> proving the permission is available.Source§impl Has<NetConnect> for Cap<NetAll>
impl Has<NetConnect> for Cap<NetAll>
Source§fn cap_ref(&self) -> Cap<NetConnect>
fn cap_ref(&self) -> Cap<NetConnect>
Returns a new
Cap<P> proving the permission is available.Source§impl<P: Permission> Has<P> for Cap<P>
impl<P: Permission> Has<P> for Cap<P>
Auto Trait Implementations§
impl<P> Freeze for Cap<P>
impl<P> RefUnwindSafe for Cap<P>where
P: RefUnwindSafe,
impl<P> !Send for Cap<P>
impl<P> !Sync for Cap<P>
impl<P> Unpin for Cap<P>where
P: Unpin,
impl<P> UnsafeUnpin for Cap<P>
impl<P> UnwindSafe for Cap<P>where
P: UnwindSafe,
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more