Index: bfd/doc/cache.texi |
diff --git a/bfd/doc/cache.texi b/bfd/doc/cache.texi |
deleted file mode 100644 |
index 5820a2a6a1d376e5f40a756bb4bec527c3f75933..0000000000000000000000000000000000000000 |
--- a/bfd/doc/cache.texi |
+++ /dev/null |
@@ -1,65 +0,0 @@ |
-@section File caching |
-The file caching mechanism is embedded within BFD and allows |
-the application to open as many BFDs as it wants without |
-regard to the underlying operating system's file descriptor |
-limit (often as low as 20 open files). The module in |
-@code{cache.c} maintains a least recently used list of |
-@code{BFD_CACHE_MAX_OPEN} files, and exports the name |
-@code{bfd_cache_lookup}, which runs around and makes sure that |
-the required BFD is open. If not, then it chooses a file to |
-close, closes it and opens the one wanted, returning its file |
-handle. |
- |
-@subsection Caching functions |
- |
- |
-@findex bfd_cache_init |
-@subsubsection @code{bfd_cache_init} |
-@strong{Synopsis} |
-@example |
-bfd_boolean bfd_cache_init (bfd *abfd); |
-@end example |
-@strong{Description}@* |
-Add a newly opened BFD to the cache. |
- |
-@findex bfd_cache_close |
-@subsubsection @code{bfd_cache_close} |
-@strong{Synopsis} |
-@example |
-bfd_boolean bfd_cache_close (bfd *abfd); |
-@end example |
-@strong{Description}@* |
-Remove the BFD @var{abfd} from the cache. If the attached file is open, |
-then close it too. |
- |
-@strong{Returns}@* |
-@code{FALSE} is returned if closing the file fails, @code{TRUE} is |
-returned if all is well. |
- |
-@findex bfd_cache_close_all |
-@subsubsection @code{bfd_cache_close_all} |
-@strong{Synopsis} |
-@example |
-bfd_boolean bfd_cache_close_all (void); |
-@end example |
-@strong{Description}@* |
-Remove all BFDs from the cache. If the attached file is open, |
-then close it too. |
- |
-@strong{Returns}@* |
-@code{FALSE} is returned if closing one of the file fails, @code{TRUE} is |
-returned if all is well. |
- |
-@findex bfd_open_file |
-@subsubsection @code{bfd_open_file} |
-@strong{Synopsis} |
-@example |
-FILE* bfd_open_file (bfd *abfd); |
-@end example |
-@strong{Description}@* |
-Call the OS to open a file for @var{abfd}. Return the @code{FILE *} |
-(possibly @code{NULL}) that results from this operation. Set up the |
-BFD so that future accesses know the file is open. If the @code{FILE *} |
-returned is @code{NULL}, then it won't have been put in the |
-cache, so it won't have to be removed from it. |
- |