\hypertarget{jack_8h}{
\section{jack.h File Reference}
\label{jack_8h}\index{jack.h@{jack.h}}
}
{\tt \#include $<$pthread.h$>$}\par
{\tt \#include $<$jack/types.h$>$}\par
{\tt \#include $<$jack/error.h$>$}\par
{\tt \#include $<$jack/transport.h$>$}\par
\subsection*{Functions}
\begin{CompactItemize}
\item 
\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$ \hyperlink{jack_8h_a0}{jack\_\-client\_\-new} (const char $\ast$client\_\-name)
\item 
\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$ \hyperlink{jack_8h_a1}{jack\_\-client\_\-new\_\-inprocess} (const char $\ast$client\_\-name, const char $\ast$so\_\-name, const char $\ast$so\_\-data)
\item 
int \hyperlink{jack_8h_a2}{jack\_\-client\_\-close} (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$client)
\item 
void \hyperlink{jack_8h_a3}{jack\_\-on\_\-shutdown} (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$client, void($\ast$function)(void $\ast$arg), void $\ast$arg)
\item 
int \hyperlink{jack_8h_a4}{jack\_\-set\_\-process\_\-callback} (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$, \hyperlink{types_8h_a6}{Jack\-Process\-Callback} process\_\-callback, void $\ast$arg)
\item 
int \hyperlink{jack_8h_a5}{jack\_\-set\_\-buffer\_\-size\_\-callback} (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$, \hyperlink{types_8h_a9}{Jack\-Buffer\-Size\-Callback} bufsize\_\-callback, void $\ast$arg)
\item 
int \hyperlink{jack_8h_a6}{jack\_\-set\_\-sample\_\-rate\_\-callback} (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$, \hyperlink{types_8h_a10}{Jack\-Sample\-Rate\-Callback} srate\_\-callback, void $\ast$arg)
\item 
int \hyperlink{jack_8h_a7}{jack\_\-set\_\-port\_\-registration\_\-callback} (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$, \hyperlink{types_8h_a11}{Jack\-Port\-Registration\-Callback} registration\_\-callback, void $\ast$arg)
\item 
int \hyperlink{jack_8h_a8}{jack\_\-set\_\-graph\_\-order\_\-callback} (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$, \hyperlink{types_8h_a7}{Jack\-Graph\-Order\-Callback} graph\_\-callback, void $\ast$)
\item 
int \hyperlink{jack_8h_a9}{jack\_\-set\_\-xrun\_\-callback} (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$, \hyperlink{types_8h_a8}{Jack\-XRun\-Callback} xrun\_\-callback, void $\ast$arg)
\item 
int \hyperlink{jack_8h_a10}{jack\_\-activate} (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$client)
\item 
int \hyperlink{jack_8h_a11}{jack\_\-deactivate} (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$client)
\item 
\hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$ \hyperlink{jack_8h_a12}{jack\_\-port\_\-register} (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$, const char $\ast$port\_\-name, const char $\ast$port\_\-type, unsigned long flags, unsigned long buffer\_\-size)
\item 
int \hyperlink{jack_8h_a13}{jack\_\-port\_\-unregister} (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$, \hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$)
\item 
const char $\ast$ \hyperlink{jack_8h_a14}{jack\_\-port\_\-name} (const \hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$port)
\item 
const char $\ast$ \hyperlink{jack_8h_a15}{jack\_\-port\_\-short\_\-name} (const \hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$port)
\item 
int \hyperlink{jack_8h_a16}{jack\_\-port\_\-flags} (const \hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$port)
\item 
const char $\ast$ \hyperlink{jack_8h_a17}{jack\_\-port\_\-type} (const \hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$port)
\item 
int \hyperlink{jack_8h_a18}{jack\_\-port\_\-is\_\-mine} (const \hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$, const \hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$port)
\item 
int \hyperlink{jack_8h_a19}{jack\_\-port\_\-connected} (const \hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$port)
\item 
int \hyperlink{jack_8h_a20}{jack\_\-port\_\-connected\_\-to} (const \hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$port, const char $\ast$portname)
\item 
const char $\ast$$\ast$ \hyperlink{jack_8h_a21}{jack\_\-port\_\-get\_\-connections} (const \hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$port)
\item 
const char $\ast$$\ast$ \hyperlink{jack_8h_a22}{jack\_\-port\_\-get\_\-all\_\-connections} (const \hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$client, const \hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$port)
\item 
int \hyperlink{jack_8h_a23}{jack\_\-port\_\-set\_\-name} (\hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$port, const char $\ast$name)
\item 
void $\ast$ \hyperlink{jack_8h_a24}{jack\_\-port\_\-get\_\-buffer} (\hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$, \hyperlink{types_8h_a2}{jack\_\-nframes\_\-t})
\item 
int \hyperlink{jack_8h_a25}{jack\_\-connect} (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$, const char $\ast$source\_\-port, const char $\ast$destination\_\-port)
\item 
int \hyperlink{jack_8h_a26}{jack\_\-disconnect} (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$, const char $\ast$source\_\-port, const char $\ast$destination\_\-port)
\item 
int \hyperlink{jack_8h_a27}{jack\_\-port\_\-connect} (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$, \hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$src, \hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$dst)
\item 
int \hyperlink{jack_8h_a28}{jack\_\-port\_\-disconnect} (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$, \hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$)
\item 
int \hyperlink{jack_8h_a29}{jack\_\-port\_\-tie} (\hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$src, \hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$dst)
\item 
int \hyperlink{jack_8h_a30}{jack\_\-port\_\-untie} (\hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$port)
\item 
int \hyperlink{jack_8h_a31}{jack\_\-port\_\-lock} (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$, \hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$)
\item 
int \hyperlink{jack_8h_a32}{jack\_\-port\_\-unlock} (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$, \hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$)
\item 
\hyperlink{types_8h_a2}{jack\_\-nframes\_\-t} \hyperlink{jack_8h_a33}{jack\_\-port\_\-get\_\-latency} (\hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$port)
\item 
\hyperlink{types_8h_a2}{jack\_\-nframes\_\-t} \hyperlink{jack_8h_a34}{jack\_\-port\_\-get\_\-total\_\-latency} (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$, \hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$port)
\item 
void \hyperlink{jack_8h_a35}{jack\_\-port\_\-set\_\-latency} (\hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$, \hyperlink{types_8h_a2}{jack\_\-nframes\_\-t})
\item 
int \hyperlink{jack_8h_a36}{jack\_\-port\_\-request\_\-monitor} (\hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$port, int onoff)
\item 
int \hyperlink{jack_8h_a37}{jack\_\-port\_\-request\_\-monitor\_\-by\_\-name} (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$client, const char $\ast$port\_\-name, int onoff)
\item 
int \hyperlink{jack_8h_a38}{jack\_\-port\_\-ensure\_\-monitor} (\hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$port, int onoff)
\item 
int \hyperlink{jack_8h_a39}{jack\_\-port\_\-monitoring\_\-input} (\hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$port)
\item 
unsigned long \hyperlink{jack_8h_a40}{jack\_\-get\_\-sample\_\-rate} (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$)
\item 
\hyperlink{types_8h_a2}{jack\_\-nframes\_\-t} \hyperlink{jack_8h_a41}{jack\_\-get\_\-buffer\_\-size} (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$)
\item 
const char $\ast$$\ast$ \hyperlink{jack_8h_a42}{jack\_\-get\_\-ports} (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$, const char $\ast$port\_\-name\_\-pattern, const char $\ast$type\_\-name\_\-pattern, unsigned long flags)
\item 
\hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$ \hyperlink{jack_8h_a43}{jack\_\-port\_\-by\_\-name} (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$, const char $\ast$portname)
\item 
\hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$ \hyperlink{jack_8h_a44}{jack\_\-port\_\-by\_\-id} (const \hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$client, \hyperlink{types_8h_a5}{jack\_\-port\_\-id\_\-t} id)
\item 
int \hyperlink{jack_8h_a45}{jack\_\-engine\_\-takeover\_\-timebase} (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$)
\item 
void \hyperlink{jack_8h_a46}{jack\_\-update\_\-time} (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$, \hyperlink{types_8h_a2}{jack\_\-nframes\_\-t})
\item 
\hyperlink{types_8h_a2}{jack\_\-nframes\_\-t} \hyperlink{jack_8h_a47}{jack\_\-frames\_\-since\_\-cycle\_\-start} (const \hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$)
\item 
\hyperlink{types_8h_a2}{jack\_\-nframes\_\-t} \hyperlink{jack_8h_a48}{jack\_\-frame\_\-time} (const \hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$)
\item 
float \hyperlink{jack_8h_a49}{jack\_\-cpu\_\-load} (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$client)
\item 
void \hyperlink{jack_8h_a50}{jack\_\-set\_\-server\_\-dir} (const char $\ast$path)
\item 
int \hyperlink{jack_8h_a51}{jack\_\-add\_\-alias} (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$, const char $\ast$portname, const char $\ast$alias)
\item 
int \hyperlink{jack_8h_a52}{jack\_\-remove\_\-alias} (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$, const char $\ast$alias)
\item 
pthread\_\-t \hyperlink{jack_8h_a53}{jack\_\-client\_\-thread\_\-id} (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$)
\end{CompactItemize}


\subsection{Function Documentation}
\hypertarget{jack_8h_a10}{
\index{jack.h@{jack.h}!jack_activate@{jack\_\-activate}}
\index{jack_activate@{jack\_\-activate}!jack.h@{jack.h}}
\subsubsection[jack\_\-activate]{\setlength{\rightskip}{0pt plus 5cm}int jack\_\-activate (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$ {\em client})}}
\label{jack_8h_a10}


Tell the Jack server that the program is ready to start processing audio. \hypertarget{jack_8h_a51}{
\index{jack.h@{jack.h}!jack_add_alias@{jack\_\-add\_\-alias}}
\index{jack_add_alias@{jack\_\-add\_\-alias}!jack.h@{jack.h}}
\subsubsection[jack\_\-add\_\-alias]{\setlength{\rightskip}{0pt plus 5cm}int jack\_\-add\_\-alias (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$, const char $\ast$ {\em portname}, const char $\ast$ {\em alias})}}
\label{jack_8h_a51}


Create an alias for a port. Returns zero if successful, non-zero otherwise. After a successful return, `alias' may be used to refer to a port instead of the port's actual name. the naming scheme is \char`\"{}alias:$<$alias$>$\char`\"{}, so if the port alias was \char`\"{}left\char`\"{}, and the port name was \char`\"{}foo:out1\char`\"{}, then \char`\"{}alias:left\char`\"{} will refer to \char`\"{}foo:out1\char`\"{}. \hypertarget{jack_8h_a2}{
\index{jack.h@{jack.h}!jack_client_close@{jack\_\-client\_\-close}}
\index{jack_client_close@{jack\_\-client\_\-close}!jack.h@{jack.h}}
\subsubsection[jack\_\-client\_\-close]{\setlength{\rightskip}{0pt plus 5cm}int jack\_\-client\_\-close (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$ {\em client})}}
\label{jack_8h_a2}


Disconnects from Jack server. \hypertarget{jack_8h_a0}{
\index{jack.h@{jack.h}!jack_client_new@{jack\_\-client\_\-new}}
\index{jack_client_new@{jack\_\-client\_\-new}!jack.h@{jack.h}}
\subsubsection[jack\_\-client\_\-new]{\setlength{\rightskip}{0pt plus 5cm}\hyperlink{types_8h_a4}{jack\_\-client\_\-t}$\ast$ jack\_\-client\_\-new (const char $\ast$ {\em client\_\-name})}}
\label{jack_8h_a0}


Attemps to become an out-of-process client of the Jack server. \hypertarget{jack_8h_a1}{
\index{jack.h@{jack.h}!jack_client_new_inprocess@{jack\_\-client\_\-new\_\-inprocess}}
\index{jack_client_new_inprocess@{jack\_\-client\_\-new\_\-inprocess}!jack.h@{jack.h}}
\subsubsection[jack\_\-client\_\-new\_\-inprocess]{\setlength{\rightskip}{0pt plus 5cm}\hyperlink{types_8h_a4}{jack\_\-client\_\-t}$\ast$ jack\_\-client\_\-new\_\-inprocess (const char $\ast$ {\em client\_\-name}, const char $\ast$ {\em so\_\-name}, const char $\ast$ {\em so\_\-data})}}
\label{jack_8h_a1}


\begin{Desc}
\item[Parameters: ]\par
\begin{description}
\item[{\em 
client\_\-name}]The name for the new client \item[{\em 
so\_\-name}]A path to a shared object file containing the code for the new client  \item[{\em 
so\_\-data}]An arbitary string containing information to be passed to the init() routine of the new client\end{description}
\end{Desc}
Attemps to create an in-process client of the Jack server. \hypertarget{jack_8h_a53}{
\index{jack.h@{jack.h}!jack_client_thread_id@{jack\_\-client\_\-thread\_\-id}}
\index{jack_client_thread_id@{jack\_\-client\_\-thread\_\-id}!jack.h@{jack.h}}
\subsubsection[jack\_\-client\_\-thread\_\-id]{\setlength{\rightskip}{0pt plus 5cm}pthread\_\-t jack\_\-client\_\-thread\_\-id (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$)}}
\label{jack_8h_a53}


Return the pthread ID of the thread running the JACK client side code. \hypertarget{jack_8h_a25}{
\index{jack.h@{jack.h}!jack_connect@{jack\_\-connect}}
\index{jack_connect@{jack\_\-connect}!jack.h@{jack.h}}
\subsubsection[jack\_\-connect]{\setlength{\rightskip}{0pt plus 5cm}int jack\_\-connect (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$, const char $\ast$ {\em source\_\-port}, const char $\ast$ {\em destination\_\-port})}}
\label{jack_8h_a25}


Establishes a connection between two ports.

When a connection exists, data written to the source port will be available to be read at the destination port.

The types of both ports must be identical to establish a connection. The flags of the source port must include Port\-Is\-Output. The flags of the destination port must include Port\-Is\-Input. \hypertarget{jack_8h_a49}{
\index{jack.h@{jack.h}!jack_cpu_load@{jack\_\-cpu\_\-load}}
\index{jack_cpu_load@{jack\_\-cpu\_\-load}!jack.h@{jack.h}}
\subsubsection[jack\_\-cpu\_\-load]{\setlength{\rightskip}{0pt plus 5cm}float jack\_\-cpu\_\-load (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$ {\em client})}}
\label{jack_8h_a49}


This returns the current CPU load estimated by JACK as a percentage. The load is computed by measuring the number of cycles it took to execute all clients as a fraction of the total number of cycles represented by the data that was processed. \hypertarget{jack_8h_a11}{
\index{jack.h@{jack.h}!jack_deactivate@{jack\_\-deactivate}}
\index{jack_deactivate@{jack\_\-deactivate}!jack.h@{jack.h}}
\subsubsection[jack\_\-deactivate]{\setlength{\rightskip}{0pt plus 5cm}int jack\_\-deactivate (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$ {\em client})}}
\label{jack_8h_a11}


Tells the Jack server that the program should be removed from the  processing graph. As a side effect, this will disconnect any and all ports belonging to the client, since inactive clients are not allowed to be connected to any other ports. \hypertarget{jack_8h_a26}{
\index{jack.h@{jack.h}!jack_disconnect@{jack\_\-disconnect}}
\index{jack_disconnect@{jack\_\-disconnect}!jack.h@{jack.h}}
\subsubsection[jack\_\-disconnect]{\setlength{\rightskip}{0pt plus 5cm}int jack\_\-disconnect (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$, const char $\ast$ {\em source\_\-port}, const char $\ast$ {\em destination\_\-port})}}
\label{jack_8h_a26}


Removes a connection between two ports.

The types of both ports must be identical to establish a connection. The flags of the source port must include Port\-Is\-Output. The flags of the destination port must include Port\-Is\-Input. \hypertarget{jack_8h_a45}{
\index{jack.h@{jack.h}!jack_engine_takeover_timebase@{jack\_\-engine\_\-takeover\_\-timebase}}
\index{jack_engine_takeover_timebase@{jack\_\-engine\_\-takeover\_\-timebase}!jack.h@{jack.h}}
\subsubsection[jack\_\-engine\_\-takeover\_\-timebase]{\setlength{\rightskip}{0pt plus 5cm}int jack\_\-engine\_\-takeover\_\-timebase (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$)}}
\label{jack_8h_a45}


If a client is told (by the user) to become the timebase for the entire system, it calls this function. If it returns zero, then the client has the responsibility to call \hyperlink{transport_8h_a6}{jack\_\-set\_\-transport\_\-info()}) at the end of its process() callback. \hypertarget{jack_8h_a48}{
\index{jack.h@{jack.h}!jack_frame_time@{jack\_\-frame\_\-time}}
\index{jack_frame_time@{jack\_\-frame\_\-time}!jack.h@{jack.h}}
\subsubsection[jack\_\-frame\_\-time]{\setlength{\rightskip}{0pt plus 5cm}\hyperlink{types_8h_a2}{jack\_\-nframes\_\-t} jack\_\-frame\_\-time (const \hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$)}}
\label{jack_8h_a48}


Return an estimate of the current time in frames. It is a running counter - no significance should be attached to the return value. it should be used to compute the difference between a previously returned value. \hypertarget{jack_8h_a47}{
\index{jack.h@{jack.h}!jack_frames_since_cycle_start@{jack\_\-frames\_\-since\_\-cycle\_\-start}}
\index{jack_frames_since_cycle_start@{jack\_\-frames\_\-since\_\-cycle\_\-start}!jack.h@{jack.h}}
\subsubsection[jack\_\-frames\_\-since\_\-cycle\_\-start]{\setlength{\rightskip}{0pt plus 5cm}\hyperlink{types_8h_a2}{jack\_\-nframes\_\-t} jack\_\-frames\_\-since\_\-cycle\_\-start (const \hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$)}}
\label{jack_8h_a47}


This estimates the time that has passed since the start jack server started calling the process() callbacks of all its clients. \hypertarget{jack_8h_a41}{
\index{jack.h@{jack.h}!jack_get_buffer_size@{jack\_\-get\_\-buffer\_\-size}}
\index{jack_get_buffer_size@{jack\_\-get\_\-buffer\_\-size}!jack.h@{jack.h}}
\subsubsection[jack\_\-get\_\-buffer\_\-size]{\setlength{\rightskip}{0pt plus 5cm}\hyperlink{types_8h_a2}{jack\_\-nframes\_\-t} jack\_\-get\_\-buffer\_\-size (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$)}}
\label{jack_8h_a41}


This returns the current maximum size that will ever be passed to the \char`\"{}process\char`\"{} callback. It should only be used $\ast$before$\ast$ the client has been activated. After activation, the client will be notified of buffer size changes if it registers a buffer\_\-size callback. \hypertarget{jack_8h_a42}{
\index{jack.h@{jack.h}!jack_get_ports@{jack\_\-get\_\-ports}}
\index{jack_get_ports@{jack\_\-get\_\-ports}!jack.h@{jack.h}}
\subsubsection[jack\_\-get\_\-ports]{\setlength{\rightskip}{0pt plus 5cm}const char$\ast$$\ast$ jack\_\-get\_\-ports (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$, const char $\ast$ {\em port\_\-name\_\-pattern}, const char $\ast$ {\em type\_\-name\_\-pattern}, unsigned long {\em flags})}}
\label{jack_8h_a42}


\begin{Desc}
\item[Parameters: ]\par
\begin{description}
\item[{\em 
port\_\-name\_\-pattern}]A regular expression used to select  ports by name. If NULL or of zero length, no selection based  on name will be carried out. \item[{\em 
type\_\-name\_\-pattern}]A regular expression used to select  ports by type. If NULL or of zero length, no selection based  on type will be carried out. \item[{\em 
flags}]A value used to select ports by their flags.  If zero, no selection based on flags will be carried out.\end{description}
\end{Desc}
This function returns a NULL-terminated array of ports that match  the specified arguments. The caller is responsible for calling free(3) any non-NULL returned value. \hypertarget{jack_8h_a40}{
\index{jack.h@{jack.h}!jack_get_sample_rate@{jack\_\-get\_\-sample\_\-rate}}
\index{jack_get_sample_rate@{jack\_\-get\_\-sample\_\-rate}!jack.h@{jack.h}}
\subsubsection[jack\_\-get\_\-sample\_\-rate]{\setlength{\rightskip}{0pt plus 5cm}unsigned long jack\_\-get\_\-sample\_\-rate (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$)}}
\label{jack_8h_a40}


This returns the sample rate of the jack system, as set by the user when jackd was started. \hypertarget{jack_8h_a3}{
\index{jack.h@{jack.h}!jack_on_shutdown@{jack\_\-on\_\-shutdown}}
\index{jack_on_shutdown@{jack\_\-on\_\-shutdown}!jack.h@{jack.h}}
\subsubsection[jack\_\-on\_\-shutdown]{\setlength{\rightskip}{0pt plus 5cm}void jack\_\-on\_\-shutdown (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$ {\em client}, void($\ast$ {\em function})(void $\ast$arg), void $\ast$ {\em arg})}}
\label{jack_8h_a3}


\begin{Desc}
\item[Parameters: ]\par
\begin{description}
\item[{\em 
client}]The Jack client structure. \item[{\em 
function}]The jack\_\-shutdown function pointer. \item[{\em 
arg}]The arguments for the jack\_\-shutdown function.\end{description}
\end{Desc}
Register a function (and argument) to be called if and when the JACK server shuts down the client thread. The function must be written as if it were an asynchonrous POSIX signal handler --- use only async-safe functions, and remember that it is executed from another thread. A typical function might set a flag or write to a pipe so that the rest of the application knows that the JACK client thread has shut down.

NOTE: clients do not need to call this. It exists only to help more complex clients understand what is going on. If called, it must be called before jack\_\-client\_\-activate(). \hypertarget{jack_8h_a44}{
\index{jack.h@{jack.h}!jack_port_by_id@{jack\_\-port\_\-by\_\-id}}
\index{jack_port_by_id@{jack\_\-port\_\-by\_\-id}!jack.h@{jack.h}}
\subsubsection[jack\_\-port\_\-by\_\-id]{\setlength{\rightskip}{0pt plus 5cm}\hyperlink{types_8h_a3}{jack\_\-port\_\-t}$\ast$ jack\_\-port\_\-by\_\-id (const \hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$ {\em client}, \hyperlink{types_8h_a5}{jack\_\-port\_\-id\_\-t} {\em id})}}
\label{jack_8h_a44}


Searchs for and returns the jack\_\-port\_\-t of id @id. \hypertarget{jack_8h_a43}{
\index{jack.h@{jack.h}!jack_port_by_name@{jack\_\-port\_\-by\_\-name}}
\index{jack_port_by_name@{jack\_\-port\_\-by\_\-name}!jack.h@{jack.h}}
\subsubsection[jack\_\-port\_\-by\_\-name]{\setlength{\rightskip}{0pt plus 5cm}\hyperlink{types_8h_a3}{jack\_\-port\_\-t}$\ast$ jack\_\-port\_\-by\_\-name (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$, const char $\ast$ {\em portname})}}
\label{jack_8h_a43}


Searchs for and returns the jack\_\-port\_\-t with the name value from portname. \hypertarget{jack_8h_a27}{
\index{jack.h@{jack.h}!jack_port_connect@{jack\_\-port\_\-connect}}
\index{jack_port_connect@{jack\_\-port\_\-connect}!jack.h@{jack.h}}
\subsubsection[jack\_\-port\_\-connect]{\setlength{\rightskip}{0pt plus 5cm}int jack\_\-port\_\-connect (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$, \hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$ {\em src}, \hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$ {\em dst})}}
\label{jack_8h_a27}


Performs the exact same function as \hyperlink{jack_8h_a25}{jack\_\-connect()}, but it uses port handles rather than names, which avoids the name lookup inherent in the name-based version.

It is envisaged that clients connecting their own ports will use these two, whereas generic connection clients (e.g. patchbays) will use the name-based versions. \hypertarget{jack_8h_a19}{
\index{jack.h@{jack.h}!jack_port_connected@{jack\_\-port\_\-connected}}
\index{jack_port_connected@{jack\_\-port\_\-connected}!jack.h@{jack.h}}
\subsubsection[jack\_\-port\_\-connected]{\setlength{\rightskip}{0pt plus 5cm}int jack\_\-port\_\-connected (const \hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$ {\em port})}}
\label{jack_8h_a19}


This returns a positive integer indicating the number of connections to or from @port.

The calling client must own @port. \hypertarget{jack_8h_a20}{
\index{jack.h@{jack.h}!jack_port_connected_to@{jack\_\-port\_\-connected\_\-to}}
\index{jack_port_connected_to@{jack\_\-port\_\-connected\_\-to}!jack.h@{jack.h}}
\subsubsection[jack\_\-port\_\-connected\_\-to]{\setlength{\rightskip}{0pt plus 5cm}int jack\_\-port\_\-connected\_\-to (const \hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$ {\em port}, const char $\ast$ {\em portname})}}
\label{jack_8h_a20}


This returns TRUE or FALSE if the port argument is DIRECTLY connected to the port with the name given in 'portname'

The calling client must own @port. \hypertarget{jack_8h_a28}{
\index{jack.h@{jack.h}!jack_port_disconnect@{jack\_\-port\_\-disconnect}}
\index{jack_port_disconnect@{jack\_\-port\_\-disconnect}!jack.h@{jack.h}}
\subsubsection[jack\_\-port\_\-disconnect]{\setlength{\rightskip}{0pt plus 5cm}int jack\_\-port\_\-disconnect (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$, \hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$)}}
\label{jack_8h_a28}


Performs the exact same function as \hyperlink{jack_8h_a26}{jack\_\-disconnect()}, but it uses port handles rather than names, which avoids the name lookup inherent in the name-based version.

It is envisaged that clients disconnecting their own ports will use these two, whereas generic connection clients (e.g. patchbays) will use the name-based versions. \hypertarget{jack_8h_a38}{
\index{jack.h@{jack.h}!jack_port_ensure_monitor@{jack\_\-port\_\-ensure\_\-monitor}}
\index{jack_port_ensure_monitor@{jack\_\-port\_\-ensure\_\-monitor}!jack.h@{jack.h}}
\subsubsection[jack\_\-port\_\-ensure\_\-monitor]{\setlength{\rightskip}{0pt plus 5cm}int jack\_\-port\_\-ensure\_\-monitor (\hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$ {\em port}, int {\em onoff})}}
\label{jack_8h_a38}


If Jack\-Port\-Can\-Monitor is set for a port, then this function will turn on input monitoring if it was off, and will turn it off it only one request has been made to turn it on. If Jack\-Port\-Can\-Monitor is not set, then this function will do nothing. \hypertarget{jack_8h_a16}{
\index{jack.h@{jack.h}!jack_port_flags@{jack\_\-port\_\-flags}}
\index{jack_port_flags@{jack\_\-port\_\-flags}!jack.h@{jack.h}}
\subsubsection[jack\_\-port\_\-flags]{\setlength{\rightskip}{0pt plus 5cm}int jack\_\-port\_\-flags (const \hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$ {\em port})}}
\label{jack_8h_a16}


Returns the flags of the jack\_\-port\_\-t. \hypertarget{jack_8h_a22}{
\index{jack.h@{jack.h}!jack_port_get_all_connections@{jack\_\-port\_\-get\_\-all\_\-connections}}
\index{jack_port_get_all_connections@{jack\_\-port\_\-get\_\-all\_\-connections}!jack.h@{jack.h}}
\subsubsection[jack\_\-port\_\-get\_\-all\_\-connections]{\setlength{\rightskip}{0pt plus 5cm}const char$\ast$$\ast$ jack\_\-port\_\-get\_\-all\_\-connections (const \hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$ {\em client}, const \hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$ {\em port})}}
\label{jack_8h_a22}


This returns a null-terminated array of port names to which  the argument port is connected. if there are no connections, it  returns NULL.

The caller is responsible for calling free(3) on any non-NULL returned value.

It differs from \hyperlink{jack_8h_a21}{jack\_\-port\_\-get\_\-connections()} in two important respects:

1) You may not call this function from code that is executed in response to a JACK event. For example, you cannot use it in a Graph\-Reordered handler.

