xhyve-ruby 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: e6b3306528c86e2cefcf0f27af532d40d5161bdb
+  data.tar.gz: a2be4f5098ed71764dc2601aa4da17c9920e6d55
+SHA512:
+  metadata.gz: 11b66ab3d71dcc8df1115ea5e517d6dd711cad6f8dd58a76a658727d131bba29eb4de0a9f9b1b22e894f2ca3ba8435d435f3235f773699e75f0ed9dd93b02164
+  data.tar.gz: 1ddea73c5928460bae1184d38edfae0a69e0a990c31a38c48b9e328c0a968ac281abb68c1410127fa08a80adb7637195f9714dd043e74a7b20c84641ef8abc64

data/ext/vmnet/extconf.rb

@@ -0,0 +1,28 @@
+require "mkmf"
+
+require 'rbconfig'
+
+def host_os
+  os = RbConfig::CONFIG['host_os']
+  case
+  when os.downcase.include?('linux')
+    'linux'
+  when os.downcase.include?('darwin')
+    'darwin'
+  else
+    puts 'You are not on a supported platform. exiting...'
+    puts 'Mac OS X and Linux are the only supported platforms.'
+    exit
+  end
+end
+
+abort "missing vmnet.h" unless have_header "uuid.h"
+abort "missing vmnet.h" unless have_header "vmnet/vmnet.h"
+
+if host_os == 'darwin'
+  abort "missing vmnet" unless have_framework "vmnet"
+else
+  abort "missing vmnet" unless have_library "vmnet"
+end
+
+create_makefile "vmnet/vmnet"

data/ext/vmnet/uuid.h

@@ -0,0 +1,153 @@
+/*-
+ * Copyright (c) 2002,2005 Marcel Moolenaar
+ * Copyright (c) 2002 Hiten Mahesh Pandya
+ * All rights reserved.
+ *
+ * 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.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE AUTHOR 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 AUTHOR 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.
+ *
+ * $FreeBSD$
+ */
+
+#pragma once
+
+#include <stdint.h>
+#include <stdio.h>
+#include <string.h>
+
+#define	_UUID_NODE_LEN 6
+
+#pragma clang diagnostic push
+#pragma clang diagnostic ignored "-Wpadded"
+struct uuid {
+	uint32_t time_low;
+	uint16_t time_mid;
+	uint16_t time_hi_and_version;
+	uint8_t clock_seq_hi_and_reserved;
+	uint8_t clock_seq_low;
+	uint8_t node[_UUID_NODE_LEN];
+};
+#pragma clang diagnostic pop
+
+typedef struct uuid uuid_internal_t;
+
+/*
+ * This implementation mostly conforms to the DCE 1.1 specification.
+ * See Also:
+ *	uuidgen(1), uuidgen(2), uuid(3)
+ */
+
+/* Status codes returned by the functions. */
+#define	uuid_s_ok			0
+#define	uuid_s_bad_version		1
+#define	uuid_s_invalid_string_uuid	2
+#define	uuid_s_no_memory		3
+
+/*
+ * uuid_create_nil() - create a nil UUID.
+ * See also:
+ *	http://www.opengroup.org/onlinepubs/009629399/uuid_create_nil.htm
+ */
+static inline void
+uuid_create_nil(uuid_t *u, uint32_t *status)
+{
+	if (status)
+		*status = uuid_s_ok;
+
+	bzero(u, sizeof(*u));
+}
+
+static inline void
+uuid_enc_le(void *buf, uuid_t *uuid)
+{
+	uuid_internal_t *u = (uuid_internal_t *) ((void *) uuid);
+	uint8_t *p = buf;
+	int i;
+
+	memcpy(p, &u->time_low, 4);
+	memcpy(p, &u->time_mid, 2);
+	memcpy(p, &u->time_hi_and_version, 2);
+	p[8] = u->clock_seq_hi_and_reserved;
+	p[9] = u->clock_seq_low;
+	for (i = 0; i < _UUID_NODE_LEN; i++)
+		p[10 + i] = u->node[i];
+}
+
+/*
+ * uuid_from_string() - convert a string representation of an UUID into
+ *			a binary representation.
+ * See also:
+ *	http://www.opengroup.org/onlinepubs/009629399/uuid_from_string.htm
+ *
+ * NOTE: The sequence field is in big-endian, while the time fields are in
+ *	 native byte order.
+ */
+static inline void
+uuid_from_string(const char *s, uuid_t *uuid, uint32_t *status)
+{
+	uuid_internal_t *u = (uuid_internal_t *) ((void *) uuid);
+	int n;
+
+	/* Short-circuit 2 special cases: NULL pointer and empty string. */
+	if (s == NULL || *s == '\0') {
+		uuid_create_nil(((uuid_t *) u), status);
+		return;
+	}
+
+	/* Assume the worst. */
+	if (status != NULL)
+		*status = uuid_s_invalid_string_uuid;
+
+	/* The UUID string representation has a fixed length. */
+	if (strlen(s) != 36)
+		return;
+
+	/*
+	 * We only work with "new" UUIDs. New UUIDs have the form:
+	 *	01234567-89ab-cdef-0123-456789abcdef
+	 * The so called "old" UUIDs, which we don't support, have the form:
+	 *	0123456789ab.cd.ef.01.23.45.67.89.ab
+	 */
+	if (s[8] != '-')
+		return;
+
+	n = sscanf(s,
+	    "%8x-%4hx-%4hx-%2hhx%2hhx-%2hhx%2hhx%2hhx%2hhx%2hhx%2hhx",
+	    &u->time_low, &u->time_mid, &u->time_hi_and_version,
+	    &u->clock_seq_hi_and_reserved, &u->clock_seq_low, &u->node[0],
+	    &u->node[1], &u->node[2], &u->node[3], &u->node[4], &u->node[5]);
+
+	/* Make sure we have all conversions. */
+	if (n != 11)
+		return;
+
+	/* We have a successful scan. Check semantics... */
+	n = u->clock_seq_hi_and_reserved;
+	if ((n & 0x80) != 0x00 &&			/* variant 0? */
+	    (n & 0xc0) != 0x80 &&			/* variant 1? */
+	    (n & 0xe0) != 0xc0) {			/* variant 2? */
+		if (status != NULL)
+			*status = uuid_s_bad_version;
+	} else {
+		if (status != NULL)
+			*status = uuid_s_ok;
+	}
+}

