lustre/utils/lctl_thread.h

   1 /*
   2  * LGPL HEADER START
   3  *
   4  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   5  *
   6  * (C) Copyright 2012 Commissariat a l'energie atomique et aux energies
   7  *     alternatives
   8  *
   9  * Copyright (c) 2016, 2017, Intel Corporation.
  10  *
  11  * All rights reserved. This program and the accompanying materials
  12  * are made available under the terms of the GNU Lesser General Public License
  13  * (LGPL) version 2.1 or (at your discretion) any later version.
  14  * (LGPL) version 2.1 accompanies this distribution, and is available at
  15  * http://www.gnu.org/licenses/lgpl-2.1.html
  16  *
  17  *
  18  * This library is distributed in the hope that it will be useful,
  19  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  20  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  21  * Lesser General Public License for more details.
  22  *
  23  * LGPL HEADER END
  24  */
  25 /*
  26  *
  27  * lustre/utils/lctl_thread.h
  28  *
  29  * Author: Rajeev Mishra <rajeevm@hpe.com>
  30  */
  31 #if HAVE_LIBPTHREAD
  32 #include <pthread.h>
  33 #endif
  34 #ifndef STRINGIFY
  35 #define STRINGIFY(a) #a
  36 #endif
  37
  38 struct param_opts {
  39         unsigned int po_only_path:1;
  40         unsigned int po_show_path:1;
  41         unsigned int po_show_type:1;
  42         unsigned int po_recursive:1;
  43         unsigned int po_perm:1;
  44         unsigned int po_delete:1;
  45         unsigned int po_only_dir:1;
  46         unsigned int po_file:1;
  47         unsigned int po_yaml:1;
  48         unsigned int po_detail:1;
  49         unsigned int po_header:1;
  50         unsigned int po_parallel_threads;
  51 };
  52 #define popt_is_parallel(popt) ((popt).po_parallel_threads > 0)
  53
  54 #ifdef HAVE_LIBPTHREAD
  55 int write_param(const char *path, const char *param_name,
  56                 struct param_opts *popt, const char *value);
  57
  58 #define LCFG_THREADS_DEF 8
  59
  60 /* A work item for parallel set_param */
  61 struct sp_work_item {
  62         /* The full path to the parameter file */
  63         char *spwi_path;
  64
  65         /* The parameter name as returned by display_name */
  66         char *spwi_param_name;
  67
  68         /* The value to which the parameter is to be set */
  69         char *spwi_value;
  70 };
  71
  72 /* A work queue struct for parallel set_param */
  73 struct sp_workq {
  74         /* The parameter options passed to set_param */
  75         struct param_opts *spwq_popt;
  76
  77         /* The number of valid items in spwq_items */
  78         int spwq_len;
  79
  80         /* The size of the spwq_items list */
  81         int spwq_size;
  82
  83         /* The current index into the spwq_items list */
  84         int spwq_cur_index;
  85
  86         /* Array of work items. */
  87         struct sp_work_item *spwq_items;
  88
  89         /* A mutex to control access to the work queue */
  90         pthread_mutex_t spwq_mutex;
  91 };
  92
  93 int spwq_init(struct sp_workq *wq, struct param_opts *popt);
  94 int spwq_destroy(struct sp_workq *wq);
  95 int spwq_expand(struct sp_workq *wq, size_t num_items);
  96 int spwq_add_item(struct sp_workq *wq, char *path, char *param_name,
  97                   char *value);
  98 int sp_run_threads(struct sp_workq *wq);
  99 #endif