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