From 62c0e1a9b2af8565497fa5a34193707c5bab5d15 Mon Sep 17 00:00:00 2001
From: Prasanna Kumar Kalever <prasanna.kalever@redhat.com>
Date: Fri, 23 Dec 2016 21:37:29 +0530
Subject: gluster-block: Initial Commit

gluster block storage CLI.

As of now, gluster-block is capable of creating tcmu based gluster
block devices, across multiple nodes.

All you need is a gluster volume (on one set of nodes) and tcmu-runner
(https://github.com/open-iscsi/tcmu-runner) running on same(as gluster)
or different set of nodes.

From an another (or same) node where gluster-block is installed you
can create iSCSI based gluster block devices.

What it can do ?
--------------
1. create a file (name uuid) in the gluster volume.
2. create the iSCSI LUN and export the target via tcmu-runner in
multiple nodes (--block-host IP1,IP2 ...)
3. list the available LUN's across multiple nodes.
4. get info about a LUN across multiple nodes.
5. delete a given LUN across all given nodes.

$ gluster-block --help
gluster-block (Version 0.1)
 -c, --create      <name>          Create the gluster block
     -v, --volume       <vol>            gluster volume name
     -h, --host         <gluster-node>   node addr from gluster pool
     -s, --size         <size>           block storage size in KiB|MiB|GiB|TiB..

 -l, --list                        List available gluster blocks

 -i, --info        <name>          Details about gluster block

 -m, --modify      <RESIZE|AUTH>   Modify the metadata

 -d, --delete      <name>          Delete the gluster block

     [-b, --block-host <IP1,IP2,IP3...>]  block servers, clubbed with any option

Typically gluster-block, gluster volume and tcmu-runner can coexist on
single set of nodes/node or can be split across different set of nodes.

Install:
-------
$ make -j install (hopefully that should correct you.)

Points to remember:
------------------
1. setup gluster volume
2. run tcmu-runner service

Signed-off-by: Prasanna Kumar Kalever <prasanna.kalever@redhat.com>
---
 utils.h | 56 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 56 insertions(+)
 create mode 100644 utils.h

(limited to 'utils.h')

diff --git a/utils.h b/utils.h
new file mode 100644
index 0000000..75dd285
--- /dev/null
+++ b/utils.h
@@ -0,0 +1,56 @@
+/*
+  Copyright (c) 2016 Red Hat, Inc. <http://www.redhat.com>
+  This file is part of gluster-block.
+
+  This file is licensed to you under your choice of the GNU Lesser
+  General Public License, version 3 or any later version (LGPLv3 or
+  later), or the GNU General Public License, version 2 (GPLv2), in all
+  cases as published by the Free Software Foundation.
+*/
+
+
+# ifndef   _UTILS_H
+# define   _UTILS_H   1
+
+# include  <stdio.h>
+# include  <stdlib.h>
+# include  <stdbool.h>
+# include  <string.h>
+# include  <errno.h>
+
+
+#define ERROR(fmt, ...) \
+        fprintf(stderr, "Error: " fmt " [at %s+%d :<%s>]\n", \
+                __VA_ARGS__, __FILE__, __LINE__, __FUNCTION__)
+
+#define MSG(fmt, ...) \
+        fprintf(stdout, fmt "\n", __VA_ARGS__)
+
+
+# define CALLOC(x)    calloc(1, x)
+
+# define GB_ALLOC_N(ptr, count) gbAllocN(&(ptr), sizeof(*(ptr)), (count), \
+                                         __FILE__, __FUNCTION__, __LINE__)
+
+# define GB_ALLOC(ptr) gbAlloc(&(ptr), sizeof(*(ptr)), \
+                               __FILE__, __FUNCTION__, __LINE__)
+
+# define GB_STRDUP(dst, src) gbStrdup(&(dst), src, \
+                                      __FILE__, __FUNCTION__, __LINE__)
+
+# define GB_FREE(ptr) gbFree(1 ? (void *) &(ptr) : (ptr))
+
+
+
+int gbAlloc(void *ptrptr, size_t size,
+            const char *filename, const char *funcname, size_t linenr);
+
+int gbAllocN(void *ptrptr, size_t size, size_t count,
+             const char *filename, const char *funcname, size_t linenr);
+
+int gbStrdup(char **dest, const char *src,
+             const char *filename, const char *funcname, size_t linenr);
+
+void gbFree(void *ptrptr);
+
+#endif  /* _UTILS_H */
-- 
cgit