lustre/tests/copytool.c

   1 /* -*- mode: c; c-basic-offset: 8; indent-tabs-mode: nil; -*-
   2  * vim:expandtab:shiftwidth=8:tabstop=8:
   3  *
   4  * GPL HEADER START
   5  *
   6  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   7  *
   8  * This program is free software; you can redistribute it and/or modify
   9  * it under the terms of the GNU General Public License version 2 only,
  10  * as published by the Free Software Foundation.
  11  *
  12  * This program is distributed in the hope that it will be useful, but
  13  * WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  15  * General Public License version 2 for more details (a copy is included
  16  * in the LICENSE file that accompanied this code).
  17  *
  18  * You should have received a copy of the GNU General Public License
  19  * version 2 along with this program; If not, see
  20  * http://www.sun.com/software/products/lustre/docs/GPLv2.pdf
  21  *
  22  * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
  23  * CA 95054 USA or visit www.sun.com if you need additional information or
  24  * have any questions.
  25  *
  26  * GPL HEADER END
  27  */
  28 /*
  29  * Copyright  2009 Sun Microsystems, Inc. All rights reserved
  30  * Use is subject to license terms.
  31  */
  32 /*
  33  * This file is part of Lustre, http://www.lustre.org/
  34  * Lustre is a trademark of Sun Microsystems, Inc.
  35  *
  36  * Author: Nathan Rutman <nathan.rutman@sun.com>
  37  *
  38  */
  39
  40 /* HSM copytool example program.
  41  * The copytool acts on action requests from Lustre to copy files to and from
  42  * an HSM archive system.
  43  *
  44  * Note: under Linux, until llapi_copytool_fini is called (or the program is
  45  * killed), the libcfs module will be referenced and unremovable,
  46  * even after Lustre services stop.
  47  */
  48
  49 #include <stdio.h>
  50 #include <libcfs/libcfs.h>
  51 #include <lustre/lustre_user.h>
  52 #include <lustre/liblustreapi.h>
  53
  54 int main() {
  55         void *ctdata;
  56         int archive_nums[] = {1}; /* which archive numbers we care about */
  57         int rc;
  58
  59         rc = llapi_copytool_start(&ctdata, 0, ARRAY_SIZE(archive_nums),
  60                                   archive_nums);
  61         if (rc < 0) {
  62                 fprintf(stderr, "Can't start copytool interface: %s\n",
  63                         strerror(-rc));
  64                 return rc;
  65         }
  66
  67         printf("Waiting for message from kernel (pid=%d)\n", getpid());
  68
  69         while(1) {
  70                 struct hsm_action_list *hal;
  71                 struct hsm_action_item *hai;
  72                 int msgsize, i = 0;
  73
  74                 rc = llapi_copytool_recv(ctdata, &hal, &msgsize);
  75                 if (rc == -ESHUTDOWN) {
  76                         fprintf(stderr, "shutting down");
  77                         break;
  78                 }
  79                 if (rc < 0) {
  80                         fprintf(stderr, "Message receive: %s", strerror(-rc));
  81                         break;
  82                 }
  83                 if (msgsize == 0)
  84                         continue; /* msg not for us */
  85
  86                 printf("Copytool fs=%s archive#=%d item_count=%d\n",
  87                        hal->hal_fsname, hal->hal_archive_num, hal->hal_count);
  88
  89                 hai = hai_zero(hal);
  90                 while (++i <= hal->hal_count) {
  91                         printf("Item %d: action %d reclen %d\n", i,
  92                                hai->hai_action, hai->hai_len);
  93                         printf(" "DFID" gid="LPU64" cookie="LPU64"\n",
  94                                PFID(&hai->hai_fid), hai->hai_gid,
  95                                hai->hai_cookie);
  96                         hai = hai_next(hai);
  97                 }
  98
  99                 llapi_copytool_free(&hal);
 100         }
 101
 102         llapi_copytool_fini(&ctdata);
 103
 104         return 0;
 105 }
 106
 107
 108