Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
NOZZLE_OPEN(3)		  Kronosnet Programmer's Manual 	  NOZZLE_OPEN(3)

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 IF-
     NAMSIZ).

     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: updown-
     path/<action>/<interface_name> updownpath specifies where to find those di-
     rectories 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
     Copyright (C) 2010-2023 Red Hat, Inc. All rights reserved.

kronosnet			   2023-07-10			  NOZZLE_OPEN(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=nozzle_open&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help