* Copyright (C) 2009 The Regents of the University of California
* Written by Michael Vrable <mvrable@cs.ucsd.edu>
*
- * TODO: Licensing
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ * 1. Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ * 2. Redistributions in binary form must reproduce the above copyright
+ * notice, this list of conditions and the following disclaimer in the
+ * documentation and/or other materials provided with the distribution.
+ * 3. Neither the name of the University nor the names of its contributors
+ * may be used to endorse or promote products derived from this software
+ * without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
+ * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+ * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+ * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+ * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+ * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ * SUCH DAMAGE.
*/
#ifndef _BLUESKY_H
#define _BLUESKY_H
#include <stdint.h>
+#include <stdio.h>
#include <inttypes.h>
#include <glib.h>
/* Various options to tweak for performance benchmarking purposes. */
typedef struct {
- /* Perform all get/put operations synchronously. */
+ /* OBSOLETE: Perform all get/put operations synchronously. */
int synchronous_stores;
- /* Write data in cache immediately after file is modified. */
+ /* OBSOLETE: Write data in cache immediately after file is modified. */
int writethrough_cache;
/* Can inodes be fetched asynchronously? (Inode object is initially
/* Target size of the disk cache at the proxy, in kilobytes. */
int cache_size;
+
+ /* Full segment fetches (1) or use range requests (0) for fetching segments
+ * from cloud? */
+ int full_segment_fetches;
+
+ /* Disable aggregating of data into log segments. Each object will be
+ * stored in a separate segment. */
+ int disable_aggregation;
+
+ /* Disable cryptography. This is for benchmarking purposes. */
+ int disable_crypto;
+
+ /* Disable aggregation of read requests. Fetch items individually. */
+ int disable_read_aggregation;
} BlueSkyOptions;
extern BlueSkyOptions bluesky_options;
struct bluesky_stats *bluesky_stats_new(const char *name);
void bluesky_stats_add(struct bluesky_stats *stats, int64_t value);
void bluesky_stats_dump_all();
+void bluesky_stats_run_periodic_dump(FILE *f);
/* BlueSky status and error codes. Various frontends should translate these to
* the appropriate error code for whatever protocol they implement. */
struct BlueSkyRangeset;
typedef struct BlueSkyRangeset BlueSkyRangeset;
+typedef struct {
+ uint64_t start, length;
+ gpointer data;
+} BlueSkyRangesetItem;
+
BlueSkyRangeset *bluesky_rangeset_new();
void bluesky_rangeset_free(BlueSkyRangeset *rangeset);
gboolean bluesky_rangeset_insert(BlueSkyRangeset *rangeset,
- int start, int length, gpointer data);
-gpointer bluesky_rangeset_lookup(BlueSkyRangeset *rangeset, int start);
+ uint64_t start, uint64_t length,
+ gpointer data);
+const BlueSkyRangesetItem *bluesky_rangeset_lookup(BlueSkyRangeset *rangeset,
+ uint64_t offset);
+const BlueSkyRangesetItem *bluesky_rangeset_lookup_next(BlueSkyRangeset *rangeset, uint64_t offset);
+void bluesky_rangeset_get_extents(BlueSkyRangeset *rangeset,
+ uint64_t *start, uint64_t *length);
/* Storage interface. This presents a key-value store abstraction, and can
* have multiple implementations: in-memory, on-disk, in-cloud. */
/* Symlink-specific fields */
gchar *symlink_contents;
+
+ /* A field for short-term use internally while the lock is held. */
+ gpointer private_data;
} BlueSkyInode;
/* A directory entry. The name is UTF-8 and is a freshly-allocated string.
char *buf, gint len);
void bluesky_inode_fetch(BlueSkyFS *fs, uint64_t inum);
+void bluesky_inode_prefetch(BlueSkyFS *fs, uint64_t inum);
gint bluesky_dirent_compare(gconstpointer a, gconstpointer b,
gpointer unused);
void bluesky_debug_dump(BlueSkyFS *fs);
+/* Request response time tracking. */
+typedef struct BlueSkyProfile {
+ int magic;
+ GMutex *lock;
+ char *description;
+ GList *events;
+} BlueSkyProfile;
+
+BlueSkyProfile *bluesky_profile_new();
+void bluesky_profile_free(BlueSkyProfile *profile);
+void bluesky_profile_add_event(BlueSkyProfile *profile, char *message);
+void bluesky_profile_print(BlueSkyProfile *profile);
+BlueSkyProfile *bluesky_profile_get();
+void bluesky_profile_set(BlueSkyProfile *profile);
+void bluesky_profile_set_output(FILE *stream);
+
#ifdef __cplusplus
}
#endif