2) You need not be the owner of the port to get information about its connections. \hypertarget{jack_8h_a24}{
\index{jack.h@{jack.h}!jack_port_get_buffer@{jack\_\-port\_\-get\_\-buffer}}
\index{jack_port_get_buffer@{jack\_\-port\_\-get\_\-buffer}!jack.h@{jack.h}}
\subsubsection[jack\_\-port\_\-get\_\-buffer]{\setlength{\rightskip}{0pt plus 5cm}void$\ast$ jack\_\-port\_\-get\_\-buffer (\hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$, \hyperlink{types_8h_a2}{jack\_\-nframes\_\-t})}}
\label{jack_8h_a24}


This returns a pointer to the memory area associated with the specified port. For an output port, it will be a memory area that can be written to; for an input port, it will be an area containing the data from the port's connection(s), or zero-filled. if there are multiple inbound connections, the data will be mixed appropriately.

You may cache the value returned, but only between calls to your \char`\"{}blocksize\char`\"{} callback. For this reason alone, you should either never cache the return value or ensure you have a \char`\"{}blocksize\char`\"{} callback and be sure to invalidate the cached address from there. \hypertarget{jack_8h_a21}{
\index{jack.h@{jack.h}!jack_port_get_connections@{jack\_\-port\_\-get\_\-connections}}
\index{jack_port_get_connections@{jack\_\-port\_\-get\_\-connections}!jack.h@{jack.h}}
\subsubsection[jack\_\-port\_\-get\_\-connections]{\setlength{\rightskip}{0pt plus 5cm}const char$\ast$$\ast$ jack\_\-port\_\-get\_\-connections (const \hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$ {\em port})}}
\label{jack_8h_a21}


