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