jammy (3) nozzle_open.3.gz

Provided by: libknet-doc_1.23-2build1_all bug

NAME
       nozzle_open - create a new tap device on the system.


SYNOPSIS
       #include <libnozzle.h>

       nozzle_t nozzle_open(
           char         *devname,
           size_t        devname_size,
           const char   *updownpath
       );


DESCRIPTION
       nozzle_open

       devname  - pointer to device name of at least size IFNAMSIZ. if the dev strlen is 0, then the system will
       assign a name automatically. if a string is specified, the system will try to create a  device  with  the
       specified name. NOTE: on FreeBSD the tap device names can only be tapX where X is a number from 0 to 255.
       On Linux such limitation does not apply. The name must be unique to the system. If an interface with  the
       same name is already configured on the system, an error will be returned.

       devname_size - length of the buffer provided in dev (has to be at least IFNAMSIZ).

       updownpath  - nozzle supports the typical filesystem structure to execute actions for: down.d post-down.d
       pre-up.d up.d in the form of: updownpath/<action>/<interface_name> updownpath  specifies  where  to  find
       those directories on the filesystem and it must be an absolute path.


RETURN VALUE
       nozzle_open returns a pointer to a nozzle struct on success NULL on error and errno is set.


SEE ALSO
       nozzle_close(3), nozzle_set_mtu(3), nozzle_get_fd(3), nozzle_get_mtu(3), nozzle_reset_mtu(3),
       nozzle_set_up(3), nozzle_get_ips(3), nozzle_set_down(3), nozzle_reset_mac(3),
       nozzle_get_handle_by_name(3), nozzle_run_updown(3), nozzle_del_ip(3), nozzle_get_mac(3),
       nozzle_set_mac(3), nozzle_get_name_by_handle(3), nozzle_add_ip(3)


       Copyright (C) 2010-2021 Red Hat, Inc. All rights reserved.