This returns a null-terminated array of port names to which  the argument port is connected. if there are no connections, it  returns NULL.

The caller is responsible for calling free(3) on any non-NULL returned value.

The calling client must own @port.

See \hyperlink{jack_8h_a22}{jack\_\-port\_\-get\_\-all\_\-connections()} for an alternative. \hypertarget{jack_8h_a33}{
\index{jack.h@{jack.h}!jack_port_get_latency@{jack\_\-port\_\-get\_\-latency}}
\index{jack_port_get_latency@{jack\_\-port\_\-get\_\-latency}!jack.h@{jack.h}}
\subsubsection[jack\_\-port\_\-get\_\-latency]{\setlength{\rightskip}{0pt plus 5cm}\hyperlink{types_8h_a2}{jack\_\-nframes\_\-t} jack\_\-port\_\-get\_\-latency (\hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$ {\em port})}}
\label{jack_8h_a33}


Returns the time (in frames) between data being available or delivered at/to a port, and the time at which it arrived at or is delivered to the \char`\"{}other side\char`\"{} of the port. E.g. for a physical audio output port, this is the time between writing to the port and when the audio will be audible. For a physical audio input port, this is the time between the sound being audible and the corresponding frames being readable from the port. \hypertarget{jack_8h_a34}{
\index{jack.h@{jack.h}!jack_port_get_total_latency@{jack\_\-port\_\-get\_\-total\_\-latency}}
\index{jack_port_get_total_latency@{jack\_\-port\_\-get\_\-total\_\-latency}!jack.h@{jack.h}}
\subsubsection[jack\_\-port\_\-get\_\-total\_\-latency]{\setlength{\rightskip}{0pt plus 5cm}\hyperlink{types_8h_a2}{jack\_\-nframes\_\-t} jack\_\-port\_\-get\_\-total\_\-latency (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$, \hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$ {\em port})}}
\label{jack_8h_a34}


