system/core/devmgr/devmgr.h

// Copyright 2016 The Fuchsia Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#pragma once

#include <sys/types.h>

#include <zircon/compiler.h>
#include <zircon/types.h>
#include <zircon/device/vfs.h>

__BEGIN_CDECLS

void coordinator(void);

void devfs_init(zx_handle_t root_job);

void devmgr_io_init(void);
void devmgr_vfs_init(void);
void devmgr_set_bootdata(zx_handle_t vmo);

zx_handle_t devmgr_load_file(const char* path);

#define FS_SVC      0x0001
#define FS_DEV      0x0002
#define FS_BOOT     0x0004
#define FS_DATA     0x0010
#define FS_SYSTEM   0x0020
#define FS_BLOB     0x0040
#define FS_VOLUME   0x0080
#define FS_PKGFS    0x0100
#define FS_INSTALL  0x0200
#define FS_TMP      0x0400
#define FS_HUB      0x0800
#define FS_ALL      0xFFFF


#define FS_FOR_FSPROC  (FS_SVC)
#define FS_FOR_APPMGR  (FS_ALL & (~FS_SVC) & (~FS_HUB))

#define FS_DIR_FLAGS \
    (ZX_FS_RIGHT_READABLE | ZX_FS_RIGHT_ADMIN |\
    ZX_FS_FLAG_DIRECTORY | ZX_FS_FLAG_NOREMOTE)

zx_status_t devmgr_launch(zx_handle_t job, const char* name,
                          int argc, const char* const* argv,
                          const char** envp, int stdiofd,
                          zx_handle_t* handles, uint32_t* types, size_t len,
                          zx_handle_t* proc_out, uint32_t flags);
bool secondary_bootfs_ready(void);

#define FSHOST_SIGNAL_READY      ZX_USER_SIGNAL_0  // Signalled by fshost
#define FSHOST_SIGNAL_EXIT       ZX_USER_SIGNAL_1  // Signalled by devmgr
#define FSHOST_SIGNAL_EXIT_DONE  ZX_USER_SIGNAL_2  // Signalled by fshost

void bootfs_create_from_startup_handle(void);
void fshost_start(void);
zx_status_t copy_vmo(zx_handle_t src, zx_off_t offset, size_t length, zx_handle_t* out_dest);

void load_system_drivers(void);

void devmgr_disable_appmgr_services(void);

// The variable to set on the kernel command line to enable ld.so tracing
// of the processes we launch.
#define LDSO_TRACE_CMDLINE "ldso.trace"
// The env var to set to enable ld.so tracing.
#define LDSO_TRACE_ENV "LD_TRACE=1"

zx_handle_t devfs_root_clone(void);
zx_handle_t fs_clone(const char* path);

void block_device_watcher(zx_handle_t job, bool netboot);

// getenv_bool looks in the environment for name. If not found, it returns
// default. If found, it returns false if the found value matches "0", "off", or
// "false", otherwise it returns true.
bool getenv_bool(const char* key, bool _default);

// Global flag tracking if devmgr believes this is a full Fuchsia build
// (requiring /system, etc) or not.
extern bool require_system;

__END_CDECLS