.\" Man page generated from reStructuredText.
.
.TH "MONGOC_DATABASE_ADD_USER" "3" "Jun 04, 2021" "1.17.6" "libmongoc"
.SH NAME
mongoc_database_add_user \- mongoc_database_add_user()
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.SH SYNOPSIS
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
bool
mongoc_database_add_user (mongoc_database_t *database,
                          const char *username,
                          const char *password,
                          const bson_t *roles,
                          const bson_t *custom_data,
                          bson_error_t *error);
.ft P
.fi
.UNINDENT
.UNINDENT
.SH PARAMETERS
.INDENT 0.0
.IP \(bu 2
\fBdatabase\fP: A \fBmongoc_database_t\fP\&.
.IP \(bu 2
\fBusername\fP: The name of the user.
.IP \(bu 2
\fBpassword\fP: The cleartext password for the user.
.IP \(bu 2
\fBroles\fP: An optional \fI\%bson_t\fP for roles.
.IP \(bu 2
\fBcustom_data\fP: A optional \fI\%bson_t\fP for extra data.
.IP \(bu 2
\fBerror\fP: A location for a \fBbson_error_t\fP or \fBNULL\fP\&.
.UNINDENT
.sp
This function shall create a new user with access to \fBdatabase\fP\&.
.sp
\fBWARNING:\fP
.INDENT 0.0
.INDENT 3.5
Do not call this function without TLS.
.UNINDENT
.UNINDENT
.SH ERRORS
.sp
Errors are returned through the \fBerror\fP parameter and can include socket or other server side failures.
.SH RETURNS
.sp
Returns \fBtrue\fP if the user was successfully added. Returns \fBfalse\fP and sets \fBerror\fP if there are invalid arguments or a server or network error.
.SH AUTHOR
MongoDB, Inc
.SH COPYRIGHT
2017-present, MongoDB, Inc
.\" Generated by docutils manpage writer.
.