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