po4a/inotify/po/inotify.pot

   1 # SOME DESCRIPTIVE TITLE
   2 # Copyright (C) YEAR Free Software Foundation, Inc.
   3 # This file is distributed under the same license as the PACKAGE package.
   4 # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
   5 #
   6 #, fuzzy
   7 msgid ""
   8 msgstr ""
   9 "Project-Id-Version: PACKAGE VERSION\n"
  10 "POT-Creation-Date: 2013-08-15 19:31+0900\n"
  11 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
  12 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
  13 "Language-Team: LANGUAGE <LL@li.org>\n"
  14 "Language: \n"
  15 "MIME-Version: 1.0\n"
  16 "Content-Type: text/plain; charset=CHARSET\n"
  17 "Content-Transfer-Encoding: 8bit\n"
  18
  19 #. type: TH
  20 #: build/C/man7/inotify.7:26
  21 #, no-wrap
  22 msgid "INOTIFY"
  23 msgstr ""
  24
  25 #. type: TH
  26 #: build/C/man7/inotify.7:26
  27 #, no-wrap
  28 msgid "2013-07-21"
  29 msgstr ""
  30
  31 #. type: TH
  32 #: build/C/man7/inotify.7:26 build/C/man2/inotify_add_watch.2:28 build/C/man2/inotify_init.2:28 build/C/man2/inotify_rm_watch.2:27
  33 #, no-wrap
  34 msgid "Linux"
  35 msgstr ""
  36
  37 #. type: TH
  38 #: build/C/man7/inotify.7:26 build/C/man2/inotify_add_watch.2:28 build/C/man2/inotify_init.2:28 build/C/man2/inotify_rm_watch.2:27
  39 #, no-wrap
  40 msgid "Linux Programmer's Manual"
  41 msgstr ""
  42
  43 #. type: SH
  44 #: build/C/man7/inotify.7:27 build/C/man2/inotify_add_watch.2:29 build/C/man2/inotify_init.2:29 build/C/man2/inotify_rm_watch.2:28
  45 #, no-wrap
  46 msgid "NAME"
  47 msgstr ""
  48
  49 #. type: Plain text
  50 #: build/C/man7/inotify.7:29
  51 msgid "inotify - monitoring file system events"
  52 msgstr ""
  53
  54 #. type: SH
  55 #: build/C/man7/inotify.7:29 build/C/man2/inotify_add_watch.2:35 build/C/man2/inotify_init.2:38 build/C/man2/inotify_rm_watch.2:36
  56 #, no-wrap
  57 msgid "DESCRIPTION"
  58 msgstr ""
  59
  60 #. type: Plain text
  61 #: build/C/man7/inotify.7:37
  62 msgid ""
  63 "The I<inotify> API provides a mechanism for monitoring file system events.  "
  64 "Inotify can be used to monitor individual files, or to monitor directories.  "
  65 "When a directory is monitored, inotify will return events for the directory "
  66 "itself, and for files inside the directory."
  67 msgstr ""
  68
  69 #. type: Plain text
  70 #: build/C/man7/inotify.7:47
  71 msgid ""
  72 "The following system calls are used with this API: B<inotify_init>(2)  (or "
  73 "B<inotify_init1>(2)), B<inotify_add_watch>(2), B<inotify_rm_watch>(2), "
  74 "B<read>(2), and B<close>(2)."
  75 msgstr ""
  76
  77 #. type: Plain text
  78 #: build/C/man7/inotify.7:56
  79 msgid ""
  80 "B<inotify_init>(2)  creates an inotify instance and returns a file "
  81 "descriptor referring to the inotify instance.  The more recent "
  82 "B<inotify_init1>(2)  is like B<inotify_init>(2), but provides some extra "
  83 "functionality."
  84 msgstr ""
  85
  86 #. type: Plain text
  87 #: build/C/man7/inotify.7:69
  88 msgid ""
  89 "B<inotify_add_watch>(2)  manipulates the \"watch list\" associated with an "
  90 "inotify instance.  Each item (\"watch\") in the watch list specifies the "
  91 "pathname of a file or directory, along with some set of events that the "
  92 "kernel should monitor for the file referred to by that pathname.  "
  93 "B<inotify_add_watch>(2)  either creates a new watch item, or modifies an "
  94 "existing watch.  Each watch has a unique \"watch descriptor\", an integer "
  95 "returned by B<inotify_add_watch>(2)  when the watch is created."
  96 msgstr ""
  97
  98 #. type: Plain text
  99 #: build/C/man7/inotify.7:72
 100 msgid "B<inotify_rm_watch>(2)  removes an item from an inotify watch list."
 101 msgstr ""
 102
 103 #. type: Plain text
 104 #: build/C/man7/inotify.7:78
 105 msgid ""
 106 "When all file descriptors referring to an inotify instance have been closed, "
 107 "the underlying object and its resources are freed for reuse by the kernel; "
 108 "all associated watches are automatically freed."
 109 msgstr ""
 110
 111 #. type: Plain text
 112 #: build/C/man7/inotify.7:91
 113 msgid ""
 114 "To determine what events have occurred, an application B<read>(2)s from the "
 115 "inotify file descriptor.  If no events have so far occurred, then, assuming "
 116 "a blocking file descriptor, B<read>(2)  will block until at least one event "
 117 "occurs (unless interrupted by a signal, in which case the call fails with "
 118 "the error B<EINTR>; see B<signal>(7))."
 119 msgstr ""
 120
 121 #. type: Plain text
 122 #: build/C/man7/inotify.7:95
 123 msgid ""
 124 "Each successful B<read>(2)  returns a buffer containing one or more of the "
 125 "following structures:"
 126 msgstr ""
 127
 128 #.  FIXME . The type of the 'wd' field should probably be "int32_t".
 129 #.  I submitted a patch to fix this.  See the LKML thread
 130 #.  "[patch] Fix type errors in inotify interfaces", 18 Nov 2008
 131 #.  Glibc bug filed: http://sources.redhat.com/bugzilla/show_bug.cgi?id=7040
 132 #. type: Plain text
 133 #: build/C/man7/inotify.7:110
 134 #, no-wrap
 135 msgid ""
 136 "struct inotify_event {\n"
 137 "    int      wd;       /* Watch descriptor */\n"
 138 "    uint32_t mask;     /* Mask of events */\n"
 139 "    uint32_t cookie;   /* Unique cookie associating related\n"
 140 "                          events (for rename(2)) */\n"
 141 "    uint32_t len;      /* Size of I<name> field */\n"
 142 "    char     name[];   /* Optional null-terminated name */\n"
 143 "};\n"
 144 msgstr ""
 145
 146 #. type: Plain text
 147 #: build/C/man7/inotify.7:117
 148 msgid ""
 149 "I<wd> identifies the watch for which this event occurs.  It is one of the "
 150 "watch descriptors returned by a previous call to B<inotify_add_watch>(2)."
 151 msgstr ""
 152
 153 #. type: Plain text
 154 #: build/C/man7/inotify.7:120
 155 msgid "I<mask> contains bits that describe the event that occurred (see below)."
 156 msgstr ""
 157
 158 #. type: Plain text
 159 #: build/C/man7/inotify.7:132
 160 msgid ""
 161 "I<cookie> is a unique integer that connects related events.  Currently this "
 162 "is used only for rename events, and allows the resulting pair of "
 163 "B<IN_MOVED_FROM> and B<IN_MOVED_TO> events to be connected by the "
 164 "application.  For all other event types, I<cookie> is set to 0."
 165 msgstr ""
 166
 167 #. type: Plain text
 168 #: build/C/man7/inotify.7:141
 169 msgid ""
 170 "The I<name> field is present only when an event is returned for a file "
 171 "inside a watched directory; it identifies the file pathname relative to the "
 172 "watched directory.  This pathname is null-terminated, and may include "
 173 "further null bytes (\\(aq\\e0\\(aq) to align subsequent reads to a suitable "
 174 "address boundary."
 175 msgstr ""
 176
 177 #. type: Plain text
 178 #: build/C/man7/inotify.7:151
 179 msgid ""
 180 "The I<len> field counts all of the bytes in I<name>, including the null "
 181 "bytes; the length of each I<inotify_event> structure is thus I<sizeof(struct "
 182 "inotify_event)+len>."
 183 msgstr ""
 184
 185 #. type: Plain text
 186 #: build/C/man7/inotify.7:162
 187 msgid ""
 188 "The behavior when the buffer given to B<read>(2)  is too small to return "
 189 "information about the next event depends on the kernel version: in kernels "
 190 "before 2.6.21, B<read>(2)  returns 0; since kernel 2.6.21, B<read>(2)  fails "
 191 "with the error B<EINVAL>.  Specifying a buffer of size"
 192 msgstr ""
 193
 194 #. type: Plain text
 195 #: build/C/man7/inotify.7:164
 196 #, no-wrap
 197 msgid "    sizeof(struct inotify_event) + NAME_MAX + 1\n"
 198 msgstr ""
 199
 200 #. type: Plain text
 201 #: build/C/man7/inotify.7:166
 202 msgid "will be sufficient to read at least one event."
 203 msgstr ""
 204
 205 #. type: SS
 206 #: build/C/man7/inotify.7:166
 207 #, no-wrap
 208 msgid "inotify events"
 209 msgstr ""
 210
 211 #. type: Plain text
 212 #: build/C/man7/inotify.7:186
 213 msgid ""
 214 "The B<inotify_add_watch>(2)  I<mask> argument and the I<mask> field of the "
 215 "I<inotify_event> structure returned when B<read>(2)ing an inotify file "
 216 "descriptor are both bit masks identifying inotify events.  The following "
 217 "bits can be specified in I<mask> when calling B<inotify_add_watch>(2)  and "
 218 "may be returned in the I<mask> field returned by B<read>(2):"
 219 msgstr ""
 220
 221 #. type: TP
 222 #: build/C/man7/inotify.7:189
 223 #, no-wrap
 224 msgid "B<IN_ACCESS>"
 225 msgstr ""
 226
 227 #. type: Plain text
 228 #: build/C/man7/inotify.7:192
 229 msgid "File was accessed (read) (*)."
 230 msgstr ""
 231
 232 #. type: TP
 233 #: build/C/man7/inotify.7:192
 234 #, no-wrap
 235 msgid "B<IN_ATTRIB>"
 236 msgstr ""
 237
 238 #. type: Plain text
 239 #: build/C/man7/inotify.7:196
 240 msgid ""
 241 "Metadata changed, e.g., permissions, timestamps, extended attributes, link "
 242 "count (since Linux 2.6.25), UID, GID, etc. (*)."
 243 msgstr ""
 244
 245 #. type: TP
 246 #: build/C/man7/inotify.7:196
 247 #, no-wrap
 248 msgid "B<IN_CLOSE_WRITE>"
 249 msgstr ""
 250
 251 #. type: Plain text
 252 #: build/C/man7/inotify.7:199
 253 msgid "File opened for writing was closed (*)."
 254 msgstr ""
 255
 256 #. type: TP
 257 #: build/C/man7/inotify.7:199
 258 #, no-wrap
 259 msgid "B<IN_CLOSE_NOWRITE>"
 260 msgstr ""
 261
 262 #. type: Plain text
 263 #: build/C/man7/inotify.7:202
 264 msgid "File not opened for writing was closed (*)."
 265 msgstr ""
 266
 267 #. type: TP
 268 #: build/C/man7/inotify.7:202
 269 #, no-wrap
 270 msgid "B<IN_CREATE>"
 271 msgstr ""
 272
 273 #. type: Plain text
 274 #: build/C/man7/inotify.7:205
 275 msgid "File/directory created in watched directory (*)."
 276 msgstr ""
 277
 278 #. type: TP
 279 #: build/C/man7/inotify.7:205
 280 #, no-wrap
 281 msgid "B<IN_DELETE>"
 282 msgstr ""
 283
 284 #. type: Plain text
 285 #: build/C/man7/inotify.7:208
 286 msgid "File/directory deleted from watched directory (*)."
 287 msgstr ""
 288
 289 #. type: TP
 290 #: build/C/man7/inotify.7:208
 291 #, no-wrap
 292 msgid "B<IN_DELETE_SELF>"
 293 msgstr ""
 294
 295 #. type: Plain text
 296 #: build/C/man7/inotify.7:211
 297 msgid "Watched file/directory was itself deleted."
 298 msgstr ""
 299
 300 #. type: TP
 301 #: build/C/man7/inotify.7:211
 302 #, no-wrap
 303 msgid "B<IN_MODIFY>"
 304 msgstr ""
 305
 306 #. type: Plain text
 307 #: build/C/man7/inotify.7:214
 308 msgid "File was modified (*)."
 309 msgstr ""
 310
 311 #. type: TP
 312 #: build/C/man7/inotify.7:214
 313 #, no-wrap
 314 msgid "B<IN_MOVE_SELF>"
 315 msgstr ""
 316
 317 #. type: Plain text
 318 #: build/C/man7/inotify.7:217
 319 msgid "Watched file/directory was itself moved."
 320 msgstr ""
 321
 322 #. type: TP
 323 #: build/C/man7/inotify.7:217
 324 #, no-wrap
 325 msgid "B<IN_MOVED_FROM>"
 326 msgstr ""
 327
 328 #. type: Plain text
 329 #: build/C/man7/inotify.7:221
 330 msgid ""
 331 "Generated for the directory containing the old filename when a file is "
 332 "renamed (*)."
 333 msgstr ""
 334
 335 #. type: TP
 336 #: build/C/man7/inotify.7:221
 337 #, no-wrap
 338 msgid "B<IN_MOVED_TO>"
 339 msgstr ""
 340
 341 #. type: Plain text
 342 #: build/C/man7/inotify.7:225
 343 msgid ""
 344 "Generated for the directory containing the new filename when a file is "
 345 "renamed (*)."
 346 msgstr ""
 347
 348 #. type: TP
 349 #: build/C/man7/inotify.7:225
 350 #, no-wrap
 351 msgid "B<IN_OPEN>"
 352 msgstr ""
 353
 354 #. type: Plain text
 355 #: build/C/man7/inotify.7:228
 356 msgid "File was opened (*)."
 357 msgstr ""
 358
 359 #. type: Plain text
 360 #: build/C/man7/inotify.7:238
 361 msgid ""
 362 "When monitoring a directory, the events marked with an asterisk (*) above "
 363 "can occur for files in the directory, in which case the I<name> field in the "
 364 "returned I<inotify_event> structure identifies the name of the file within "
 365 "the directory."
 366 msgstr ""
 367
 368 #. type: Plain text
 369 #: build/C/man7/inotify.7:246
 370 msgid ""
 371 "The B<IN_ALL_EVENTS> macro is defined as a bit mask of all of the above "
 372 "events.  This macro can be used as the I<mask> argument when calling "
 373 "B<inotify_add_watch>(2)."
 374 msgstr ""
 375
 376 #. type: Plain text
 377 #: build/C/man7/inotify.7:255
 378 msgid ""
 379 "Two additional convenience macros are B<IN_MOVE>, which equates to "
 380 "IN_MOVED_FROM|IN_MOVED_TO, and B<IN_CLOSE>, which equates to "
 381 "IN_CLOSE_WRITE|IN_CLOSE_NOWRITE."
 382 msgstr ""
 383
 384 #. type: Plain text
 385 #: build/C/man7/inotify.7:260
 386 msgid ""
 387 "The following further bits can be specified in I<mask> when calling "
 388 "B<inotify_add_watch>(2):"
 389 msgstr ""
 390
 391 #. type: TP
 392 #: build/C/man7/inotify.7:263
 393 #, no-wrap
 394 msgid "B<IN_DONT_FOLLOW> (since Linux 2.6.15)"
 395 msgstr ""
 396
 397 #. type: Plain text
 398 #: build/C/man7/inotify.7:268
 399 msgid "Don't dereference I<pathname> if it is a symbolic link."
 400 msgstr ""
 401
 402 #. type: TP
 403 #: build/C/man7/inotify.7:268
 404 #, no-wrap
 405 msgid "B<IN_EXCL_UNLINK> (since Linux 2.6.36)"
 406 msgstr ""
 407
 408 #.  commit 8c1934c8d70b22ca8333b216aec6c7d09fdbd6a6
 409 #. type: Plain text
 410 #: build/C/man7/inotify.7:284
 411 msgid ""
 412 "By default, when watching events on the children of a directory, events are "
 413 "generated for children even after they have been unlinked from the "
 414 "directory.  This can result in large numbers of uninteresting events for "
 415 "some applications (e.g., if watching I</tmp>, in which many applications "
 416 "create temporary files whose names are immediately unlinked).  Specifying "
 417 "B<IN_EXCL_UNLINK> changes the default behavior, so that events are not "
 418 "generated for children after they have been unlinked from the watched "
 419 "directory."
 420 msgstr ""
 421
 422 #. type: TP
 423 #: build/C/man7/inotify.7:284
 424 #, no-wrap
 425 msgid "B<IN_MASK_ADD>"
 426 msgstr ""
 427
 428 #. type: Plain text
 429 #: build/C/man7/inotify.7:288
 430 msgid ""
 431 "Add (OR) events to watch mask for this pathname if it already exists "
 432 "(instead of replacing mask)."
 433 msgstr ""
 434
 435 #. type: TP
 436 #: build/C/man7/inotify.7:288
 437 #, no-wrap
 438 msgid "B<IN_ONESHOT>"
 439 msgstr ""
 440
 441 #. type: Plain text
 442 #: build/C/man7/inotify.7:294
 443 msgid "Monitor I<pathname> for one event, then remove from watch list."
 444 msgstr ""
 445
 446 #. type: TP
 447 #: build/C/man7/inotify.7:294
 448 #, no-wrap
 449 msgid "B<IN_ONLYDIR> (since Linux 2.6.15)"
 450 msgstr ""
 451
 452 #. type: Plain text
 453 #: build/C/man7/inotify.7:299
 454 msgid "Only watch I<pathname> if it is a directory."
 455 msgstr ""
 456
 457 #. type: Plain text
 458 #: build/C/man7/inotify.7:306
 459 msgid "The following bits may be set in the I<mask> field returned by B<read>(2):"
 460 msgstr ""
 461
 462 #. type: TP
 463 #: build/C/man7/inotify.7:309
 464 #, no-wrap
 465 msgid "B<IN_IGNORED>"
 466 msgstr ""
 467
 468 #. type: Plain text
 469 #: build/C/man7/inotify.7:314
 470 msgid ""
 471 "Watch was removed explicitly (B<inotify_rm_watch>(2))  or automatically "
 472 "(file was deleted, or file system was unmounted)."
 473 msgstr ""
 474
 475 #. type: TP
 476 #: build/C/man7/inotify.7:314
 477 #, no-wrap
 478 msgid "B<IN_ISDIR>"
 479 msgstr ""
 480
 481 #. type: Plain text
 482 #: build/C/man7/inotify.7:317
 483 msgid "Subject of this event is a directory."
 484 msgstr ""
 485
 486 #. type: TP
 487 #: build/C/man7/inotify.7:317
 488 #, no-wrap
 489 msgid "B<IN_Q_OVERFLOW>"
 490 msgstr ""
 491
 492 #. type: Plain text
 493 #: build/C/man7/inotify.7:322
 494 msgid "Event queue overflowed (I<wd> is -1 for this event)."
 495 msgstr ""
 496
 497 #. type: TP
 498 #: build/C/man7/inotify.7:322
 499 #, no-wrap
 500 msgid "B<IN_UNMOUNT>"
 501 msgstr ""
 502
 503 #. type: Plain text
 504 #: build/C/man7/inotify.7:325
 505 msgid "File system containing watched object was unmounted."
 506 msgstr ""
 507
 508 #. type: SS
 509 #: build/C/man7/inotify.7:327
 510 #, no-wrap
 511 msgid "/proc interfaces"
 512 msgstr ""
 513
 514 #. type: Plain text
 515 #: build/C/man7/inotify.7:330
 516 msgid ""
 517 "The following interfaces can be used to limit the amount of kernel memory "
 518 "consumed by inotify:"
 519 msgstr ""
 520
 521 #. type: TP
 522 #: build/C/man7/inotify.7:330
 523 #, no-wrap
 524 msgid "I</proc/sys/fs/inotify/max_queued_events>"
 525 msgstr ""
 526
 527 #. type: Plain text
 528 #: build/C/man7/inotify.7:339
 529 msgid ""
 530 "The value in this file is used when an application calls B<inotify_init>(2)  "
 531 "to set an upper limit on the number of events that can be queued to the "
 532 "corresponding inotify instance.  Events in excess of this limit are dropped, "
 533 "but an B<IN_Q_OVERFLOW> event is always generated."
 534 msgstr ""
 535
 536 #. type: TP
 537 #: build/C/man7/inotify.7:339
 538 #, no-wrap
 539 msgid "I</proc/sys/fs/inotify/max_user_instances>"
 540 msgstr ""
 541
 542 #. type: Plain text
 543 #: build/C/man7/inotify.7:343
 544 msgid ""
 545 "This specifies an upper limit on the number of inotify instances that can be "
 546 "created per real user ID."
 547 msgstr ""
 548
 549 #. type: TP
 550 #: build/C/man7/inotify.7:343
 551 #, no-wrap
 552 msgid "I</proc/sys/fs/inotify/max_user_watches>"
 553 msgstr ""
 554
 555 #. type: Plain text
 556 #: build/C/man7/inotify.7:347
 557 msgid ""
 558 "This specifies an upper limit on the number of watches that can be created "
 559 "per real user ID."
 560 msgstr ""
 561
 562 #. type: SH
 563 #: build/C/man7/inotify.7:347 build/C/man2/inotify_add_watch.2:114 build/C/man2/inotify_init.2:90 build/C/man2/inotify_rm_watch.2:66
 564 #, no-wrap
 565 msgid "VERSIONS"
 566 msgstr ""
 567
 568 #. type: Plain text
 569 #: build/C/man7/inotify.7:355
 570 msgid ""
 571 "Inotify was merged into the 2.6.13 Linux kernel.  The required library "
 572 "interfaces were added to glibc in version 2.4.  (B<IN_DONT_FOLLOW>, "
 573 "B<IN_MASK_ADD>, and B<IN_ONLYDIR> were added in version 2.5.)"
 574 msgstr ""
 575
 576 #. type: SH
 577 #: build/C/man7/inotify.7:355 build/C/man2/inotify_add_watch.2:116 build/C/man2/inotify_init.2:97 build/C/man2/inotify_rm_watch.2:68
 578 #, no-wrap
 579 msgid "CONFORMING TO"
 580 msgstr ""
 581
 582 #. type: Plain text
 583 #: build/C/man7/inotify.7:357
 584 msgid "The inotify API is Linux-specific."
 585 msgstr ""
 586
 587 #. type: SH
 588 #: build/C/man7/inotify.7:357
 589 #, no-wrap
 590 msgid "NOTES"
 591 msgstr ""
 592
 593 #. type: Plain text
 594 #: build/C/man7/inotify.7:364
 595 msgid ""
 596 "Inotify file descriptors can be monitored using B<select>(2), B<poll>(2), "
 597 "and B<epoll>(7).  When an event is available, the file descriptor indicates "
 598 "as readable."
 599 msgstr ""
 600
 601 #. type: Plain text
 602 #: build/C/man7/inotify.7:393
 603 msgid ""
 604 "Since Linux 2.6.25, signal-driven I/O notification is available for inotify "
 605 "file descriptors; see the discussion of B<F_SETFL> (for setting the "
 606 "B<O_ASYNC> flag), B<F_SETOWN>, and B<F_SETSIG> in B<fcntl>(2).  The "
 607 "I<siginfo_t> structure (described in B<sigaction>(2))  that is passed to the "
 608 "signal handler has the following fields set: I<si_fd> is set to the inotify "
 609 "file descriptor number; I<si_signo> is set to the signal number; I<si_code> "
 610 "is set to B<POLL_IN>; and B<POLLIN> is set in I<si_band>."
 611 msgstr ""
 612
 613 #. type: Plain text
 614 #: build/C/man7/inotify.7:403
 615 msgid ""
 616 "If successive output inotify events produced on the inotify file descriptor "
 617 "are identical (same I<wd>, I<mask>, I<cookie>, and I<name>)  then they are "
 618 "coalesced into a single event if the older event has not yet been read (but "
 619 "see BUGS)."
 620 msgstr ""
 621
 622 #. type: Plain text
 623 #: build/C/man7/inotify.7:409
 624 msgid ""
 625 "The events returned by reading from an inotify file descriptor form an "
 626 "ordered queue.  Thus, for example, it is guaranteed that when renaming from "
 627 "one directory to another, events will be produced in the correct order on "
 628 "the inotify file descriptor."
 629 msgstr ""
 630
 631 #. type: Plain text
 632 #: build/C/man7/inotify.7:415
 633 msgid ""
 634 "The B<FIONREAD> B<ioctl>(2)  returns the number of bytes available to read "
 635 "from an inotify file descriptor."
 636 msgstr ""
 637
 638 #. type: SS
 639 #: build/C/man7/inotify.7:415
 640 #, no-wrap
 641 msgid "Limitations and caveats"
 642 msgstr ""
 643
 644 #. type: Plain text
 645 #: build/C/man7/inotify.7:420
 646 msgid ""
 647 "Inotify monitoring of directories is not recursive: to monitor "
 648 "subdirectories under a directory, additional watches must be created.  This "
 649 "can take a significant amount time for large directory trees."
 650 msgstr ""
 651
 652 #. type: Plain text
 653 #: build/C/man7/inotify.7:427
 654 msgid ""
 655 "The inotify API provides no information about the user or process that "
 656 "triggered the inotify event.  In particular, there is no easy way for a "
 657 "process that is monitoring events via inotify to distinguish events that it "
 658 "triggers itself from those that are triggered by other processes."
 659 msgstr ""
 660
 661 #. type: Plain text
 662 #: build/C/man7/inotify.7:432
 663 msgid ""
 664 "Note that the event queue can overflow.  In this case, events are lost.  "
 665 "Robust applications should handle the possibility of lost events gracefully."
 666 msgstr ""
 667
 668 #. type: Plain text
 669 #: build/C/man7/inotify.7:436
 670 msgid ""
 671 "The inotify API identifies affected files by filename.  However, by the time "
 672 "an application processes an inotify event, the filename may already have "
 673 "been deleted or renamed."
 674 msgstr ""
 675
 676 #. type: Plain text
 677 #: build/C/man7/inotify.7:443
 678 msgid ""
 679 "If monitoring an entire directory subtree, and a new subdirectory is created "
 680 "in that tree, be aware that by the time you create a watch for the new "
 681 "subdirectory, new files may already have been created in the subdirectory.  "
 682 "Therefore, you may want to scan the contents of the subdirectory immediately "
 683 "after adding the watch."
 684 msgstr ""
 685
 686 #. type: SH
 687 #: build/C/man7/inotify.7:443
 688 #, no-wrap
 689 msgid "BUGS"
 690 msgstr ""
 691
 692 #. type: Plain text
 693 #: build/C/man7/inotify.7:448
 694 msgid "In kernels before 2.6.16, the B<IN_ONESHOT> I<mask> flag does not work."
 695 msgstr ""
 696
 697 #. type: Plain text
 698 #: build/C/man7/inotify.7:456
 699 msgid ""
 700 "Before kernel 2.6.25, the kernel code that was intended to coalesce "
 701 "successive identical events (i.e., the two most recent events could "
 702 "potentially be coalesced if the older had not yet been read)  instead "
 703 "checked if the most recent event could be coalesced with the I<oldest> "
 704 "unread event."
 705 msgstr ""
 706
 707 #. type: SH
 708 #: build/C/man7/inotify.7:456 build/C/man2/inotify_add_watch.2:118 build/C/man2/inotify_init.2:99 build/C/man2/inotify_rm_watch.2:70
 709 #, no-wrap
 710 msgid "SEE ALSO"
 711 msgstr ""
 712
 713 #. type: Plain text
 714 #: build/C/man7/inotify.7:463
 715 msgid ""
 716 "B<inotify_add_watch>(2), B<inotify_init>(2), B<inotify_init1>(2), "
 717 "B<inotify_rm_watch>(2), B<read>(2), B<stat>(2)"
 718 msgstr ""
 719
 720 #. type: Plain text
 721 #: build/C/man7/inotify.7:466
 722 msgid "I<Documentation/filesystems/inotify.txt> in the Linux kernel source tree"
 723 msgstr ""
 724
 725 #. type: SH
 726 #: build/C/man7/inotify.7:466 build/C/man2/inotify_add_watch.2:122 build/C/man2/inotify_init.2:103 build/C/man2/inotify_rm_watch.2:74
 727 #, no-wrap
 728 msgid "COLOPHON"
 729 msgstr ""
 730
 731 #. type: Plain text
 732 #: build/C/man7/inotify.7:473 build/C/man2/inotify_add_watch.2:129 build/C/man2/inotify_init.2:110 build/C/man2/inotify_rm_watch.2:81
 733 msgid ""
 734 "This page is part of release 3.53 of the Linux I<man-pages> project.  A "
 735 "description of the project, and information about reporting bugs, can be "
 736 "found at \\%http://www.kernel.org/doc/man-pages/."
 737 msgstr ""
 738
 739 #. type: TH
 740 #: build/C/man2/inotify_add_watch.2:28
 741 #, no-wrap
 742 msgid "INOTIFY_ADD_WATCH"
 743 msgstr ""
 744
 745 #. type: TH
 746 #: build/C/man2/inotify_add_watch.2:28
 747 #, no-wrap
 748 msgid "2010-10-20"
 749 msgstr ""
 750
 751 #. type: Plain text
 752 #: build/C/man2/inotify_add_watch.2:31
 753 msgid "inotify_add_watch - add a watch to an initialized inotify instance"
 754 msgstr ""
 755
 756 #. type: SH
 757 #: build/C/man2/inotify_add_watch.2:31 build/C/man2/inotify_init.2:31 build/C/man2/inotify_rm_watch.2:30
 758 #, no-wrap
 759 msgid "SYNOPSIS"
 760 msgstr ""
 761
 762 #. type: Plain text
 763 #: build/C/man2/inotify_add_watch.2:33 build/C/man2/inotify_rm_watch.2:32
 764 msgid "B<#include E<lt>sys/inotify.hE<gt>>"
 765 msgstr ""
 766
 767 #. type: Plain text
 768 #: build/C/man2/inotify_add_watch.2:35
 769 msgid ""
 770 "B<int inotify_add_watch(int >I<fd>B<, const char *>I<pathname>B<, uint32_t "
 771 ">I<mask>B<);>"
 772 msgstr ""
 773
 774 #. type: Plain text
 775 #: build/C/man2/inotify_add_watch.2:54
 776 msgid ""
 777 "B<inotify_add_watch>()  adds a new watch, or modifies an existing watch, for "
 778 "the file whose location is specified in I<pathname>; the caller must have "
 779 "read permission for this file.  The I<fd> argument is a file descriptor "
 780 "referring to the inotify instance whose watch list is to be modified.  The "
 781 "events to be monitored for I<pathname> are specified in the I<mask> bit-mask "
 782 "argument.  See B<inotify>(7)  for a description of the bits that can be set "
 783 "in I<mask>."
 784 msgstr ""
 785
 786 #. type: Plain text
 787 #: build/C/man2/inotify_add_watch.2:68
 788 msgid ""
 789 "A successful call to B<inotify_add_watch>()  returns the unique watch "
 790 "descriptor associated with I<pathname> for this inotify instance.  If "
 791 "I<pathname> was not previously being watched by this inotify instance, then "
 792 "the watch descriptor is newly allocated.  If I<pathname> was already being "
 793 "watched, then the descriptor for the existing watch is returned."
 794 msgstr ""
 795
 796 #. type: Plain text
 797 #: build/C/man2/inotify_add_watch.2:79
 798 msgid ""
 799 "The watch descriptor is returned by later B<read>(2)s from the inotify file "
 800 "descriptor.  These reads fetch I<inotify_event> structures (see "
 801 "B<inotify>(7))  indicating file system events; the watch descriptor inside "
 802 "this structure identifies the object for which the event occurred."
 803 msgstr ""
 804
 805 #. type: SH
 806 #: build/C/man2/inotify_add_watch.2:79 build/C/man2/inotify_init.2:70 build/C/man2/inotify_rm_watch.2:48
 807 #, no-wrap
 808 msgid "RETURN VALUE"
 809 msgstr ""
 810
 811 #. type: Plain text
 812 #: build/C/man2/inotify_add_watch.2:86
 813 msgid ""
 814 "On success, B<inotify_add_watch>()  returns a nonnegative watch descriptor.  "
 815 "On error -1 is returned and I<errno> is set appropriately."
 816 msgstr ""
 817
 818 #. type: SH
 819 #: build/C/man2/inotify_add_watch.2:86 build/C/man2/inotify_init.2:75 build/C/man2/inotify_rm_watch.2:54
 820 #, no-wrap
 821 msgid "ERRORS"
 822 msgstr ""
 823
 824 #. type: TP
 825 #: build/C/man2/inotify_add_watch.2:87
 826 #, no-wrap
 827 msgid "B<EACCES>"
 828 msgstr ""
 829
 830 #. type: Plain text
 831 #: build/C/man2/inotify_add_watch.2:90
 832 msgid "Read access to the given file is not permitted."
 833 msgstr ""
 834
 835 #. type: TP
 836 #: build/C/man2/inotify_add_watch.2:90 build/C/man2/inotify_rm_watch.2:55
 837 #, no-wrap
 838 msgid "B<EBADF>"
 839 msgstr ""
 840
 841 #. type: Plain text
 842 #: build/C/man2/inotify_add_watch.2:93
 843 msgid "The given file descriptor is not valid."
 844 msgstr ""
 845
 846 #. type: TP
 847 #: build/C/man2/inotify_add_watch.2:93
 848 #, no-wrap
 849 msgid "B<EFAULT>"
 850 msgstr ""
 851
 852 #. type: Plain text
 853 #: build/C/man2/inotify_add_watch.2:97
 854 msgid "I<pathname> points outside of the process's accessible address space."
 855 msgstr ""
 856
 857 #. type: TP
 858 #: build/C/man2/inotify_add_watch.2:97 build/C/man2/inotify_init.2:76 build/C/man2/inotify_rm_watch.2:59
 859 #, no-wrap
 860 msgid "B<EINVAL>"
 861 msgstr ""
 862
 863 #. type: Plain text
 864 #: build/C/man2/inotify_add_watch.2:102
 865 msgid ""
 866 "The given event mask contains no valid events; or I<fd> is not an inotify "
 867 "file descriptor."
 868 msgstr ""
 869
 870 #. type: TP
 871 #: build/C/man2/inotify_add_watch.2:102
 872 #, no-wrap
 873 msgid "B<ENOENT>"
 874 msgstr ""
 875
 876 #. type: Plain text
 877 #: build/C/man2/inotify_add_watch.2:107
 878 msgid ""
 879 "A directory component in I<pathname> does not exist or is a dangling "
 880 "symbolic link."
 881 msgstr ""
 882
 883 #. type: TP
 884 #: build/C/man2/inotify_add_watch.2:107 build/C/man2/inotify_init.2:87
 885 #, no-wrap
 886 msgid "B<ENOMEM>"
 887 msgstr ""
 888
 889 #. type: Plain text
 890 #: build/C/man2/inotify_add_watch.2:110
 891 msgid "Insufficient kernel memory was available."
 892 msgstr ""
 893
 894 #. type: TP
 895 #: build/C/man2/inotify_add_watch.2:110
 896 #, no-wrap
 897 msgid "B<ENOSPC>"
 898 msgstr ""
 899
 900 #. type: Plain text
 901 #: build/C/man2/inotify_add_watch.2:114
 902 msgid ""
 903 "The user limit on the total number of inotify watches was reached or the "
 904 "kernel failed to allocate a needed resource."
 905 msgstr ""
 906
 907 #. type: Plain text
 908 #: build/C/man2/inotify_add_watch.2:116 build/C/man2/inotify_rm_watch.2:68
 909 msgid "Inotify was merged into the 2.6.13 Linux kernel."
 910 msgstr ""
 911
 912 #. type: Plain text
 913 #: build/C/man2/inotify_add_watch.2:118 build/C/man2/inotify_rm_watch.2:70
 914 msgid "This system call is Linux-specific."
 915 msgstr ""
 916
 917 #. type: Plain text
 918 #: build/C/man2/inotify_add_watch.2:122
 919 msgid "B<inotify_init>(2), B<inotify_rm_watch>(2), B<inotify>(7)"
 920 msgstr ""
 921
 922 #. type: TH
 923 #: build/C/man2/inotify_init.2:28
 924 #, no-wrap
 925 msgid "INOTIFY_INIT"
 926 msgstr ""
 927
 928 #. type: TH
 929 #: build/C/man2/inotify_init.2:28
 930 #, no-wrap
 931 msgid "2012-05-04"
 932 msgstr ""
 933
 934 #. type: Plain text
 935 #: build/C/man2/inotify_init.2:31
 936 msgid "inotify_init, inotify_init1 - initialize an inotify instance"
 937 msgstr ""
 938
 939 #. type: Plain text
 940 #: build/C/man2/inotify_init.2:34
 941 #, no-wrap
 942 msgid "B<#include E<lt>sys/inotify.hE<gt>>\n"
 943 msgstr ""
 944
 945 #. type: Plain text
 946 #: build/C/man2/inotify_init.2:37
 947 #, no-wrap
 948 msgid ""
 949 "B<int inotify_init(void);>\n"
 950 "B<int inotify_init1(int >I<flags>B<);>\n"
 951 msgstr ""
 952
 953 #. type: Plain text
 954 #: build/C/man2/inotify_init.2:42
 955 msgid ""
 956 "B<inotify_init>()  initializes a new inotify instance and returns a file "
 957 "descriptor associated with a new inotify event queue."
 958 msgstr ""
 959
 960 #. type: Plain text
 961 #: build/C/man2/inotify_init.2:52
 962 msgid ""
 963 "If I<flags> is 0, then B<inotify_init1>()  is the same as "
 964 "B<inotify_init>().  The following values can be bitwise ORed in I<flags> to "
 965 "obtain different behavior:"
 966 msgstr ""
 967
 968 #. type: TP
 969 #: build/C/man2/inotify_init.2:52
 970 #, no-wrap
 971 msgid "B<IN_NONBLOCK>"
 972 msgstr ""
 973
 974 #. type: Plain text
 975 #: build/C/man2/inotify_init.2:60
 976 msgid ""
 977 "Set the B<O_NONBLOCK> file status flag on the new open file description.  "
 978 "Using this flag saves extra calls to B<fcntl>(2)  to achieve the same "
 979 "result."
 980 msgstr ""
 981
 982 #. type: TP
 983 #: build/C/man2/inotify_init.2:60
 984 #, no-wrap
 985 msgid "B<IN_CLOEXEC>"
 986 msgstr ""
 987
 988 #. type: Plain text
 989 #: build/C/man2/inotify_init.2:70
 990 msgid ""
 991 "Set the close-on-exec (B<FD_CLOEXEC>)  flag on the new file descriptor.  See "
 992 "the description of the B<O_CLOEXEC> flag in B<open>(2)  for reasons why this "
 993 "may be useful."
 994 msgstr ""
 995
 996 #. type: Plain text
 997 #: build/C/man2/inotify_init.2:75
 998 msgid ""
 999 "On success, these system calls return a new file descriptor.  On error, -1 "
