Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit c9bc6bb4 authored by Tom Cherry's avatar Tom Cherry
Browse files

init: add some documentation in service_utils.h

Test: n/a
Change-Id: I2a2691a6d1f643e255550498d9871e38f1b51efa
parent 180b2671
Loading
Loading
Loading
Loading
+5 −0
Original line number Original line Diff line number Diff line
@@ -37,6 +37,8 @@ class Descriptor {
    Descriptor(const std::string& name, android::base::unique_fd fd)
    Descriptor(const std::string& name, android::base::unique_fd fd)
        : name_(name), fd_(std::move(fd)){};
        : name_(name), fd_(std::move(fd)){};


    // Publish() unsets FD_CLOEXEC from the FD and publishes its name via setenv().  It should be
    // called when starting a service after fork() and before exec().
    void Publish() const;
    void Publish() const;


  private:
  private:
@@ -53,6 +55,9 @@ struct SocketDescriptor {
    std::string context;
    std::string context;
    bool passcred = false;
    bool passcred = false;


    // Create() creates the named unix domain socket in /dev/socket and returns a Descriptor object.
    // It should be called when starting a service, before calling fork(), such that the socket is
    // synchronously created before starting any other services, which may depend on it.
    Result<Descriptor> Create(const std::string& global_context) const;
    Result<Descriptor> Create(const std::string& global_context) const;
};
};