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-05-01 04:38+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 "2012-04-26"
  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 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:167
 206 #, no-wrap
 207 msgid "inotify events"
 208 msgstr ""
 209
 210 #. type: Plain text
 211 #: build/C/man7/inotify.7:187
 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:190
 222 #, no-wrap
 223 msgid "B<IN_ACCESS>"
 224 msgstr ""
 225
 226 #. type: Plain text
 227 #: build/C/man7/inotify.7:193
 228 msgid "File was accessed (read) (*)."
 229 msgstr ""
 230
 231 #. type: TP
 232 #: build/C/man7/inotify.7:193
 233 #, no-wrap
 234 msgid "B<IN_ATTRIB>"
 235 msgstr ""
 236
 237 #. type: Plain text
 238 #: build/C/man7/inotify.7:197
 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:197
 246 #, no-wrap
 247 msgid "B<IN_CLOSE_WRITE>"
 248 msgstr ""
 249
 250 #. type: Plain text
 251 #: build/C/man7/inotify.7:200
 252 msgid "File opened for writing was closed (*)."
 253 msgstr ""
 254
 255 #. type: TP
 256 #: build/C/man7/inotify.7:200
 257 #, no-wrap
 258 msgid "B<IN_CLOSE_NOWRITE>"
 259 msgstr ""
 260
 261 #. type: Plain text
 262 #: build/C/man7/inotify.7:203
 263 msgid "File not opened for writing was closed (*)."
 264 msgstr ""
 265
 266 #. type: TP
 267 #: build/C/man7/inotify.7:203
 268 #, no-wrap
 269 msgid "B<IN_CREATE>"
 270 msgstr ""
 271
 272 #. type: Plain text
 273 #: build/C/man7/inotify.7:206
 274 msgid "File/directory created in watched directory (*)."
 275 msgstr ""
 276
 277 #. type: TP
 278 #: build/C/man7/inotify.7:206
 279 #, no-wrap
 280 msgid "B<IN_DELETE>"
 281 msgstr ""
 282
 283 #. type: Plain text
 284 #: build/C/man7/inotify.7:209
 285 msgid "File/directory deleted from watched directory (*)."
 286 msgstr ""
 287
 288 #. type: TP
 289 #: build/C/man7/inotify.7:209
 290 #, no-wrap
 291 msgid "B<IN_DELETE_SELF>"
 292 msgstr ""
 293
 294 #. type: Plain text
 295 #: build/C/man7/inotify.7:212
 296 msgid "Watched file/directory was itself deleted."
 297 msgstr ""
 298
 299 #. type: TP
 300 #: build/C/man7/inotify.7:212
 301 #, no-wrap
 302 msgid "B<IN_MODIFY>"
 303 msgstr ""
 304
 305 #. type: Plain text
 306 #: build/C/man7/inotify.7:215
 307 msgid "File was modified (*)."
 308 msgstr ""
 309
 310 #. type: TP
 311 #: build/C/man7/inotify.7:215
 312 #, no-wrap
 313 msgid "B<IN_MOVE_SELF>"
 314 msgstr ""
 315
 316 #. type: Plain text
 317 #: build/C/man7/inotify.7:218
 318 msgid "Watched file/directory was itself moved."
 319 msgstr ""
 320
 321 #. type: TP
 322 #: build/C/man7/inotify.7:218
 323 #, no-wrap
 324 msgid "B<IN_MOVED_FROM>"
 325 msgstr ""
 326
 327 #. type: Plain text
 328 #: build/C/man7/inotify.7:221
 329 msgid "File moved out of watched directory (*)."
 330 msgstr ""
 331
 332 #. type: TP
 333 #: build/C/man7/inotify.7:221
 334 #, no-wrap
 335 msgid "B<IN_MOVED_TO>"
 336 msgstr ""
 337
 338 #. type: Plain text
 339 #: build/C/man7/inotify.7:224
 340 msgid "File moved into watched directory (*)."
 341 msgstr ""
 342
 343 #. type: TP
 344 #: build/C/man7/inotify.7:224
 345 #, no-wrap
 346 msgid "B<IN_OPEN>"
 347 msgstr ""
 348
 349 #. type: Plain text
 350 #: build/C/man7/inotify.7:227
 351 msgid "File was opened (*)."
 352 msgstr ""
 353
 354 #. type: Plain text
 355 #: build/C/man7/inotify.7:237
 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:245
 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:254
 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:259
 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:262
 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:265
 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:265
 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:281
 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:281
 419 #, no-wrap
 420 msgid "B<IN_MASK_ADD>"
 421 msgstr ""
 422
 423 #. type: Plain text
 424 #: build/C/man7/inotify.7:285
 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:285
 432 #, no-wrap
 433 msgid "B<IN_ONESHOT>"
 434 msgstr ""
 435
 436 #. type: Plain text
 437 #: build/C/man7/inotify.7:289
 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:289
 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:292
 449 msgid "Only watch I<pathname> if it is a directory."
 450 msgstr ""
 451
 452 #. type: Plain text
 453 #: build/C/man7/inotify.7:299
 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:302
 459 #, no-wrap
 460 msgid "B<IN_IGNORED>"
 461 msgstr ""
 462
 463 #. type: Plain text
 464 #: build/C/man7/inotify.7:306
 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:306
 472 #, no-wrap
 473 msgid "B<IN_ISDIR>"
 474 msgstr ""
 475
 476 #. type: Plain text
 477 #: build/C/man7/inotify.7:309
 478 msgid "Subject of this event is a directory."
 479 msgstr ""
 480
 481 #. type: TP
 482 #: build/C/man7/inotify.7:309
 483 #, no-wrap
 484 msgid "B<IN_Q_OVERFLOW>"
 485 msgstr ""
 486
 487 #. type: Plain text
 488 #: build/C/man7/inotify.7:312
 489 msgid "Event queue overflowed (I<wd> is -1 for this event)."
 490 msgstr ""
 491
 492 #. type: TP
 493 #: build/C/man7/inotify.7:312
 494 #, no-wrap
 495 msgid "B<IN_UNMOUNT>"
 496 msgstr ""
 497
 498 #. type: Plain text
 499 #: build/C/man7/inotify.7:315
 500 msgid "File system containing watched object was unmounted."
 501 msgstr ""
 502
 503 #. type: SS
 504 #: build/C/man7/inotify.7:317
 505 #, no-wrap
 506 msgid "/proc interfaces"
 507 msgstr ""
 508
 509 #. type: Plain text
 510 #: build/C/man7/inotify.7:320
 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:320
 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:329
 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:329
 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:333
 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:333
 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:337
 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:337 build/C/man2/inotify_add_watch.2:115 build/C/man2/inotify_init.2:91 build/C/man2/inotify_rm_watch.2:67
 559 #, no-wrap
 560 msgid "VERSIONS"
 561 msgstr ""
 562
 563 #. type: Plain text
 564 #: build/C/man7/inotify.7:345
 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:345 build/C/man2/inotify_add_watch.2:117 build/C/man2/inotify_init.2:96 build/C/man2/inotify_rm_watch.2:69
 573 #, no-wrap
 574 msgid "CONFORMING TO"
 575 msgstr ""
 576
 577 #. type: Plain text
 578 #: build/C/man7/inotify.7:347
 579 msgid "The inotify API is Linux-specific."
 580 msgstr ""
 581
 582 #. type: SH
 583 #: build/C/man7/inotify.7:347
 584 #, no-wrap
 585 msgid "NOTES"
 586 msgstr ""
 587
 588 #. type: Plain text
 589 #: build/C/man7/inotify.7:354
 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:383
 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:393
 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:399
 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:405
 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:405
 635 #, no-wrap
 636 msgid "Limitations and caveats"
 637 msgstr ""
 638
 639 #. type: Plain text
 640 #: build/C/man7/inotify.7:410
 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:413
 649 msgid ""
 650 "The inotify API provides no information about the user or process that "
 651 "triggered the inotify event."
 652 msgstr ""
 653
 654 #. type: Plain text
 655 #: build/C/man7/inotify.7:418
 656 msgid ""
 657 "Note that the event queue can overflow.  In this case, events are lost.  "
 658 "Robust applications should handle the possibility of lost events gracefully."
 659 msgstr ""
 660
 661 #. type: Plain text
 662 #: build/C/man7/inotify.7:422
 663 msgid ""
 664 "The inotify API identifies affected files by filename.  However, by the time "
 665 "an application processes an inotify event, the filename may already have "
 666 "been deleted or renamed."
 667 msgstr ""
 668
 669 #. type: Plain text
 670 #: build/C/man7/inotify.7:429
 671 msgid ""
 672 "If monitoring an entire directory subtree, and a new subdirectory is created "
 673 "in that tree, be aware that by the time you create a watch for the new "
 674 "subdirectory, new files may already have been created in the subdirectory.  "
 675 "Therefore, you may want to scan the contents of the subdirectory immediately "
 676 "after adding the watch."
 677 msgstr ""
 678
 679 #. type: SH
 680 #: build/C/man7/inotify.7:429
 681 #, no-wrap
 682 msgid "BUGS"
 683 msgstr ""
 684
 685 #. type: Plain text
 686 #: build/C/man7/inotify.7:434
 687 msgid "In kernels before 2.6.16, the B<IN_ONESHOT> I<mask> flag does not work."
 688 msgstr ""
 689
 690 #. type: Plain text
 691 #: build/C/man7/inotify.7:442
 692 msgid ""
 693 "Before kernel 2.6.25, the kernel code that was intended to coalesce "
 694 "successive identical events (i.e., the two most recent events could "
 695 "potentially be coalesced if the older had not yet been read)  instead "
 696 "checked if the most recent event could be coalesced with the I<oldest> "
 697 "unread event."
 698 msgstr ""
 699
 700 #. type: SH
 701 #: build/C/man7/inotify.7:442 build/C/man2/inotify_add_watch.2:119 build/C/man2/inotify_init.2:98 build/C/man2/inotify_rm_watch.2:71
 702 #, no-wrap
 703 msgid "SEE ALSO"
 704 msgstr ""
 705
 706 #. type: Plain text
 707 #: build/C/man7/inotify.7:450
 708 msgid ""
 709 "B<inotify_add_watch>(2), B<inotify_init>(2), B<inotify_init1>(2), "
 710 "B<inotify_rm_watch>(2), B<read>(2), B<stat>(2), "
 711 "I<Documentation/filesystems/inotify.txt>."
 712 msgstr ""
 713
 714 #. type: SH
 715 #: build/C/man7/inotify.7:450 build/C/man2/inotify_add_watch.2:123 build/C/man2/inotify_init.2:102 build/C/man2/inotify_rm_watch.2:75
 716 #, no-wrap
 717 msgid "COLOPHON"
 718 msgstr ""
 719
 720 #. type: Plain text
 721 #: build/C/man7/inotify.7:457 build/C/man2/inotify_add_watch.2:130 build/C/man2/inotify_init.2:109 build/C/man2/inotify_rm_watch.2:82
 722 msgid ""
 723 "This page is part of release 3.40 of the Linux I<man-pages> project.  A "
 724 "description of the project, and information about reporting bugs, can be "
 725 "found at http://www.kernel.org/doc/man-pages/."
 726 msgstr ""
 727
 728 #. type: TH
 729 #: build/C/man2/inotify_add_watch.2:29
 730 #, no-wrap
 731 msgid "INOTIFY_ADD_WATCH"
 732 msgstr ""
 733
 734 #. type: TH
 735 #: build/C/man2/inotify_add_watch.2:29
 736 #, no-wrap
 737 msgid "2010-10-20"
 738 msgstr ""
 739
 740 #. type: Plain text
 741 #: build/C/man2/inotify_add_watch.2:32
 742 msgid "inotify_add_watch - add a watch to an initialized inotify instance"
 743 msgstr ""
 744
 745 #. type: SH
 746 #: build/C/man2/inotify_add_watch.2:32 build/C/man2/inotify_init.2:32 build/C/man2/inotify_rm_watch.2:31
 747 #, no-wrap
 748 msgid "SYNOPSIS"
 749 msgstr ""
 750
 751 #. type: Plain text
 752 #: build/C/man2/inotify_add_watch.2:34 build/C/man2/inotify_rm_watch.2:33
 753 msgid "B<#include E<lt>sys/inotify.hE<gt>>"
 754 msgstr ""
 755
 756 #. type: Plain text
 757 #: build/C/man2/inotify_add_watch.2:36
 758 msgid ""
 759 "B<int inotify_add_watch(int >I<fd>B<, const char *>I<pathname>B<, uint32_t "
 760 ">I<mask>B<);>"
 761 msgstr ""
 762
 763 #. type: Plain text
 764 #: build/C/man2/inotify_add_watch.2:55
 765 msgid ""
 766 "B<inotify_add_watch>()  adds a new watch, or modifies an existing watch, for "
 767 "the file whose location is specified in I<pathname>; the caller must have "
 768 "read permission for this file.  The I<fd> argument is a file descriptor "
 769 "referring to the inotify instance whose watch list is to be modified.  The "
 770 "events to be monitored for I<pathname> are specified in the I<mask> bit-mask "
 771 "argument.  See B<inotify>(7)  for a description of the bits that can be set "
 772 "in I<mask>."
 773 msgstr ""
 774
 775 #. type: Plain text
 776 #: build/C/man2/inotify_add_watch.2:69
 777 msgid ""
 778 "A successful call to B<inotify_add_watch>()  returns the unique watch "
 779 "descriptor associated with I<pathname> for this inotify instance.  If "
 780 "I<pathname> was not previously being watched by this inotify instance, then "
 781 "the watch descriptor is newly allocated.  If I<pathname> was already being "
 782 "watched, then the descriptor for the existing watch is returned."
 783 msgstr ""
 784
 785 #. type: Plain text
 786 #: build/C/man2/inotify_add_watch.2:80
 787 msgid ""
 788 "The watch descriptor is returned by later B<read>(2)s from the inotify file "
 789 "descriptor.  These reads fetch I<inotify_event> structures (see "
 790 "B<inotify>(7))  indicating file system events; the watch descriptor inside "
 791 "this structure identifies the object for which the event occurred."
 792 msgstr ""
 793
 794 #. type: SH
 795 #: build/C/man2/inotify_add_watch.2:80 build/C/man2/inotify_init.2:71 build/C/man2/inotify_rm_watch.2:49
 796 #, no-wrap
 797 msgid "RETURN VALUE"
 798 msgstr ""
 799
 800 #. type: Plain text
 801 #: build/C/man2/inotify_add_watch.2:87
 802 msgid ""
 803 "On success, B<inotify_add_watch>()  returns a nonnegative watch descriptor.  "
 804 "On error -1 is returned and I<errno> is set appropriately."
 805 msgstr ""
 806
 807 #. type: SH
 808 #: build/C/man2/inotify_add_watch.2:87 build/C/man2/inotify_init.2:76 build/C/man2/inotify_rm_watch.2:55
 809 #, no-wrap
 810 msgid "ERRORS"
 811 msgstr ""
 812
 813 #. type: TP
 814 #: build/C/man2/inotify_add_watch.2:88
 815 #, no-wrap
 816 msgid "B<EACCES>"
 817 msgstr ""
 818
 819 #. type: Plain text
 820 #: build/C/man2/inotify_add_watch.2:91
 821 msgid "Read access to the given file is not permitted."
 822 msgstr ""
 823
 824 #. type: TP
 825 #: build/C/man2/inotify_add_watch.2:91 build/C/man2/inotify_rm_watch.2:56
 826 #, no-wrap
 827 msgid "B<EBADF>"
 828 msgstr ""
 829
 830 #. type: Plain text
 831 #: build/C/man2/inotify_add_watch.2:94
 832 msgid "The given file descriptor is not valid."
 833 msgstr ""
 834
 835 #. type: TP
 836 #: build/C/man2/inotify_add_watch.2:94
 837 #, no-wrap
 838 msgid "B<EFAULT>"
 839 msgstr ""
 840
 841 #. type: Plain text
 842 #: build/C/man2/inotify_add_watch.2:98
 843 msgid "I<pathname> points outside of the process's accessible address space."
 844 msgstr ""
 845
 846 #. type: TP
 847 #: build/C/man2/inotify_add_watch.2:98 build/C/man2/inotify_init.2:77 build/C/man2/inotify_rm_watch.2:60
 848 #, no-wrap
 849 msgid "B<EINVAL>"
 850 msgstr ""
 851
 852 #. type: Plain text
 853 #: build/C/man2/inotify_add_watch.2:103
 854 msgid ""
 855 "The given event mask contains no valid events; or I<fd> is not an inotify "
 856 "file descriptor."
 857 msgstr ""
 858
 859 #. type: TP
 860 #: build/C/man2/inotify_add_watch.2:103
 861 #, no-wrap
 862 msgid "B<ENOENT>"
 863 msgstr ""
 864
 865 #. type: Plain text
 866 #: build/C/man2/inotify_add_watch.2:108
 867 msgid ""
 868 "A directory component in I<pathname> does not exist or is a dangling "
 869 "symbolic link."
 870 msgstr ""
 871
 872 #. type: TP
 873 #: build/C/man2/inotify_add_watch.2:108 build/C/man2/inotify_init.2:88
 874 #, no-wrap
 875 msgid "B<ENOMEM>"
 876 msgstr ""
 877
 878 #. type: Plain text
 879 #: build/C/man2/inotify_add_watch.2:111
 880 msgid "Insufficient kernel memory was available."
 881 msgstr ""
 882
 883 #. type: TP
 884 #: build/C/man2/inotify_add_watch.2:111
 885 #, no-wrap
 886 msgid "B<ENOSPC>"
 887 msgstr ""
 888
 889 #. type: Plain text
 890 #: build/C/man2/inotify_add_watch.2:115
 891 msgid ""
 892 "The user limit on the total number of inotify watches was reached or the "
 893 "kernel failed to allocate a needed resource."
 894 msgstr ""
 895
 896 #. type: Plain text
 897 #: build/C/man2/inotify_add_watch.2:117 build/C/man2/inotify_rm_watch.2:69
 898 msgid "Inotify was merged into the 2.6.13 Linux kernel."
 899 msgstr ""
 900
 901 #. type: Plain text
 902 #: build/C/man2/inotify_add_watch.2:119 build/C/man2/inotify_rm_watch.2:71
 903 msgid "This system call is Linux-specific."
 904 msgstr ""
 905
 906 #. type: Plain text
 907 #: build/C/man2/inotify_add_watch.2:123
 908 msgid "B<inotify_init>(2), B<inotify_rm_watch>(2), B<inotify>(7)"
 909 msgstr ""
 910
 911 #. type: TH
 912 #: build/C/man2/inotify_init.2:29
 913 #, no-wrap
 914 msgid "INOTIFY_INIT"
 915 msgstr ""
 916
 917 #. type: TH
 918 #: build/C/man2/inotify_init.2:29
 919 #, no-wrap
 920 msgid "2008-10-10"
 921 msgstr ""
 922
 923 #. type: Plain text
 924 #: build/C/man2/inotify_init.2:32
 925 msgid "inotify_init, inotify_init1 - initialize an inotify instance"
 926 msgstr ""
 927
 928 #. type: Plain text
 929 #: build/C/man2/inotify_init.2:35
 930 #, no-wrap
 931 msgid "B<#include E<lt>sys/inotify.hE<gt>>\n"
 932 msgstr ""
 933
 934 #. type: Plain text
 935 #: build/C/man2/inotify_init.2:38
 936 #, no-wrap
 937 msgid ""
 938 "B<int inotify_init(void);>\n"
 939 "B<int inotify_init1(int >I<flags>B<);>\n"
 940 msgstr ""
 941
 942 #. type: Plain text
 943 #: build/C/man2/inotify_init.2:43
 944 msgid ""
 945 "B<inotify_init>()  initializes a new inotify instance and returns a file "
 946 "descriptor associated with a new inotify event queue."
 947 msgstr ""
 948
 949 #. type: Plain text
 950 #: build/C/man2/inotify_init.2:53
 951 msgid ""
 952 "If I<flags> is 0, then B<inotify_init1>()  is the same as "
 953 "B<inotify_init>().  The following values can be bitwise ORed in I<flags> to "
 954 "obtain different behavior:"
 955 msgstr ""
 956
 957 #. type: TP
 958 #: build/C/man2/inotify_init.2:53
 959 #, no-wrap
 960 msgid "B<IN_NONBLOCK>"
 961 msgstr ""
 962
 963 #. type: Plain text
 964 #: build/C/man2/inotify_init.2:61
 965 msgid ""
 966 "Set the B<O_NONBLOCK> file status flag on the new open file description.  "
 967 "Using this flag saves extra calls to B<fcntl>(2)  to achieve the same "
 968 "result."
 969 msgstr ""
 970
 971 #. type: TP
 972 #: build/C/man2/inotify_init.2:61
 973 #, no-wrap
 974 msgid "B<IN_CLOEXEC>"
 975 msgstr ""
 976
 977 #. type: Plain text
 978 #: build/C/man2/inotify_init.2:71
 979 msgid ""
 980 "Set the close-on-exec (B<FD_CLOEXEC>)  flag on the new file descriptor.  See "
 981 "the description of the B<O_CLOEXEC> flag in B<open>(2)  for reasons why this "
 982 "may be useful."
 983 msgstr ""
 984
 985 #. type: Plain text
 986 #: build/C/man2/inotify_init.2:76
 987 msgid ""
 988 "On success, these system calls return a new file descriptor.  On error, -1 "
 989 "is returned, and I<errno> is set to indicate the error."
 990 msgstr ""
 991
 992 #. type: Plain text
 993 #: build/C/man2/inotify_init.2:82
 994 msgid "(B<inotify_init1>())  An invalid value was specified in I<flags>."
 995 msgstr ""
 996
 997 #. type: TP
 998 #: build/C/man2/inotify_init.2:82
 999 #, no-wrap
