modules/access/vnc.c

   1 /*****************************************************************************
   2  * vnc.c: libVNC access
   3  *****************************************************************************
   4  * Copyright (C) 2013 VideoLAN and VLC Authors
   5  *****************************************************************************
   6  *
   7  * This program is free software; you can redistribute it and/or modify it
   8  * under the terms of the GNU Lesser General Public License as published by
   9  * the Free Software Foundation; either version 2.1 of the License, or
  10  * (at your option) any later version.
  11  *
  12  * This program is distributed in the hope that it will be useful,
  13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  15  * GNU Lesser General Public License for more details.
  16  *
  17  * You should have received a copy of the GNU Lesser General Public License
  18  * along with this program; if not, write to the Free Software Foundation,
  19  * Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
  20  *****************************************************************************/
  21
  22 /*****************************************************************************
  23  * NOTA BENE: this module requires the linking against a library which is
  24  * known to require licensing under the GNU General Public License version 2
  25  * (or later). Therefore, the result of compiling this module will normally
  26  * be subject to the terms of that later license.
  27  *****************************************************************************/
  28
  29 /*****************************************************************************
  30  * Preamble
  31  *****************************************************************************/
  32
  33 #ifdef HAVE_CONFIG_H
  34 # include "config.h"
  35 #endif
  36
  37 #include <vlc_common.h>
  38 #include <vlc_plugin.h>
  39 #include <vlc_demux.h>
  40 #include <vlc_url.h>
  41 #include <vlc_meta.h>
  42 #include <vlc_fourcc.h>
  43
  44 #include <rfb/rfbclient.h>
  45
  46 #define RFB_USER N_("Username")
  47 #define RFB_PASSWORD N_("Password")
  48 #define RFB_CA_TEXT N_("X.509 Certificate Authority")
  49 #define RFB_CA_LONGTEXT N_("Certificate of the Authority to verify server's against")
  50 #define RFB_CRL_TEXT N_("X.509 Certificate Revocation List")
  51 #define RFB_CRL_LONGTEXT N_("List of revoked servers certificates")
  52 #define RFB_CERT_TEXT N_("X.509 Client certificate")
  53 #define RFB_CERT_LONGTEXT N_("Certificate for client authentication")
  54 #define RFB_KEY_TEXT N_("X.509 Client private key")
  55 #define RFB_KEY_LONGTEXT N_("Private key for authentication by certificate")
  56
  57 #define RFB_CHROMA N_("Frame buffer depth")
  58 #define RFB_CHROMA_LONGTEXT N_("RGB chroma (RV32, RV24, RV16, RGB2)")
  59 #define RFB_FPS N_("Frame rate")
  60 #define RFB_FPS_LONGTEXT N_("How many times the screen content should be refreshed per second.")
  61 #define RFB_COMPRESS N_("Compression level")
  62 #define RFB_COMPRESS_LONGTEXT N_("Transfer compression level from 0 (none) to 9 (max)")
  63 #define RFB_QUALITY N_("Image quality")
  64 #define RFB_QUALITY_LONGTEXT N_("Image quality 1 to 9 (max)")
  65
  66 #define CFG_PREFIX "rfb-"
  67
  68 const char *const rgb_chromas[] = { N_("32 bits"), N_("24 bits"), N_("16 bits"), N_("8 bits") };
  69 const char *const rgb_chromas_v[] = { "RV32", "RV24", "RV16", "RGB8" };
  70
  71 /*****************************************************************************
  72  * Module descriptor
  73  *****************************************************************************/
  74 static int  Open ( vlc_object_t * );
  75 static void Close( vlc_object_t * );
  76
  77 vlc_module_begin()
  78     set_shortname( N_("VNC") )
  79     add_shortcut( "vnc" )
  80     set_category( CAT_INPUT )
  81     set_subcategory( SUBCAT_INPUT_ACCESS )
  82     set_description( N_("VNC client access") )
  83     set_capability( "access_demux", 0 )
  84
  85     add_string( CFG_PREFIX "user", NULL, RFB_USER, RFB_USER, false )
  86         change_safe()
  87     add_password( CFG_PREFIX "password", NULL, RFB_PASSWORD, RFB_PASSWORD, false )
  88         change_safe()
  89     add_loadfile( CFG_PREFIX "x509-ca", NULL, RFB_CA_TEXT, RFB_CA_LONGTEXT, true )
  90         change_safe()
  91     add_loadfile( CFG_PREFIX "x509-crl", NULL, RFB_CRL_TEXT, RFB_CRL_LONGTEXT, true )
  92         change_safe()
  93     add_loadfile( CFG_PREFIX "x509-client-cert", NULL, RFB_CERT_TEXT, RFB_CERT_LONGTEXT, true )
  94         change_safe()
  95     add_loadfile( CFG_PREFIX "x509-client-key", NULL, RFB_KEY_TEXT, RFB_KEY_LONGTEXT, true )
  96         change_safe()
  97
  98     add_float( CFG_PREFIX "fps", 5, RFB_FPS, RFB_FPS_LONGTEXT, true )
  99     add_string( CFG_PREFIX "chroma", rgb_chromas_v[0], RFB_CHROMA, RFB_CHROMA_LONGTEXT, false )
 100         change_string_list (rgb_chromas_v, rgb_chromas)
 101         change_safe()
 102     add_integer( CFG_PREFIX "compress-level", 0, RFB_COMPRESS, RFB_COMPRESS_LONGTEXT, true )
 103         change_integer_range (0, 9)
 104         change_safe()
 105     add_integer( CFG_PREFIX "quality-level", 9, RFB_QUALITY, RFB_QUALITY_LONGTEXT, true )
 106         change_integer_range (1, 9)
 107         change_safe()
 108
 109     set_callbacks( Open, Close )
 110 vlc_module_end()
 111
 112 struct demux_sys_t
 113 {
 114     vlc_thread_t thread;
 115     int i_cancel_state;
 116
 117     rfbClient* p_client;
 118     int i_framebuffersize;
 119     block_t *p_block;
 120
 121     float f_fps;
 122     int i_frame_interval;
 123     mtime_t i_starttime;
 124
 125     es_out_id_t *es;
 126 };
 127
 128 static void *DemuxThread( void *p_data );
 129
 130 /*****************************************************************************
 131  * Local prototypes
 132  *****************************************************************************/
 133
 134 static rfbBool mallocFrameBufferHandler( rfbClient* p_client )
 135 {
 136     vlc_fourcc_t i_chroma;
 137     demux_t *p_demux = (demux_t *) rfbClientGetClientData( p_client, DemuxThread );
 138     demux_sys_t *p_sys = p_demux->p_sys;
 139
 140     if ( p_sys->es ) /* Source has changed resolution */
 141     {
 142         es_out_Del( p_demux->out, p_sys->es );
 143         p_sys->es = NULL;
 144     }
 145
 146     int i_width = p_client->width;
 147     int i_height = p_client->height;
 148     int i_depth = p_client->format.bitsPerPixel;
 149
 150     switch( i_depth )
 151     {
 152         case 8:
 153             i_chroma = VLC_CODEC_RGB8;
 154             break;
 155         default:
 156         case 16:
 157             i_chroma = VLC_CODEC_RGB16;
 158             break;
 159         case 24:
 160             i_chroma = VLC_CODEC_RGB24;
 161             break;
 162         case 32:
 163             i_chroma = VLC_CODEC_RGB32;
 164             break;
 165     }
 166
 167     if ( i_chroma != VLC_CODEC_RGB8 ) /* Palette based, no mask */
 168     {
 169         video_format_t videofmt;
 170         video_format_Init( &videofmt, i_chroma );
 171         video_format_FixRgb( &videofmt );
 172
 173         p_client->format.redShift = videofmt.i_lrshift;
 174         p_client->format.greenShift = videofmt.i_lgshift;
 175         p_client->format.blueShift = videofmt.i_lbshift;
 176         p_client->format.redMax = videofmt.i_rmask >> videofmt.i_lrshift;
 177         p_client->format.greenMax = videofmt.i_gmask >> videofmt.i_lgshift;
 178         p_client->format.blueMax = videofmt.i_bmask >> videofmt.i_lbshift;
 179         video_format_Clean( &videofmt );
 180     }
 181
 182     /* Set up framebuffer */
 183     p_sys->i_framebuffersize = i_width * i_height * i_depth / 8;
 184
 185     /* Reuse unsent block */
 186     if ( p_sys->p_block )
 187         p_sys->p_block = block_Realloc( p_sys->p_block, 0, p_sys->i_framebuffersize );
 188     else
 189         p_sys->p_block = block_Alloc( p_sys->i_framebuffersize );
 190
 191     if ( p_sys->p_block )
 192         p_sys->p_block->i_buffer = p_sys->i_framebuffersize;
 193     else
 194         return FALSE;
 195
 196     /* Push our VNC config */
 197     SetFormatAndEncodings( p_client );
 198
 199     /* Now init and fill es format */
 200     es_format_t fmt;
 201     es_format_Init( &fmt, VIDEO_ES, i_chroma );
 202
 203     /* Fill input format */
 204     fmt.video.i_chroma = i_chroma;
 205     fmt.video.i_visible_width =
 206             fmt.video.i_width = i_width;
 207
 208     fmt.video.i_visible_height =
 209             fmt.video.i_height = i_height;
 210
 211     fmt.video.i_frame_rate_base = 1000;
 212     fmt.video.i_frame_rate = 1000 * p_sys->f_fps;
 213
 214     fmt.video.i_bits_per_pixel = i_depth;
 215     fmt.video.i_rmask = p_client->format.redMax << p_client->format.redShift;
 216     fmt.video.i_gmask = p_client->format.greenMax << p_client->format.greenShift;
 217     fmt.video.i_bmask = p_client->format.blueMax << p_client->format.blueShift;
 218
 219     fmt.video.i_sar_num = fmt.video.i_sar_den = 1;
 220
 221     /* declare the new es */
 222     p_sys->es = es_out_Add( p_demux->out, &fmt );
 223
 224     return TRUE;
 225 }
 226
 227 /* Auth */
 228 static char *getPasswordHandler( rfbClient *p_client )
 229 {
 230     demux_t *p_demux = (demux_t *) rfbClientGetClientData( p_client, DemuxThread );
 231     /* freed by libvnc */
 232     return var_InheritString( p_demux, CFG_PREFIX "password" );
 233 }
 234
 235 static rfbCredential* getCredentialHandler( rfbClient *p_client, int i_credentialType )
 236 {
 237     demux_t *p_demux = (demux_t *) rfbClientGetClientData( p_client, DemuxThread );
 238
 239     rfbCredential *credential = calloc( 1, sizeof(rfbCredential) );
 240     if ( !credential ) return NULL;
 241
 242     switch( i_credentialType )
 243     {
 244         case rfbCredentialTypeX509:
 245             /* X509None, X509Vnc, X509Plain */
 246             credential->x509Credential.x509CACertFile =
 247                     var_InheritString( p_demux, CFG_PREFIX "x509-ca" );
 248             credential->x509Credential.x509CACrlFile =
 249                     var_InheritString( p_demux, CFG_PREFIX "x509-crl" );
 250             /* client auth by certificate */
 251             credential->x509Credential.x509ClientCertFile =
 252                     var_InheritString( p_demux, CFG_PREFIX "x509-client-cert" );
 253             credential->x509Credential.x509ClientKeyFile =
 254                     var_InheritString( p_demux, CFG_PREFIX "x509-client-key" );
 255             break;
 256
 257         case rfbCredentialTypeUser:
 258             credential->userCredential.username =
 259                     var_InheritString( p_demux, CFG_PREFIX "user" );
 260             credential->userCredential.password =
 261                     var_InheritString( p_demux, CFG_PREFIX "password" );
 262             break;
 263
 264         default:
 265             free( credential );
 266             return NULL; /* Unsupported Auth */
 267     }
 268     /* freed by libvnc */
 269     return credential;
 270 }
 271
 272 /*****************************************************************************
 273  * Control:
 274  *****************************************************************************/
 275 static int Control( demux_t *p_demux, int i_query, va_list args )
 276 {
 277     demux_sys_t *p_sys = p_demux->p_sys;
 278     bool *pb;
 279     int64_t *pi64;
 280     double *p_dbl;
 281     vlc_meta_t *p_meta;
 282
 283     switch( i_query )
 284     {
 285         case DEMUX_CAN_PAUSE:
 286         case DEMUX_CAN_SEEK:
 287         case DEMUX_CAN_CONTROL_PACE:
 288         case DEMUX_CAN_CONTROL_RATE:
 289         case DEMUX_HAS_UNSUPPORTED_META:
 290             pb = va_arg( args, bool * );
 291             *pb = false;
 292             return VLC_SUCCESS;
 293
 294         case DEMUX_CAN_RECORD:
 295             pb = va_arg( args, bool * );
 296             *pb = true;
 297             return VLC_SUCCESS;
 298
 299         case DEMUX_GET_PTS_DELAY:
 300             pi64 = va_arg( args, int64_t * );
 301             *pi64 = INT64_C(1000)
 302                   * var_InheritInteger( p_demux, "network-caching" );
 303             return VLC_SUCCESS;
 304
 305         case DEMUX_GET_TIME:
 306             pi64 = va_arg( args, int64_t * );
 307             *pi64 = mdate() - p_sys->i_starttime;
 308             return VLC_SUCCESS;
 309
 310         case DEMUX_GET_LENGTH:
 311             pi64 = va_arg( args, int64_t * );
 312             *pi64 = 0;
 313             return VLC_SUCCESS;
 314
 315         case DEMUX_GET_FPS:
 316             p_dbl = va_arg( args, double * );
 317             *p_dbl = p_sys->f_fps;
 318             return VLC_SUCCESS;
 319
 320         case DEMUX_GET_META:
 321             p_meta = va_arg( args, vlc_meta_t * );
 322             vlc_meta_Set( p_meta, vlc_meta_Title, p_demux->psz_location );
 323             return VLC_SUCCESS;
 324
 325         default:
 326             return VLC_EGENERIC;
 327     }
 328 }
 329
 330 /*****************************************************************************
 331  * Demux:
 332  *****************************************************************************/
 333
 334 static void *DemuxThread( void *p_data )
 335 {
 336     demux_t *p_demux = (demux_t *) p_data;
 337     demux_sys_t  *p_sys = p_demux->p_sys;
 338     mtime_t i_next_frame_date = mdate() + p_sys->i_frame_interval;
 339     int i_status;
 340
 341     for(;;)
 342     {
 343         p_sys->i_cancel_state = vlc_savecancel();
 344         i_status = WaitForMessage( p_sys->p_client, p_sys->i_frame_interval );
 345         vlc_restorecancel( p_sys->i_cancel_state );
 346
 347         /* Ensure we're not building frames too fast */
 348         /* as WaitForMessage takes only a maximum wait */
 349         mwait( i_next_frame_date );
 350         i_next_frame_date += p_sys->i_frame_interval;
 351
 352         if ( i_status > 0 )
 353         {
 354             p_sys->p_client->frameBuffer = p_sys->p_block->p_buffer;
 355             p_sys->i_cancel_state = vlc_savecancel();
 356             i_status = HandleRFBServerMessage( p_sys->p_client );
 357             vlc_restorecancel( p_sys->i_cancel_state );
 358             if ( ! i_status )
 359             {
 360                 msg_Warn( p_demux, "Cannot get announced data. Server closed ?" );
 361                 es_out_Del( p_demux->out, p_sys->es );
 362                 p_sys->es = NULL;
 363                 return NULL;
 364             }
 365             else
 366             {
 367                 block_t *p_block = block_Duplicate( p_sys->p_block );
 368                 if ( p_block ) /* drop frame/content if no next block */
 369                 {
 370                     p_sys->p_block->i_dts = p_sys->p_block->i_pts = mdate();
 371                     es_out_SetPCR( p_demux->out, p_sys->p_block->i_pts );
 372                     es_out_Send( p_demux->out, p_sys->es, p_sys->p_block );
 373                     p_sys->p_block = p_block;
 374                 }
 375             }
 376         }
 377     }
 378     return NULL;
 379 }
 380
 381 /*****************************************************************************
 382  * Open:
 383  *****************************************************************************/
 384 static int Open( vlc_object_t *p_this )
 385 {
 386     demux_t      *p_demux = (demux_t*)p_this;
 387     demux_sys_t  *p_sys;
 388
 389     p_sys = vlc_obj_calloc( p_this, 1, sizeof(demux_sys_t) );
 390     if( !p_sys ) return VLC_ENOMEM;
 391
 392     p_sys->f_fps = var_InheritFloat( p_demux, CFG_PREFIX "fps" );
 393     if ( p_sys->f_fps <= 0 ) p_sys->f_fps = 1.0;
 394     p_sys->i_frame_interval = 1000000 / p_sys->f_fps ;
 395
 396     char *psz_chroma = var_InheritString( p_demux, CFG_PREFIX "chroma" );
 397     vlc_fourcc_t i_chroma = vlc_fourcc_GetCodecFromString( VIDEO_ES, psz_chroma );
 398     free( psz_chroma );
 399     if ( !i_chroma || vlc_fourcc_IsYUV( i_chroma ) )
 400     {
 401         msg_Err( p_demux, "Only RGB chroma are supported" );
 402         return VLC_EGENERIC;
 403     }
 404
 405     const vlc_chroma_description_t *p_chroma_desc = vlc_fourcc_GetChromaDescription( i_chroma );
 406     if ( !p_chroma_desc )
 407     {
 408         msg_Err( p_demux, "Unable to get RGB chroma description" );
 409         return VLC_EGENERIC;
 410     }
 411
 412 #ifdef NDEBUG
 413     rfbEnableClientLogging = FALSE;
 414 #endif
 415
 416     p_sys->p_client = rfbGetClient( p_chroma_desc->pixel_bits / 3, // bitsPerSample
 417                                     3, // samplesPerPixel
 418                                     p_chroma_desc->pixel_size ); // bytesPerPixel
 419     if ( ! p_sys->p_client )
 420     {
 421         msg_Dbg( p_demux, "Unable to set up client for %s",
 422                  vlc_fourcc_GetDescription( VIDEO_ES, i_chroma ) );
 423         return VLC_EGENERIC;
 424     }
 425
 426     msg_Dbg( p_demux, "set up client for %s %d %d %d",
 427              vlc_fourcc_GetDescription( VIDEO_ES, i_chroma ),
 428              p_chroma_desc->pixel_bits / 3, 3, p_chroma_desc->pixel_size );
 429
 430     p_sys->p_client->MallocFrameBuffer = mallocFrameBufferHandler;
 431     p_sys->p_client->canHandleNewFBSize = TRUE;
 432     p_sys->p_client->GetCredential = getCredentialHandler;
 433     p_sys->p_client->GetPassword = getPasswordHandler; /* VNC simple auth */
 434
 435     /* Set compression and quality levels */
 436     p_sys->p_client->appData.compressLevel =
 437             var_InheritInteger( p_demux, CFG_PREFIX "compress-level" );
 438     p_sys->p_client->appData.qualityLevel =
 439             var_InheritInteger( p_demux, CFG_PREFIX "quality-level" );
 440
 441     /* Parse uri params */
 442     vlc_url_t url;
 443     vlc_UrlParse( &url, p_demux->psz_location );
 444
 445     if ( !EMPTY_STR(url.psz_host) )
 446         p_sys->p_client->serverHost = strdup( url.psz_host );
 447     else
 448         p_sys->p_client->serverHost = strdup( "localhost" );
 449
 450     p_sys->p_client->appData.viewOnly = TRUE;
 451     p_sys->p_client->serverPort = ( url.i_port > 0 ) ? url.i_port : 5900;
 452
 453     msg_Dbg( p_demux, "VNC init %s host=%s port=%d",
 454              p_demux->psz_location,
 455              p_sys->p_client->serverHost,
 456              p_sys->p_client->serverPort );
 457
 458     vlc_UrlClean( &url );
 459
 460     /* make demux available for callback handlers */
 461     rfbClientSetClientData( p_sys->p_client, DemuxThread, p_demux );
 462     p_demux->p_sys = p_sys;
 463
 464     if( !rfbInitClient( p_sys->p_client, NULL, NULL ) )
 465     {
 466         msg_Err( p_demux, "can't connect to RFB server" );
 467         return VLC_EGENERIC;
 468     }
 469
 470     p_sys->i_starttime = mdate();
 471
 472     if ( vlc_clone( &p_sys->thread, DemuxThread, p_demux, VLC_THREAD_PRIORITY_INPUT ) != VLC_SUCCESS )
 473     {
 474         msg_Err( p_demux, "can't spawn thread" );
 475         return VLC_EGENERIC;
 476     }
 477
 478     p_demux->pf_demux = NULL;
 479     p_demux->pf_control = Control;
 480
 481     return VLC_SUCCESS;
 482 }
 483
 484 /*****************************************************************************
 485  * Close:
 486  *****************************************************************************/
 487 static void Close( vlc_object_t *p_this )
 488 {
 489     demux_t     *p_demux = (demux_t*)p_this;
 490     demux_sys_t *p_sys = p_demux->p_sys;
 491
 492     vlc_cancel( p_sys->thread );
 493     vlc_join( p_sys->thread, NULL );
 494
 495     if ( p_sys->es )
 496         es_out_Del( p_demux->out, p_sys->es );
 497
 498     rfbClientCleanup( p_sys->p_client );
 499
 500     if ( p_sys->p_block )
 501         block_Release( p_sys->p_block );
 502 }