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_parallel_threads;
  50 };
  51 #define popt_is_parallel(popt) ((popt).po_parallel_threads > 0)
  52
  53 #ifdef HAVE_LIBPTHREAD
  54 int write_param(const char *path, const char *param_name,
  55                 struct param_opts *popt, const char *value);
  56
  57 #define LCFG_THREADS_DEF 8
  58
  59 /* A work item for parallel set_param */
  60 struct sp_work_item {
  61         /* The full path to the parameter file */
  62         char *spwi_path;
  63
  64         /* The parameter name as returned by display_name */
  65         char *spwi_param_name;
  66
  67         /* The value to which the parameter is to be set */
  68         char *spwi_value;
  69 };
  70
  71 /* A work queue struct for parallel set_param */
  72 struct sp_workq {
  73         /* The parameter options passed to set_param */
  74         struct param_opts *spwq_popt;
  75
  76         /* The number of valid items in spwq_items */
  77         int spwq_len;
  78
  79         /* The size of the spwq_items list */
  80         int spwq_size;
  81
  82         /* The current index into the spwq_items list */
  83         int spwq_cur_index;
  84
  85         /* Array of work items. */
  86         struct sp_work_item *spwq_items;
  87
  88         /* A mutex to control access to the work queue */
  89         pthread_mutex_t spwq_mutex;
  90 };
  91
  92 int spwq_init(struct sp_workq *wq, struct param_opts *popt);
  93 int spwq_destroy(struct sp_workq *wq);
  94 int spwq_expand(struct sp_workq *wq, size_t num_items);
  95 int spwq_add_item(struct sp_workq *wq, char *path, char *param_name,
  96                   char *value);
  97 int sp_run_threads(struct sp_workq *wq);
  98 #endif