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