#, fuzzy msgid "" msgstr "" "Project-Id-Version: man-pages-l10n VERSION\n" "POT-Creation-Date: 2014-07-17 17:53+0900\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. type: TH #: man-pages/man2/delete_module.2:25 #, no-wrap msgid "DELETE_MODULE" msgstr "" #. type: TH #: man-pages/man2/delete_module.2:25 #, no-wrap msgid "2014-05-10" msgstr "" #. type: TH #: man-pages/man2/delete_module.2:25 #, no-wrap msgid "Linux" msgstr "" #. type: TH #: man-pages/man2/delete_module.2:25 #, no-wrap msgid "Linux Programmer's Manual" msgstr "" #. type: SH #: man-pages/man2/delete_module.2:26 #, no-wrap msgid "NAME" msgstr "" #. type: Plain text #: man-pages/man2/delete_module.2:28 msgid "delete_module - unload a kernel module" msgstr "" #. type: SH #: man-pages/man2/delete_module.2:28 #, no-wrap msgid "SYNOPSIS" msgstr "" #. type: Plain text #: man-pages/man2/delete_module.2:31 #, no-wrap msgid "BIB<, int >IB<);>\n" msgstr "" #. type: Plain text #: man-pages/man2/delete_module.2:35 msgid "" "I: No declaration of this function is provided in glibc headers; see " "NOTES." msgstr "" #. type: SH #: man-pages/man2/delete_module.2:35 #, no-wrap msgid "DESCRIPTION" msgstr "" #. type: Plain text #: man-pages/man2/delete_module.2:49 msgid "" "The B() system call attempts to remove the unused loadable " "module entry identified by I. If the module has an I function, " "then that function is executed before unloading the module. The I " "argument is used to modify the behavior of the system call, as described " "below. This system call requires privilege." msgstr "" #. type: Plain text #: man-pages/man2/delete_module.2:51 msgid "Module removal is attempted according to the following rules:" msgstr "" #. type: IP #: man-pages/man2/delete_module.2:51 #, no-wrap msgid "1." msgstr "" #. type: Plain text #: man-pages/man2/delete_module.2:55 msgid "" "If there are other loaded modules that depend on (i.e., refer to symbols " "defined in) this module, then the call fails." msgstr "" #. type: IP #: man-pages/man2/delete_module.2:55 #, no-wrap msgid "2." msgstr "" #. type: Plain text #: man-pages/man2/delete_module.2:59 msgid "" "Otherwise, if the reference count for the module (i.e., the number of " "processes currently using the module) is zero, then the module is " "immediately unloaded." msgstr "" #. type: IP #: man-pages/man2/delete_module.2:59 #, no-wrap msgid "3." msgstr "" #. O_TRUNC == KMOD_REMOVE_FORCE in kmod library #. O_NONBLOCK == KMOD_REMOVE_NOWAIT in kmod library #. type: Plain text #: man-pages/man2/delete_module.2:70 msgid "" "If a module has a nonzero reference count, then the behavior depends on the " "bits set in I. In normal usage (see NOTES), the B flag " "is always specified, and the B flag may additionally be specified." msgstr "" #. type: Plain text #: man-pages/man2/delete_module.2:74 msgid "The various combinations for I have the following effect:" msgstr "" #. type: TP #: man-pages/man2/delete_module.2:75 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/delete_module.2:78 msgid "The call returns immediately, with an error." msgstr "" #. type: TP #: man-pages/man2/delete_module.2:78 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/delete_module.2:82 msgid "" "The module is unloaded immediately, regardless of whether it has a nonzero " "reference count." msgstr "" #. type: TP #: man-pages/man2/delete_module.2:82 #, no-wrap msgid "B<(flags & O_NONBLOCK) == 0>" msgstr "" #. type: Plain text #: man-pages/man2/delete_module.2:89 msgid "If I does not specify B, the following steps occur:" msgstr "" #. type: IP #: man-pages/man2/delete_module.2:90 man-pages/man2/delete_module.2:92 man-pages/man2/delete_module.2:97 #, no-wrap msgid "*" msgstr "" #. type: Plain text #: man-pages/man2/delete_module.2:92 msgid "The module is marked so that no new references are permitted." msgstr "" #. type: Plain text #: man-pages/man2/delete_module.2:97 msgid "" "If the module's reference count is nonzero, the caller is placed in an " "uninterruptible sleep state (B) until the reference " "count is zero, at which point the call unblocks." msgstr "" #. type: Plain text #: man-pages/man2/delete_module.2:99 msgid "The module is unloaded in the usual way." msgstr "" #. type: Plain text #: man-pages/man2/delete_module.2:113 msgid "" "The B flag has one further effect on the rules described above. By " "default, if a module has an I function but no I function, then " "an attempt to remove the module will fail. However, if B was " "specified, this requirement is bypassed." msgstr "" #. type: Plain text #: man-pages/man2/delete_module.2:124 msgid "" "Using the B flag is dangerous! If the kernel was not built with " "B, this flag is silently ignored. (Normally, " "B is enabled.) Using this flag taints the " "kernel (TAINT_FORCED_RMMOD)." msgstr "" #. type: SH #: man-pages/man2/delete_module.2:124 #, no-wrap msgid "RETURN VALUE" msgstr "" #. type: Plain text #: man-pages/man2/delete_module.2:129 msgid "" "On success, zero is returned. On error, -1 is returned and I is set " "appropriately." msgstr "" #. type: SH #: man-pages/man2/delete_module.2:129 #, no-wrap msgid "ERRORS" msgstr "" #. type: TP #: man-pages/man2/delete_module.2:130 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/delete_module.2:143 msgid "" "The module is not \"live\" (i.e., it is still being initialized or is " "already marked for removal); or, the module has an I function but has " "no I function, and B was not specified in I." msgstr "" #. type: TP #: man-pages/man2/delete_module.2:143 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/delete_module.2:147 msgid "" "I refers to a location outside the process's accessible address space." msgstr "" #. type: TP #: man-pages/man2/delete_module.2:147 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/delete_module.2:150 msgid "No module by that name exists." msgstr "" #. type: TP #: man-pages/man2/delete_module.2:150 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/delete_module.2:161 msgid "" "The caller was not privileged (did not have the B " "capability), or module unloading is disabled (see I in B(5))." msgstr "" #. type: TP #: man-pages/man2/delete_module.2:161 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/delete_module.2:172 msgid "" "Other modules depend on this module; or, B was specified in " "I, but the reference count of this module is nonzero and B " "was not specified in I." msgstr "" #. type: SH #: man-pages/man2/delete_module.2:172 #, no-wrap msgid "CONFORMING TO" msgstr "" #. type: Plain text #: man-pages/man2/delete_module.2:175 msgid "B() is Linux-specific." msgstr "" #. type: SH #: man-pages/man2/delete_module.2:175 #, no-wrap msgid "NOTES" msgstr "" #. type: Plain text #: man-pages/man2/delete_module.2:185 msgid "" "The B() system call is not supported by glibc. No " "declaration is provided in glibc headers, but, through a quirk of history, " "glibc does export an ABI for this system call. Therefore, in order to " "employ this system call, it is sufficient to manually declare the interface " "in your code; alternatively, you can invoke the system call using " "B(2)." msgstr "" #. type: Plain text #: man-pages/man2/delete_module.2:195 msgid "" "The uninterruptible sleep that may occur if B is omitted from " "I is considered undesirable, because the sleeping process is left in " "an unkillable state. As at Linux 3.7, specifying B is optional, " "but in future kernels it is likely to become mandatory." msgstr "" #. type: SS #: man-pages/man2/delete_module.2:195 #, no-wrap msgid "Linux 2.4 and earlier" msgstr "" #. type: Plain text #: man-pages/man2/delete_module.2:197 msgid "In Linux 2.4 and earlier, the system call took only one argument:" msgstr "" #. type: Plain text #: man-pages/man2/delete_module.2:199 msgid "B< int delete_module(const char *>IB<);>" msgstr "" #. type: Plain text #: man-pages/man2/delete_module.2:203 msgid "If I is NULL, all unused modules marked auto-clean are removed." msgstr "" #. type: Plain text #: man-pages/man2/delete_module.2:209 msgid "" "Some further details of differences in the behavior of B() " "in Linux 2.4 and earlier are I currently explained in this manual page." msgstr "" #. type: SH #: man-pages/man2/delete_module.2:209 #, no-wrap msgid "SEE ALSO" msgstr "" #. type: Plain text #: man-pages/man2/delete_module.2:216 msgid "" "B(2), B(2), B(2), B(8), " "B(8), B(8)" msgstr "" #. type: SH #: man-pages/man2/delete_module.2:216 #, no-wrap msgid "COLOPHON" msgstr "" #. type: Plain text #: man-pages/man2/delete_module.2:224 msgid "" "This page is part of release 3.70 of the Linux I project. A " "description of the project, information about reporting bugs, and the latest " "version of this page, can be found at \\%http://www.kernel.org/doc/man-pages/" "." msgstr ""