1.\" Copyright (c) 1980, 1993
2.\" The Regents of the University of California. All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\" notice, this list of conditions and the following disclaimer.
--- 16 unchanged lines hidden (view full) ---
25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30.\" SUCH DAMAGE.
31.\"
32.\" @(#)xstr.1 8.2 (Berkeley) 12/30/93
33.\" $FreeBSD: head/usr.bin/xstr/xstr.1 95124 2002-04-20 12:18:28Z charnier $
34.\"
35.Dd December 30, 1993
36.Dt XSTR 1
37.Os
38.Sh NAME
39.Nm xstr
40.Nd "extract strings from C programs to implement shared strings"
41.Sh SYNOPSIS
42.Nm
43.Op Fl c
44.Op Fl
45.Op Fl v
46.Op Ar file
47.Sh DESCRIPTION
48The
49.Nm
50utility maintains a file
51.Pa strings
52into which strings in component parts of a large program are hashed.
53These strings are replaced with references to this common area.
54This serves to implement shared constant strings, most useful if they
55are also read-only.
56.Pp
57Available options:
58.Bl -tag -width Ds
59.It Fl
60Read from the standard input.
61.It Fl c
62Extract the strings from the C source
63.Ar file
64or the standard input
65.Pq Fl ,
66replacing
67string references by expressions of the form (&xstr[number])
68for some number.
69An appropriate declaration of
70.Nm
--- 21 unchanged lines hidden (view full) ---
92.Pp
93The file
94.Pa xs.c
95should then be compiled and loaded with the rest
96of the program.
97If possible, the array can be made read-only (shared) saving
98space and swap overhead.
99.Pp
100The
101.Nm
102utility can also be used on a single file.
103A command
104.Bd -literal -offset indent
105xstr name
106.Ed
107.Pp
108creates files
109.Pa x.c
110and
--- 12 unchanged lines hidden (view full) ---
123after the C preprocessor is:
124.Pp
125.Bd -literal -offset indent -compact
126cc \-E name.c | xstr \-c \-
127cc \-c x.c
128mv x.o name.o
129.Ed
130.Pp
131The
132.Nm
133utility does not touch the file
134.Pa strings
135unless new items are added, thus
136.Xr make 1
137can avoid remaking
138.Pa xs.o
139unless truly necessary.
140.Sh FILES
141.Bl -tag -width /tmp/xsxx* -compact
--- 23 unchanged lines hidden ---
2.\" The Regents of the University of California. All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\" notice, this list of conditions and the following disclaimer.
--- 16 unchanged lines hidden (view full) ---
25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30.\" SUCH DAMAGE.
31.\"
32.\" @(#)xstr.1 8.2 (Berkeley) 12/30/93
33.\" $FreeBSD: head/usr.bin/xstr/xstr.1 95124 2002-04-20 12:18:28Z charnier $
34.\"
35.Dd December 30, 1993
36.Dt XSTR 1
37.Os
38.Sh NAME
39.Nm xstr
40.Nd "extract strings from C programs to implement shared strings"
41.Sh SYNOPSIS
42.Nm
43.Op Fl c
44.Op Fl
45.Op Fl v
46.Op Ar file
47.Sh DESCRIPTION
48The
49.Nm
50utility maintains a file
51.Pa strings
52into which strings in component parts of a large program are hashed.
53These strings are replaced with references to this common area.
54This serves to implement shared constant strings, most useful if they
55are also read-only.
56.Pp
57Available options:
58.Bl -tag -width Ds
59.It Fl
60Read from the standard input.
61.It Fl c
62Extract the strings from the C source
63.Ar file
64or the standard input
65.Pq Fl ,
66replacing
67string references by expressions of the form (&xstr[number])
68for some number.
69An appropriate declaration of
70.Nm
--- 21 unchanged lines hidden (view full) ---
92.Pp
93The file
94.Pa xs.c
95should then be compiled and loaded with the rest
96of the program.
97If possible, the array can be made read-only (shared) saving
98space and swap overhead.
99.Pp
100The
101.Nm
102utility can also be used on a single file.
103A command
104.Bd -literal -offset indent
105xstr name
106.Ed
107.Pp
108creates files
109.Pa x.c
110and
--- 12 unchanged lines hidden (view full) ---
123after the C preprocessor is:
124.Pp
125.Bd -literal -offset indent -compact
126cc \-E name.c | xstr \-c \-
127cc \-c x.c
128mv x.o name.o
129.Ed
130.Pp
131The
132.Nm
133utility does not touch the file
134.Pa strings
135unless new items are added, thus
136.Xr make 1
137can avoid remaking
138.Pa xs.o
139unless truly necessary.
140.Sh FILES
141.Bl -tag -width /tmp/xsxx* -compact
--- 23 unchanged lines hidden ---