The maximum of the sum of the latencies in every connection path that can be drawn between the port and other ports with the Jack\-Port\-Is\-Terminal flag set. \hypertarget{jack_8h_a18}{
\index{jack.h@{jack.h}!jack_port_is_mine@{jack\_\-port\_\-is\_\-mine}}
\index{jack_port_is_mine@{jack\_\-port\_\-is\_\-mine}!jack.h@{jack.h}}
\subsubsection[jack\_\-port\_\-is\_\-mine]{\setlength{\rightskip}{0pt plus 5cm}int jack\_\-port\_\-is\_\-mine (const \hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$, const \hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$ {\em port})}}
\label{jack_8h_a18}


Returns 1 if the jack\_\-port\_\-t belongs to the jack\_\-client\_\-t. \hypertarget{jack_8h_a31}{
\index{jack.h@{jack.h}!jack_port_lock@{jack\_\-port\_\-lock}}
\index{jack_port_lock@{jack\_\-port\_\-lock}!jack.h@{jack.h}}
\subsubsection[jack\_\-port\_\-lock]{\setlength{\rightskip}{0pt plus 5cm}int jack\_\-port\_\-lock (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$, \hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$)}}
\label{jack_8h_a31}


A client may call this function to prevent other objects from changing the connection status of a port. The port must be owned by the calling client. \hypertarget{jack_8h_a39}{
\index{jack.h@{jack.h}!jack_port_monitoring_input@{jack\_\-port\_\-monitoring\_\-input}}
\index{jack_port_monitoring_input@{jack\_\-port\_\-monitoring\_\-input}!jack.h@{jack.h}}
\subsubsection[jack\_\-port\_\-monitoring\_\-input]{\setlength{\rightskip}{0pt plus 5cm}int jack\_\-port\_\-monitoring\_\-input (\hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$ {\em port})}}
\label{jack_8h_a39}


