| … | |
… | |
| 305 | might be supported on the current system, you would need to look at |
305 | might be supported on the current system, you would need to look at |
| 306 | \&\f(CW\*(C`ev_embeddable_backends () & ev_supported_backends ()\*(C'\fR, likewise for |
306 | \&\f(CW\*(C`ev_embeddable_backends () & ev_supported_backends ()\*(C'\fR, likewise for |
| 307 | recommended ones. |
307 | recommended ones. |
| 308 | .Sp |
308 | .Sp |
| 309 | See the description of \f(CW\*(C`ev_embed\*(C'\fR watchers for more info. |
309 | See the description of \f(CW\*(C`ev_embed\*(C'\fR watchers for more info. |
| 310 | .IP "ev_set_allocator (void *(*cb)(void *ptr, size_t size))" 4 |
310 | .IP "ev_set_allocator (void *(*cb)(void *ptr, long size))" 4 |
| 311 | .IX Item "ev_set_allocator (void *(*cb)(void *ptr, size_t size))" |
311 | .IX Item "ev_set_allocator (void *(*cb)(void *ptr, long size))" |
| 312 | Sets the allocation function to use (the prototype and semantics are |
312 | Sets the allocation function to use (the prototype is similar \- the |
| 313 | identical to the realloc C function). It is used to allocate and free |
313 | semantics is identical \- to the realloc C function). It is used to |
| 314 | memory (no surprises here). If it returns zero when memory needs to be |
314 | allocate and free memory (no surprises here). If it returns zero when |
| 315 | allocated, the library might abort or take some potentially destructive |
315 | memory needs to be allocated, the library might abort or take some |
| 316 | action. The default is your system realloc function. |
316 | potentially destructive action. The default is your system realloc |
|
|
317 | function. |
| 317 | .Sp |
318 | .Sp |
| 318 | You could override this function in high-availability programs to, say, |
319 | You could override this function in high-availability programs to, say, |
| 319 | free some memory if it cannot allocate memory, to use a special allocator, |
320 | free some memory if it cannot allocate memory, to use a special allocator, |
| 320 | or even to sleep a while and retry until some memory is available. |
321 | or even to sleep a while and retry until some memory is available. |
| 321 | .Sp |
322 | .Sp |
| … | |
… | |
| 1382 | The path does not need to exist: changing from \*(L"path exists\*(R" to \*(L"path does |
1383 | The path does not need to exist: changing from \*(L"path exists\*(R" to \*(L"path does |
| 1383 | not exist\*(R" is a status change like any other. The condition \*(L"path does |
1384 | not exist\*(R" is a status change like any other. The condition \*(L"path does |
| 1384 | not exist\*(R" is signified by the \f(CW\*(C`st_nlink\*(C'\fR field being zero (which is |
1385 | not exist\*(R" is signified by the \f(CW\*(C`st_nlink\*(C'\fR field being zero (which is |
| 1385 | otherwise always forced to be at least one) and all the other fields of |
1386 | otherwise always forced to be at least one) and all the other fields of |
| 1386 | the stat buffer having unspecified contents. |
1387 | the stat buffer having unspecified contents. |
|
|
1388 | .PP |
|
|
1389 | The path \fIshould\fR be absolute and \fImust not\fR end in a slash. If it is |
|
|
1390 | relative and your working directory changes, the behaviour is undefined. |
| 1387 | .PP |
1391 | .PP |
| 1388 | Since there is no standard to do this, the portable implementation simply |
1392 | Since there is no standard to do this, the portable implementation simply |
| 1389 | calls \f(CW\*(C`stat (2)\*(C'\fR regularly on the path to see if it changed somehow. You |
1393 | calls \f(CW\*(C`stat (2)\*(C'\fR regularly on the path to see if it changed somehow. You |
| 1390 | can specify a recommended polling interval for this case. If you specify |
1394 | can specify a recommended polling interval for this case. If you specify |
| 1391 | a polling interval of \f(CW0\fR (highly recommended!) then a \fIsuitable, |
1395 | a polling interval of \f(CW0\fR (highly recommended!) then a \fIsuitable, |
