Go to main content

man pages section 3: Extended Library Functions, Volume 2

Exit Print View

Updated: Thursday, June 13, 2019
 
 

it_portal_delete(3ISCSIT)

Name

it_portal_create, it_portal_delete - create and delete iSCSI portals

Synopsis

cc [ flag… ] file–liscsit [ library… ]
#include <libiscsit.h>

int it_portal_create(it_config_t *cfg, it_tpg_t *tpg,
     it_portal_t **portal, char *portal_ip_port);
void it_portal_delete(it_config_t *cfg, it_tpg_t *tpg,
     it_portal_t *portal);

Parameters

cfg

a pointer to the iSCSI configuration structure

tpg

a pointer to the it_tpg_t structure representing the target portal group

portal

a pointer to the it_portal_t structure representing the portal

portal_ip_port

a string containing an appropriatedly formatted IP address:port. Both IPv4 and IPv6 addresses are permitted. IPv6 addresses should be enclosed in square brackets ('[', ']').

Description

The it_portal_create() function adds an it_portal_t structure representing a new portal to the specified target portal group. A portal may belong to one and only one target portal group.

The it_portal_delete() function removes the specified portal from the specified target portal group.

Configuration changes as a result of these functions are not instantiated until the modified configuration is committed by calling it_config_commit(3ISCSIT).

Return Values

The it_portal_create() function returns 0 on success and an error value on failure.

Errors

The it_portal_create() function will fail if:

EEXIST

The portal was already configured for another portal group.

EINVAL

A parameter is invalid.

ENOMEM

Resources could not be allocated.

Attributes

See attributes(7) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Interface Stability
Committed
MT-Level
MT-Safe

See Also

it_config_commit(3ISCSIT), it_ini_create(3ISCSIT), it_tgt_create(3ISCSIT), it_tpg_create(3ISCSIT), libiscsit(3LIB), libiscsit(3LIB), libnvpair(3LIB), libstmf(3LIB), attributes(7)