Returns a true or false value depending on whether or not  input monitoring has been requested for 'port'. \hypertarget{jack_8h_a14}{
\index{jack.h@{jack.h}!jack_port_name@{jack\_\-port\_\-name}}
\index{jack_port_name@{jack\_\-port\_\-name}!jack.h@{jack.h}}
\subsubsection[jack\_\-port\_\-name]{\setlength{\rightskip}{0pt plus 5cm}const char$\ast$ jack\_\-port\_\-name (const \hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$ {\em port})}}
\label{jack_8h_a14}


Returns the name of the jack\_\-port\_\-t. \hypertarget{jack_8h_a12}{
\index{jack.h@{jack.h}!jack_port_register@{jack\_\-port\_\-register}}
\index{jack_port_register@{jack\_\-port\_\-register}!jack.h@{jack.h}}
\subsubsection[jack\_\-port\_\-register]{\setlength{\rightskip}{0pt plus 5cm}\hyperlink{types_8h_a3}{jack\_\-port\_\-t}$\ast$ jack\_\-port\_\-register (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$, const char $\ast$ {\em port\_\-name}, const char $\ast$ {\em port\_\-type}, unsigned long {\em flags}, unsigned long {\em buffer\_\-size})}}
\label{jack_8h_a12}


This creates a new port for the client.

