include/linux/umh.h

   1 #ifndef __LINUX_UMH_H__
   2 #define __LINUX_UMH_H__
   3
   4 #include <linux/gfp.h>
   5 #include <linux/stddef.h>
   6 #include <linux/errno.h>
   7 #include <linux/compiler.h>
   8 #include <linux/workqueue.h>
   9 #include <linux/sysctl.h>
  10
  11 struct cred;
  12 struct file;
  13
  14 #define UMH_NO_WAIT     0       /* don't wait at all */
  15 #define UMH_WAIT_EXEC   1       /* wait for the exec, but not the process */
  16 #define UMH_WAIT_PROC   2       /* wait for the process to complete */
  17 #define UMH_KILLABLE    4       /* wait for EXEC/PROC killable */
  18
  19 struct subprocess_info {
  20         struct work_struct work;
  21         struct completion *complete;
  22         const char *path;
  23         char **argv;
  24         char **envp;
  25         struct file *file;
  26         int wait;
  27         int retval;
  28         int (*init)(struct subprocess_info *info, struct cred *new);
  29         void (*cleanup)(struct subprocess_info *info);
  30         void *data;
  31 } __randomize_layout;
  32
  33 extern int
  34 call_usermodehelper(const char *path, char **argv, char **envp, int wait);
  35
  36 extern struct subprocess_info *
  37 call_usermodehelper_setup(const char *path, char **argv, char **envp,
  38                           gfp_t gfp_mask,
  39                           int (*init)(struct subprocess_info *info, struct cred *new),
  40                           void (*cleanup)(struct subprocess_info *), void *data);
  41
  42 struct subprocess_info *call_usermodehelper_setup_file(struct file *file,
  43                           int (*init)(struct subprocess_info *info, struct cred *new),
  44                           void (*cleanup)(struct subprocess_info *), void *data);
  45 struct umh_info {
  46         const char *cmdline;
  47         struct file *pipe_to_umh;
  48         struct file *pipe_from_umh;
  49         struct list_head list;
  50         void (*cleanup)(struct umh_info *info);
  51         pid_t pid;
  52 };
  53 int fork_usermode_blob(void *data, size_t len, struct umh_info *info);
  54
  55 extern int
  56 call_usermodehelper_exec(struct subprocess_info *info, int wait);
  57
  58 extern struct ctl_table usermodehelper_table[];
  59
  60 enum umh_disable_depth {
  61         UMH_ENABLED = 0,
  62         UMH_FREEZING,
  63         UMH_DISABLED,
  64 };
  65
  66 extern int __usermodehelper_disable(enum umh_disable_depth depth);
  67 extern void __usermodehelper_set_disable_depth(enum umh_disable_depth depth);
  68
  69 static inline int usermodehelper_disable(void)
  70 {
  71         return __usermodehelper_disable(UMH_DISABLED);
  72 }
  73
  74 static inline void usermodehelper_enable(void)
  75 {
  76         __usermodehelper_set_disable_depth(UMH_ENABLED);
  77 }
  78
  79 extern int usermodehelper_read_trylock(void);
  80 extern long usermodehelper_read_lock_wait(long timeout);
  81 extern void usermodehelper_read_unlock(void);
  82
  83 #endif /* __LINUX_UMH_H__ */