daos_cont_create.3

.\" (C) Copyright 2017 Intel Corporation.
.\"
.\" Licensed under the Apache License, Version 2.0 (the "License");
.\" you may not use this file except in compliance with the License.
.\" You may obtain a copy of the License at
.\"
.\"    http://www.apache.org/licenses/LICENSE-2.0
.\"
.\" Unless required by applicable law or agreed to in writing, software
.\" distributed under the License is distributed on an "AS IS" BASIS,
.\" WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
.\" See the License for the specific language governing permissions and
.\" limitations under the License.
.\"
.\" GOVERNMENT LICENSE RIGHTS-OPEN SOURCE SOFTWARE
.\" The Government's rights to use, modify, reproduce, release, perform, display,
.\" or disclose this software are subject to the terms of the Apache License as
.\" provided in Contract No. B609815.
.\" Any reproduction of computer software, computer software documentation, or
.\" portions thereof marked with this legend must also reproduce the markings.
.\"
.TH daos_cont_create 3 2017-07-20 "0.0.1" "DAOS Client API"
.SH NAME
daos_cont_create \- create a container within a DAOS pool
.SH SYNOPSIS
.nf
.B #include "daos.h"
.B #include "daos_api.h"
.sp
.BI "int daos_cont_create(daos_handle_t "poh ", const uuid_t "uuid ",
.BI "                     daos_event_t * "ev);
.fi
.SH DESCRIPTION
The function
.BR daos_cont_create ()
creates an object address space known as a container.  Containers exist within
a pool.  The caller supplied
.I poh
parameter identifes the pool within which the container will be created.  The
.I uuid
parameter is the identifier of the container created by the call.  If the
create operation fails the contents of this variable are undefined.  The
.I ev
parameter determines whether the call is synchronous or asynchronous.  If the
caller supplies NULL, the call will block until complete.  If an event
structure is supplied the call will return immediately and the event is
used to track the completion status.
.SH RETURN VALUE
The function
.BR daos_cont_create ()
returns zero on success or an error number upon error.
.SH ERRORS
.TP
.B DER_INVAL
One or more of the caller supplied method parameters is invalid.
.TP
.B DER_NO_HDL
The caller suppied pool handle does not reference a valid pool.
.TP
.B DER_NO_PERM
Caller does not have permission to perform this operation.
.TP
.B DER_UNREACH
The network is unreachable
.SH CONFORMING TO
TBD
.SH SEE ALSO
.BR daos_cont_open (3),
.BR daos_cont_close (3),
.BR daos_cont_destroy (3),
.BR daos_cont_query (3)
.SH COLOPHON
This page is part of release 0.0.1 of the Distributed Asynchronous
Object Storage (DAOS) exascale storage project. The project git reposity
can be found at:
\%https://github.com/daos-stack/daos.git
Bugs can be reported at:
\%https://jira.hpdd.intel.com/projects/DAOS/.