A port is an object used for moving data in or out of the client. the data may be of any type. Ports may be connected to each other in various ways.

A port has a short name, which may be any non-NULL and non-zero length string, and is passed as the first argument. A port's full name is the name of the client concatenated with a colon (:) and then its short name.

A port has a type, which may be any non-NULL and non-zero length string, and is passed as the second argument. For types that are not built into the jack API (currently just JACK\_\-DEFAULT\_\-AUDIO\_\-TYPE) the client MUST supply a non-zero size for the buffer as for @buffer\_\-size. For builtin types,  @buffer\_\-size is ignored.

The @flags argument is formed from a bitmask of Jack\-Port\-Flags values. \hypertarget{jack_8h_a36}{
\index{jack.h@{jack.h}!jack_port_request_monitor@{jack\_\-port\_\-request\_\-monitor}}
\index{jack_port_request_monitor@{jack\_\-port\_\-request\_\-monitor}!jack.h@{jack.h}}
\subsubsection[jack\_\-port\_\-request\_\-monitor]{\setlength{\rightskip}{0pt plus 5cm}int jack\_\-port\_\-request\_\-monitor (\hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$ {\em port}, int {\em onoff})}}
\label{jack_8h_a36}


If Jack\-Port\-Can\-Monitor is set for a port, then these 2 functions will turn on/off input monitoring for the port. If Jack\-Port\-Can\-Monitor is not set, then these functions will have no effect. \hypertarget{jack_8h_a37}{
\index{jack.h@{jack.h}!jack_port_request_monitor_by_name@{jack\_\-port\_\-request\_\-monitor\_\-by\_\-name}}
\index{jack_port_request_monitor_by_name@{jack\_\-port\_\-request\_\-monitor\_\-by\_\-name}!jack.h@{jack.h}}
\subsubsection[jack\_\-port\_\-request\_\-monitor\_\-by\_\-name]{\setlength{\rightskip}{0pt plus 5cm}int jack\_\-port\_\-request\_\-monitor\_\-by\_\-name (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$ {\em client}, const char $\ast$ {\em port\_\-name}, int {\em onoff})}}
\label{jack_8h_a37}


