Statistics
| Branch: | Revision:

urtware / doc / activitydiagrams / request / srtrequest / urtSrtRequestTryAcquire.svg @ 5c6cb22f

History | View | Annotate | Download (14.181 KB)

1 2d315870 Thomas Schöpping
<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="470px" preserveAspectRatio="none" style="width:1030px;height:470px;" version="1.1" viewBox="0 0 1030 470" width="1030px" zoomAndPan="magnify"><defs><filter height="300%" id="fyt4o6we16ks9" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.0"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.0" dy="4.0" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><text fill="#000000" font-family="sans-serif" font-size="18" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="89" x="469.5" y="26.708">µRtWare</text><text fill="#000000" font-family="sans-serif" font-size="18" lengthAdjust="spacingAndGlyphs" textLength="236" x="396" y="47.6611">urtSrtRequestTryAcquire()</text><text fill="#000000" font-family="sans-serif" font-size="18" lengthAdjust="spacingAndGlyphs" textLength="0" x="517" y="68.6143"/><path d="M437,72.8594 L437,198.7891 L1018,198.7891 L1018,82.8594 L1008,72.8594 L437,72.8594 " fill="#FBFB77" filter="url(#fyt4o6we16ks9)" style="stroke: #A80036; stroke-width: 1.0;"/><path d="M1008,72.8594 L1008,82.8594 L1018,82.8594 L1008,72.8594 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.0;"/><line style="stroke: #A80036; stroke-width: 1.0;" x1="437" x2="634" y1="85.4258" y2="85.4258"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacingAndGlyphs" textLength="0" x="638" y="89.4263"/><text fill="#000000" font-family="sans-serif" font-size="13" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="57" x="638" y="89.4263">request</text><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacingAndGlyphs" textLength="118" x="699" y="89.4263">: urt_srtrequest_t*</text><line style="stroke: #A80036; stroke-width: 1.0;" x1="821" x2="1018" y1="85.4258" y2="85.4258"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacingAndGlyphs" textLength="204" x="443" y="105.0591">The SRT request to be acquired.</text><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacingAndGlyphs" textLength="76" x="443" y="120.1919">Must not be</text><text fill="#000000" font-family="monospace" font-size="13" lengthAdjust="spacingAndGlyphs" textLength="32" x="523" y="120.1919">NULL</text><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacingAndGlyphs" textLength="4" x="555" y="120.1919">.</text><line style="stroke: #A80036; stroke-width: 1.0;" x1="437" x2="1018" y1="128.2578" y2="128.2578"/><line style="stroke: #A80036; stroke-width: 1.0;" x1="437" x2="1018" y1="130.2578" y2="130.2578"/><line style="stroke: #A80036; stroke-width: 1.0;" x1="437" x2="656.5" y1="140.8242" y2="140.8242"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacingAndGlyphs" textLength="0" x="660.5" y="144.8247"/><text fill="#000000" font-family="sans-serif" font-size="13" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="45" x="660.5" y="144.8247">return</text><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacingAndGlyphs" textLength="85" x="709.5" y="144.8247">: urt_status_t</text><line style="stroke: #A80036; stroke-width: 1.0;" x1="798.5" x2="1018" y1="140.8242" y2="140.8242"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacingAndGlyphs" textLength="49" x="443" y="160.4575">Returns</text><text fill="#000000" font-family="monospace" font-size="13" lengthAdjust="spacingAndGlyphs" textLength="104" x="496" y="160.4575">URT_STATUS_OK</text><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacingAndGlyphs" textLength="120" x="604" y="160.4575">in case of success.</text><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacingAndGlyphs" textLength="49" x="443" y="175.5903">Returns</text><text fill="#000000" font-family="monospace" font-size="13" lengthAdjust="spacingAndGlyphs" textLength="216" x="496" y="175.5903">URT_STATUS_REQUEST_BADOWNER</text><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacingAndGlyphs" textLength="287" x="716" y="175.5903">if the request is aloready owned by a service.</text><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacingAndGlyphs" textLength="49" x="443" y="190.7231">Returns</text><text fill="#000000" font-family="monospace" font-size="13" lengthAdjust="spacingAndGlyphs" textLength="200" x="496" y="190.7231">URT_STATUS_REQUEST_LOCKED</text><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacingAndGlyphs" textLength="254" x="700" y="190.7231">if the request's mutex is already locked.</text><ellipse cx="727.5" cy="228.7891" fill="#000000" filter="url(#fyt4o6we16ks9)" rx="10" ry="10" style="stroke: none; stroke-width: 1.0;"/><path d="M538.5,263.207 L538.5,288.3398 A0,0 0 0 0 538.5,288.3398 L658.5,288.3398 A0,0 0 0 0 658.5,288.3398 L658.5,281.207 L678.5,275.7734 L658.5,273.207 L658.5,273.207 L648.5,263.207 L538.5,263.207 A0,0 0 0 0 538.5,263.207 " fill="#FBFB77" filter="url(#fyt4o6we16ks9)" style="stroke: #A80036; stroke-width: 1.0;"/><path d="M648.5,263.207 L648.5,273.207 L658.5,273.207 L648.5,263.207 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.0;"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacingAndGlyphs" textLength="99" x="544.5" y="280.2739">Does not block.</text><rect fill="#FEFECE" filter="url(#fyt4o6we16ks9)" height="33.9688" rx="12.5" ry="12.5" style="stroke: #A80036; stroke-width: 1.5;" width="98" x="678.5" y="258.7891"/><text fill="#000000" font-family="sans-serif" font-size="12" lengthAdjust="spacingAndGlyphs" textLength="78" x="688.5" y="279.9277">lock request</text><polygon fill="#FEFECE" filter="url(#fyt4o6we16ks9)" points="655.5,312.7578,799.5,312.7578,811.5,324.7578,799.5,336.7578,655.5,336.7578,643.5,324.7578,655.5,312.7578" style="stroke: #A80036; stroke-width: 1.5;"/><text fill="#000000" font-family="sans-serif" font-size="11" lengthAdjust="spacingAndGlyphs" textLength="144" x="655.5" y="328.5659">Request could be locked?</text><text fill="#000000" font-family="sans-serif" font-size="11" lengthAdjust="spacingAndGlyphs" textLength="20" x="623.5" y="322.1636">yes</text><text fill="#000000" font-family="sans-serif" font-size="11" lengthAdjust="spacingAndGlyphs" textLength="14" x="811.5" y="322.1636">no</text><polygon fill="#FEFECE" filter="url(#fyt4o6we16ks9)" points="390,346.7578,570,346.7578,582,358.7578,570,370.7578,390,370.7578,378,358.7578,390,346.7578" style="stroke: #A80036; stroke-width: 1.5;"/><text fill="#000000" font-family="sans-serif" font-size="11" lengthAdjust="spacingAndGlyphs" textLength="180" x="390" y="362.5659">Request is owned by a service?</text><text fill="#000000" font-family="sans-serif" font-size="11" lengthAdjust="spacingAndGlyphs" textLength="20" x="358" y="356.1636">yes</text><text fill="#000000" font-family="sans-serif" font-size="11" lengthAdjust="spacingAndGlyphs" textLength="14" x="582" y="356.1636">no</text><rect fill="#FEFECE" filter="url(#fyt4o6we16ks9)" height="33.9688" rx="12.5" ry="12.5" style="stroke: #A80036; stroke-width: 1.5;" width="114" x="278" y="380.7578"/><text fill="#000000" font-family="sans-serif" font-size="12" lengthAdjust="spacingAndGlyphs" textLength="94" x="288" y="401.8965">unlock request</text><path d="M10,433.1602 L10,458.293 A0,0 0 0 0 10,458.293 L304,458.293 A0,0 0 0 0 304,458.293 L304,451.1602 L324,445.7266 L304,443.1602 L304,443.1602 L294,433.1602 L10,433.1602 A0,0 0 0 0 10,433.1602 " fill="#FBFB77" filter="url(#fyt4o6we16ks9)" style="stroke: #A80036; stroke-width: 1.0;"/><path d="M294,433.1602 L294,443.1602 L304,443.1602 L294,433.1602 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.0;"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacingAndGlyphs" textLength="49" x="16" y="450.2271">Returns</text><text fill="#000000" font-family="monospace" font-size="13" lengthAdjust="spacingAndGlyphs" textLength="216" x="69" y="450.2271">URT_STATUS_REQUEST_BADOWNER</text><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacingAndGlyphs" textLength="4" x="285" y="450.2271">.</text><ellipse cx="335" cy="445.7266" fill="#FFFFFF" filter="url(#fyt4o6we16ks9)" rx="11" ry="11" style="stroke: #000000; stroke-width: 1.0;"/><ellipse cx="335" cy="445.7266" fill="#000000" rx="6" ry="6" style="stroke: #7F7F7F; stroke-width: 1.0;"/><path d="M412,380.7578 L412,405.8906 A0,0 0 0 0 412,405.8906 L594,405.8906 A0,0 0 0 0 594,405.8906 L594,398.7578 L614,393.3242 L594,390.7578 L594,390.7578 L584,380.7578 L412,380.7578 A0,0 0 0 0 412,380.7578 " fill="#FBFB77" filter="url(#fyt4o6we16ks9)" style="stroke: #A80036; stroke-width: 1.0;"/><path d="M584,380.7578 L584,390.7578 L594,390.7578 L584,380.7578 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.0;"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacingAndGlyphs" textLength="49" x="418" y="397.8247">Returns</text><text fill="#000000" font-family="monospace" font-size="13" lengthAdjust="spacingAndGlyphs" textLength="104" x="471" y="397.8247">URT_STATUS_OK</text><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacingAndGlyphs" textLength="4" x="575" y="397.8247">.</text><ellipse cx="625" cy="393.3242" fill="#FFFFFF" filter="url(#fyt4o6we16ks9)" rx="11" ry="11" style="stroke: #000000; stroke-width: 1.0;"/><ellipse cx="625" cy="393.3242" fill="#000000" rx="6" ry="6" style="stroke: #7F7F7F; stroke-width: 1.0;"/><path d="M666,346.7578 L666,371.8906 A0,0 0 0 0 666,371.8906 L944,371.8906 A0,0 0 0 0 944,371.8906 L944,364.7578 L964,359.3242 L944,356.7578 L944,356.7578 L934,346.7578 L666,346.7578 A0,0 0 0 0 666,346.7578 " fill="#FBFB77" filter="url(#fyt4o6we16ks9)" style="stroke: #A80036; stroke-width: 1.0;"/><path d="M934,346.7578 L934,356.7578 L944,356.7578 L934,346.7578 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.0;"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacingAndGlyphs" textLength="49" x="672" y="363.8247">Returns</text><text fill="#000000" font-family="monospace" font-size="13" lengthAdjust="spacingAndGlyphs" textLength="200" x="725" y="363.8247">URT_STATUS_REQUEST_LOCKED</text><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacingAndGlyphs" textLength="4" x="925" y="363.8247">.</text><ellipse cx="975" cy="359.3242" fill="#FFFFFF" filter="url(#fyt4o6we16ks9)" rx="11" ry="11" style="stroke: #000000; stroke-width: 1.0;"/><ellipse cx="975" cy="359.3242" fill="#000000" rx="6" ry="6" style="stroke: #7F7F7F; stroke-width: 1.0;"/><line style="stroke: #A80036; stroke-width: 1.5;" x1="727.5" x2="727.5" y1="198.7891" y2="218.7891"/><polygon fill="#A80036" points="723.5,208.7891,727.5,218.7891,731.5,208.7891,727.5,212.7891" style="stroke: #A80036; stroke-width: 1.0;"/><line style="stroke: #A80036; stroke-width: 1.5;" x1="727.5" x2="727.5" y1="238.7891" y2="258.7891"/><polygon fill="#A80036" points="723.5,248.7891,727.5,258.7891,731.5,248.7891,727.5,252.7891" style="stroke: #A80036; stroke-width: 1.0;"/><line style="stroke: #A80036; stroke-width: 1.5;" x1="335" x2="335" y1="414.7266" y2="434.7266"/><polygon fill="#A80036" points="331,424.7266,335,434.7266,339,424.7266,335,428.7266" style="stroke: #A80036; stroke-width: 1.0;"/><line style="stroke: #A80036; stroke-width: 1.5;" x1="378" x2="335" y1="358.7578" y2="358.7578"/><line style="stroke: #A80036; stroke-width: 1.5;" x1="335" x2="335" y1="358.7578" y2="380.7578"/><polygon fill="#A80036" points="331,370.7578,335,380.7578,339,370.7578,335,374.7578" style="stroke: #A80036; stroke-width: 1.0;"/><line style="stroke: #A80036; stroke-width: 1.5;" x1="582" x2="625" y1="358.7578" y2="358.7578"/><line style="stroke: #A80036; stroke-width: 1.5;" x1="625" x2="625" y1="358.7578" y2="382.3242"/><polygon fill="#A80036" points="621,372.3242,625,382.3242,629,372.3242,625,376.3242" style="stroke: #A80036; stroke-width: 1.0;"/><line style="stroke: #A80036; stroke-width: 1.5;" x1="643.5" x2="480" y1="324.7578" y2="324.7578"/><line style="stroke: #A80036; stroke-width: 1.5;" x1="480" x2="480" y1="324.7578" y2="346.7578"/><polygon fill="#A80036" points="476,336.7578,480,346.7578,484,336.7578,480,340.7578" style="stroke: #A80036; stroke-width: 1.0;"/><line style="stroke: #A80036; stroke-width: 1.5;" x1="811.5" x2="975" y1="324.7578" y2="324.7578"/><line style="stroke: #A80036; stroke-width: 1.5;" x1="975" x2="975" y1="324.7578" y2="348.3242"/><polygon fill="#A80036" points="971,338.3242,975,348.3242,979,338.3242,975,342.3242" style="stroke: #A80036; stroke-width: 1.0;"/><line style="stroke: #A80036; stroke-width: 1.5;" x1="727.5" x2="727.5" y1="292.7578" y2="312.7578"/><polygon fill="#A80036" points="723.5,302.7578,727.5,312.7578,731.5,302.7578,727.5,306.7578" style="stroke: #A80036; stroke-width: 1.0;"/><!--MD5=[e08e75b745c41c19a2afa393cbad90e7]
2
@startuml
3
4
title **µRtWare**\nurtSrtRequestTryAcquire()\n
5
6
7
8
9
10
11
note
12
  - - **request** : urt_srtrequest_t* - -
