git.gag.com Git - debian/amanda/blob - server-src/changer.h

   1 /*
   2  * Amanda, The Advanced Maryland Automatic Network Disk Archiver
   3  * Copyright (c) 1991-1998 University of Maryland at College Park
   4  * All Rights Reserved.
   5  *
   6  * Permission to use, copy, modify, distribute, and sell this software and its
   7  * documentation for any purpose is hereby granted without fee, provided that
   8  * the above copyright notice appear in all copies and that both that
   9  * copyright notice and this permission notice appear in supporting
  10  * documentation, and that the name of U.M. not be used in advertising or
  11  * publicity pertaining to distribution of the software without specific,
  12  * written prior permission.  U.M. makes no representations about the
  13  * suitability of this software for any purpose.  It is provided "as is"
  14  * without express or implied warranty.
  15  *
  16  * U.M. DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL
  17  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL U.M.
  18  * BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  19  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION
  20  * OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
  21  * CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  22  *
  23  * Authors: the Amanda Development Team.  Its members are listed in a
  24  * file named AUTHORS, in the root directory of this distribution.
  25  */
  26 /*
  27  * $Id: changer.h,v 1.12 2005/12/21 19:07:50 paddy_s Exp $
  28  *
  29  * interface routines for tape changers
  30  */
  31 #include "amanda.h"
  32
  33 extern int changer_debug;
  34 extern char *changer_resultstr;
  35
  36 int changer_init P((void));
  37 int changer_reset P((char **slotstr));
  38 int changer_clean P((char **slotstr));
  39 int changer_eject P((char **slotstr));
  40 int changer_label P((char *slotsp, char *labelstr));
  41 int changer_info P((int *nslotsp, char **curslotstr, int *backwards));
  42 int changer_query P((int *nslotsp, char **curslotstr, int *backwards,
  43                      int *searchable));
  44 int changer_search P((char *searchlabel, char **outslotstr, char **devicename));
  45 int changer_loadslot P((char *inslotstr, char **outslotstr, char **devicename));
  46 void changer_current P((void *user_data,
  47                         int (*user_init)(void *user_data,
  48                                          int rc, int nslots, int backwards,
  49                                          int searchable),
  50                      int (*user_slot)(void *user_data,
  51                                       int rc, char *slotstr, char *device)));
  52
  53
  54 /* USAGE: changer_find(user_data, init_fxn, slot_fxn, searchlabel)
  55  *
  56  * Searches the changer. If searchlabel is not NULL, and the changer has
  57  * barcode support, then changer_find will load that tape
  58  * first. Otherwise, changer_find will search through the tape drive
  59  * one by one until user_slot() returns nonzero.
  60  *
  61  * Parameters: user_data: A pointer which is not interpreted by
  62  *                        changer_find, but passed back to the
  63  *                        callback functions user_data and user_slot.
  64  *                        You can use this structure instead of
  65  *                        globals.
  66  *             user_init: This function is called right away. Its
  67  *                        arguments are:
  68  *                        user_data: (as above)
  69  *                        rc:     The results of the changer -info
  70  *                                command.
  71  *                        nslots: The number of slots in the changer.
  72  *                        backwards: Whether this changer can go
  73  *                                backwards or not. Some changers
  74  *                                can only search in one direction,
  75  *                                and then the operator must reload
  76  *                                the tapes.
  77  *                        searchable: Whether this changer has a
  78  *                                barcode reader or similar device.
  79  *             user_slot: This function is called for every slot.
  80  *                        Searching stops when it returns
  81  *                        nonzero. Arguments are:
  82  *                        user_data: (as above)
  83  *                        rc:     The results of the changer -slot
  84  *                                command.
  85  *                        slotstr: The slot which was loaded
  86  *                        device: The tape device to use to read this slot.
  87  */
  88
  89
  90
  91 void changer_find P((void *user_data,
  92                      int (*user_init)(void *user_data, int rc,
  93                                       int nslots, int backwards,
  94                                       int searchable),
  95                      int (*user_slot)(void *user_data, int rc,
  96                                       char *slotstr, char *device),
  97                      char *searchlabel));