man2/delete_module.2

   1 .\" Copyright (C) 1996 Free Software Foundation, Inc.
   2 .\" This file is distributed according to the GNU General Public License.
   3 .\" See the file COPYING in the top level source directory for details.
   4 .\"
   5 .\" 2006-02-09, some reformatting by Luc Van Oostenryck; some
   6 .\" reformatting and rewordings by mtk
   7 .\"
   8 .TH DELETE_MODULE 2 2006-02-09 Linux "Linux Programmer's Manual"
   9 .SH NAME
  10 delete_module \- delete a loadable module entry
  11 .SH SYNOPSIS
  12 .nf
  13 .B #include <linux/module.h>
  14 .sp
  15 .BI "int delete_module(const char *" name );
  16 .fi
  17 .SH DESCRIPTION
  18 .BR delete_module ()
  19 attempts to remove an unused loadable module entry.
  20 If
  21 .I name
  22 is NULL,
  23 all unused modules marked auto-clean will be removed.
  24 This system call requires privilege.
  25 .SH "RETURN VALUE"
  26 On success, zero is returned.
  27 On error, \-1 is returned and
  28 .I errno
  29 is set appropriately.
  30 .SH ERRORS
  31 .TP
  32 .B EBUSY
  33 The module is in use.
  34 .TP
  35 .B EFAULT
  36 .I name
  37 is outside the program's accessible address space.
  38 .TP
  39 .B EINVAL
  40 .I name
  41 was an empty string.
  42 .TP
  43 .B ENOENT
  44 No module by that name exists.
  45 .TP
  46 .B EPERM
  47 The caller was not privileged
  48 (did not have the
  49 .B CAP_SYS_MODULE
  50 capability).
  51 .SH "CONFORMING TO"
  52 .BR delete_module ()
  53 is Linux specific.
  54 .SH "SEE ALSO"
  55 .BR create_module (2),
  56 .BR init_module (2),
  57 .BR query_module (2)