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-09-28 04:06+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-09-16"
  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 filesystem 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 filesystem 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 filesystem 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 "Filesystem 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:465
 715 msgid ""
 716 "B<inotifywait>(1), B<inotifywatch>(1), B<inotify_add_watch>(2), "
 717 "B<inotify_init>(2), B<inotify_init1>(2), B<inotify_rm_watch>(2), B<read>(2), "
 718 "B<stat>(2)"
 719 msgstr ""
 720
 721 #. type: Plain text
 722 #: build/C/man7/inotify.7:468
 723 msgid "I<Documentation/filesystems/inotify.txt> in the Linux kernel source tree"
 724 msgstr ""
 725
 726 #. type: SH
 727 #: build/C/man7/inotify.7:468 build/C/man2/inotify_add_watch.2:122 build/C/man2/inotify_init.2:103 build/C/man2/inotify_rm_watch.2:74
 728 #, no-wrap
 729 msgid "COLOPHON"
 730 msgstr ""
 731
 732 #. type: Plain text
 733 #: build/C/man7/inotify.7:475 build/C/man2/inotify_add_watch.2:129 build/C/man2/inotify_init.2:110 build/C/man2/inotify_rm_watch.2:81
 734 msgid ""
 735 "This page is part of release 3.54 of the Linux I<man-pages> project.  A "
 736 "description of the project, and information about reporting bugs, can be "
 737 "found at \\%http://www.kernel.org/doc/man-pages/."
 738 msgstr ""
 739
 740 #. type: TH
 741 #: build/C/man2/inotify_add_watch.2:28
 742 #, no-wrap
 743 msgid "INOTIFY_ADD_WATCH"
 744 msgstr ""
 745
 746 #. type: TH
 747 #: build/C/man2/inotify_add_watch.2:28
 748 #, no-wrap
 749 msgid "2010-10-20"
 750 msgstr ""
 751
 752 #. type: Plain text
 753 #: build/C/man2/inotify_add_watch.2:31
 754 msgid "inotify_add_watch - add a watch to an initialized inotify instance"
 755 msgstr ""
 756
 757 #. type: SH
 758 #: build/C/man2/inotify_add_watch.2:31 build/C/man2/inotify_init.2:31 build/C/man2/inotify_rm_watch.2:30
 759 #, no-wrap
 760 msgid "SYNOPSIS"
 761 msgstr ""
 762
 763 #. type: Plain text
 764 #: build/C/man2/inotify_add_watch.2:33 build/C/man2/inotify_rm_watch.2:32
 765 msgid "B<#include E<lt>sys/inotify.hE<gt>>"
 766 msgstr ""
 767
 768 #. type: Plain text
 769 #: build/C/man2/inotify_add_watch.2:35
 770 msgid ""
 771 "B<int inotify_add_watch(int >I<fd>B<, const char *>I<pathname>B<, uint32_t "
 772 ">I<mask>B<);>"
 773 msgstr ""
 774
 775 #. type: Plain text
 776 #: build/C/man2/inotify_add_watch.2:54
 777 msgid ""
 778 "B<inotify_add_watch>()  adds a new watch, or modifies an existing watch, for "
 779 "the file whose location is specified in I<pathname>; the caller must have "
 780 "read permission for this file.  The I<fd> argument is a file descriptor "
 781 "referring to the inotify instance whose watch list is to be modified.  The "
 782 "events to be monitored for I<pathname> are specified in the I<mask> bit-mask "
 783 "argument.  See B<inotify>(7)  for a description of the bits that can be set "
 784 "in I<mask>."
 785 msgstr ""
 786
 787 #. type: Plain text
 788 #: build/C/man2/inotify_add_watch.2:68
 789 msgid ""
 790 "A successful call to B<inotify_add_watch>()  returns the unique watch "
 791 "descriptor associated with I<pathname> for this inotify instance.  If "
 792 "I<pathname> was not previously being watched by this inotify instance, then "
 793 "the watch descriptor is newly allocated.  If I<pathname> was already being "
 794 "watched, then the descriptor for the existing watch is returned."
 795 msgstr ""
 796
 797 #. type: Plain text
 798 #: build/C/man2/inotify_add_watch.2:79
 799 msgid ""
 800 "The watch descriptor is returned by later B<read>(2)s from the inotify file "
 801 "descriptor.  These reads fetch I<inotify_event> structures (see "
 802 "B<inotify>(7))  indicating filesystem events; the watch descriptor inside "
 803 "this structure identifies the object for which the event occurred."
 804 msgstr ""
 805
 806 #. type: SH
 807 #: build/C/man2/inotify_add_watch.2:79 build/C/man2/inotify_init.2:70 build/C/man2/inotify_rm_watch.2:48
 808 #, no-wrap
 809 msgid "RETURN VALUE"
 810 msgstr ""
 811
 812 #. type: Plain text
 813 #: build/C/man2/inotify_add_watch.2:86
 814 msgid ""
 815 "On success, B<inotify_add_watch>()  returns a nonnegative watch descriptor.  "
 816 "On error -1 is returned and I<errno> is set appropriately."
 817 msgstr ""
 818
 819 #. type: SH
 820 #: build/C/man2/inotify_add_watch.2:86 build/C/man2/inotify_init.2:75 build/C/man2/inotify_rm_watch.2:54
 821 #, no-wrap
 822 msgid "ERRORS"
 823 msgstr ""
 824
 825 #. type: TP
 826 #: build/C/man2/inotify_add_watch.2:87
 827 #, no-wrap
 828 msgid "B<EACCES>"
 829 msgstr ""
 830
 831 #. type: Plain text
 832 #: build/C/man2/inotify_add_watch.2:90
 833 msgid "Read access to the given file is not permitted."
 834 msgstr ""
 835
 836 #. type: TP
 837 #: build/C/man2/inotify_add_watch.2:90 build/C/man2/inotify_rm_watch.2:55
 838 #, no-wrap
 839 msgid "B<EBADF>"
 840 msgstr ""
 841
 842 #. type: Plain text
 843 #: build/C/man2/inotify_add_watch.2:93
 844 msgid "The given file descriptor is not valid."
 845 msgstr ""
 846
 847 #. type: TP
 848 #: build/C/man2/inotify_add_watch.2:93
 849 #, no-wrap
 850 msgid "B<EFAULT>"
 851 msgstr ""
 852
 853 #. type: Plain text
 854 #: build/C/man2/inotify_add_watch.2:97
 855 msgid "I<pathname> points outside of the process's accessible address space."
 856 msgstr ""
 857
 858 #. type: TP
 859 #: build/C/man2/inotify_add_watch.2:97 build/C/man2/inotify_init.2:76 build/C/man2/inotify_rm_watch.2:59
 860 #, no-wrap
 861 msgid "B<EINVAL>"
 862 msgstr ""
 863
 864 #. type: Plain text
 865 #: build/C/man2/inotify_add_watch.2:102
 866 msgid ""
 867 "The given event mask contains no valid events; or I<fd> is not an inotify "
 868 "file descriptor."
 869 msgstr ""
 870
 871 #. type: TP
 872 #: build/C/man2/inotify_add_watch.2:102
 873 #, no-wrap
 874 msgid "B<ENOENT>"
 875 msgstr ""
 876
 877 #. type: Plain text
 878 #: build/C/man2/inotify_add_watch.2:107
 879 msgid ""
 880 "A directory component in I<pathname> does not exist or is a dangling "
 881 "symbolic link."
 882 msgstr ""
 883
 884 #. type: TP
 885 #: build/C/man2/inotify_add_watch.2:107 build/C/man2/inotify_init.2:87
 886 #, no-wrap
 887 msgid "B<ENOMEM>"
 888 msgstr ""
 889
 890 #. type: Plain text
 891 #: build/C/man2/inotify_add_watch.2:110
 892 msgid "Insufficient kernel memory was available."
 893 msgstr ""
 894
 895 #. type: TP
 896 #: build/C/man2/inotify_add_watch.2:110
 897 #, no-wrap
 898 msgid "B<ENOSPC>"
 899 msgstr ""
 900
 901 #. type: Plain text
 902 #: build/C/man2/inotify_add_watch.2:114
 903 msgid ""
 904 "The user limit on the total number of inotify watches was reached or the "
 905 "kernel failed to allocate a needed resource."
 906 msgstr ""
 907
 908 #. type: Plain text
 909 #: build/C/man2/inotify_add_watch.2:116 build/C/man2/inotify_rm_watch.2:68
 910 msgid "Inotify was merged into the 2.6.13 Linux kernel."
 911 msgstr ""
 912
 913 #. type: Plain text
 914 #: build/C/man2/inotify_add_watch.2:118 build/C/man2/inotify_rm_watch.2:70
 915 msgid "This system call is Linux-specific."
 916 msgstr ""
 917
 918 #. type: Plain text
 919 #: build/C/man2/inotify_add_watch.2:122
 920 msgid "B<inotify_init>(2), B<inotify_rm_watch>(2), B<inotify>(7)"
 921 msgstr ""
 922
 923 #. type: TH
 924 #: build/C/man2/inotify_init.2:28
 925 #, no-wrap
 926 msgid "INOTIFY_INIT"
 927 msgstr ""
 928
 929 #. type: TH
 930 #: build/C/man2/inotify_init.2:28
 931 #, no-wrap
 932 msgid "2012-05-04"
 933 msgstr ""
 934
 935 #. type: Plain text
 936 #: build/C/man2/inotify_init.2:31
 937 msgid "inotify_init, inotify_init1 - initialize an inotify instance"
 938 msgstr ""
 939
 940 #. type: Plain text
 941 #: build/C/man2/inotify_init.2:34
 942 #, no-wrap
 943 msgid "B<#include E<lt>sys/inotify.hE<gt>>\n"
 944 msgstr ""
 945
 946 #. type: Plain text
 947 #: build/C/man2/inotify_init.2:37
 948 #, no-wrap
 949 msgid ""
 950 "B<int inotify_init(void);>\n"
 951 "B<int inotify_init1(int >I<flags>B<);>\n"
 952 msgstr ""
 953
 954 #. type: Plain text
 955 #: build/C/man2/inotify_init.2:42
 956 msgid ""
 957 "B<inotify_init>()  initializes a new inotify instance and returns a file "
 958 "descriptor associated with a new inotify event queue."
 959 msgstr ""
 960
 961 #. type: Plain text
 962 #: build/C/man2/inotify_init.2:52
 963 msgid ""
 964 "If I<flags> is 0, then B<inotify_init1>()  is the same as "
 965 "B<inotify_init>().  The following values can be bitwise ORed in I<flags> to "
 966 "obtain different behavior:"
 967 msgstr ""
 968
 969 #. type: TP
 970 #: build/C/man2/inotify_init.2:52
 971 #, no-wrap
 972 msgid "B<IN_NONBLOCK>"
 973 msgstr ""
 974
 975 #. type: Plain text
 976 #: build/C/man2/inotify_init.2:60
 977 msgid ""
 978 "Set the B<O_NONBLOCK> file status flag on the new open file description.  "
 979 "Using this flag saves extra calls to B<fcntl>(2)  to achieve the same "
 980 "result."
 981 msgstr ""
 982
 983 #. type: TP
 984 #: build/C/man2/inotify_init.2:60
 985 #, no-wrap
 986 msgid "B<IN_CLOEXEC>"
 987 msgstr ""
 988
 989 #. type: Plain text
 990 #: build/C/man2/inotify_init.2:70
 991 msgid ""
 992 "Set the close-on-exec (B<FD_CLOEXEC>)  flag on the new file descriptor.  See "
 993 "the description of the B<O_CLOEXEC> flag in B<open>(2)  for reasons why this "
 994 "may be useful."
 995 msgstr ""
 996
 997 #. type: Plain text
 998 #: build/C/man2/inotify_init.2:75
 999 msgid ""