If Jack\-Port\-Can\-Monitor is set for a port, then these 2 functions will turn on/off input monitoring for the port. If Jack\-Port\-Can\-Monitor is not set, then these functions will have no effect. \hypertarget{jack_8h_a35}{
\index{jack.h@{jack.h}!jack_port_set_latency@{jack\_\-port\_\-set\_\-latency}}
\index{jack_port_set_latency@{jack\_\-port\_\-set\_\-latency}!jack.h@{jack.h}}
\subsubsection[jack\_\-port\_\-set\_\-latency]{\setlength{\rightskip}{0pt plus 5cm}void jack\_\-port\_\-set\_\-latency (\hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$, \hyperlink{types_8h_a2}{jack\_\-nframes\_\-t})}}
\label{jack_8h_a35}


The port latency is zero by default. Clients that control physical hardware with non-zero latency should call this to set the latency to its correct value. Note that the value should include any systemic latency present \char`\"{}outside\char`\"{} the physical hardware controlled by the client. For example, for a client controlling a digital audio interface connected to an external digital converter, the latency setting should include both buffering by the audio interface $\ast$and$\ast$ the converter. \hypertarget{jack_8h_a23}{
\index{jack.h@{jack.h}!jack_port_set_name@{jack\_\-port\_\-set\_\-name}}
\index{jack_port_set_name@{jack\_\-port\_\-set\_\-name}!jack.h@{jack.h}}
\subsubsection[jack\_\-port\_\-set\_\-name]{\setlength{\rightskip}{0pt plus 5cm}int jack\_\-port\_\-set\_\-name (\hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$ {\em port}, const char $\ast$ {\em name})}}
\label{jack_8h_a23}


This modifies a port's name, and may be called at any time. \hypertarget{jack_8h_a15}{
\index{jack.h@{jack.h}!jack_port_short_name@{jack\_\-port\_\-short\_\-name}}
\index{jack_port_short_name@{jack\_\-port\_\-short\_\-name}!jack.h@{jack.h}}
\subsubsection[jack\_\-port\_\-short\_\-name]{\setlength{\rightskip}{0pt plus 5cm}const char$\ast$ jack\_\-port\_\-short\_\-name (const \hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$ {\em port})}}
\label{jack_8h_a15}


Returns the short name of the jack\_\-port\_\-t. \hypertarget{jack_8h_a29}{
\index{jack.h@{jack.h}!jack_port_tie@{jack\_\-port\_\-tie}}
\index{jack_port_tie@{jack\_\-port\_\-tie}!jack.h@{jack.h}}
\subsubsection[jack\_\-port\_\-tie]{\setlength{\rightskip}{0pt plus 5cm}int jack\_\-port\_\-tie (\hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$ {\em src}, \hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$ {\em dst})}}
\label{jack_8h_a29}


A client may call this on a pair of its own ports to  semi-permanently wire them together. This means that a client that wants to direct-wire an input port to an output port can call this and then no longer have to worry about moving data between them. Any data arriving at the input port will appear automatically at the output port.

The 'destination' port must be an output port. The 'source' port must be an input port. Both ports must belong to the same client. You cannot use this to tie ports between clients. That is what a connection is for. \hypertarget{jack_8h_a17}{
\index{jack.h@{jack.h}!jack_port_type@{jack\_\-port\_\-type}}
\index{jack_port_type@{jack\_\-port\_\-type}!jack.h@{jack.h}}
\subsubsection[jack\_\-port\_\-type]{\setlength{\rightskip}{0pt plus 5cm}const char$\ast$ jack\_\-port\_\-type (const \hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$ {\em port})}}
\label{jack_8h_a17}


Returns the type of the jack\_\-port\_\-t. \hypertarget{jack_8h_a32}{
\index{jack.h@{jack.h}!jack_port_unlock@{jack\_\-port\_\-unlock}}
\index{jack_port_unlock@{jack\_\-port\_\-unlock}!jack.h@{jack.h}}
\subsubsection[jack\_\-port\_\-unlock]{\setlength{\rightskip}{0pt plus 5cm}int jack\_\-port\_\-unlock (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$, \hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$)}}
\label{jack_8h_a32}


This allows other objects to change the connection status of a port. \hypertarget{jack_8h_a13}{
\index{jack.h@{jack.h}!jack_port_unregister@{jack\_\-port\_\-unregister}}
\index{jack_port_unregister@{jack\_\-port\_\-unregister}!jack.h@{jack.h}}
\subsubsection[jack\_\-port\_\-unregister]{\setlength{\rightskip}{0pt plus 5cm}int jack\_\-port\_\-unregister (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$, \hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$)}}
\label{jack_8h_a13}


This removes the port from the client, disconnecting any existing connections at the same time. \hypertarget{jack_8h_a30}{
\index{jack.h@{jack.h}!jack_port_untie@{jack\_\-port\_\-untie}}
\index{jack_port_untie@{jack\_\-port\_\-untie}!jack.h@{jack.h}}
\subsubsection[jack\_\-port\_\-untie]{\setlength{\rightskip}{0pt plus 5cm}int jack\_\-port\_\-untie (\hyperlink{types_8h_a3}{jack\_\-port\_\-t} $\ast$ {\em port})}}
\label{jack_8h_a30}


This undoes the effect of \hyperlink{jack_8h_a29}{jack\_\-port\_\-tie()}. The port should be same as the 'destination' port passed to \hyperlink{jack_8h_a29}{jack\_\-port\_\-tie()}. \hypertarget{jack_8h_a52}{
\index{jack.h@{jack.h}!jack_remove_alias@{jack\_\-remove\_\-alias}}
\index{jack_remove_alias@{jack\_\-remove\_\-alias}!jack.h@{jack.h}}
\subsubsection[jack\_\-remove\_\-alias]{\setlength{\rightskip}{0pt plus 5cm}int jack\_\-remove\_\-alias (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$, const char $\ast$ {\em alias})}}
\label{jack_8h_a52}