13
  The SRT request to be acquired.
14
  Must not be ""NULL"".
15
  ====
16
  - - **return** : urt_status_t - -
17
  Returns ""URT_STATUS_OK"" in case of success.
18
  Returns ""URT_STATUS_REQUEST_BADOWNER"" if the request is aloready owned by a service.
19
  Returns ""URT_STATUS_REQUEST_LOCKED"" if the request's mutex is already locked.
20
endnote
21
22
23
  start
24
  :lock request;
25
  note
26
    Does not block.
27
  endnote
28
  if (Request could be locked?) then (yes)
29
    if (Request is owned by a service?) then (yes)
30
      :unlock request;
31
      stop
32
      note
33
        Returns ""URT_STATUS_REQUEST_BADOWNER"".
34
      endnote
35
    else (no)
36
      stop
37
      note
38
        Returns ""URT_STATUS_OK"".
39
      endnote
40
    endif
41
  else (no)
42
    stop
43
    note
44
      Returns ""URT_STATUS_REQUEST_LOCKED"".
45
    endnote
46
  endif
47
48
49
@enduml
50
51
PlantUML version 1.2020.00(Sat Jan 11 13:30:53 CET 2020)
52
(GPL source distribution)
53
Java Runtime: OpenJDK Runtime Environment
54
JVM: OpenJDK 64-Bit Server VM
55
Java Version: 11.0.7+10-post-Ubuntu-2ubuntu218.04
56
Operating System: Linux
57
Default Encoding: UTF-8
58
Language: en
59
Country: US
60
--></g></svg>