.TH "iscsi_session_password_in_get" 3 "iscsi_session_password_in_get" "June 2023" "API Manual" LINUX
.SH NAME
iscsi_session_password_in_get \- Retrieve authentication password of specified session.
.SH SYNOPSIS
.B "const char *" iscsi_session_password_in_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 inbound authentication password of specified iSCSI session.
Currently open-iscsi only support CHAP authentication method.
The inbound authentication here means the iSCSI initiator authenticates the
iSCSI target using CHAP.
It's controlled this setting in iscsid.conf:
'node.session.auth.password_in'
.SH "RETURN"
const char *. Empty string if not using inbound 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.