Remove `alias' from a JACK system. Returns zero if successful, less than zero if the alias did not exist, greater than zero if the alias could not be removed. \hypertarget{jack_8h_a5}{
\index{jack.h@{jack.h}!jack_set_buffer_size_callback@{jack\_\-set\_\-buffer\_\-size\_\-callback}}
\index{jack_set_buffer_size_callback@{jack\_\-set\_\-buffer\_\-size\_\-callback}!jack.h@{jack.h}}
\subsubsection[jack\_\-set\_\-buffer\_\-size\_\-callback]{\setlength{\rightskip}{0pt plus 5cm}int jack\_\-set\_\-buffer\_\-size\_\-callback (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$, \hyperlink{types_8h_a9}{Jack\-Buffer\-Size\-Callback} {\em bufsize\_\-callback}, void $\ast$ {\em arg})}}
\label{jack_8h_a5}


Tell the Jack server to call 'bufsize\_\-callback' whenever the maximum number of frames that could be passed to 'process()' changes. 'arg' will be supplied as a second argument. \hypertarget{jack_8h_a8}{
\index{jack.h@{jack.h}!jack_set_graph_order_callback@{jack\_\-set\_\-graph\_\-order\_\-callback}}
\index{jack_set_graph_order_callback@{jack\_\-set\_\-graph\_\-order\_\-callback}!jack.h@{jack.h}}
\subsubsection[jack\_\-set\_\-graph\_\-order\_\-callback]{\setlength{\rightskip}{0pt plus 5cm}int jack\_\-set\_\-graph\_\-order\_\-callback (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$, \hyperlink{types_8h_a7}{Jack\-Graph\-Order\-Callback} {\em graph\_\-callback}, void $\ast$)}}
\label{jack_8h_a8}


Tell the Jack server to call 'registration\_\-callback' whenever the processing graph is reordered, passing 'arg' as an argument. \hypertarget{jack_8h_a7}{
\index{jack.h@{jack.h}!jack_set_port_registration_callback@{jack\_\-set\_\-port\_\-registration\_\-callback}}
\index{jack_set_port_registration_callback@{jack\_\-set\_\-port\_\-registration\_\-callback}!jack.h@{jack.h}}
\subsubsection[jack\_\-set\_\-port\_\-registration\_\-callback]{\setlength{\rightskip}{0pt plus 5cm}int jack\_\-set\_\-port\_\-registration\_\-callback (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$, \hyperlink{types_8h_a11}{Jack\-Port\-Registration\-Callback} {\em registration\_\-callback}, void $\ast$ {\em arg})}}
\label{jack_8h_a7}


Tell the Jack server to call 'registration\_\-callback' whenever a port is registered or unregistered, passing 'arg' as a second argument. \hypertarget{jack_8h_a4}{
\index{jack.h@{jack.h}!jack_set_process_callback@{jack\_\-set\_\-process\_\-callback}}
\index{jack_set_process_callback@{jack\_\-set\_\-process\_\-callback}!jack.h@{jack.h}}
\subsubsection[jack\_\-set\_\-process\_\-callback]{\setlength{\rightskip}{0pt plus 5cm}int jack\_\-set\_\-process\_\-callback (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$, \hyperlink{types_8h_a6}{Jack\-Process\-Callback} {\em process\_\-callback}, void $\ast$ {\em arg})}}
\label{jack_8h_a4}


Tell the Jack server to call 'process\_\-callback' whenever there is work be done, passing 'arg' as the second argument. \hypertarget{jack_8h_a6}{
\index{jack.h@{jack.h}!jack_set_sample_rate_callback@{jack\_\-set\_\-sample\_\-rate\_\-callback}}
\index{jack_set_sample_rate_callback@{jack\_\-set\_\-sample\_\-rate\_\-callback}!jack.h@{jack.h}}
\subsubsection[jack\_\-set\_\-sample\_\-rate\_\-callback]{\setlength{\rightskip}{0pt plus 5cm}int jack\_\-set\_\-sample\_\-rate\_\-callback (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$, \hyperlink{types_8h_a10}{Jack\-Sample\-Rate\-Callback} {\em srate\_\-callback}, void $\ast$ {\em arg})}}
\label{jack_8h_a6}


Tell the Jack server to call 'srate\_\-callback' whenever the sample rate of the system changes. \hypertarget{jack_8h_a50}{
\index{jack.h@{jack.h}!jack_set_server_dir@{jack\_\-set\_\-server\_\-dir}}
\index{jack_set_server_dir@{jack\_\-set\_\-server\_\-dir}!jack.h@{jack.h}}
\subsubsection[jack\_\-set\_\-server\_\-dir]{\setlength{\rightskip}{0pt plus 5cm}void jack\_\-set\_\-server\_\-dir (const char $\ast$ {\em path})}}
\label{jack_8h_a50}


Set the directory in which the server is expected to have put its communication FIFOs. A client will need to call this before calling \hyperlink{jack_8h_a0}{jack\_\-client\_\-new()} if the server was started with arguments telling it to use a non-standard directory. \hypertarget{jack_8h_a9}{
\index{jack.h@{jack.h}!jack_set_xrun_callback@{jack\_\-set\_\-xrun\_\-callback}}
\index{jack_set_xrun_callback@{jack\_\-set\_\-xrun\_\-callback}!jack.h@{jack.h}}
\subsubsection[jack\_\-set\_\-xrun\_\-callback]{\setlength{\rightskip}{0pt plus 5cm}int jack\_\-set\_\-xrun\_\-callback (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$, \hyperlink{types_8h_a8}{Jack\-XRun\-Callback} {\em xrun\_\-callback}, void $\ast$ {\em arg})}}
\label{jack_8h_a9}


Tell the Jack server to call 'xrun\_\-callback' whenever there is a xrun, passing 'arg' as an argument. \hypertarget{jack_8h_a46}{
\index{jack.h@{jack.h}!jack_update_time@{jack\_\-update\_\-time}}
\index{jack_update_time@{jack\_\-update\_\-time}!jack.h@{jack.h}}
\subsubsection[jack\_\-update\_\-time]{\setlength{\rightskip}{0pt plus 5cm}void jack\_\-update\_\-time (\hyperlink{types_8h_a4}{jack\_\-client\_\-t} $\ast$, \hyperlink{types_8h_a2}{jack\_\-nframes\_\-t})}}
\label{jack_8h_a46}


undocumented