a6084ea0511a32194893bd20cc3e0b0c3b3b3659
[com/asn1c.git] / doc / man / enber.man.md
1 % enber(1) unber(1) counterpart
2 % Lev Walkin <vlm@lionet.info>
3 % 2016-01-23
4
5 # NAME
6
7 enber -- Convert the unber XML output back into BER
8
9 # SYNOPSIS
10
11 enber [**-n**] [**-**] [*input-filenames*...]
12
13 # DESCRIPTION
14
15 enber converts the XML-formatted files produced by `unber`(1) back into the BER format.
16 A single dash denotes the standard input.
17
18 # OPTIONS
19
20 -n
21 :   Disable input validation.
22 By default, enber performs some basic validity checks
23 against XML input.
24
25 # EXAMPLES
26
27 Decode a BER sequence and immediately encode it back
28
29 > unber **-p** *filename.ber* | enber **-** > *reconstructed.ber*
30
31 # FOOTNOTES
32
33 This program does not attempt to perform full-fledged XML parsing.
34 It is merely compatible with `unber`(1)'s output.
35 In particular, the XML style comments are not supported.
36 A hash "**#**" or two dashes "**--**" following a whitespace is treated as a beginning of a comment line, which is ignored completely.
37 Empty lines are ignored as well.
38
39 The following example `enber`(1) input demonstrates the use of comments:
40
41 | \<C O="0" T="[1]" TL="2" V="2">
42 |     \<I O="2" T="[1]" TL="2" V="Indefinite">
43 |     **--** \</I O="4" T="[UNIVERSAL 0]" L="4">
44 |     **#** Do not terminate:
45 |     **#** the absence of end-of-content octets is intentional!
46 | \</C O="6" T="[1]" L="6">
47
48 # SEE ALSO
49
50 `unber`(1), `asn1c`(1).