pub enum ManagerRequest {
    Connect {
        fuzzer_url: String,
        controller: ServerEnd<ControllerMarker>,
        responder: ManagerConnectResponder,
    },
    GetOutput {
        fuzzer_url: String,
        output: TestOutput,
        socket: Socket,
        responder: ManagerGetOutputResponder,
    },
    Stop {
        fuzzer_url: String,
        responder: ManagerStopResponder,
    },
}
Expand description

Entry point for users, e.g. ffx fuzz, used to start and stop fuzzers. A fuzzer will be started on the first call to Connect with a given URL. Closing the given Controller channel does not stop the associated fuzzer. Instead, since fuzzing is meant to be long-running, clients may drop the connection and re-Connect some time later.

Variants§

§

Connect

Fields

§fuzzer_url: String

Connects to a fuzzer that implements the fuchsia.fuzzer/Controller protocol.

If the fuzzer is not currently running, the fuzz_manager will first start it (via the test_manager) before proceeding. The fuzz_manager sends the controller on to the fuzz-registry, which contains the ControllerProviders that can fulfill the connection request.

See fuchsia.test.manager/LaunchError for details on ways test_manager can fail.

  • request fuzzer_url the package URL for the fuzzer.
  • request controller the connection from the client.
  • error one of the following:
    • ZX_ERR_NO_RESOURCES if test_manager needs resources that are unavailable.
    • ZX_ERR_NOT_FOUND if the fuzzer URL is not recognized by test_manager.
    • ZX_ERR_INVALID_ARGS if test_manager reports invalid arguments.
    • ZX_ERR_NOT_SUPPORTED if test_manager cannot connect to the test suite.
    • ZX_ERR_INTERNAL if test_manager encountered some other, unspecified failure.
    • ZX_ERR_TIMED_OUT if the fuzzer is not present or added to fuzz-registry after starting.
    • ZX_ERR_SHOULD_WAIT if another fuzzer is still starting.
§

GetOutput

Fields

§fuzzer_url: String
§output: TestOutput
§socket: Socket

Forwards the fuzzer’s output of the given type to the provided socket.

If this method is called multiple times for the same output type, the socket from the subsequent call replaces the socket from the earlier call, which is closed.

  • request fuzzer_url the package URL for the fuzzer.
  • request output the type of the output stream to forward.
  • request socket a socket to forward the output stream to.
  • error one of the following:
    • ZX_ERR_INVALID_ARGS if the URL cannot be parsed.
    • ZX_ERR_NOT_FOUND if the fuzzer URL was not recognized by test_manager.
    • ZX_ERR_BAD_STATE if the fuzzer is not connected.
§

Stop

Fields

§fuzzer_url: String

Stops the associated fuzzer immediately, ending any workflows in progress.

  • request fuzzer_url the package URL for the fuzzer.
  • error ZX_ERR_NOT_FOUND if no fuzzer was active with the given URL.

Implementations§

Trait Implementations§

source§

impl Debug for ManagerRequest

source§

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

Formats the value using the given formatter. Read more

Auto Trait Implementations§

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> Encode<Ambiguous1> for T

source§

unsafe fn encode( self, _encoder: &mut Encoder<'_>, _offset: usize, _depth: Depth ) -> Result<(), Error>

Encodes the object into the encoder’s buffers. Any handles stored in the object are swapped for Handle::INVALID. Read more
source§

impl<T> Encode<Ambiguous2> for T

source§

unsafe fn encode( self, _encoder: &mut Encoder<'_>, _offset: usize, _depth: Depth ) -> Result<(), Error>

Encodes the object into the encoder’s buffers. Any handles stored in the object are swapped for Handle::INVALID. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

§

impl<T> Instrument for T

§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided [Span], returning an Instrumented wrapper. Read more
§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

§

impl<T> Pointable for T

§

const ALIGN: usize = _

The alignment of pointer.
§

type Init = T

The type for initializers.
§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<T> WithSubscriber for T

§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a [WithDispatch] wrapper. Read more