1000 "is returned, and I<errno> is set to indicate the error."
1001 msgstr ""
1002
1003 #. type: Plain text
1004 #: build/C/man2/inotify_init.2:81
1005 msgid "(B<inotify_init1>())  An invalid value was specified in I<flags>."
1006 msgstr ""
1007
1008 #. type: TP
1009 #: build/C/man2/inotify_init.2:81
1010 #, no-wrap
1011 msgid "B<EMFILE>"
1012 msgstr ""
1013
1014 #. type: Plain text
1015 #: build/C/man2/inotify_init.2:84
1016 msgid "The user limit on the total number of inotify instances has been reached."
1017 msgstr ""
1018
1019 #. type: TP
1020 #: build/C/man2/inotify_init.2:84
1021 #, no-wrap
1022 msgid "B<ENFILE>"
1023 msgstr ""
1024
1025 #. type: Plain text
1026 #: build/C/man2/inotify_init.2:87
1027 msgid "The system limit on the total number of file descriptors has been reached."
1028 msgstr ""
1029
1030 #. type: Plain text
1031 #: build/C/man2/inotify_init.2:90
1032 msgid "Insufficient kernel memory is available."
1033 msgstr ""
1034
1035 #. type: Plain text
1036 #: build/C/man2/inotify_init.2:97
1037 msgid ""
1038 "B<inotify_init>()  first appeared in Linux 2.6.13; library support was added "
1039 "to glibc in version 2.4.  B<inotify_init1>()  was added in Linux 2.6.27; "
1040 "library support was added to glibc in version 2.9."
1041 msgstr ""
1042
1043 #. type: Plain text
1044 #: build/C/man2/inotify_init.2:99
1045 msgid "These system calls are Linux-specific."
1046 msgstr ""
1047
1048 #. type: Plain text
1049 #: build/C/man2/inotify_init.2:103
1050 msgid "B<inotify_add_watch>(2), B<inotify_rm_watch>(2), B<inotify>(7)"
1051 msgstr ""
1052
1053 #. type: TH
1054 #: build/C/man2/inotify_rm_watch.2:27
1055 #, no-wrap
1056 msgid "INOTIFY_RM_WATCH"
1057 msgstr ""
1058
1059 #. type: TH
1060 #: build/C/man2/inotify_rm_watch.2:27
1061 #, no-wrap
1062 msgid "2010-10-15"
1063 msgstr ""
1064
1065 #. type: Plain text
1066 #: build/C/man2/inotify_rm_watch.2:30
1067 msgid "inotify_rm_watch - remove an existing watch from an inotify instance"
1068 msgstr ""
1069
1070 #.  Before glibc 2.10, the second argument was types as uint32_t.
1071 #.  http://sources.redhat.com/bugzilla/show_bug.cgi?id=7040
1072 #. type: Plain text
1073 #: build/C/man2/inotify_rm_watch.2:36
1074 msgid "B<int inotify_rm_watch(int >I<fd>B<, int >I<wd>B<);>"
1075 msgstr ""
1076
1077 #. type: Plain text
1078 #: build/C/man2/inotify_rm_watch.2:42
1079 msgid ""
1080 "B<inotify_rm_watch>()  removes the watch associated with the watch "
1081 "descriptor I<wd> from the inotify instance associated with the file "
1082 "descriptor I<fd>."
1083 msgstr ""
1084
1085 #. type: Plain text
1086 #: build/C/man2/inotify_rm_watch.2:48
1087 msgid ""
1088 "Removing a watch causes an B<IN_IGNORED> event to be generated for this "
1089 "watch descriptor.  (See B<inotify>(7).)"
1090 msgstr ""
1091
1092 #. type: Plain text
1093 #: build/C/man2/inotify_rm_watch.2:54
1094 msgid ""
1095 "On success, B<inotify_rm_watch>()  returns zero, or -1 if an error occurred "
1096 "(in which case, I<errno> is set appropriately)."
1097 msgstr ""
1098
1099 #. type: Plain text
1100 #: build/C/man2/inotify_rm_watch.2:59
1101 msgid "I<fd> is not a valid file descriptor."
1102 msgstr ""
1103
1104 #. type: Plain text
1105 #: build/C/man2/inotify_rm_watch.2:66
1106 msgid ""
1107 "The watch descriptor I<wd> is not valid; or I<fd> is not an inotify file "
1108 "descriptor."
1109 msgstr ""
1110
1111 #. type: Plain text
1112 #: build/C/man2/inotify_rm_watch.2:74
1113 msgid "B<inotify_add_watch>(2), B<inotify_init>(2), B<inotify>(7)"
1114 msgstr ""