plistbuddy(8) [mojave man page]

PLISTBUDDY(8)						    BSD System Manager's Manual 					     PLISTBUDDY(8)

NAME

     PlistBuddy -- read and write values to plists

SYNOPSIS

     PlistBuddy [-cxh] file.plist

DESCRIPTION

     The PlistBuddy command is used to read and modify values inside of a plist. Unless specified by the -c switch, PlistBuddy runs in interactive
     mode.

     The following commands are used to manipulate plist data:

     Help	 Prints this information.

     Exit	 Exits the program. Changes are not saved to the file.

     Save	 Saves the current changes to the file.

     Revert	 Reloads the last saved version of the file.

     Clear type  Clears out all existing entries, and creates root of type type.  See below for a list of types.

     Print [entry]
		 Prints value of entry.  If an entry is not specified, prints entire file. See below for an explanation of how entry works.

     Set entry value
		 Sets the value at entry to value.

     Add entry type [value]
		 Adds entry with type type and optional value value.  See below for a list of types.

     Copy entrySrc entryDst
		 Copies the entrySrc property to entryDst.

     Delete entry
		 Deletes entry from the plist.

     Merge file [entry]
		 Adds the contents of plist file to entry.

     Import entry file
		 Creates or sets entry to the contents of file.

     Entries consist of property key names delimited by colons. Array items are specified by a zero-based integer index. Examples:

	 :CFBundleShortVersionString
	 :CFBundleDocumentTypes:2:CFBundleTypeExtensions

     Entries may be of the following types:

	 string
	 array
	 dict
	 bool
	 real
	 integer
	 date
	 data

OPTIONS

     -c command  Execute command and exit. By default, PlistBuddy will run in interactive mode.

     -x 	 Output will be in the form of an xml plist where appropriate.

     -h 	 Print the complete help info.

EXAMPLES

     Set the CFBundleIdentifier property to com.apple.plistbuddy:

	     Set :CFBundleIdentifier com.apple.plistbuddy

     Add the CFBundleGetInfoString property to the plist:

	     Add :CFBundleGetInfoString string "App version 1.0.1"

     Add a new item of type dict to the CFBundleDocumentTypes array:

	     Add :CFBundleDocumentTypes: dict

     Add the new item to the beginning of the array:

	     Add :CFBundleDocumentTypes:0 dict

     Delete the FIRST item in the array:

	     Delete :CFBundleDocumentTypes:0 dict

     Delete the ENTIRE CFBundleDocumentTypes array:

	     Delete :CFBundleDocumentTypes

EXIT STATUS

     PlistBuddy command returns a zero exit status if it succeeds. Non zero is returned in case of failure.

Mac OS X							 February 19, 2007							  Mac OS X

Check Out this Related Man Page

PLUTIL(1)						    BSD General Commands Manual 						 PLUTIL(1)

NAME

     plutil -- property list utility

SYNOPSIS

     plutil [command_option] [other_options] file
	     ...

DESCRIPTION

     plutil can be used to check the syntax of property list files, or convert a plist file from one format to another.  Specifying - as an input
     file reads from stdin.

     The first argument indicates the operation to perform, one of:

     -help	   Show the usage information for the command and exit.

     -p 	   Print the property list in a human-readable fashion. The output format is not stable and not designed for machine parsing. The
		   purpose of this command is to be able to easily read the contents of a plist file, no matter what format it is in.

     -lint	   Check the named property list files for syntax errors.  This is the default command option if none is specified.

     -convert fmt  Convert the named file to the indicated format and write back to the file system.  If the file can't be loaded due to invalid
		   syntax, the operation fails.

		   fmt is one of:  xml1, for version 1 of the XML plist format binary1, for version 1 of the binary plist format json, for the
				   JSON format

     There are a few additional options:

     -- 	   Specifies that all further arguments are file names

     -s 	   Don't print anything on success.

     -r 	   For JSON, add whitespace and indentation to make the output more human-readable.

     -o path	   Specify an alternate path name for the result of the -convert operation; this option is only useful with a single file to be
		   converted.  Specifying - as the path outputs to stdout.

     -e extension  Specify an alternate extension for converted files, and the output file names are otherwise the same.

DIAGNOSTICS

     The plutil command exits 0 on success, and 1 on failure.

SEE ALSO

     plist(5)

STANDARDS

     The plutil command obeys no one's rules but its own.

HISTORY

     The plutil command first appeared in Mac OS X 10.2.

Mac OS X							  August 30, 2002							  Mac OS X

Linux and UNIX Man Pages

plistbuddy(8) [mojave man page]

Check Out this Related Man Page