Struct Device 

pub struct Device { /* private fields */ }

One device on an AdbServer, named by its serial.

Implementations

impl Device

pub fn serial(&self) -> &str

pub fn shell(&self, command: &str) -> Result<ShellOutput>

Runs command with shell protocol v2 and collects its output. Standard input is closed at once, so a command that reads it sees end of file.

pub fn shell_until( &self, command: &str, deadline: Instant, ) -> Result<ShellOutput>

Runs command as Self::shell does, bounded by deadline rather than by the server’s timeout for each read: the output is read with the time left to deadline, so that a command that prints nothing for longer than that timeout, as am start -W while it waits for the app’s first frame, completes within it (design D1 of android-pass-fixes). A command that has not ended by deadline, or a deadline already past, which runs nothing, fails with a timeout (Error::is_timeout) whose message names the deadline; opening the stream keeps the server’s timeout.

pub fn shell_stream(&self, command: &str) -> Result<ShellStream>

Starts command with shell protocol v2 and hands back the stream, for output that must be read as it arrives. Closing the stream makes adbd send SIGHUP to the command.

pub fn shell_stream_with( &self, command: &str, stdio: Stdio, ) -> Result<ShellStream>

Self::shell_stream with the command’s streams connected as stdio says.

pub fn push(&self, local: &Path, remote: &str, mode: u32) -> Result<()>

Copies the local file at local to remote with permission bits mode.

adbd copies the owner’s bits to group and other, so 0o644 arrives as 0666 and 0o755 as 0777; restrict the file afterwards if that matters.

pub fn push_bytes(&self, data: &[u8], remote: &str, mode: u32) -> Result<()>

Writes data to remote with permission bits mode, which adbd widens as Self::push describes.

pub fn forward(&self, host: &str, device: &str) -> Result<Option<u16>>

Installs adb forward <host> <device>. Returns the host port when the host side is a TCP socket; tcp:0 lets the server pick a free one.

pub fn forward_tcp(&self, device: &str) -> Result<u16>

Forwards a free host TCP port, chosen by the server, to device.

pub fn remove_forward(&self, host: &str) -> Result<()>

Removes the forward rule whose host side is host.

pub fn forwards(&self) -> Result<Vec<Rule>>

This device’s forward rules.

pub fn reverse(&self, device: &str, host: &str) -> Result<()>

Installs adb reverse <device> <host>: adbd listens on device and relays each connection to host.

Remove a reverse rule only after the connections through it have closed and nothing on the device will dial it again: when a device-side connection arrives for a rule the server has already dropped, the adb server aborts (spike S6).

pub fn remove_reverse(&self, device: &str) -> Result<()>

Removes the reverse rule whose device side is device.

pub fn reverses(&self) -> Result<Vec<Rule>>

adbd’s reverse rules on this device.

pub fn open_service(&self, service: &str) -> Result<TcpStream>

Opens a device service such as localabstract:<name> or tcp:<port> as a byte stream, with no forward rule. A service nothing listens on fails with Error::Fail and the message closed. The stream is returned without read or write deadlines; the caller sets its own.

pub fn open_abstract(&self, name: &str) -> Result<TcpStream>

Self::open_service for the abstract Unix socket name.

Trait Implementations

impl Clone for Device

fn clone(&self) -> Self

Returns a duplicate 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.