tree: cd1142e86e1eef07d6dda2d3b5dc1ead981726d4 [path history] [tgz]
  1. BUILD.gn
  2. README.md
  3. include/
  4. llcpp/
zircon/system/ulib/service/README.md

LLCPP FIDL Service library

This library provides low-level C++ (LLCPP) APIs to connect to and serve FIDL Services.

A FIDL Service is a logical grouping of FIDL protocols, exposed as members of a virtual directory.

There can exist multiple instances of a FIDL Service in a component's incoming namespace.

For example, a component use-ing a FIDL Service might have an incoming namespace that looks like:

/svc
    /fidl.examples.Echo
                       /default
                               /foo
                               /bar
                       /other
                             /foo
                             /bar
    /...

FIDL Services were introduced in FTP-041.

Example FIDL Service declaration

library fidl.examples.echo;

service EchoService {
    EchoProtocol foo;
    EchoProtocol bar;
};

protocol EchoProtocol {
    // ...
}

Client API

The client API allows callers to enumerate the instances of a FIDL Service, connect to an instance, enumerate its members, and establish connections to those member protocols, all in a type-safe API.

A FIDL Service's name and members are derived from its generated LLCPP FIDL bindings. The service library uses that information to generate convenient type-safe APIs that still allow the caller to manage memory allocations on their own.

Any buffers that are required by the library are small and allocated on the stack.

To get started, see the documentation for sys::OpenServiceAt<FidlService>, in <lib/service/llcpp/service.h>.

Server API

The server API provides a virtual filesystem capable of serving the outgoing namespace of a component (/svc, etc.). It depends on //zircon/system/ulib/fs to actually implement the fuchsia.io protocols.

The developer may not control allocations performed while serving the VFS. However, the developer defines how each member protocol of a FIDL Service is handled through callback functions registered with this library.

See <lib/service/llcpp/outgoing_directory.h> for details.

The server API is closely modelled (read “copied”) after the High Level C++ FIDL sys library in the SDK (//sdk/lib/sys/service).

Once the LLCPP FIDL library is promoted to the SDK, llcpp::sys::OutgoingDirectory and sys::OutgoingDirectory can be merged.