data/ext/vmnet/vmnet.c

@@ -0,0 +1,146 @@
+/*-
+ * Copyright (c) 2011 NetApp, Inc.
+ * Copyright (c) 2015 xhyve developers
+ * All rights reserved.
+ *
+ * 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.
+ *
+ * THIS SOFTWARE IS PROVIDED BY NETAPP, INC ``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 NETAPP, INC 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.
+ *
+ * $FreeBSD$
+ */
+
+/*
+ * https://github.com/mirage/ocaml-vmnet/blob/master/lib/vmnet_stubs.c
+ *
+ * Copyright (C) 2014 Anil Madhavapeddy <anil@recoil.org>
+ *
+ * Permission to use, copy, modify, and distribute this software for any
+ * purpose with or without fee is hereby granted, provided that the above
+ * copyright notice and this permission notice appear in all copies.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+ * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+ * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+ * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+ * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+ */
+
+#include <ruby.h>
+
+#include <stdio.h>
+
+#include <vmnet/vmnet.h>
+
+#include "uuid.h"
+
+static VALUE
+vmnet_get_mac_address_from_uuid(VALUE self, VALUE guest_uuid_str_ruby) {
+/*
+ * from vmn_create() in https://github.com/mist64/xhyve/blob/master/src/pci_virtio_vmnet.c
+ */
+  char* guest_uuid_str;
+  xpc_object_t interface_desc;
+  uuid_t uuid;
+  __block interface_ref iface;
+  __block vmnet_return_t iface_status;
+  __block char* mac = malloc(18);
+  dispatch_semaphore_t iface_created, iface_stopped;
+  dispatch_queue_t if_create_q, if_stop_q;
+  uint32_t uuid_status;
+
+  guest_uuid_str = RSTRING_PTR(guest_uuid_str_ruby);
+  interface_desc = xpc_dictionary_create(NULL, NULL, 0);
+  xpc_dictionary_set_uint64(interface_desc, vmnet_operation_mode_key, VMNET_SHARED_MODE);
+
+  uuid_from_string(guest_uuid_str, &uuid, &uuid_status);
+  if (uuid_status != uuid_s_ok) {
+    fprintf(stderr, "Invalid UUID %s\n", guest_uuid_str);
+    return rb_str_new2("");
+  }
+
+  xpc_dictionary_set_uuid(interface_desc, vmnet_interface_id_key, uuid);
+  iface = NULL;
+  iface_status = 0;
+
+  if_create_q = dispatch_queue_create("org.xhyve.vmnet.create", DISPATCH_QUEUE_SERIAL);
+
+  iface_created = dispatch_semaphore_create(0);
+
+  iface = vmnet_start_interface(interface_desc, if_create_q,
+    ^(vmnet_return_t status, xpc_object_t interface_param)
+  {
+    iface_status = status;
+    if (status != VMNET_SUCCESS || !interface_param) {
+      dispatch_semaphore_signal(iface_created);
+      return;
+    }
+
+    //printf("%s\n", xpc_dictionary_get_string(interface_param, vmnet_mac_address_key));
+    const char *macStr = xpc_dictionary_get_string(interface_param, vmnet_mac_address_key);
+    strcpy(mac, macStr);
+
+    dispatch_semaphore_signal(iface_created);
+  });
+
+  dispatch_semaphore_wait(iface_created, DISPATCH_TIME_FOREVER);
+  dispatch_release(if_create_q);
+
+  if (iface == NULL || iface_status != VMNET_SUCCESS) {
+    fprintf(stderr, "virtio_net: Could not create vmnet interface, "
+      "permission denied or no entitlement?\n");
+    return rb_str_new2("");
+  }
+
+  iface_status = 0;
+
+  if_stop_q = dispatch_queue_create("org.xhyve.vmnet.stop", DISPATCH_QUEUE_SERIAL);
+
+  iface_stopped = dispatch_semaphore_create(0);
+
+  iface_status = vmnet_stop_interface(iface, if_stop_q,
+    ^(vmnet_return_t status)
+  {
+    iface_status = status;
+    dispatch_semaphore_signal(iface_stopped);
+  });
+
+  dispatch_semaphore_wait(iface_stopped, DISPATCH_TIME_FOREVER);
+  dispatch_release(if_stop_q);
+
+  if (iface_status != VMNET_SUCCESS) {
+    fprintf(stderr, "virtio_net: Could not stop vmnet interface, "
+      "permission denied or no entitlement?\n");
+    return rb_str_new2("");
+  }
+
+  return rb_str_new2(mac);
+}
+
+void 
+Init_vmnet(void){
+  VALUE cVmnet;
+
+  cVmnet = rb_define_module("VMNet");
+
+  rb_define_singleton_method(cVmnet, "uuid_to_mac", vmnet_get_mac_address_from_uuid, 1);
+}

