<doc>
	<legacy_id>2468</legacy_id>
	<name>close process</name>
	<type>command</type>

	<syntax>
		<example>close process <i>processName</i></example>
	</syntax>

	<synonyms>
	</synonyms>

	<summary>Closes a <glossary tag="process">process</glossary> that was started with the <command tag="open process">open process</command> <glossary tag="command">command</glossary>.</summary>

	<examples>
<example>close process "/bin/sh"</example>
<example>close process tOpenProgram</example>
	</examples>

	<history>
		<introduced version="1.0">Added.</introduced>
		<deprecated version=""></deprecated>
		<removed version=""></removed>
		<changed version="2.0">2.0</changed>
		<experimental version=""></experimental>
		<nonexperimental version=""></nonexperimental>
	</history>

	<objects>
	</objects>

	<platforms>
		<mac/>
		<windows/>
		<linux/>
	</platforms>

	<classes>
		<desktop/>
		<server/>
		<web/>
	</classes>

	<security>
		<process/>
	</security>


	<classification>
		<category>The System Environment</category>
	</classification>

	<references>
		<function tag="openProcesses">openProcesses Function</function>
		<command tag="kill">kill Command</command>
		<command tag="quit">quit Command</command>
		<command tag="read from process">read from process Command</command>
	</references>

	<description>Use the <b>close process</b> <glossary tag="command">command</glossary> to tell a <glossary tag="process">process</glossary> to <control_st tag="exit">exit</control_st> after you've finished using it.<p></p><p><b>Parameters:</b></p><p>The <i>processName</i> is the <glossary tag="file path">file path</glossary> to the <glossary tag="process">process</glossary> you opened with the <command tag="open process">open process</command> command.</p><p></p><p><b>Comments:</b></p><p>On Unix and Windows systems, <b>close process</b> closes the <glossary tag="process">process's</glossary> <glossary tag="standard input">standard input</glossary>. The <glossary tag="process">process</glossary> then finishes processing whatever data remains, and exits when done. On <glossary tag="Mac OS">Mac OS systems</glossary>, the <b>close process</b> <glossary tag="command">command</glossary> has no effect; you can use the <command tag="kill">kill</command> <glossary tag="command">command</glossary> instead to quit an application that LiveCode launched.</p><p></p><p>The process takes a short time to exit after you issue the <b>close process</b> <glossary tag="command">command</glossary>. Since two <glossary tag="process">processes</glossary> cannot have the same name, you need to wait for a <glossary tag="process">process</glossary> to exit before opening a new <glossary tag="process">process</glossary> with the same name. To reopen the same <glossary tag="process">process</glossary> after closing it, use the <command tag="wait">wait</command> <glossary tag="command">command</glossary> to delay until the <glossary tag="process">process</glossary> has finished exiting:</p><p></p><p>  close process myProcess</p><p>  wait until myProcess is not among the lines of the openProcesses</p><p>  open process myProcess</p><p></p><p>If a process was opened with the access mode neither, it exits automatically when it finishes running, and does not need to be closed.</p><p></p><p></p><change><p>Support for using the <b>close process</b> <glossary tag="command">command</glossary> on <glossary tag="OS X">OS X systems</glossary> was added in version 2.0.</change></description>
</doc>