1000 "On success, these system calls return a new file descriptor.  On error, -1 "
1001 "is returned, and I<errno> is set to indicate the error."
1002 msgstr ""
1003
1004 #. type: Plain text
1005 #: build/C/man2/inotify_init.2:81
1006 msgid "(B<inotify_init1>())  An invalid value was specified in I<flags>."
1007 msgstr ""
1008
1009 #. type: TP
1010 #: build/C/man2/inotify_init.2:81
1011 #, no-wrap
1012 msgid "B<EMFILE>"
1013 msgstr ""
1014
1015 #. type: Plain text
1016 #: build/C/man2/inotify_init.2:84
1017 msgid "The user limit on the total number of inotify instances has been reached."
1018 msgstr ""
1019
1020 #. type: TP
1021 #: build/C/man2/inotify_init.2:84
1022 #, no-wrap
1023 msgid "B<ENFILE>"
1024 msgstr ""
1025
1026 #. type: Plain text
1027 #: build/C/man2/inotify_init.2:87
1028 msgid "The system limit on the total number of file descriptors has been reached."
1029 msgstr ""
1030
1031 #. type: Plain text
1032 #: build/C/man2/inotify_init.2:90
1033 msgid "Insufficient kernel memory is available."
1034 msgstr ""
1035
1036 #. type: Plain text
1037 #: build/C/man2/inotify_init.2:97
1038 msgid ""
1039 "B<inotify_init>()  first appeared in Linux 2.6.13; library support was added "
1040 "to glibc in version 2.4.  B<inotify_init1>()  was added in Linux 2.6.27; "
1041 "library support was added to glibc in version 2.9."
1042 msgstr ""
1043
1044 #. type: Plain text
1045 #: build/C/man2/inotify_init.2:99
1046 msgid "These system calls are Linux-specific."
1047 msgstr ""
1048
1049 #. type: Plain text
1050 #: build/C/man2/inotify_init.2:103
1051 msgid "B<inotify_add_watch>(2), B<inotify_rm_watch>(2), B<inotify>(7)"
1052 msgstr ""
1053
1054 #. type: TH
1055 #: build/C/man2/inotify_rm_watch.2:27
1056 #, no-wrap
1057 msgid "INOTIFY_RM_WATCH"
1058 msgstr ""
1059
1060 #. type: TH
1061 #: build/C/man2/inotify_rm_watch.2:27
1062 #, no-wrap
1063 msgid "2010-10-15"
1064 msgstr ""
1065
1066 #. type: Plain text
1067 #: build/C/man2/inotify_rm_watch.2:30
1068 msgid "inotify_rm_watch - remove an existing watch from an inotify instance"
1069 msgstr ""
1070
1071 #.  Before glibc 2.10, the second argument was types as uint32_t.
1072 #.  http://sources.redhat.com/bugzilla/show_bug.cgi?id=7040
1073 #. type: Plain text
1074 #: build/C/man2/inotify_rm_watch.2:36
1075 msgid "B<int inotify_rm_watch(int >I<fd>B<, int >I<wd>B<);>"
1076 msgstr ""
1077
1078 #. type: Plain text
1079 #: build/C/man2/inotify_rm_watch.2:42
1080 msgid ""
1081 "B<inotify_rm_watch>()  removes the watch associated with the watch "
1082 "descriptor I<wd> from the inotify instance associated with the file "
1083 "descriptor I<fd>."
1084 msgstr ""
1085
1086 #. type: Plain text
1087 #: build/C/man2/inotify_rm_watch.2:48
1088 msgid ""
1089 "Removing a watch causes an B<IN_IGNORED> event to be generated for this "
1090 "watch descriptor.  (See B<inotify>(7).)"
1091 msgstr ""
1092
1093 #. type: Plain text
1094 #: build/C/man2/inotify_rm_watch.2:54
1095 msgid ""
1096 "On success, B<inotify_rm_watch>()  returns zero, or -1 if an error occurred "
1097 "(in which case, I<errno> is set appropriately)."
1098 msgstr ""
1099
1100 #. type: Plain text
1101 #: build/C/man2/inotify_rm_watch.2:59
1102 msgid "I<fd> is not a valid file descriptor."
1103 msgstr ""
1104
1105 #. type: Plain text
1106 #: build/C/man2/inotify_rm_watch.2:66
1107 msgid ""
1108 "The watch descriptor I<wd> is not valid; or I<fd> is not an inotify file "
1109 "descriptor."
1110 msgstr ""
1111
1112 #. type: Plain text
1113 #: build/C/man2/inotify_rm_watch.2:74
1114 msgid "B<inotify_add_watch>(2), B<inotify_init>(2), B<inotify>(7)"
1115 msgstr ""