data/lib/xhyve/version.rb

@@ -0,0 +1,3 @@
+module Xhyve
+  VERSION='0.0.1'
+end

data/lib/xhyve.rb

@@ -0,0 +1,4 @@
+$LOAD_PATH.unshift(File.expand_path('../lib', __FILE__))
+
+require 'xhyve/version'
+require 'xhyve/vmnet/vmnet.bundle'

metadata

@@ -0,0 +1,78 @@
+--- !ruby/object:Gem::Specification
+name: xhyve-ruby
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Dale Hamel
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-11-23 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 10.4.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 10.4.2
+- !ruby/object:Gem::Dependency
+  name: rake-compiler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.9.5
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.9.5
+description: Provides a means of interacting with xhyve from ruby
+email: dale.hamel@srvthe.net
+executables: []
+extensions:
+- ext/vmnet/extconf.rb
+extra_rdoc_files: []
+files:
+- ext/vmnet/extconf.rb
+- ext/vmnet/uuid.h
+- ext/vmnet/vmnet.c
+- lib/xhyve.rb
+- lib/xhyve/version.rb
+- lib/xhyve/vmnet/vmnet.bundle
+homepage: http://rubygems.org/gems/ruby-xhyve
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.3
+signing_key: 
+specification_version: 4
+summary: Ruby wrapper for xhyve
+test_files: []