.TH "iscsi_session_username_get" 3 "iscsi_session_username_get" "March 2025" "API Manual" LINUX
.SH NAME
iscsi_session_username_get \- Retrieve authentication username of specified session.
.SH SYNOPSIS
.B "const char *" iscsi_session_username_get
.BI "(struct iscsi_session *" se ");"
.SH ARGUMENTS
.IP "se" 12
Pointer of 'struct iscsi_session'.
If this pointer is NULL, your program will be terminated by assert.
.SH "DESCRIPTION"

Retrieve the authentication username of specified iSCSI session.
Currently open-iscsi only support CHAP authentication method.
It's controlled this setting in iscsid.conf:
'node.session.auth.username'
.SH "RETURN"
const char *. Empty string if not using CHAP authentication or failed
to read authentication information.
No need to free this memory, the resources will get freed by
\fBiscsi_session_free\fP or \fBiscsi_sessions_free\fP.