summaryrefslogtreecommitdiff
path: root/usr/src/man/man3ext/auto_ef.3ext
diff options
context:
space:
mode:
authorJason King <jason.king@joyent.com>2020-11-16 16:37:31 +0000
committerJason King <jason.king@joyent.com>2020-11-16 16:37:31 +0000
commit5ffcb7f72a2f7a214b40ea8d0ef402f68aeada38 (patch)
tree86b767ee8b3625c219d1f5438eb25530c9703534 /usr/src/man/man3ext/auto_ef.3ext
parent45f7bf1d4508f8d85c7add1bdeb9f7ea099f0ab2 (diff)
parentde0f04687a2a3fe3692d9ad1254738343bf9c4eb (diff)
downloadillumos-joyent-5ffcb7f72a2f7a214b40ea8d0ef402f68aeada38.tar.gz
[illumos-gate merge]
commit de0f04687a2a3fe3692d9ad1254738343bf9c4eb 13310 Remove auto_ef.3ext as we don't have the software commit 25befe07d3c1488cbbdecdb765cd0558e12cc364 13302 pthread_attr_get_np.3c erroneously refers to pthread_getattr_np commit 509a605d87b8005c687f8d8264f1be379620e886 13304 bhyve ioport handling bungled on reinit commit 83cd75bb2949d26e6eb38ddefc60fdeed1909643 13309 bhyve movs emulation leaks mem refcnt commit b713c91e508f40be7797bedd4ae1146ef0652625 7537 want nextboot (one time boot) support commit 09fcda9fe16a733cc35aa3156a47ef4b909251a6 13172 Port OpenZFS: zfs label bootenv should store data as nvlist commit c4ecba8aa5f13f00c2439c06af2aa1198771ee66 13025 Port OpenZFS: Add support for boot environment data to be stored in the label commit 1a2acdcd3ce765904dbf2bfc511e92d68022d100 13308 testrunner/run needs updates for python 3.9 commit 04573c73a7ab1505c46b2c4db26bfde5176dd6a5 13286 bhyve ins/outs emulation misuses %rax commit 3dfdac06b0c70e672dbe56a2f38ec05fc0254d07 13278 CTF assertion failed cmp->cm_tmap[id].cmt_map == suid commit a676209deb2ce5d0c98f331659de25e2483f8c4c 13252 ctf_update()/ctf_dwarf_convert_function() leak memory commit effb27ee30c48fe502152c38487ced379d9f8693 13247 CTF conversion fails with large files 13251 CTF conversion fails if any CU is missing DWARF data Conflicts: usr/src/test/test-runner/cmd/run usr/src/lib/libctf/common/libctf.h usr/src/lib/libctf/common/ctf_convert.c
Diffstat (limited to 'usr/src/man/man3ext/auto_ef.3ext')
-rw-r--r--usr/src/man/man3ext/auto_ef.3ext202
1 files changed, 0 insertions, 202 deletions
diff --git a/usr/src/man/man3ext/auto_ef.3ext b/usr/src/man/man3ext/auto_ef.3ext
deleted file mode 100644
index 82537dd139..0000000000
--- a/usr/src/man/man3ext/auto_ef.3ext
+++ /dev/null
@@ -1,202 +0,0 @@
-'\" te
-.\" Copyright (c) 1983 Regents of the University of California. All rights reserved. The Berkeley software License Agreement specifies the terms and conditions for redistribution. Copyright (c) 2003, Sun Microsystems, Inc. All Rights Reserved
-.TH AUTO_EF 3EXT "Sep 22, 2003"
-.SH NAME
-auto_ef, auto_ef_file, auto_ef_str, auto_ef_free, auto_ef_get_encoding,
-auto_ef_get_score \- auto encoding finder functions
-.SH SYNOPSIS
-.LP
-.nf
-cc [ \fIflag \fR... ] \fIfile\fR... \fB-lauto_ef\fR [ \fIlibrary\fR... ]
-#include <auto_ef.h>
-
-\fBsize_t\fR \fBauto_ef_file\fR(\fBauto_ef_t **\fR\fIinfo\fR, \fBconst char *\fR\fIfilename\fR, \fBint\fR \fIflags\fR);
-.fi
-
-.LP
-.nf
-\fBsize_t\fR \fBauto_ef_str\fR(\fBauto_ef_t **\fR\fIinfo\fR, \fBconst char *\fR\fIbuffer\fR, \fBsize_t\fR \fIbufsize\fR,
- \fBint\fR \fIflags\fR);
-.fi
-
-.LP
-.nf
-\fBvoid\fR \fBauto_ef_free\fR(\fBauto_ef_t *\fR\fIinfo\fR);
-.fi
-
-.LP
-.nf
-\fBchar *\fR\fBauto_ef_get_encoding\fR(\fBauto_ef_t\fR \fIinfo\fR);
-.fi
-
-.LP
-.nf
-\fBdouble\fR \fBauto_ef_get_score\fR(\fBauto_ef_t\fR \fIinfo\fR);
-.fi
-
-.SH DESCRIPTION
-.sp
-.LP
-Auto encoding finder provides functions that find the encoding of given file or
-string.
-.sp
-.LP
-The \fBauto_ef_file()\fR function examines text in the file specified with
-\fIfilename\fR and returns information on possible encodings.
-.sp
-.LP
-The \fIinfo\fR argument is a pointer to a pointer to an \fBauto_ef_t\fR, the
-location at which the pointer to the \fBauto_ef_t\fR array is stored upon
-return.
-.sp
-.LP
-The \fIflags\fR argument specifies the level of examination. Currently only one
-set of flags, exclusive each other, is available: \fBAE_LEVEL_0\fR,
-\fBAE_LEVEL_1\fR, \fBAE_LEVEL_2\fR, and \fBAE_LEVEL_3\fR. The \fBAE_LEVEL_0\fR
-level is fastest but the result can be less accurate. The \fBAE_LEVEL_3\fR
-level produces best result but can be slow. If the \fIflags\fR argument is
-unspecified, the default is \fBAE_LEVEL_0\fR. When another flag or set of flags
-are defined in the future, use the inclusive-bitwise OR operation to specify
-multiple flags.
-.sp
-.LP
-Information about encodings are stored in data type\fBauto_ef_t\fR in the order
-of possibility with the most possible encoding stored first. To examine the
-information, use the \fBauto_ef_get_encoding()\fR and \fBauto_ef_get_score()\fR
-access functions. For a list of encodings with which \fBauto_ef_file()\fR can
-examine text, see \fBauto_ef\fR(3EXT).
-.sp
-.LP
-If \fBauto_ef_file()\fR cannot determine the encoding of text, it returns 0 and
-stores \fINULL\fR at the location pointed by \fIinfo\fR.
-.sp
-.LP
-The \fBauto_ef_get_encoding()\fR function returns the name of the encoding. The
-returned string is vaild until until the location pointed to by \fIinfo\fR is
-freed with \fBauto_ef_free()\fR. Applications should not use \fBfree\fR(3C) to
-free the pointer returned by \fBauto_ef_get_encoding()\fR.
-.sp
-.LP
-The \fBauto_ef_get_score()\fR function returns the score of this encoding in
-the range between 0.0 and 1.0.
-.sp
-.LP
-The \fBauto_ef_str()\fR function is identical to \fBauto_ef_file()\fR, except
-that it examines text in the buffer specified by \fIbuffer\fR with a maximum
-size of \fIbufsize\fR bytes, instead of text in a file.
-.sp
-.LP
-The \fBauto_ef_free()\fR function frees the area allocated by
-\fBauto_ef_file()\fR or by \fBauto_ef_str()\fR, taking as its argument the
-pointer stored at the location pointed to by \fIinfo\fR.
-.SH RETURN VALUES
-.sp
-.LP
-Upon successful completion, the \fBauto_ef_file()\fR and \fBauto_ef_str()\fR
-functions return the number of possible encodings for which information is
-stored. Otherwise, \(mi1 is returned.
-.sp
-.LP
-The \fBauto_ef_get_encoding()\fR function returns the string that stores the
-encoding name.
-.sp
-.LP
-the \fBauto_ef_get_score()\fR function returns the score value for encoding the
-name with the examined text data.
-.SH ERRORS
-.sp
-.LP
-The \fBauto_ef_file()\fR and \fBauto_ef_str()\fR will fail if:
-.sp
-.ne 2
-.na
-\fB\fBEACCES\fR\fR
-.ad
-.RS 10n
-Search permission is denied on a component of the path prefix, the file exists
-and the permissions specified by mode are denied, the file does not exist and
-write permission is denied for the parent directory of the file to be created,
-or \fBlibauto_ef\fR cannot find the internal hashtable.
-.RE
-
-.sp
-.ne 2
-.na
-\fB\fBEINTR\fR\fR
-.ad
-.RS 10n
-A signal was caught during the execution.
-.RE
-
-.sp
-.ne 2
-.na
-\fB\fBENOMEM\fR\fR
-.ad
-.RS 10n
-Failed to allocate area to store the result.
-.RE
-
-.sp
-.ne 2
-.na
-\fB\fBEMFILE\fR\fR
-.ad
-.RS 10n
-Too many files descriptors are currently open in the calling process.
-.RE
-
-.sp
-.ne 2
-.na
-\fB\fBENFILE\fR\fR
-.ad
-.RS 10n
-Too many files are currently open in the system.
-.RE
-
-.SH EXAMPLES
-.LP
-\fBExample 1 \fRSpecify the array index to examine stored information.
-.sp
-.LP
-Since \fBauto_ef_file()\fR stores the array whose elements hold information on
-each possible encoding, the following example specifies the array index to
-examine the stored information.
-
-.sp
-.in +2
-.nf
-#include <auto_ef.h>
-auto_ef_t *array_info;
-size_t number;
-char *encoding;
-
-number = auto_ef_file(&array_info, filename, flags);
-encoding = auto_ef_get_encoding(array_info[0]);
-auto_ef_free(array_info);
-.fi
-.in -2
-
-.SH ATTRIBUTES
-.sp
-.LP
-See \fBattributes\fR(5) for descriptions of the following attributes:
-.sp
-
-.sp
-.TS
-box;
-c | c
-l | l .
-ATTRIBUTE TYPE ATTRIBUTE VALUE
-_
-Interface Stability Stable
-_
-MT-Level MT-Safe
-.TE
-
-.SH SEE ALSO
-.sp
-.LP
-\fBauto_ef\fR(3EXT), \fBlibauto_ef\fR(3LIB), \fBattributes\fR(5)