======================
flux_request_encode(3)
======================

.. default-domain:: c

SYNOPSIS
========

.. code-block:: c

   #include <flux/core.h>

   flux_msg_t *flux_request_encode (const char *topic, const char *s);

   flux_msg_t *flux_request_encode_raw (const char *topic,
                                        void *data,
                                        size_t len);

Link with :command:`-lflux-core`.

DESCRIPTION
===========

:func:`flux_request_encode` encodes a request message with topic string
:var:`topic` and optional NULL terminated string payload :var:`s`. The newly
constructed message that is returned must be destroyed with
:func:`flux_msg_destroy`.

:func:`flux_request_encode_raw` encodes a request message with topic
string :var:`topic`. If :var:`data` is non-NULL its contents will be used
as the message payload, and the payload type set to raw.


RETURN VALUE
============

These functions return a message on success. On error, NULL is
returned, and :var:`errno` is set appropriately.


ERRORS
======

EINVAL
   The *topic* argument was NULL or *s* is not NULL terminated.

ENOMEM
   Memory was unavailable.


RESOURCES
=========

.. include:: common/resources.rst


SEE ALSO
========

:man3:`flux_response_decode`, :man3:`flux_rpc`