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 --- |