============================
flux_service_register(3)
============================

.. default-domain:: c

SYNOPSIS
========

.. code-block:: c

   #include <flux/core.h>

   flux_future_t *flux_service_register (flux_t *h, const char *name);

   flux_future_t *flux_service_unregister (flux_t *h, const char *name);

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

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

:func:`flux_service_register` enables a new service :var:`name` to be registered
with the flux broker.  On success, request message sent to "name.*" will
be routed to this handle until :func:`flux_service_unregister` is called
for :var:`name`.

While :func:`flux_service_register` registers :var:`name`, the user must
still setup a handler for the service.  One can be setup through
:man3:`flux_msg_handler_addvec`.


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

:func:`flux_service_register` and :func:`flux_service_unregister` return a
:type:`flux_future_t` on success, or NULL on failure with :var:`errno` set
appropriately.


ERRORS
======

EINVAL
   One of the arguments was invalid.

ENOMEM
   Out of memory.


RESOURCES
=========

.. include:: common/resources.rst


SEE ALSO
========

flux_future_get(3), flux_msg_handler_addvec(3)