add-optional-permissions: add ability to change permissions of screen recording file and path

[alailsonko]

Description

Add record-path-permissions and record-file-permissions optional fields when starting record of session.

[necouchman]

@alailsonko: Thanks for the pull request and contribution to the project. You'll need to get a Jira account and create a Jira issue for this, and then tag both the pull request and the commit messages with the Jira issue (GUACAMOLE-XXXX:) before we'll accept and merge this.

Please see the following page for full contribution guidelines: https://guacamole.apache.org/open-source/

[mike-jumper]

I'm not sure about directly coupling the API for screen recordings to POSIX-specific mode_t when libguac is generally intended to support Windows as a platform. Perhaps there's a way to implement this without making guac_recording_create() non-portable?

If it were possible to implement this in a way that doesn't require API/ABI-breaking changes, that would also be ideal.

[alailsonko]

i dont have the jira account for create issues at the moment.

thanks for letting me know and giving attention to this PR, i understand it is very delicate change.

we could change from mode_t to int, i think it would be agnostic. or creating own mode_t type.

i was reading documentation of c in microsoft and they use type int for mode.

• https://learn.microsoft.com/en-us/cpp/c-runtime-library/reference/open-wopen?view=msvc-170

int _open(
   const char *filename,
   int oflag [,
   int pmode]
);
int _wopen(
   const wchar_t *filename,
   int oflag [,
   int pmode]
);

• https://learn.microsoft.com/en-us/cpp/c-runtime-library/reference/sopen-s-wsopen-s?view=msvc-170

errno_t _sopen_s(
   int* pfh,
   const char *filename,
   int oflag,
   int shflag,
   int pmode
);
errno_t _wsopen_s(
   int* pfh,
   const wchar_t *filename,
   int oflag,
   int shflag,
   int pmode,
);