plugins/golang/examples/dump-plugin/dumpplugin.go

   1 /* Example plugin.
   2  * Copyright Red Hat
   3  *
   4  * Redistribution and use in source and binary forms, with or without
   5  * modification, are permitted provided that the following conditions are
   6  * met:
   7  *
   8  * * Redistributions of source code must retain the above copyright
   9  * notice, this list of conditions and the following disclaimer.
  10  *
  11  * * Redistributions in binary form must reproduce the above copyright
  12  * notice, this list of conditions and the following disclaimer in the
  13  * documentation and/or other materials provided with the distribution.
  14  *
  15  * * Neither the name of Red Hat nor the names of its contributors may be
  16  * used to endorse or promote products derived from this software without
  17  * specific prior written permission.
  18  *
  19  * THIS SOFTWARE IS PROVIDED BY RED HAT AND CONTRIBUTORS ''AS IS'' AND
  20  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
  21  * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
  22  * PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL RED HAT OR
  23  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  24  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  25  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
  26  * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
  27  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
  28  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
  29  * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  30  * SUCH DAMAGE.
  31  */
  32
  33 package main
  34
  35 import (
  36         "C"
  37         "fmt"
  38         "libguestfs.org/nbdkit"
  39         "unsafe"
  40 )
  41
  42 var pluginName = "dumpplugin"
  43
  44 type DumpPlugin struct {
  45         nbdkit.Plugin
  46 }
  47
  48 type DumpConnection struct {
  49         nbdkit.Connection
  50 }
  51
  52 var size uint64 = 1024 * 1024
  53
  54 func (p *DumpPlugin) DumpPlugin() {
  55         fmt.Println("golang_dump_plugin=1")
  56 }
  57
  58 func (p *DumpPlugin) Open(readonly bool) (nbdkit.ConnectionInterface, error) {
  59         return &DumpConnection{}, nil
  60 }
  61
  62 func (c *DumpConnection) GetSize() (uint64, error) {
  63         return size, nil
  64 }
  65
  66 func (c *DumpConnection) PRead(buf []byte, offset uint64,
  67         flags uint32) error {
  68         for i := 0; i < len(buf); i++ {
  69                 buf[i] = 0
  70         }
  71         return nil
  72 }
  73
  74 //----------------------------------------------------------------------
  75 //
  76 // The boilerplate below this line is required by all golang plugins,
  77 // as well as importing "C" and "unsafe" modules at the top of the
  78 // file.
  79
  80 //export plugin_init
  81 func plugin_init() unsafe.Pointer {
  82         // If your plugin needs to do any initialization, you can
  83         // either put it here or implement a Load() method.
  84         // ...
  85
  86         // Then you must call the following function.
  87         return nbdkit.PluginInitialize(pluginName, &DumpPlugin{})
  88 }
  89
  90 // This is never(?) called, but must exist.
  91 func main() {}