Summary

Write a message to the debug serial port.

Declaration

#include <zircon/syscalls.h>

zx_status_t zx_debug_write(const char* buffer, size_t buffer_size);

Description

zx_debug_write() attempts to write data of buffer_size bytes to the debug serial port.

To use the zx_debug_write() function, you must specify kernel.enable-serial-syscalls=true or kernel.enable-serial-syscalls=output-only on the kernel command line. Otherwise, the function returns ZX_ERR_NOT_SUPPORTED.

zx_debug_write is intended for diagnostic use. Data may be dropped or truncated, but the data from two different zx_debug_write calls will not be interleaved or reordered.

Rights

None.

Return value

Returns ZX_OK on success.

Errors

ZX_ERR_NOT_SUPPORTED kernel.enable-serial-syscalls is not set to true or output-only on the kernel command line.

ZX_ERR_INVALID_ARGS buffer is NULL.

See also

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-03-04 UTC.