1000 msgid "B<EMFILE>"
1001 msgstr ""
1002
1003 #. type: Plain text
1004 #: build/C/man2/inotify_init.2:85
1005 msgid "The user limit on the total number of inotify instances has been reached."
1006 msgstr ""
1007
1008 #. type: TP
1009 #: build/C/man2/inotify_init.2:85
1010 #, no-wrap
1011 msgid "B<ENFILE>"
1012 msgstr ""
1013
1014 #. type: Plain text
1015 #: build/C/man2/inotify_init.2:88
1016 msgid "The system limit on the total number of file descriptors has been reached."
1017 msgstr ""
1018
1019 #. type: Plain text
1020 #: build/C/man2/inotify_init.2:91
1021 msgid "Insufficient kernel memory is available."
1022 msgstr ""
1023
1024 #. type: Plain text
1025 #: build/C/man2/inotify_init.2:96
1026 msgid ""
1027 "B<inotify_init>()  first appeared in Linux 2.6.13.  B<inotify_init1>()  was "
1028 "added in Linux 2.6.27."
1029 msgstr ""
1030
1031 #. type: Plain text
1032 #: build/C/man2/inotify_init.2:98
1033 msgid "These system calls are Linux-specific."
1034 msgstr ""
1035
1036 #. type: Plain text
1037 #: build/C/man2/inotify_init.2:102
1038 msgid "B<inotify_add_watch>(2), B<inotify_rm_watch>(2), B<inotify>(7)"
1039 msgstr ""
1040
1041 #. type: TH
1042 #: build/C/man2/inotify_rm_watch.2:28
1043 #, no-wrap
1044 msgid "INOTIFY_RM_WATCH"
1045 msgstr ""
1046
1047 #. type: TH
1048 #: build/C/man2/inotify_rm_watch.2:28
1049 #, no-wrap
1050 msgid "2010-10-15"
1051 msgstr ""
1052
1053 #. type: Plain text
1054 #: build/C/man2/inotify_rm_watch.2:31
1055 msgid "inotify_rm_watch - remove an existing watch from an inotify instance"
1056 msgstr ""
1057
1058 #.  Before glibc 2.10, the second argument was types as uint32_t.
1059 #.  http://sources.redhat.com/bugzilla/show_bug.cgi?id=7040
1060 #. type: Plain text
1061 #: build/C/man2/inotify_rm_watch.2:37
1062 msgid "B<int inotify_rm_watch(int >I<fd>B<, int >I<wd>B<);>"
1063 msgstr ""
1064
1065 #. type: Plain text
1066 #: build/C/man2/inotify_rm_watch.2:43
1067 msgid ""
1068 "B<inotify_rm_watch>()  removes the watch associated with the watch "
1069 "descriptor I<wd> from the inotify instance associated with the file "
1070 "descriptor I<fd>."
1071 msgstr ""
1072
1073 #. type: Plain text
1074 #: build/C/man2/inotify_rm_watch.2:49
1075 msgid ""
1076 "Removing a watch causes an B<IN_IGNORED> event to be generated for this "
1077 "watch descriptor.  (See B<inotify>(7).)"
1078 msgstr ""
1079
1080 #. type: Plain text
1081 #: build/C/man2/inotify_rm_watch.2:55
1082 msgid ""
1083 "On success, B<inotify_rm_watch>()  returns zero, or -1 if an error occurred "
1084 "(in which case, I<errno> is set appropriately)."
1085 msgstr ""
1086
1087 #. type: Plain text
1088 #: build/C/man2/inotify_rm_watch.2:60
1089 msgid "I<fd> is not a valid file descriptor."
1090 msgstr ""
1091
1092 #. type: Plain text
1093 #: build/C/man2/inotify_rm_watch.2:67
1094 msgid ""
1095 "The watch descriptor I<wd> is not valid; or I<fd> is not an inotify file "
1096 "descriptor."
1097 msgstr ""
1098
1099 #. type: Plain text
1100 #: build/C/man2/inotify_rm_watch.2:75
1101 msgid "B<inotify_add_watch>(2), B<inotify_init>(2), B<inotify>(7)"
1102 msgstr ""