Struct cust::device::Device

pub struct Device { /* private fields */ }

Opaque handle to a CUDA device.

Implementations

impl Device

pub fn num_devices() -> CudaResult<u32>

Get the number of CUDA-capable devices.

Returns the number of devices with compute-capability 2.0 or greater which are available for execution.

Example

use cust::device::Device;
let num_devices = Device::num_devices()?;
println!("Number of devices: {}", num_devices);

pub fn get_device(ordinal: u32) -> CudaResult<Device>

Get a handle to the ordinal’th CUDA device.

Ordinal must be in the range 0..num_devices(). If not, an error will be returned.

Example

use cust::device::Device;
let device = Device::get_device(0)?;
println!("Device Name: {}", device.name()?);

pub fn devices() -> CudaResult<Devices>

Return an iterator over all CUDA devices.

Example

use cust::device::Device;
for device in Device::devices()? {
    let device = device?;
    println!("Device Name: {}", device.name()?);
}

pub fn total_memory(self) -> CudaResult<usize>

Returns the total amount of memory available on the device in bytes.

Example

use cust::device::Device;
let device = Device::get_device(0)?;
println!("Device Memory: {}", device.total_memory()?);

pub fn name(self) -> CudaResult<String>

Returns the name of this device.

Example

use cust::device::Device;
let device = Device::get_device(0)?;
println!("Device Name: {}", device.name()?);

pub fn get_attribute(self, attr: DeviceAttribute) -> CudaResult<i32>

Returns information about this device.

Example

use cust::device::{Device, DeviceAttribute};
let device = Device::get_device(0)?;
println!("Max Threads Per Block: {}",
    device.get_attribute(DeviceAttribute::MaxThreadsPerBlock).unwrap());

pub fn as_raw(&self) -> CUdevice

Returns a raw handle to this device, not handing over ownership, meaning that dropping this device will try to drop the underlying device.

Trait Implementations

impl Clone for Device

fn clone(&self) -> Device

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Device

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Hash for Device

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given Hasher.

impl PartialEq<Device> for Device

fn eq(&self, other: &Device) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Device) -> bool

This method tests for !=.

impl Copy for Device

impl Eq for Device

impl StructuralEq for Device

impl StructuralPartialEq for Device