Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
INPLACE(3am)		   GNU Awk Extension Modules		  INPLACE(3am)

NAME
       inplace - emulate sed/perl/ruby in-place	editing

SYNOPSIS
       gawk -i inplace ...

DESCRIPTION
       The  inplace extension adds two functions named inplace_begin() and in-
       place_end().  These functions are meant to  be  invoked	from  the  in-
       place.awk wrapper which is installed when gawk is.

       By  default, each named file on the command line	is replaced with a new
       file of the same	name whose contents are	the results of running the AWK
       program.	 If the	user supplies an AWK variable named inplace::suffix in
       a BEGIN rule or on the command line, then the  inplace  extension  con-
       catenates that suffix onto the original filename	and uses the result as
       a filename for renaming the original.

       For backwards compatibility, the	variable will also check  INPLACE_SUF-
       FIX  (in	the awk	namespace) for the suffix to use if inplace::suffix is
       not set.

       One can disable inplace editing	selectively  by	 placing  inplace::en-
       able=0 on the command line prior	to files that should be	processed nor-
       mally.  One can reenable	inplace	editing	by  placing  inplace::enable=1
       prior to	files that should be subject to	inplace	editing.

BUGS
       While the extension does	attempt	to preserve ownership and permissions,
       it makes	no attempt to copy the ACLs from the original file.

       If the program dies prematurely,	as might happen	if an unhandled	signal
       is received, a temporary	file may be left behind.

EXAMPLE
       gawk -i inplace 'script'	files ...
       gawk -i inplace -f scriptfile files ...

SEE ALSO
       GAWK:   Effective   AWK	 Programming,	filefuncs(3am),	 fnmatch(3am),
       fork(3am), ordchr(3am),	readdir(3am),  readfile(3am),  revoutput(3am),
       rwarray(3am).

AUTHOR
       Andrew Schorr, schorr@telemetry-investments.com.

COPYING	PERMISSIONS
       Copyright  (C)  2012, 2013, 2015, 2018, 2019, Free Software Foundation,
       Inc.

       Permission is granted to	make and distribute verbatim  copies  of  this
       manual  page  provided  the copyright notice and	this permission	notice
       are preserved on	all copies.

       Permission is granted to	copy and distribute modified versions of  this
       manual  page  under  the	conditions for verbatim	copying, provided that
       the entire resulting derived work is distributed	under the terms	 of  a
       permission notice identical to this one.

       Permission  is granted to copy and distribute translations of this man-
       ual page	into another language, under the above conditions for modified
       versions,  except that this permission notice may be stated in a	trans-
       lation approved by the Foundation.

Free Software Foundation	  Jun 26 2018			  INPLACE(3am)

NAME | SYNOPSIS | DESCRIPTION | BUGS | EXAMPLE | SEE ALSO | AUTHOR | COPYING PERMISSIONS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=inplace&sektion=3am&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help