package rados // #cgo LDFLAGS: -lrados // #include // #include // #include import "C" import ( "runtime" "unsafe" ) const ( // AllNamespaces is used to reset a selected namespace to all // namespaces. See the IOContext SetNamespace function. AllNamespaces = C.LIBRADOS_ALL_NSPACES // FIXME: for backwards compatibility // RadosAllNamespaces is used to reset a selected namespace to all // namespaces. See the IOContext SetNamespace function. // // Deprecated: use AllNamespaces instead RadosAllNamespaces = AllNamespaces ) // OpFlags are flags that can be set on a per-op basis. type OpFlags uint const ( // OpFlagNone can be use to not set any flags. OpFlagNone = OpFlags(0) // OpFlagExcl marks an op to fail a create operation if the object // already exists. OpFlagExcl = OpFlags(C.LIBRADOS_OP_FLAG_EXCL) // OpFlagFailOk allows the transaction to succeed even if the flagged // op fails. OpFlagFailOk = OpFlags(C.LIBRADOS_OP_FLAG_FAILOK) // OpFlagFAdviseRandom indicates read/write op random. OpFlagFAdviseRandom = OpFlags(C.LIBRADOS_OP_FLAG_FADVISE_RANDOM) // OpFlagFAdviseSequential indicates read/write op sequential. OpFlagFAdviseSequential = OpFlags(C.LIBRADOS_OP_FLAG_FADVISE_SEQUENTIAL) // OpFlagFAdviseWillNeed indicates read/write data will be accessed in // the near future (by someone). OpFlagFAdviseWillNeed = OpFlags(C.LIBRADOS_OP_FLAG_FADVISE_WILLNEED) // OpFlagFAdviseDontNeed indicates read/write data will not accessed in // the near future (by anyone). OpFlagFAdviseDontNeed = OpFlags(C.LIBRADOS_OP_FLAG_FADVISE_DONTNEED) // OpFlagFAdviseNoCache indicates read/write data will not accessed // again (by *this* client). OpFlagFAdviseNoCache = OpFlags(C.LIBRADOS_OP_FLAG_FADVISE_NOCACHE) ) // Version returns the major, minor, and patch components of the version of // the RADOS library linked against. func Version() (int, int, int) { var c_major, c_minor, c_patch C.int C.rados_version(&c_major, &c_minor, &c_patch) return int(c_major), int(c_minor), int(c_patch) } func makeConn() *Conn { return &Conn{connected: false} } func newConn(user *C.char) (*Conn, error) { conn := makeConn() ret := C.rados_create(&conn.cluster, user) if ret != 0 { return nil, getError(ret) } runtime.SetFinalizer(conn, freeConn) return conn, nil } // NewConn creates a new connection object. It returns the connection and an // error, if any. func NewConn() (*Conn, error) { return newConn(nil) } // NewConnWithUser creates a new connection object with a custom username. // It returns the connection and an error, if any. func NewConnWithUser(user string) (*Conn, error) { c_user := C.CString(user) defer C.free(unsafe.Pointer(c_user)) return newConn(c_user) } // NewConnWithClusterAndUser creates a new connection object for a specific cluster and username. // It returns the connection and an error, if any. func NewConnWithClusterAndUser(clusterName string, userName string) (*Conn, error) { c_cluster_name := C.CString(clusterName) defer C.free(unsafe.Pointer(c_cluster_name)) c_name := C.CString(userName) defer C.free(unsafe.Pointer(c_name)) conn := makeConn() ret := C.rados_create2(&conn.cluster, c_cluster_name, c_name, 0) if ret != 0 { return nil, getError(ret) } runtime.SetFinalizer(conn, freeConn) return conn, nil } // freeConn releases resources that are allocated while configuring the // connection to the cluster. rados_shutdown() should only be needed after a // successful call to rados_connect(), however if the connection has been // configured with non-default parameters, some of the parameters may be // allocated before connecting. rados_shutdown() will free the allocated // resources, even if there has not been a connection yet. // // This function is setup as a destructor/finalizer when rados_create() is // called. func freeConn(conn *Conn) { if conn.cluster != nil { C.rados_shutdown(conn.cluster) // prevent calling rados_shutdown() more than once conn.cluster = nil } }