Lines Matching +full:ascii +full:. +full:d
1 .\" Copyright (c) 1992, 1993
2 .\" The Regents of the University of California. All rights reserved.
3 .\"
4 .\" This code is derived from software contributed to Berkeley by
5 .\" Casey Leedom of Lawrence Livermore National Laboratory.
6 .\"
7 .\" Redistribution and use in source and binary forms, with or without
8 .\" modification, are permitted provided that the following conditions
9 .\" are met:
10 .\" 1. Redistributions of source code must retain the above copyright
11 .\" notice, this list of conditions and the following disclaimer.
12 .\" 2. Redistributions in binary form must reproduce the above copyright
13 .\" notice, this list of conditions and the following disclaimer in the
14 .\" documentation and/or other materials provided with the distribution.
15 .\" 3. Neither the name of the University nor the names of its contributors
16 .\" may be used to endorse or promote products derived from this software
17 .\" without specific prior written permission.
18 .\"
19 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
20 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
22 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
23 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
24 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
25 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
26 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
27 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
28 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
29 .\" SUCH DAMAGE.
30 .\"
80 .Xr malloc 3 Ns \&'d
82 .Fa buf .
86 .Pa .db
89 before accessing the ASCII file.
101 .Xr free 3 Ns \&'d .
107 \-2 if a system error was encountered (could not open/read a file, etc.) also
112 comments below).
118 to the capability database.
121 .Fn cgetent .
123 .Fa ent .
128 the current entry is removed from the database.
131 must precede the database traversal.
134 call.
143 call.
144 On success 0 is returned and \-1 on failure.
153 not.
162 .Fa type .
165 is specified using any single character.
168 types).
176 found.
178 .Tn ASCII
180 (see below for capability database syntax).
187 .Fa buf .
191 .Fa num .
193 be found.
200 .Fa buf .
204 .Xr malloc 3 Ns \&'d
208 .Fa str .
213 failure).
220 character of the capability string literally.
230 .Fa db_array .
234 to the first record.
242 call.
244 returned.
246 .Xr malloc 3 Ns \&'d
248 .Fa buf .
252 comments below).
260 comments below).
261 Upon completion of database (0 return) the database is closed.
266 being used.
268 .Fn cgetset .
271 .Tn ASCII
273 text editors.
275 and are ignored.
278 are ignored.
280 lines by ending each line except the last with a `\|\e'.
283 line.
285 (capabilities).
287 characters (spaces and tabs) are ignored.
290 characters.
291 These names are used to reference records in the database.
293 a lookup tag.
302 giving four names that can be used to access the record.
311 .It name Ns Em \&T Ns value
313 .Pq Em name , \&T
319 .It name Ns Em T Ns \&@
325 Names consist of one or more characters.
328 characters and avoid use of graphics like `#', `=', `%', `@', etc.
331 associated typed values.
332 Types may be any character except a `:'.
333 Typically, graphics like `#', `=', `%', etc.\& are used.
335 number of characters and may contain any character except `:'.
337 Capability records describe a set of (name, value) bindings.
339 have multiple values bound to them.
342 .Fa types .
346 name and the type of the value.
349 string typed values, but no restriction on those types is enforced.
356 and `='.
358 presence or absence indicating truth and false values respectively.
369 capability.
375 capability may be used in a record.
378 expansion scope (i.e., where the argument is searched for) contains the
381 is declared and all subsequent files in the file array.
384 record in the search is returned.
396 from being seen.
402 definitions, or hiding following definitions via `@' capabilities.
412 type `^') and any other value bindings are hidden.
415 being defined in the capability record more.
421 old\||\|old_record\||\|an old database record:\e
427 with file1 preceding file2.
432 defined by the record extensions is added to those definitions in old.
434 tc=old is important here.
436 would take precedence.
444 .It Em name Ns \&# Ns Em number
454 .It Em name Ns \&#@
458 .It Em name Ns \&=@
464 Numeric capability values may be given in one of three numeric bases.
470 may be used to denote the extended hexadecimal digits).
473 it is interpreted as an octal number.
474 Otherwise the number is interpreted as a decimal number.
476 String capability values may contain any character.
478 .Dv ASCII
481 .Bl -column "\e\|X,X\e\|X" "(ASCII octal nnn)"
483 \e\|b, \e\|B (ASCII 010) backspace
484 \e\|t, \e\|T (ASCII 011) tab
485 \e\|n, \e\|N (ASCII 012) line feed (newline)
486 \e\|f, \e\|F (ASCII 014) form feed
487 \e\|r, \e\|R (ASCII 015) carriage return
488 \e\|e, \e\|E (ASCII 027) escape
492 \e\|nnn (ASCII octal nnn)
496 the numeric code for a character.
498 .Tn ASCII
505 .Dv NUL .
519 than 0 on failure.
524 on failure.
537 .Xr close 2 .
551 No memory to allocate.
557 Colons (`:') cannot be used in names, types, or values.
562 .Fn cgetent .
566 is not unique to the database but is rather prepended to any database used.